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

文档中心

立即注册

导航

集成 SDK

最近更新时间：2024.11.06 17:33:59首次发布时间：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
  # 添加 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 的下载速度和稳定性。

添加 License 文件

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

注意

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

关闭 Bitcode

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

后续操作

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