Integrate the short video SDK for iOS - ApsaraVideo VOD - Alibaba Cloud Documentation Center

This topic describes how to integrate the short video SDK for iOS using pods.

Prerequisites

The following table lists the requirements for the development environment.

Category	Description
System version	iOS 9.0 or later is supported.
macOS High Sierra version	macOS High Sierra 10.13 or later is supported.
Xcode version	Xcode 9.0 or later is supported. Download Xcode.

Background information

The short video SDK is available in Basic, Standard, and Professional editions. All three editions use the AliVCSDK_ShortVideo.framework library. You must activate the license for the edition that meets your business requirements.

The Basic Edition includes only the recording and crop features.
The Professional and Standard editions include all features. Calling the advanced APIs of the Standard Edition requires separate authorization.

Note

For information about feature updates of the short video SDK, see Release notes.

Integration instructions

If you want to use the short video SDK and the player SDK at the same time, integrate the all-in-one MediaBox SDK. This prevents dependency library conflicts that can occur when you integrate multiple SDKs separately. For more information about the integration, see iOS.
If you integrate the short video SDK and the player SDK separately, you must consider the version dependencies among the short video SDK, the player SDK, and AlivcFFmpeg. Otherwise, features of the short video SDK or the player SDK may not work as expected. For more information, see AlivcFFmpeg version dependencies.

Integrate the SDK using pods

Add dependencies to the Podfile. The dependencies for different versions are as follows:
Important
- If you use the short video SDK V3.24.0 or later, you must use FFmpeg V4.3.0 or later.
- Ensure that your network environment lets you access and update the pod repository. After you run the `pod install` command, verify that the framework version matches the latest version that is available on the official website.
- If you integrate the short video SDK with minimum dependencies, you must also integrate the upload SDK to upload media assets to ApsaraVideo VOD. For more information, see Upload SDK.
- Integration for V7.0.0 and later
```
pod 'AliVCSDK_ShortVideo', '~> 7.10.0'
```
- Integration for V6.21.0 and earlier
```
pod 'AliyunVideoSDKBasic', '~> 6.21.0' // Integrate the Basic Edition
pod 'AliyunVideoSDKStd', '~> 6.21.0'	// Integrate the Standard Edition
pod 'AliyunVideoSDKPro', '~> 6.21.0'	// Integrate the Professional Edition
```
Update the pod repository.
```
pod repo update
```
Install the pod.
```
pod install
```

Configure the project

After you integrate the SDK, open the project and configure the following settings:

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

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

Privacy - Camera Usage Description
Privacy - Microphone Usage Description
Privacy - Photo Library Usage Description

Configure the license

After you obtain a license, you must configure the license file. For more information about how to obtain a license, see Obtain a license for the short video SDK.

Import the downloaded license file into your app project. Add two keys to the Info.plist file. Set the AlivcLicenseKey key to your LicenseKey value. Set the AlivcLicenseFile key to the path of the built-in certificate file relative to the main bundle. The following table describes these keys:

Key	Value
AlivcLicenseKey	The value of LicenseKey. Example: MoCTfuQ391Z01mNqG8f8745e23c8a457a8ff8d5faedc1****
AlivcLicenseFile	The path of the built-in certificate file relative to the main bundle.

What to do next

Initialize the SDK

Player integration

If you want to integrate both the short video SDK for iOS and the player SDK into your project, you must use the all-in-one SDK for iOS. This prevents duplicate class issues that can cause compilation to fail.

ApsaraVideo VOD:Integrate the SDK