本文介绍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连麦) + 美颜特效 + 播放器 |
在线集成(推荐)
- 选择合适的SDK后,在Podfile文件中添加SDK依赖。
#下面8种组合,请根据自己的业务需要,选择一种接入即可 #1.直播推流(含超低延时直播、RTC连麦) + 短视频 + 播放器 pod 'AliVCSDK_Standard', '6.1.0' #2.直播推流(含超低延时直播、RTC连麦) + 短视频 + 美颜特效 + 播放器 pod 'AliVCSDK_Premium', '6.1.0' #3.直播推流 + 播放器 pod 'AliVCSDK_BasicLive', '6.1.0' #4.直播推流 + 播放器 + 美颜特效 pod 'AliVCSDK_StandardLive', '6.1.0' #5.短视频 + 播放器 pod 'AliVCSDK_UGC', '6.1.0' #6.短视频 + 美颜特效 + 播放器 pod 'AliVCSDK_UGCPro', '6.1.0' #7.直播推流(含超低延时直播、RTC连麦) + 播放器 pod 'AliVCSDK_InteractiveLive', '6.1.0' #8.直播推流(含超低延迟直播、RTC连麦)+ 美颜特效 + 播放器 pod 'AliVCSDK_PremiumLive', '6.1.0'
- 执行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下载地址。 |
- 添加动态库。
- 单击General,选择Frameworks,Libraries和Embedded Content。
- 单击+,然后单击Add Other…,分别导入
AliVCSDK_xxx.framework
(根据您实际使用的SDK选择)和alivcffmpeg.framework
(如果有)依赖。 - 导入之后选择Embed &Sign。
- 添加其他库依赖。
- 单击General,选择Frameworks,Libraries和Embedded Content。
- 单击+,分别添加
MobileCoreServices.framework
,SystemConfiguration.framework
,CoreTelephony.framework
,CoreMedia.framework
,VideoToolbox.framework
,AVFoundation.framework
和libresolv.tbd
依赖。
- 引入资源包(如有)。将
AliyunVideoSDKPro.bundle
依赖导入到工程。
说明
- 提交到App Store需要剥离模拟器版本(x86架构)的动态库,否则会被拒绝。pod集成方式已自动处理。
- 如遇编译报错时,请将Build Settings > Apple Clang - Language > Compile Sources As修改为Objective-C++。
配置App权限
SDK集成后,打开项目工程并修改以下配置:
- 配置Build Setting > Linking > Other Linker Flags ,添加-ObjC。
- 配置Build Setting > Build Options > Enable Bitcode,设为NO。
- 打开工程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的主要接口及相关说明请参见接口概览。
常见问题
集成常见问题,请参见常见问题。