All Products
Search
Document Center

Project configuration

Last Updated: Aug 19, 2019

The short video SDK supports iOS 8.0 and later versions.

Development environment

We recommend that you use macOS High Sierra 10.13 and Xcode 9.0 or their later versions.

API reference

For more information in Chinese, see API Reference.

For more information, see API Reference.

SDK edition

The short video SDK has three editions: basic edition, standard edition, and professional edition. The three editions use the same framework name AliyunVideoSDKPro.framework.

  • The basic edition supports only the recording and cropping features.
  • The standard edition and professional edition supports all features. However, authorization is required to use advanced features in the standard edition.

SDK integration

The following table lists the frameworks on which the short video SDK depends.

Name Type Description
AliyunVideoSDKPro Dynamic framework The dynamic framework of the short video SDK, which depends on alivcffmpeg, AlivcConan, and VODUpload.
alivcffmpeg Dynamic framework The FFmpeg framework.
AlivcConan Dynamic framework The tool framework.
VODUpload Static framework The upload framework of Apsaravideo for VOD, which depends on AliyunOSSiOS.
AliyunOSSiOS Static framework The OSS upload framework.

In the preceding frameworks, AliyunVideoSDKPro, alivcffmpeg, and AlivcConan are dynamic frameworks. When integrating and releasing dynamic frameworks, pay attention to the following:

  • Select the target and choose General > Embedded Binaries to add dynamic frameworks.
  • To submit an application to App Store, you need to strip the simulator architectures from dynamic frameworks. Otherwise, your application will be rejected. You can strip the simulator architectures from dynamic frameworks in any of the following ways:
  • The downloaded SDK package contains two folders: Debug and Release. The Debug folder contains frameworks for both simulators and devices, and the Release folder contains frameworks only for devices. Use the frameworks in the Debug folder to debug your application in simulators. When submitting the application to App Store, replace the frameworks with those in the Release folder.
  • Integrate frameworks in pod mode. Then, the simulator architectures are automatically stripped from dynamic frameworks when you submit your application.
  • Add a custom script in Xcode to use the Lipo command to strip the simulator architectures from dynamic frameworks.

Manually integrate the SDK

  1. Open the project and select the target. Choose General > Embedded Binaries, click the plus sign (+) and then Add Other, and import AliyunVideoSDKPro.framework, AlivcConan.framework, and alivcffmpeg.framework.

  2. Open the project and select the target. Choose General > Linked Frameworks And Libraries, click the plus sign (+) and then Add Other, and import AliyunOSSiOS.framework and VODUpload.framework.

  3. Open the project and select the target. Choose General > Linked Frameworks And Libraries, click the plus sign (+), and import libz.tbd, ImageIO.framework, CoreMedia.framework, CoreVideo.framework, VideoToolBox.framework, MediaPlayer.framework, OpenAL.framework, libc++.tbd, libsqlite3.tbd, and libiconv.tbd.

Integrate the SDK in pod mode

  1. Add dependencies to the Podfile file.
  • Professional edition:
  1. pod 'AliyunVideoSDKPro'
  2. pod 'QuCore-ThirdParty'
  3. pod 'VODUpload'
  4. pod 'AliyunOSSiOS'
  5. pod 'AlivcConan'
  • Standard edition:
  1. pod 'AliyunVideoSDKStd'
  2. pod 'QuCore-ThirdParty'
  3. pod 'VODUpload'
  4. pod 'AliyunOSSiOS'
  5. pod 'AlivcConan'
  • Basic edition:
  1. pod 'AliyunVideoSDKBasic'
  2. pod 'QuCore-ThirdParty'
  3. pod 'VODUpload'
  4. pod 'AliyunOSSiOS'
  5. pod 'AlivcConan'
  1. Update the pod repository.
  1. pod repo update
  1. Install the pods.
  1. pod install

Make sure that you can access and update the pod repository over the network. After installing the pods, check whether the framework versions are the latest, as listed on the Alibaba Cloud website.

Project configuration

After the SDK is integrated, open the project and modify the configuration as follows:

  1. Choose Build Setting > Linking > Other Linker Flags and add -ObjC.

  2. Choose Build Setting > Build Options and set Enable Bitcode to No.

  3. Open the info.Plist file of the project and add the following permissions:

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