You need to enable JavaScript to run this app.
导航
集成 SDK
最近更新时间:2024.09.11 11:14:49首次发布时间:2021.02.23 10:42:36

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

环境要求

  • 开发环境:Xcode 14.0 或以上版本,推荐使用最新版本
  • 系统版本:iOS 11.0 或以上版本的 iOS 设备

前提条件

集成 iOS 点播 SDK 前,您需要登录视频点播控制台,完成以下操作:

  • 创建应用
  • 购买 License 包
  • 绑定 License 与应用
  • 下载 License 文件

详情请见创建应用License 包管理

说明

测试版 License 不能在线上业务 App 使用,原因如下:

  • 测试版 License 仅供联调测试,到期后无法续期。
  • 测试版 License 到期会导致 App 鉴权不通过,从而影响业务使用。

操作步骤

添加依赖

您可通过 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 存在符号冲突,需要切换到动态库避免符号冲突。

添加 License 文件

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

注意

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

关闭 Bitcode

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

后续操作

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