本文提供快速集成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后,方可使用。
  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>

常见集成问题

播放器问题

功能使用文档

基础功能

进阶功能