一、开发环境要求
·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 方法如下：
# 引入TCMediaXpod 'TCMediaX', :podspec => 'https://mediacloud-76607.gzc.vod.tencent-cloud.com/MediaX/iOS/podspec/release/3.5/3.5.243/TCMediaX.podspec'# 引入TCEffectPlayerpod 'TCEffectPlayer', :podspec => 'https://mediacloud-76607.gzc.vod.tencent-cloud.com/MediaX/iOS/podspec/release/3.5/3.5.243/TCEffectPlayer.podspec' # 引入YTCommonXMagic.frameworkpod 'YTCommonXMagic', :podspec => 'https://mediacloud-76607.gzc.vod.tencent-cloud.com/MediaX/iOS/podspec/release/YTCommonXMagic_1.4/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 即可。
更多常见问题请参见 常见问题列表。