ApsaraVideo Live:Intégration du SDK

Environnement d'intégration

Téléchargement du package SDK

Intégration du Push SDK

Après avoir intégré manuellement le Push SDK ou via un pod, demandez les autorisations nécessaires et désactivez Bitcode.

Si vous optez pour une intégration manuelle du Push SDK, suivez les étapes d'intégration manuelle. Si vous choisissez d'utiliser un pod, suivez la procédure d'intégration par pod.

1. Intégration manuelle :

   1. Créez un projet de test SDK : App > DemoPush.

   2. Faites glisser les fichiers suivants dans votre projet Xcode :

      • AlivcLibReplayKitExt.framework

      • AlivcLivePusher.framework

      Pour utiliser les effets de retouche et les autocollants, faites également glisser les fichiers suivants :

      • queen.framework

      • openvc2.framework

      • MNN.framework

      • AliyunQueenUIKit.framework

      Pour dépendre d'une version du ApsaraVideo Player SDK, faites également glisser les fichiers suivants :

      • RtsSDK.framework

      • AliyunPlayer.framework

      • artcSource.framework

      • alivcffmpeg.framework

      Dans le projet Xcode, accédez à General > Frameworks, Libraries, and Embedded Content et configurez la méthode d'intégration pour chaque framework de dépendance comme suit :

      • Embed & Sign : alivcffmpeg.framework, AlivcLibReplayKitExt.framework, AlivcLibRtmp.framework, AlivcLivePusher.framework, AliyunPlayer.framework, artcSource.framework, opencv2.framework

      • Embed Without Signing : AlivcLiveBroadcast.appex

      • Do Not Embed : Accelerate.framework, CoreGraphics.framework, CoreImage.framework, CoreMedia.framework, CoreMotion.framework, CoreVideo.framework, Face3D.framework, FaceDetection.framework, Foundation.framework, Metal.framework, MNN.framework, OpenGLES.framework, pixelai.framework, QuartzCore.framework, queen.framework

   3. Sélectionnez Copy items if needed, puis cliquez sur Finish.

   4. Une fois le SDK importé, ajoutez les dépendances du SDK dans Xcode > General > Frameworks, Libraries, and Embedded Content. Dans Frameworks, Libraries, and Embedded Content, définissez la méthode d'intégration des frameworks tiers tels que alivcffmpeg.framework, AlivcLibRtmp.framework, AlivcLivePusher.framework, AliyunPlayer.framework, artcSource.framework, RtsSDK.framework et opencv2.framework sur Embed & Sign. Laissez les frameworks système (tels que Accelerate, CoreGraphics et CoreMedia) configurés sur Do Not Embed. Définissez AlivcLiveBroadcast.appex sur Embed Without Signing.

2. Intégration par pod :

   1. Dans une fenêtre de terminal, saisissez la commande suivante pour installer CocoaPods.

      Important

      Avant d'installer CocoaPods, assurez-vous qu'un environnement Ruby est installé sur votre Mac.

      sudo gem install cocoapods

   2. Accédez au chemin du projet et saisissez la commande suivante dans une fenêtre de terminal pour créer un fichier Podfile.

      pod init

   3. Modifiez le fichier Podfile pour ajouter la dépendance du Push SDK. Si vous avez besoin de la lecture en direct, vous pouvez également ajouter la dépendance du ApsaraVideo Player SDK.

      # Push SDK Basic Edition
      pod 'AlivcLivePusher', '~> x.y.z'

      Remarque

      • x.y.z représente le numéro de version du Push SDK. Remplacez cet espace réservé par le dernier numéro de version disponible sur la page Téléchargements du SDK, par exemple 7.4.0.

      • Le Push SDK ne peut pas être intégré avec le Player SDK (AliyunPlayer). Pour intégrer à la fois le Push SDK et le Player SDK, utilisez le All-in-One Media SDK. Pour plus d'informations, consultez les sections Scénarios et Intégration du All-in-One Media SDK.

   4. Saisissez la commande suivante dans une fenêtre de terminal. Une fois la commande pod exécutée, un fichier projet avec l'extension .xcworkspace est généré. Ce fichier contient le SDK intégré. Double-cliquez sur le fichier pour mettre à jour et installer le SDK.

      pod install

      ou

      pod update

3. Demandez les autorisations.

   Remarque

   Ajoutez les autorisations d'accès à la caméra et au microphone.

   Dans le fichier Info.plist, ajoutez les autorisations Privacy - Camera Usage Description et Privacy - Microphone Usage Description pour la caméra et le microphone. Si l'application doit continuer l'ingestion de flux en arrière-plan, activez le mode de capture audio en arrière-plan. Pour ce faire, dans l'onglet Capabilities du projet Xcode, définissez Background Modes sur ON, et sélectionnez Audio, AirPlay, and Picture in Picture dans la liste déroulante des modes.

4. Désactivez Bitcode.

   Le SDK ne prend pas en charge Bitcode. Désactivez l'option Bitcode dans le projet. Pour ce faire, dans Build Settings du projet Xcode, recherchez bitcode et définissez Enable Bitcode sous Build Options sur No.

5. Configurez la licence.

   Pour obtenir des instructions, consultez la section Intégration d'une licence.

Remarques d'utilisation

• Pour des informations détaillées sur l'API, consultez la Référence API de l'édition Basic.

• Pour consulter des exemples de code API, reportez-vous à la section Utilisation des fonctionnalités.

FAQ

Erreur de compilation

Si vous rencontrez l'erreur de compilation Building for iOS, but the linked and embedded framework XXX.framework' was built for iOS + iOS Simulator, effectuez les étapes suivantes :

1. Cliquez sur le menu Xcode.

2. Choisissez File > Workspace Settings pour ouvrir la boîte de dialogue des paramètres.

3. Remplacez Build System par Legacy Build System.

Bibliothèques de dépendances Queen manquantes lors de la compilation

Si des bibliothèques de dépendances Queen sont manquantes lors de l'intégration manuelle, consultez la documentation Queen_SDK_iOS pour ajouter les bibliothèques requises.