集成指引

本文主要介绍如何快速将腾讯礼物动画特效 SDK 集成到您的项目中。按照以下步骤进行配置，即可完成 SDK 的集成工作。
开发环境要求
Xcode 9.0+。
iOS 9.0 以上的 iPhone 或者 iPad 真机。
项目已配置有效的开发者签名。
集成指引
手动集成
1. 下载 MediaX_Android_iOS_Latest.zip ，下载完成后进行解压获取到 SDK 库文件。
2. 使用 TCEffectPlayer 需要集成下面的 framework：
SDK 库
TCMediaX.xcframework
TCEffectPlayer.xcframework
libtcpag.xcframework
YTCommonXMagic.framework
系统库
libz.tab
libc++.tbd
AVFoundation.framework
﻿
﻿
3. 设置 Other linker Flags 
     在“Build Settings” > “Other linker Flags ” > 设置“-ObjC”。
Pods 方式集成
目前特效播放器支持 Pods 渠道方式进行集成，集成 Pods 方法如下：
# 引入TCMediaX
pod 'TCMediaX', :podspec => 'https://mediacloud-76607.gzc.vod.tencent-cloud.com/MediaX/iOS/podspec/release/3.2/241/TCMediaX.podspec'
﻿
# 引入TCEffectPlayer
pod 'TCEffectPlayer', :podspec => 'https://mediacloud-76607.gzc.vod.tencent-cloud.com/MediaX/iOS/podspec/release/3.2/241/TCEffectPlayer.podspec'
  
# 引入YTCommonXMagic.framework
pod 'YTCommonXMagic', :podspec => 'https://mediacloud-76607.gzc.vod.tencent-cloud.com/MediaX/iOS/podspec/release/YTCommonXMagic_1.3.1/YTCommonXMagic.podspec'
TCEffectPlayer 支持单独集成或依赖腾讯云播放器 SDK 联动集成的方式，两者之间的区别在于是否利用腾讯云播放器强大的解码能力。
若您使用独立集成的方式，则视频的解码器类型（TCEffectConfig#vapEngineType）需设置为 TCEPCodecTypeAVPlayer 联动腾讯云播放器 SDK。
如果您集成腾讯云播放器精简版 SDK（LiteAVSDK_Player_Mini）， 视频的解码器类型（TCEffectConfig - vapEngineType）需设置为TCEPCodecTypeVODPlayer。播放器精简版 SDK不需要额外申请播放器 License。
如果您的项目中已经集成了腾讯云视立方 SDK， 请检查是否包含播放器 SDK ，同时检查是否已经申请和配置播放器 License，播放器 License 申请指引。
腾讯云播放器接入文档可参见 腾讯云播放器集成文档 。
申请动画特效播放 License
使用 TCEffectPlayer 需要申请动画特效播放 License，详细申请流程请参见 控制台 License 申请指南。﻿
常见问题
YTCommonXMagic 冲突如何解决?
如果您的项目中集成了美颜特效 SDK，由于美颜特效 SDK 和 动画特效 SDK 都使用了 License 授权库 YTCommonXMagic.framework，所以会集成是出现符号冲突。此时在集成动画特效 SDK 时，不需要额外集成 YTCommonXMagic.framework，共享一份美颜特效 SDK 的 YTCommonXMagic.framework 即可。