本文提供快速集成iOS播放器SDK的指引。

环境要求

类别 说明
系统版本 支持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的冲突。
  1. 采用pod语句集成播放器SDK，示例代码如下：
    ruby
  platform:ios, '8.0'
  target 'yourProject' do
    pod 'AliPlayerSDK_iOS'
   end
  2. 可选：如果需要支持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版本开始不再需要依赖。
  1. 在Xcode工程中，单击General页签。
  2. 将SDK的framework添加到Frameworks，Libraries，and Embedded Content中，并将Embed设置为Embed & Sign。
    本地集成
  3. 单击Build Settings页签。
  4. 单击Search Paths区域下的Framework Search Paths，修改为本地framework所在的目录。

配置License

说明
  • V5.4.7.1及之后版本的iOS播放器SDK必须按以下操作配置License后，方可使用。
  • License配置完成后，查看日志若无License相关报错，则表示License配置成功。
  1. 获取License证书文件，获取方式请参见获取License。
    说明 配置的License文件和LicenseKey和申请时提交的应用信息（BundleID）有严格的对应关系，请确保License文件和LicenseKey和申请时的信息保持一致，否则会出现鉴权失败的情况。
  2. 在Xcode工程里，通过Build Phases > Copy Bundle Resources，将获取到的证书文件拷贝到Xcode的项目中，建议放到AppSupportFiles目录下，也可以放到沙箱或者其他路径。
  3. 在Info.plist文件中添加如下字段。
    ios-license
    • key为AlivcLicenseKey，value为LicenseKey的值。
    • key为AlivcLicenseFile，value为步骤二中证书文件的放置路径，请根据实际情况填写。 
      <key>AlivcLicenseKey</key>
    <string>Wo8s*******************</string>
  <key>AlivcLicenseFile</key>
    <string>license.crt</string>

常见集成问题

播放器问题

功能使用文档

基础功能

进阶功能