本文为您介绍了iOS端播放器SDK的支持系统、开发环境以及集成方式,通过本文您将了解如何进行SDK集成。

前提条件

类别 说明
系统版本 支持iOS 8.0及以上。
开发工具 建议使用Xcode,本文操作步骤基于Xcode发开。下载Xcode
播放器SDK版本 支持播放器5.3.0版本SDK及以上版本。更多信息,请参见升级指南

准备工作

下载SDK

下载最新版本iOS播放器SDK

SDK包中的文件,需要下载。打开终端,按照以下代码进行下载。
cd $(SDK_PATH)   //SDK_PATH:SDK所在路径
sh createMoreKindsOfArch.sh
下载完成后,SDK包整体结构如下图所示。SDK包结构
文件夹说明。
  • ARM文件夹:带bitcode,不包括模拟器。
  • ARM_NO_BITCODE文件夹:不带bitcode,不包括模拟器。
  • ARM_SIMULATOR_NO_BITCODE:不带bitcode,包含i386 x86_64 armv7 arm64架构。
  • ARM_SIMULATOR文件夹:带bitcode,带模拟器。
注意 发版时,不能使用带模拟器的版本,否则会提交appStore失败。
Framework说明。
  • AliyunMediaDownloader:用于离线下载,非必须。
  • artcSource.framework:支持artc协议,非必须。
  • artpSource.framework:支持artp协议,非必须。
  • RtsSDK.framework:低延迟直播,非必须
  • AlivcConan:在5.3.0已经移除了对它的依赖。
说明

在进行打包时,dSYM文件用于crash符号表解析。

使用时,alivcffmpeg和AliyunPlayer都是必须的,缺一不可。播放器头文件位于AliyunPlayer。

SDK集成

SDK集成包含本地集成和cocoapods集成两种方法。

将最新版本播放器SDK,添加的Xcode工程中。
  • 本地集成
    1. 单击General页签。
    2. 将SDK的framework添加到Frameworks,Libraries,and Embedded Content中,并将Embed设置为Embed & Sign本地集成
    3. 单击Build Settings页签。
    4. 单击Search Paths区域下的Framework Search Paths,修改为本地framework所在的目录。
      说明 如果您的代码或引用的第三方代码,与alivcffmpeg或AlivcConan的symbol有冲突,可以将alivcffmpeg或AlivcConan从Linked Frameworks and Libraries里删除,app link时可以不依赖这两个framework。AlivcConan在5.3.0不需要依赖。
  • cocoapods集成
    采用pod语句集成,示例代码如下所示:
    ruby
      platform:ios, '8.0'
      target 'yourProject' do
        pod 'AliPlayerSDK_iOS'
       end
    如果需要支持artc、artp或rts,示例代码如下所示:
    ruby
      platform:ios, '8.0'
      target 'yourProject' do
        pod 'AliPlayerSDK_iOS', '5.3.0'
        pod 'AliPlayerSDK_iOS_ARTP', '5.3.0'
        pod 'AliPlayerSDK_iOS_ARTC', '5.3.0'
        pod 'RtsSDK', '1.5.0'
       end
    说明 如需同时集成播放器SDK和短视频SDK,将AliPlayerSDK_iOS替换成 AliPlayerPartSDK_iOS。AliPlayerPartSDK_iOS不包含ffmpeg,避免了与短视频SDK中的ffmpeg的冲突。