集成 SDK--视频点播-火山引擎

文档中心

立即注册

导航

视频点播

集成 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
  # 添加 TTSDKFramework 动态库并指定 subspecs 为 Player-SR
  # 推荐使用最新稳定版，版本信息见「获取 SDK 最新版本号」小节
  pod 'TTSDKFramework', 'x.x.x.x-standard', :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

如果您已购买基础版 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-standard', :subspecs => ['Player-SR']
 
end

注意

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

步骤 2：添加 License 文件

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

注意

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

步骤 3：关闭 Bitcode

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

后续操作

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