全部产品
云市场

工程配置

更新时间:2019-07-31 16:30:06

系统版本

支持iOS8.0及以上版本

开发环境

建议您使用macOS High Sierra 10.13 Xcode9.0及以上版本的开发环境。

接口文档

中文版请访问:接口文档

英文版请访问:API Reference

SDK版本

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

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

SDK集成

短视频SDK依赖四个Framework如下:

名称 类型 描述
AliyunVideoSDKPro 动态库 短视频SDK,依赖alivcffmpeg,AlivcConan,VODUpload
alivcffmpeg 动态库 ffmepg库
AlivcConan 动态库 工具库
VODUpload 静态库 点播上传库,依赖AliyunOSSiOS
AliyunOSSiOS 静态库 OSS上传库

其中,AliyunVideoSDKPro,alivcffmpeg,AlivcConan是动态库。关于动态库的集成和发布,如果采用手动导入而非pod方式,需要注意以下问题:

  1. 动态库需要在TARGETS -> General -> Embedded Binaries中导入添加。

  2. 提交到App Store需要剥离模拟器版本(x86架构)的动态库,否则会被拒绝。剥离的方式有三种:

    • SDK压缩包包含Debug和Release两个文件夹,Debug文件夹下的framework包含模拟器版本(x86架构)和真机版本(ARM架构),Release文件夹下的framework只包含了真机版本。包含模拟器版本的Debug文件夹下的framework包含模拟器版本支持模拟器调试下编译运行不报错,但是提交App Store时需要用Debug文件夹下的framework替换Release文件夹下的framework。
    • 在Xcode中添加自定义脚本,使用lipo命令剥离模拟器架构的framework。
    • 通过pod方式集成,pod方式集成无需关心动态库还是静态库,pod会在打包时自动剥离掉模拟器架构的framework。

pod方式集成

  1. 在Podfile文件中添加依赖

    • 专业版:
      1. pod 'AliyunVideoSDKPro'
      2. pod 'QuCore-ThirdParty'
      3. pod 'VODUpload'
      4. pod 'AliyunOSSiOS'
      5. pod 'AlivcConan'
    • 标准版:

      1. pod 'AliyunVideoSDKStd'
      2. pod 'QuCore-ThirdParty'
      3. pod 'VODUpload'
      4. pod 'AliyunOSSiOS'
      5. pod 'AlivcConan'
    • 基础版:

      1. pod 'AliyunVideoSDKBasic'
      2. pod 'QuCore-ThirdParty'
      3. pod 'VODUpload'
      4. pod 'AliyunOSSiOS'
      5. pod 'AlivcConan'
  2. 更新pod repo

    1. pod repo update
  3. 安装pod

    1. pod install

请确保网络环境可以访问更新pod仓库,并在pod install安装完成后检查framework版本号是否和官网最新版一致。

手动方式集成

  1. 打开工程,选择目标target,选择”General”->”Embededed Binaries”,单击”+”号,单击“Add Other…”,导入AliyunVideoSDKPro.framework, AlivcConan.framework和alivcffmpeg.framework。

  2. 打开工程,选择目标target,选择”General”->”Linked Frameworks And Libraries”,单击”+”号,单击“Add Other…”,导入AliyunOSSiOS.framework和VODUpload.framework。

  3. 打开工程,选择目标target,选择”General”->”Linked Frameworks And Libraries”,单击”+”号,依赖libz.tbd、ImageIO.framework、CoreMedia.framework、CoreVideo.framework,VideoToolBox.framework、MediaPlayer.framework、OpenAL.framework,libc++.tbd,libsqlite3.tbd,libiconv.tbd,libresolv.tbd。

项目配置

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

  1. 配置Build Setting — Linking — Other Linker Flags,添加-ObjC

  2. 配置Build Setting — Build Options — Enable Bitcde,设为NO

  3. 打开工程info.Plist,添加以下权限:

    1. Privacy - Camera Usage Description
    2. Privacy - Microphone Usage Description
    3. Privacy - Photo Library Usage Description