本文为您介绍iOS短视频SDK的pod集成和手动配置操作。

前提条件

开发前的环境要求如下表所示。
类别 说明
系统版本 支持iOS 9.0及以上版本。
macOS High Sierra版本 支持macOS High Sierra 10.13及以上版本。
Xcode版本 支持Xcode 9.0及以上版本，下载Xcode。

背景信息

短视频SDK分为专业版，标准版和基础版，三个版本使用的库名分别为专业版（AliyunVideoSDKPro.framework），标准版（AliyunVideoSDKPro.framework）和基础版（AliyunVideoSDKBasic.framework）。

  • 基础版只包含录制与裁剪模块。
  • 专业版和标准版包含全功能模块，标准版的高级接口需要单独授权才能调用。
说明 短视频SDK的功能更新，请参见发布说明。

pod方式集成（推荐）

操作步骤

  1. 在Podfile文件中添加依赖，各版本依赖如下表所示。
    注意 如果使用短视频SDK 3.24.0及以上版本，请务必使用FFmpeg 4.3.0及以上版本。
    版本 Podfile文件对应依赖
    专业版 
    pod 'AliyunVideoSDKPro', '~> 3.33.0'
    标准版 
    pod 'AliyunVideoSDKStd', '~> 3.33.0'
    基础版 
    pod 'AliyunVideoSDKBasic', '~> 3.33.0'
  2. 更新pod repo。
    pod repo update
  3. 安装pod。
    pod install
说明 请确保网络环境可以访问更新pod仓库，并在pod install安装完成后检查framework版本号是否和官网最新版一致。

手动方式集成（不推荐）

专业版、标准版本需要手动方式集成需要从Github下载最新的release包，下载相应版本的6个库和一个bundle资源包。
名称 类型 描述 下载地址
AliyunVideoSDKPro 动态库 短视频SDK 专业版/标准版
AliyunVideoSDKPro.bundle 资源包 短视频SDK 专业版（仅专业版需要资源包）
alivcffmpeg 动态库 ffmpeg库 Github下载地址
AlivcConan 动态库 工具库 Github下载地址
VODUpload 静态库 点播上传库 Github下载地址
AliyunOSSiOS 静态库 OSS上传库 Github下载地址
基础版本需要从Github下载最新的release包，下载相应版本的4个库。
名称 类型 描述 下载地址
AliyunVideoSDKBasic 动态库 短视频SDK 基础版
alivcffmpeg 动态库 ffmpeg库 Github下载地址
AlivcConan 动态库 工具库 Github下载地址

操作步骤

注意
  1. 动态库需要在TARGETS > General > Frameworks, Libraries, and Embedded Content中导入添加。
  2. 提交到App Store需要剥离模拟器版本（x86架构）的动态库，否则会被拒绝。剥离的方式有两种：
    • 使用命令行工具lipo剥离模拟器架构的framework。
    • 通过pod方式集成，pod会在打包时自动剥离掉模拟器架构的framework。
  1. 添加动态库。
    单击General，选择Frameworks, Libraries, and Embedded Content。单击＋，然后单击Add Other…，分别导入AliyunVideoAIO.framework， AlivcConan.framework和alivcffmpeg.framework依赖。导入之后请选择Embed &Sign。
  2. 添加静态库。
    单击General，选择Frameworks，Libraries和Embedded Content。单击＋，然后单击Add Other…，分别导入AliyunVideoSDKPro.framework， AliyunOSSiOS.framework和VODUpload.framework依赖。
  3. 添加其他库依赖。
    单击General，选择Frameworks, Libraries, and Embedded Content。单击＋，分别添加MobileCoreServices.framework，SystemConfiguration.framework和libresolv.tbd依赖。
  4. 专业版SDK需要将AliyunVideoSDKPro.bundle依赖导入到工程，基础版和标准版SDK可忽略此步骤。
    单击Build Phases，选择Copy Bundle Resources，单击＋，然后单击Add Other…，导入AliyunVideoSDKPro.bundle。
说明

手动方式集成较为繁琐，同时需要注意动态库提交App Store问题，推荐使用pod方式集成。

编译报错时，请修改Build Settings > Apple Clang - Language > Compile Sources As，修改为Objective-C++。

配置项目

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

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

配置License

获取到License后，需要按以下操作配置License文件。License的获取及详细信息请参见获取短视频SDK License。

把下载的License文件导入到App工程中，在Info.plist文件中添加两个key，第一个key为AlivcLicenseKey，value为LicenseKey的值；第二个key为AlivcLicenseFile，value为内置证书文件（相对于mainBundle）的路径。示例如下所示：
key value
AlivcLicenseKey LicenseKey的值。取值示例：MoCTfuQ391Z01mNqG8f8745e23c8a457a8ff8d5faedc1****
AlivcLicenseFile 内置证书文件（相对于mainBundle）的路径。

相关文档

API接口信息，请参见API参考。

后续步骤，请参见初始化SDK。