本文介绍iOS播放器SDK的环境要求、集成方式及权限配置等信息。

环境要求

类别 说明
iOS版本 支持iOS 9.0及以上版本。
macOS High Sierra版本 支持macOS High Sierra 10.13及以上版本。
Xcode版本 建议使用Xcode，本文操作步骤基于Xcode开发。下载地址请参见Xcode。

SDK说明

从1.2.0版本开始，根据相关的业务场景，我们提供了不同SDK组合形式，选择合适的组合包，不仅便于操作，而且包体更小。具体的组合形式如下：

包名 场景 组合形式
AliVCSDK_Standard 全功能（不含美颜特效） 直播推流（含超低延时直播、RTC连麦） + 短视频 + 播放器
AliVCSDK_Premium 全功能（含美颜特效） 直播推流（含超低延时直播、RTC连麦） + 短视频 + 美颜特效 + 播放器
AliVCSDK_BasicLive 基础直播 直播推流 + 播放器
AliVCSDK_StandardLive 基础直播（含美颜特效） 直播推流 + 播放器 + 美颜特效
AliVCSDK_UGC 短视频 短视频 + 播放器
AliVCSDK_UGCPro 短视频（含美颜特效） 短视频 + 美颜特效 + 播放器
AliVCSDK_InteractiveLive 互动直播，适用于连麦、超低延时直播需求的业务场景 直播推流（含超低延时直播、RTC连麦） + 播放器
AliVCSDK_PremiumLive 互动直播（含美颜特效），适用于有连麦、超低演示直播需求的业务场景 直播推流（含超低延时直播、RTC连麦） + 美颜特效 + 播放器

在线集成（推荐）

  1. 选择合适的SDK后，在Podfile文件中添加SDK依赖。
    #下面8种组合，请根据自己的业务需要，选择一种接入即可

 #1.直播推流（含超低延时直播、RTC连麦） + 短视频 + 播放器
 pod 'AliVCSDK_Standard', '1.6.0'
 #2.直播推流（含超低延时直播、RTC连麦） + 短视频 + 美颜特效 + 播放器
 pod 'AliVCSDK_Premium', '1.6.0'
 #3.直播推流 + 播放器
 pod 'AliVCSDK_BasicLive', '1.6.0'
 #4.直播推流 + 播放器 + 美颜特效
 pod 'AliVCSDK_StandardLive', '1.6.0'
 #5.短视频 + 播放器
 pod 'AliVCSDK_UGC', '1.6.0'
 #6.短视频 + 美颜特效 + 播放器
 pod 'AliVCSDK_UGCPro', '1.6.0'
 #7.直播推流（含超低延时直播、RTC连麦） + 播放器
 pod 'AliVCSDK_InteractiveLive', '1.6.0'
 #8.直播推流（含超低延迟直播、RTC连麦）+ 美颜特效 + 播放器
 pod 'AliVCSDK_PremiumLive', '1.6.0'
  2. 执行pod。
    pod install

离线集成

离线集成需要手动下载集成相应版本的2个库和一个bundle资源包。

库名 描述 下载地址
AliVCSDK_xxx 音视频终端SDK
说明 库名中“xxx”表示具体的名称，请参考SDK说明。
alivcffmpeg ffmpeg动态库
说明 使用AliVCSDK_Premium、AliVCSDK_Standard、AliVCSDK_UGC、AliVCSDK_UGCPro等SDK时，需要集成，其它SDK不需要集成。
下载地址
AliyunVideoSDKPro.bundle 短视频资源包
说明 使用AliVCSDK_Premium、AliVCSDK_Standard、AliVCSDK_UGC、AliVCSDK_UGCPro等SDK，并且需要用到短视频拍摄功能时集成，其它情况不需要集成。
下载地址包含在AliVCSDK_xxx中，详细信息请参见AliVCSDK_xxx下载地址。
  1. 添加动态库。
    1. 单击General，选择Frameworks，Libraries和Embedded Content。
    2. 单击＋，然后单击Add Other…，分别导入AliVCSDK_xxx.framework（根据您实际使用的SDK选择）和alivcffmpeg.framework（如果有）依赖。
    3. 导入之后选择Embed &Sign。
  2. 添加其他库依赖。
    1. 单击General，选择Frameworks，Libraries和Embedded Content。
    2. 单击＋，分别添加MobileCoreServices.framework，SystemConfiguration.framework，CoreTelephony.framework，CoreMedia.framework，VideoToolbox.framework，AVFoundation.framework和libresolv.tbd依赖。
  3. 引入资源包（如有）。
    将AliyunVideoSDKPro.bundle依赖导入到工程。
说明
  • 提交到App Store需要剥离模拟器版本（x86架构）的动态库，否则会被拒绝。pod集成方式已自动处理。
  • 如遇编译报错时，请将Build Settings > Apple Clang - Language > Compile Sources As修改为Objective-C++。

配置App权限

SDK集成后，打开项目工程并修改以下配置：

  1. 配置Build Setting > Linking > Other Linker Flags ，添加-ObjC。
  2. 配置Build Setting > Build Options > Enable Bitcode，设为NO。
  3. 打开工程info.Plist，添加以下权限：
    Privacy - Camera Usage Description
Privacy - Microphone Usage Description
Privacy - Photo Library Usage Description

配置License授权

首次接入SDK，需要获取License，并获取到对应的License Key和License配置文件。详细操作，请参见License使用说明。

获取到LicenseFile后请导入到App工程里，并且在Info.plist中添加两个key，需要添加的key和对应的value如下表：

Key value
AlivcLicenseKey LicenseKey的值。
AlivcLicenseFile 内置证书文件（相对于mainBundle）的路径。

API文档

音视频终端SDK的主要接口及相关说明请参见接口说明。

常见问题

集成常见问题，请参见常见问题。