本文提供快速集成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.5.0'
        pod 'AliPlayerSDK_iOS_ARTC', '5.4.5.0'
        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所在的目录。

常见集成问题

播放器问题

功能使用文档

基础功能

进阶功能