Intégration rapide du SDK ApsaraVideo MediaBox pour iOS - Apsara Video SDK

Important

Si vous mettez à niveau le SDK depuis une version 6.6.0 ou antérieure vers la version 6.7.0 ou ultérieure, consultez les Mises à jour des effets de retouche intégrés du SDK ApsaraVideo MediaBox V6.7.0.

Prérequis

Élément

Description

macOS

macOS High Sierra 10.13 ou version ultérieure.

Xcode

Les étapes de cette rubrique utilisent Xcode. Téléchargez-le depuis Xcode.

Version iOS

iOS 9.0 ou version ultérieure.

Étape 1 : Intégrer le SDK

Intégration via pod (recommandée)

Dans le répertoire de votre projet, exécutez pod init pour créer un Podfile.

Ajoutez la dépendance du SDK au Podfile.

La version du SDK indiquée dans le code ci-dessous est fournie à titre d'exemple. Pour obtenir la dernière version, consultez les SDK par scénario.

# Integrate one of the following four SDKs based on your business scenario.

# 1. Standard all-in-one SDK: player + real-time streaming (RTS) + standard live streaming + short video + real-time communication (RTC) co-streaming + basic retouching
pod 'AliVCSDK_Standard', '7.11.0'
# 2. Basic live streaming SDK: player + live stream ingest + basic retouching + real-time streaming (RTS)
pod 'AliVCSDK_BasicLive', '7.11.0'   
# 3. Short video scenario SDK: player + short video + basic retouching
pod 'AliVCSDK_UGC', '7.11.0'  
# 4. Interactive live streaming SDK: player + real-time streaming (RTS) + live stream ingest + real-time communication (RTC) co-streaming + basic retouching
pod 'AliVCSDK_InteractiveLive', '7.11.0'

Exécutez la commande pod install pour installer le SDK.

Un fichier .xcworkspace est généré après l'exécution de la commande. Sa présence indique que l'intégration du SDK est terminée.

Intégration manuelle

Remarque

Avant de soumettre votre application à l'App Store, supprimez l'architecture x86 destinée aux simulateurs des frameworks dynamiques, sans quoi votre soumission sera rejetée. L'intégration via pod gère cette opération automatiquement.
En cas d'erreur de compilation, accédez à TARGETS > Build Settings > Apple Clang - Language dans votre projet Xcode et définissez Compile Sources As sur Objective-C++.

Téléchargez et décompressez le SDK par scénario requis pour iOS.
Ajoutez les dépendances du SDK.

Dans votre projet Xcode, accédez à TARGETS > General > Frameworks, Libraries, and Embedded Content. Ajoutez les dépendances AliVCSDK_***.framework, alivcffmpeg.framework et les autres dépendances requises issues du package SDK. Pour chaque dépendance importée, définissez l'option Embed sur Embed & Sign.
Ajoutez les autres dépendances de bibliothèque.

Dans votre projet Xcode, accédez à TARGETS > General > Frameworks, Libraries, and Embedded Content. Importez les dépendances MobileCoreServices.framework, SystemConfiguration.framework, CoreTelephony.framework, CoreMedia.framework, VideoToolbox.framework, AVFoundation.framework et libresolv.tbd.
Ajoutez le bundle de ressources (s'il est inclus dans le package SDK).

Ajoutez le bundle de ressources AliyunVideoSDKPro.bundle à votre projet.

Étape 2 : Configurer l'autorisation de licence

Lors de la première intégration du SDK, vous devez gérer la licence et configurer l'autorisation de licence.

Étape 3 : Configurer les permissions de l'application

Dans votre projet Xcode, accédez à TARGETS > Build Settings > Linking. Dans le champ Other Linker Flags, ajoutez l'option -ObjC.
Dans votre projet Xcode, accédez à TARGETS > Build Settings > Build Options et définissez Enable Bitcode sur NO.

Modifiez le fichier Info.plist pour configurer les permissions de l'application.

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

FAQ

Pour le dépannage, consultez les sections spécifiques aux fonctionnalités dans la FAQ.