通过阅读本文,您可以了解如何在iOS端快速集成MediaBox音视频SDK,以适应不同的业务场景。
注意事项
若您需要从v6.6.0及以下版本的SDK升级到v6.7.0(含)以上版本,详情请参见关于音视频终端SDK V6.7.0版本美颜特效集成变更公告。
环境要求
类别 | 说明 |
macOS | 支持macOS High Sierra 10.13及以上版本。 |
Xcode | 本文操作步骤基于Xcode开发,下载地址:Xcode。 |
iOS版本 | 支持iOS 9.0及以上版本。 |
步骤一:集成SDK
pod集成(推荐)
在项目目录下执行命令
pod init
,创建Podfile文件。修改Podfile文件,添加SDK依赖。
本文中引入的SDK版本号仅供参考,获取最新的版本请参见场景SDK。
#下面4种场景组合,请根据自己的业务需要,选择一种接入即可 #1.标准一体化SDK:播放器 + 超低延迟直播 + 直播 + 短视频 + RTC连麦 + 基础美颜 pod 'AliVCSDK_Standard', '6.19.0' #2.基础直播SDK:播放器 + 直播推流 + 基础美颜 + 超低延迟直播 pod 'AliVCSDK_BasicLive', '6.19.0' #3.短视频场景SDK:播放器 + 短视频 + 基础美颜 pod 'AliVCSDK_UGC', '6.19.0' #4.互动直播SDK:播放器 + 超低延迟直播 + 直播推流 + RTC连麦 + 基础美颜 pod 'AliVCSDK_InteractiveLive', '6.19.0'
执行命令
pod install
,安装SDK。命令执行完成之后,会生成*.xcworkspace文件,表示SDK集成完毕。
手动集成
提交到App Store时需要剥离模拟器版本(x86架构)的动态库,否则会被拒绝。pod集成方式已自动处理。
如遇编译报错时,在Xcode工程中
,配置为Objective-C++。
下载并解压iOS端指定场景SDK。
添加SDK依赖。
在Xcode工程中
,导入AliVCSDK_***.framework
和alivcffmpeg.framework
依赖(按需导入SDK包中的其他依赖),并将对应Embed选择为Embed & Sign。添加其他库依赖。
在Xcode工程中
,导入MobileCoreServices.framework
、SystemConfiguration.framework
、CoreTelephony.framework
、CoreMedia.framework
、VideoToolbox.framework
、AVFoundation.framework
和libresolv.tbd
依赖。添加资源包(如果SDK包有)。
将
AliyunVideoSDKPro.bundle
依赖导入到工程。
步骤二:配置License授权
首次接入SDK,需要申请License并配置License授权。
步骤三:配置App权限
在Xcode工程中
,添加-ObjC链接选项。在Xcode工程中
,配置为NO。修改Info.plist文件,配置App权限。
Privacy - Camera Usage Description Privacy - Microphone Usage Description Privacy - Photo Library Usage Description
常见问题
请参见常见问题下各功能模块章节。