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

文档中心

立即注册

导航

视频点播

集成 SDK

最近更新时间：2025.11.21 17:39:03首次发布时间：2021.02.23 10:42:36

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

开发环境

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

获取 License

视频点播通过 License 管理播放器 SDK 及其增值服务的使用权限和时间。在项目测试阶段，您可以在视频点播控制台申请免费的测试 License。您需完成创建应用、申请免费测试 License、绑定 License 与应用，详细操作步骤，请见应用管理和播放器 License。

注意

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

集成步骤

步骤 1：添加依赖

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

说明

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

通过 CocoaPods 集成

通过 SPM 集成

播放器 SDK 支持两种集成方式：静态库（TTSDK）和动态库（TTSDKFramework）。您需要在工程的 Podfile 文件中添加相关依赖，并执行 pod install 下载 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
  # 若您不使用超分功能且希望减少包体积，可指定 subspecs 为 Player
  # 推荐使用最新稳定版，版本信息见 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
  # 推荐使用最新稳定版，版本信息见 SDK 发布历史
  pod 'TTSDKFramework', 'x.x.x.x-standard', :subspecs => ['Player']
 
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
  # 若您不使用超分功能且希望减少包体积，可指定 subspecs 为 Player
  # 推荐使用最新稳定版，版本信息见 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
  # 推荐使用最新稳定版，版本信息见 SDK 发布历史
  pod 'TTSDK', 'x.x.x.x-standard', :subspecs => ['Player']
 
end

注意

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

自 1.47.3 起，支持通过 Swift Package Manager (SPM) 方式集成播放器 SDK。具体步骤如下：

在您的 Xcode 工程中，单击 Package Dependencies 页签下的 + 按钮。
在弹出的对话框右上角，输入 git@github.com:volcengine/TTSDK_SPM.git。然后输入要集成的 SDK 版本号，并单击 Add Package，添加 TTSDK 依赖。
说明
版本号中带 -standard 后缀的为基础版；带 -premium 后缀的为高级版。
说明
推荐选择 Exact Version 作为 Dependency Rule。
按需选择依赖的组件，单击 Add Package 将组件添加到您的 Target 中。

可选择以下组件：
- TTSDK_Player：点播播放器
- TTSDK_Player_SR：点播播放器，包含超分功能
- TTSDK_Player_H266：点播播放器，包含 H.266 解码

步骤 2：配置 License 文件

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

注意

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

步骤 3：关闭 Bitcode

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

后续操作

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