Intégrez le SDK Short Video pour iOS à l'aide de CocoaPods (pod).
Prérequis
Votre environnement de développement doit répondre aux exigences suivantes :
|**Élément**
|
**Description**
| | --- | --- | |
Version du système d'exploitation
|
iOS 9.0 ou version ultérieure.
| |
Version de macOS High Sierra
|
macOS High Sierra 10.13 ou version ultérieure.
| |
Version de Xcode
|
Xcode 9.0 ou version ultérieure. [Télécharger Xcode](https://apps.apple.com/cn/app/xcode/id497799835?mt=12).
|
Éditions du SDK
Le SDK Short Video est disponible en trois éditions — Professional, Standard et Basic — qui utilisent toutes la bibliothèque AliVCSDK_ShortVideo.framework. Obtenez une licence correspondant à l'édition adaptée à vos besoins.
L'édition Basic prend uniquement en charge l'enregistrement et le recadrage.
Les éditions Professional et Standard offrent des fonctionnalités complètes. L'édition Standard nécessite une autorisation distincte pour les opérations API avancées.
Consultez les notes de version pour connaître les mises à jour du SDK.
Intégration
Pour utiliser simultanément le SDK Short Video et le SDK Player, intégrez le SDK ApsaraVideo MediaBox pour iOS. Ce SDK tout-en-un évite les conflits de dépendances liés à des intégrations séparées.
Si vous intégrez séparément le SDK Short Video et le SDK Player, utilisez des versions compatibles des deux SDK ainsi que d'AlivcFFmpeg afin d'éviter tout dysfonctionnement des fonctionnalités. Consultez les dépendances de version d'AlivcFFmpeg.
Intégration via Pod
-
Ajoutez les dépendances au fichier Podfile en fonction de la version du SDK.
ImportantSi vous utilisez le SDK Short Video 3.24.0 ou une version ultérieure, vous devez utiliser FFmpeg 4.3.0 ou une version ultérieure.
Vérifiez l'accès réseau au dépôt pod. Après avoir exécuté pod install, confirmez que la version du framework correspond à la dernière version disponible sur le site officiel.
Pour télécharger des fichiers multimédias vers ApsaraVideo VOD avec une intégration minimale des dépendances, intégrez également le SDK Upload.
-
Pour la version V7.0.0 ou ultérieure
pod 'AliVCSDK_ShortVideo', '~> 7.11.0' -
Pour la version V6.21.0 ou antérieure
pod 'AliyunVideoSDKBasic', '~> 6.21.0' // Required for the Basic Edition pod 'AliyunVideoSDKStd', '~> 6.21.0' // Required for the Standard Edition pod 'AliyunVideoSDKPro', '~> 6.21.0' // Required for the Professional Edition
-
Mettez à jour le dépôt pod.
pod repo update -
Installez le pod.
pod install
Configuration du projet
Après l'intégration, configurez les paramètres suivants dans Xcode :
Dans Build Settings > Linking > Other Linker Flags, ajoutez l'indicateur -ObjC.
-
Dans le fichier Info.plist de votre projet, ajoutez les permissions suivantes :
Privacy - Camera Usage Description Privacy - Microphone Usage Description Privacy - Photo Library Usage Description
Configuration de la licence
Une fois la licence obtenue, configurez le fichier de licence. Consultez la rubrique Obtenir une licence pour le SDK Short Video.
Importez le fichier de licence dans le projet de votre application et ajoutez deux paires clé-valeur au fichier Info.plist. Définissez AlivcLicenseKey avec votre clé de licence et AlivcLicenseFile avec le chemin d'accès au fichier de licence relatif au bundle principal :
|**Clé**
|
**Valeur**
| | --- | --- | |
AlivcLicenseKey
|
Votre clé de licence. Exemple : MoCTfuQ391Z01mNqG8f8745e23c8a457a8ff8d5faedc1****
| |
AlivcLicenseFile
|
Le chemin d'accès au fichier de licence intégré, relatif au bundle principal.
|
Étapes suivantes
Intégration du lecteur
Pour utiliser simultanément le SDK Short Video et le SDK Player, utilisez le SDK ApsaraVideo MediaBox pour iOS afin d'éviter les échecs de compilation dus aux classes en double.