本文为您介绍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),标准版(AliyunVideoSDKPro.framework)和基础版(AliyunVideoSDKBasic.framework)。

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

pod方式集成(推荐)

操作步骤

  1. 在Podfile文件中添加依赖,各版本依赖如下表所示
    注意 如果使用短视频SDK 3.24.0及以上版本,请务必使用FFempg 4.3.0及以上版本。
    版本 Podfile文件对应依赖
    专业版
    pod 'AliyunVideoSDKPro', '~> 3.24.0'
    pod 'QuCore-ThirdParty', '4.3.0'#必须依赖,且版本需要在4.3.0及以上
    pod 'AlivcConan', '1.0.3'
    pod 'VODUpload'
    pod 'AliyunOSSiOS'
    标准版
    pod 'AliyunVideoSDKStd', '~> 3.24.0'
    pod 'QuCore-ThirdParty', '4.3.0'#必须依赖,且版本需要在4.3.0及以上
    pod 'AlivcConan', '1.0.3'
    pod 'VODUpload'
    pod 'AliyunOSSiOS'
    基础版
    pod 'AliyunVideoSDKBasic', '~> 3.24.0'
    pod 'QuCore-ThirdParty', '4.3.0'#必须依赖,且版本需要在4.3.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下载地址
基础版本基础需要从Github下载最新的release包,下载相应版本的4个库。
名称 类型 描述 下载地址
AliyunVideoSDKBasic 静态库 短视频SDK 基础版
AliyunVideoCore 动态库 短视频SDK 基础版
alivcffmpeg 动态库 ffmepg库 Github下载地址
AlivcConan 动态库 工具库 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