集成指引
本文主要介绍如何快速将腾讯礼物动画特效 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 方法如下:
# 引入TCMediaXpod 'TCMediaX', :podspec => 'https://mediacloud-76607.gzc.vod.tencent-cloud.com/MediaX/iOS/podspec/release/3.0.246/TCMediaX.podspec'# 引入TCEffectPlayerpod 'TCEffectPlayer', :podspec => 'https://mediacloud-76607.gzc.vod.tencent-cloud.com/MediaX/iOS/podspec/release/3.0.246/TCEffectPlayer.podspec'# 引入YTCommonXMagic.frameworkpod 'YTCommonXMagic', :podspec => 'https://mediacloud-76607.gzc.vod.tencent-cloud.com/MediaX/iOS/podspec/release/YTCommonXMagic_1.1/YTCommonXMagic.podspec'
TCEffectPlayer 支持单独集成或依赖腾讯云播放器 SDK 联动集成的方式,两者之间的区别在于是否利用腾讯云播放器强大的解码能力。
若您使用独立集成的方式,则视频的解码器类型(
TCEffectConfig#vapEngineType
)需设置为 TCEPCodecTypeAVPlayer 联动腾讯云播放器 SDK。如果您集成腾讯云播放器精简版 SDK(LiteAVSDK_Player_Mini), 视频的解码器类型(TCEffectConfig - vapEngineType)需设置为TCEPCodecTypeVODPlayer。播放器精简版 SDK不需要额外申请播放器 License。
如果您的项目中已经集成了腾讯云视立方 SDK, 请检查是否包含播放器 SDK ,同时检查是否已经申请和配置播放器 License,播放器 License 申请指引。
腾讯云播放器接入文档可参见 腾讯云播放器集成文档 。
申请动画特效播放 License
常见问题
YTCommonXMagic 冲突如何解决?
如果您的项目中集成了美颜特效 SDK,由于美颜特效 SDK 和 动画特效 SDK 都使用了 License 授权库 YTCommonXMagic.framework,所以会集成是出现符号冲突。此时在集成动画特效 SDK 时,不需要额外集成 YTCommonXMagic.framework,共享一份美颜特效 SDK 的 YTCommonXMagic.framework 即可。