iOS端

通过阅读本文,您可以了解如何在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集成(推荐)

  1. 在项目目录下执行命令pod init,创建Podfile文件。

  2. 修改Podfile文件,添加SDK依赖。

    本文中引入的SDK版本号仅供参考,获取最新的版本请参见场景SDK

    #下面4种场景组合,请根据自己的业务需要,选择一种接入即可
    
     #1.标准一体化SDK:播放器 + 超低延迟直播 + 直播 + 短视频 + RTC连麦 + 基础美颜
     pod 'AliVCSDK_Standard', '6.17.0'
     #2.基础直播SDK:播放器 + 直播推流 + 基础美颜 + 超低延迟直播
     pod 'AliVCSDK_BasicLive', '6.17.0'   
     #3.短视频场景SDK:播放器 + 短视频 + 基础美颜
     pod 'AliVCSDK_UGC', '6.17.0'  
     #4.互动直播SDK:播放器 + 超低延迟直播 + 直播推流 + RTC连麦 + 基础美颜
     pod 'AliVCSDK_InteractiveLive', '6.17.0'
  3. 执行命令pod install,安装SDK。

    命令执行完成之后,会生成*.xcworkspace文件,表示SDK集成完毕。

手动集成

说明
  • 提交到App Store时需要剥离模拟器版本(x86架构)的动态库,否则会被拒绝。pod集成方式已自动处理。

  • 如遇编译报错时,在Xcode工程中Tergets > Build Settings > Apple Clang - Language > Compile Sources As,配置为Objective-C++

  1. 下载并解压iOS端指定场景SDK

  2. 添加SDK依赖。

    在Xcode工程中Tergets > General > Frameworks, Libraries, and Embedded Content,导入AliVCSDK_***.frameworkalivcffmpeg.framework依赖(按需导入SDK包中的其他依赖),并将对应Embed选择为Embed & Sign

  3. 添加其他库依赖。

    在Xcode工程中Tergets > General > Frameworks, Libraries, and Embedded Content,导入MobileCoreServices.frameworkSystemConfiguration.frameworkCoreTelephony.frameworkCoreMedia.frameworkVideoToolbox.frameworkAVFoundation.frameworklibresolv.tbd依赖。

  4. 添加资源包(如果SDK包有)。

    AliyunVideoSDKPro.bundle依赖导入到工程。

步骤二:配置License授权

首次接入SDK,需要申请License配置License授权

步骤三:配置App权限

  1. 在Xcode工程中Tergets > Build Settings > linking > Other Linker Flags,添加-ObjC链接选项。

  2. 在Xcode工程中Tergets > Build Settings > Build Options > Enable Bitcode,配置为NO

  3. 修改Info.plist文件,配置App权限。

    Privacy - Camera Usage Description
    Privacy - Microphone Usage Description
    Privacy - Photo Library Usage Description

常见问题

请参见常见问题下各功能模块章节。