You need to enable JavaScript to run this app.
导航
集成 SDK
最近更新时间:2025.04.02 12:00:48首次发布时间:2021.02.23 10:42:36
我的收藏
有用
有用
无用
无用

本文为您介绍集成 iOS 播放器 SDK 的环境要求和具体操作步骤。

开发环境

  • Xcode 或其他可识别 xcodeproj 格式的 IDE。推荐使用最新版本。
  • iOS 11.0 及以上版本。
  • 建议使用真实设备进行开发和调试。模拟器与真实设备在播放和渲染方面存在细微差异,表现可能不一致。

获取 License

视频点播通过 License 管理播放器 SDK 及其增值服务的使用权限和时间。在项目测试阶段,您可以在视频点播控制台申请免费的测试 License。您需完成以下操作:

注意

测试 License 仅限项目测试阶段使用,不可续期。测试 License 到期会导致鉴权失败,进而影响业务的正常使用。项目上线前,请升级至正式 License

集成步骤

步骤 1:添加依赖

您可通过 CocoaPods 集成播放器 SDK。播放器 SDK 支持两种集成方式:静态库(TTSDK)和动态库(TTSDKFramework)。您需要在工程的 Podfile 文件中添加相关依赖,并执行 pod install 下载 SDK。

说明

播放器 SDK 分为基础版和高级版,不同版本之间存在功能差异,请根据购买的 License 版本选择对应的集成方式。

说明

请参见发布历史获取 SDK 最新版本号。

(推荐)方案一:使用动态库

如果您已购买高级版 License,添加依赖的示例代码如下所示。
source 'https://github.com/CocoaPods/Specs.git'
source 'https://github.com/volcengine/volcengine-specs.git'

platform :ios, '11'

target 'VOLCDemo' do
  # 添加 TTSDKFramework 动态库并指定 subspecs 为 Player-SR
  # 推荐使用最新稳定版,版本信息见「获取 SDK 最新版本号」小节
  pod 'TTSDKFramework', 'x.x.x.x-premium', :subspecs => ['Player-SR']
 
end

方案二:使用静态库

如果您已购买高级版 License,添加依赖的示例代码如下所示。
source 'https://github.com/CocoaPods/Specs.git'
source 'https://github.com/volcengine/volcengine-specs.git'

platform :ios, '11'

target 'VOLCDemo' do
  # 添加 TTSDK 静态库并指定 subspecs => ['Player-SR']
  # 推荐使用最新稳定版,版本信息见「获取 SDK 最新版本号」小节
  pod 'TTSDK', 'x.x.x.x-premium', :subspecs => ['Player-SR']
 
end

注意

  • 使用 TTSDK 静态库时,如果与其他 SDK 存在符号冲突,需要切换到动态库避免符号冲突。
  • 若项目已配置 CocoaPods 镜像,则 CocoaPods 官方源 https://github.com/CocoaPods/Specs.git 可以省略,以提升 CocoaPods 的下载速度和稳定性。

步骤 2:添加 License 文件

License 文件作为使用 TTSDK 对应模块的鉴权凭证,需要正确设置,将您获取到的 License 文件拖入工程,操作后的截图如下所示。
Image

注意

  • 传入 SDK 的初始化参数 BundleIDAppID 与 License 文件有严格的对应关系。
  • 同时需要确保您传入 SDK 的 BundleID 和工程配置的 BundleID 一致,否则会出现鉴权失败的问题。

步骤 3:关闭 Bitcode

关闭 Bitcode,操作后的截图如下所示。
Image

后续操作

至此,您已完成播放器 SDK 的集成。接下来可使用播放器 SDK 播放视频。详情请见快速开始