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

前提条件

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

接口文档

中文版接口文档,更多信息,请参见接口文档

英文版接口文档,更多信息,请参见API Reference

SDK版本

短视频SDK分为专业版,标准版和基础版,三个版本使用相同的库名(AliyunVideoSDKPro.framework)。

  • 基础版只包含录制与裁剪模块。
  • 专业版和标准版包含全功能模块,标准版的高级接口需要单独授权才能调用。

pod方式集成(推荐)

操作步骤

  1. 在Podfile文件中添加依赖,各版本依赖如下表所示。
    版本 Podfile文件对应依赖
    专业版
    pod 'AliyunVideoSDKPro', '3.20.0'
    pod 'QuCore-ThirdParty', '3.15.0'
    pod 'AlivcConan', '1.0.3'
    pod 'VODUpload'
    pod 'AliyunOSSiOS'
    标准版
    pod 'AliyunVideoSDKStd', '3.20.0'
    pod 'QuCore-ThirdParty', '3.15.0'
    pod 'AlivcConan', '1.0.3'
    pod 'VODUpload'
    pod 'AliyunOSSiOS'
    基础版
    pod 'AliyunVideoSDKBasic', '3.20.0'
    pod 'QuCore-ThirdParty', '3.15.0'
    pod 'AlivcConan', '1.0.3'
    pod 'VODUpload'
    pod 'AliyunOSSiOS'
  2. 更新pod repo。
    pod repo update
  3. 安装pod。
    pod install
说明 请确保网络环境可以访问更新pod仓库,并在pod install安装完成后检查framework版本号是否和官网最新版一致。

手动方式集成(不推荐)

手动方式集成需要从Github下载最新的release包,下载相应版本的6个库和一个bundle资源包。

名称 类型 描述 下载地址
AliyunVideoSDKPro 静态库 短视频SDK 专业版标准版基础版
AliyunVideoCore 动态库 短视频SDK 专业版标准版基础版
AliyunVideoSDKPro.bundle 资源包 短视频SDK 专业版(仅专业版需要资源包)
alivcffmpeg 动态库 ffmepg库 Github下载地址
AlivcConan 动态库 工具库 Github下载地址
VODUpload 静态库 点播上传库 Github下载地址
AliyunOSSiOS 静态库 OSS上传库 Github下载地址
其中AliyunVideoCore,alivcffmpeg,AlivcConan是动态库。关于动态库的手动集成和发布,需要注意以下问题:
  1. 动态库需要在TARGETS > General > Embedded Binaries中导入添加。
  2. 提交到App Store需要剥离模拟器版本(x86架构)的动态库,否则会被拒绝。剥离的方式有两种:
    • 使用命令行工具lipo剥离模拟器架构的framework。
    • 通过pod方式集成,pod会在打包时自动剥离掉模拟器架构的framework。

操作步骤

  1. 添加动态库。
    单击General,选择FrameworksLibrariesEmbedded Content。单击,然后单击Add Other…,分别导入AliyunVideoCore.framework, AlivcConan.framework和alivcffmpeg.framework依赖。导入之后请选择Embed &Sign。
  2. 添加静态库。
    单击General,选择FrameworksLibrariesEmbedded Content。单击,然后单击Add Other…,分别导入AliyunVideoSDKPro.framework, AliyunOSSiOS.framework和VODUpload.framework依赖。
  3. 添加其他库依赖。
    单击General,选择FrameworksLibrariesEmbedded Content。单击,分别添加MobileCoreServices.framework,SystemConfiguration.framework和libresolv.tbd依赖。
  4. 专业版SDK(其他版本可忽略)。
    将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