You need to enable JavaScript to run this app.
文档中心
文档备案控制台
视频点播

视频点播

请输入
  • 文档首页
    • 视频点播播放器 SDKiOS 播放器 SDK不含 UI 集成方案集成 SDK
复制全文
下载 pdf
我的收藏
不含 UI 集成方案
集成 SDK
复制全文
下载 pdf
我的收藏
集成 SDK

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

开发环境

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

获取 License

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

注意

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

集成步骤

步骤 1：添加依赖

您可以通过 CocoaPods 或 Swift Package Manager (SPM) 两种方式集成 SDK。

说明

  • 参见发布历史获取 SDK 最新版本号。
  • 播放器 SDK 分为基础版和高级版，不同版本之间存在功能差异，请根据购买的 License 集成不同版本的 SDK。

播放器 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
  # 添加 TTSDK 静态库并指定 subspecs 为 Player-SR
  # 若您不使用超分功能且希望减少包体积，可指定 subspecs 为 Player
  # 推荐使用最新稳定版，版本信息见 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 的初始化参数 BundleID、AppID 与 License 文件有严格的对应关系。
  • 需要确保您传入 SDK 的 BundleID 和工程配置的 BundleID 一致，否则会出现鉴权失败的问题。

步骤 3：关闭 Bitcode

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

后续操作

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

常见问题

我的视频存储在视频点播的海外柔佛地域，需要特殊配置吗？

当您的业务接入海外柔佛地域时，需要对播放器 SDK 进行专门的地域配置，主要涉及以下两个环节：

  • 配置海外日志上报通道：修改 podfile 文件，确保海外用户的播放日志从海外渠道进行上报。
  • 指定海外业务服务地域：在初始化 SDK 时，通过 appRegion 参数，明确指定视频资源所在的海外服务地域。

详细的操作步骤，请参见服务地域文档中的播放器 SDK章节。

最近更新时间：2026.06.02 15:46:54
这个页面对您有帮助吗？
有用
有用
无用
无用