快速集成 - 视频点播

环境要求


类别	说明
系统版本	支持iOS 8.0及以上版本。
开发工具	建议使用Xcode，本文操作步骤基于Xcode开发。下载地址：Xcode。

前提条件

本地集成SDK时，需要先下载iOS播放器SDK包（包含了iOS播放器SDK及Demo源码），推荐下载使用最新版本。下载地址请参见SDK简介与下载。

解压后的目录结构如下：


文件名	作用
demo	iOS播放器SDK的Demo源码。
doc	iOS播放器SDK接口文档。
sdk	iOS播放器SDK的framework库，只提供了包含bitcode和模拟器的ARM_SIMULATOR文件夹，如果需要不包含bitcode或模拟器的包，请参考以下命令另行下载。 `cd $(SDK_PATH) //SDK_PATH：SDK所在路径 sh createMoreKindsOfArch.sh`
ReleaseNote	版本说明。

sdk文件夹下各文件说明如下：


文件名	说明
ARM	带bitcode，不包括模拟器。
ARM_NO_BITCODE	不带bitcode，不包括模拟器。
ARM_SIMULATOR	带bitcode，带模拟器。
ARM_SIMULATOR_NO_BITCODE	不带bitcode，包含i386 x86_64 armv7 arm64架构。

注意模拟器用于代码调试，发布时，不能使用带模拟器的版本，否则会提交AppStore失败。

Framework说明如下：


Framework	说明
alivcffmpeg.framework	播放器底层，必须。
AliyunMediaDownloader.framework	用于离线下载，非必须。
AliyunPlayer.framework	播放器，必须。
artcSource.framework	支持artc协议，非必须。
artpSource.framework	支持artp协议，非必须。在5.4.5.0版本已经移除了对它的依赖。
RtsSDK.framework	超低延时直播，非必须。
AlivcConan	在5.3.0版本已经移除了对它的依赖。

说明

在进行打包时，dSYM文件用于crash符号表解析。
使用时，alivcffmpeg和AliyunPlayer都是必须的，缺一不可。播放器头文件位于AliyunPlayer。

SDK集成（cocoapods集成）（推荐）

说明如需同时集成播放器SDK和短视频SDK，将下面代码中的AliPlayerSDK_iOS替换成AliPlayerPartSDK_iOS。AliPlayerPartSDK_iOS不包含ffmpeg，避免了与短视频SDK中的ffmpeg的冲突。

采用pod语句集成播放器SDK，示例代码如下：

ruby
  platform:ios, '8.0'
  target 'yourProject' do
    pod 'AliPlayerSDK_iOS'
   end

可选：如果需要支持artc协议或播放超低延时直播（RTS）流，请添加以下pod依赖，示例代码如下：

说明请确保引入的播放器SDK版本号填写正确，否则将报错并引入失败。

ruby
  platform:ios, '8.0'
  target 'yourProject' do
    pod 'AliPlayerSDK_iOS', '5.4.7.1'
    pod 'AliPlayerSDK_iOS_ARTC', '5.4.7.1'
    pod 'RtsSDK', '2.2.0' //此处版本仅供参考，获取最新RTS SDK的版本请参见超低延时直播SDK下载。
   end

SDK集成（本地集成）

说明如果您的代码或引用的第三方代码，与alivcffmpeg或AlivcConan的symbol有冲突，可以将alivcffmpeg或AlivcConan从Linked Frameworks and Libraries里删除，app link时可以不依赖这两个framework。AlivcConan从5.3.0版本开始不再需要依赖。

在Xcode工程中，单击General页签。
将SDK的framework添加到Frameworks，Libraries，and Embedded Content中，并将Embed设置为Embed & Sign。
单击Build Settings页签。
单击Search Paths区域下的Framework Search Paths，修改为本地framework所在的目录。

配置License

说明 V5.4.7.1及之后版本的iOS播放器SDK必须按以下操作配置License后，方可使用。

获取License证书文件，获取方式请参见License升级说明。

说明配置的License文件和LicenseKey和申请时提交的应用信息（BundleID）有严格的对应关系，请确保License文件和LicenseKey和申请时的信息保持一致，否则会出现鉴权失败的情况。
在Xcode工程里，通过Build Phases > Copy Bundle Resources，将获取到的证书文件拷贝到Xcode的项目中，建议放到AppSupportFiles目录下，也可以放到沙箱或者其他路径。
在Info.plist文件中添加如下字段。
- key为AlivcLicenseKey，value为LicenseKey的值。
- key为AlivcLicenseFile，value为步骤二中证书文件的放置路径，请根据实际情况填写。
```
  <key>AlivcLicenseKey</key>
    <string>Wo8s*******************</string>
  <key>AlivcLicenseFile</key>
    <string>license.crt</string>
```

常见集成问题

播放器问题

功能使用文档

基础功能

进阶功能