Tous les produits
Search

Ce produit

    ApsaraVideo VOD:Intégrer le SDK

    Centre de documentation

    ApsaraVideo VOD:Intégrer le SDK

    Dernière mise à jour :Aug 13, 2026

    Intégrez rapidement ApsaraVideo Player SDK for iOS à votre projet.

    Prérequis système

    • Système d'exploitation : iOS 8.0 ou version ultérieure.

    • Outil de développement : Xcode est recommandé. Cette rubrique s'appuie sur Xcode. Téléchargez-le ici : ‎Xcode.

    • ApsaraVideo Player SDK for iOS ne prend pas en charge les simulateurs. Exécutez vos applications sur un appareil physique.

    Conditions préalables

    • Vous avez obtenu un fichier de licence pour l'autorisation du lecteur, tel que AliVideoCert-********.crt. Pour plus d'informations, consultez Obtenir une licence.

    • Pour une intégration manuelle, téléchargez la dernière version du package ApsaraVideo Player SDK for iOS. Reportez-vous à la section téléchargement.

    Remarques d'utilisation

    • Lors de la création du package de votre application, le fichier dSYM sert à symboliser les rapports de plantage.

    • ApsaraVideo Player SDK for iOS nécessite les frameworks AlivcFFmpeg et AliyunPlayer. Les fichiers d'en-tête du lecteur se trouvent dans AliyunPlayer.

    • Si vous intégrez à la fois le SDK du lecteur et le SDK vidéo courte, assurez-vous de la compatibilité des versions entre le SDK vidéo courte, le SDK du lecteur et AlivcFFmpeg. Des versions incompatibles peuvent entraîner des dysfonctionnements. Pour plus d'informations, consultez Dépendances AlivcFFmpeg.

    • Le package ApsaraVideo Player SDK for iOS inclut des architectures pour simulateur. Supprimez-les avant de soumettre votre application sur l'App Store afin d'éviter tout rejet.

    Étape 1 : Intégrer le SDK

    Intégration via CocoaPods

    1. Installez CocoaPods. Cette opération requiert un environnement Ruby.

      // In Terminal, run the following command:
sudo gem install cocoapods

    2. Vérifiez l'installation de CocoaPods.

      Exécutez la commande pod --version dans votre terminal pour confirmer l'installation.

      xxx@ ~ % pod --version
1.16.2

    3. Créez un Podfile.

      Dans votre terminal, accédez au répertoire de votre projet et exécutez pod init pour générer un Podfile.

      // Go to your project directory.
xxx@ ~ %  cd /path/yourProject
// Generate the Podfile.
xxx@ yourProject % pod init

    4. Modifiez le Podfile pour ajouter la dépendance au SDK du lecteur.

      Remarque

      • Pour intégrer simultanément le SDK du lecteur et le SDK vidéo courte, remplacez AliPlayerSDK_iOS dans le code ci-dessous par AliPlayerPartSDK_iOS. AliPlayerPartSDK_iOS n'inclut pas FFmpeg, ce qui évite les conflits avec la bibliothèque FFmpeg du SDK vidéo courte.

      • Saisissez le numéro de version correct du SDK du lecteur. Sinon, l'importation échoue et génère une erreur. Pour connaître les versions disponibles, consultez Notes de version d'ApsaraVideo Player SDK for iOS.

      source 'https://github.com/CocoaPods/Specs.git'
platform:ios, '8.0'

target 'yourProject' do
    # Player SDK. We recommend that you use the latest version.
    pod 'AliPlayerSDK_iOS'
end

    5. (Facultatif) Ajoutez une dépendance vers une version spécifique du SDK du lecteur.

      source 'https://github.com/CocoaPods/Specs.git'
platform:ios, '8.0'

player_sdk_version = '7.17.0'

target 'yourProject' do
    # Player SDK. We recommend that you use the latest version.
    pod 'AliPlayerSDK_iOS' , player_sdk_version
end

    6. Installez les dépendances.

      Exécutez la commande suivante pour installer les dépendances.

      pod install

      La sortie suivante indique que l'installation a réussi.

      xxx@ yourProject % pod install
Analyzing dependencies
Downloading dependencies
Installing AliPlayerSDK_iOS (7.17.0)
Generating Pods project
Integrating client project
Pod installation complete! There is 1 dependency from the Podfile and 1 total pod installed.

      Exécutez la commande suivante pour mettre à jour le SDK du lecteur.

      pod update AliPlayerSDK_iOS

    Intégration manuelle

    Remarque

    Si vous intégrez à la fois le SDK du lecteur et le SDK vidéo courte, importez un seul framework AlivcFFmpeg et assurez-vous d'utiliser la version appropriée.

    1. Téléchargez ApsaraVideo Player SDK for iOS.

    2. Ajoutez les frameworks du lecteur dans Frameworks, Libraries, and Embedded Content, puis définissez Embed sur Embed & Sign.

      • alivcffmpeg.framework : framework sous-jacent du lecteur.

      • AliyunMediaDownloader.framework : utilisé pour le téléchargement hors ligne.

      • AliyunPlayer.framework : framework du lecteur.

        本地集成

    3. Cliquez sur l'onglet Build Settings.

    4. Dans la section Search Paths, définissez Framework Search Paths sur votre répertoire local de frameworks.

    (Facultatif) Intégration RTS (CocoaPods)

    Pour intégrer le composant Real-Time Streaming (RTS), consultez Mettre en œuvre la récupération de flux basée sur RTS sur iOS.

    Étape 2 : Configurer la licence

    Important

    Si vous utilisez le lecteur dans des régions situées en dehors de la Chine continentale, de Hong Kong et de Macao (site international), appelez l'API suivante pour définir l'environnement avant d'invoquer toute autre API du lecteur.

    1. Méthode 1 : Appelez l'API suivante pour basculer la configuration par défaut vers l'environnement du site international.

      // For the international site, you must call this API before any other player APIs
// to set the environment. This setting cannot be changed at runtime.
AlivcBase.EnvironmentManager.globalEnvironment = ENV_SEA;

    2. Méthode 2 (Recommandée) : Pour les versions 7.6.0 et ultérieures du SDK du lecteur, configurez l'environnement du site international directement dans le fichier Info.plist.

      Ouvrez le fichier Info.plist et remplacez la valeur de AlivcEnv par SEA.

      // Configure the current environment as the international site.
<key>AlivcEnv</key>
<string>SEA</string>

      La figure suivante illustre un exemple de configuration : 1754557498401-1d235342-3c0b-4c83-bcee-ae7656e8ff23

    Pour configurer la licence sur votre client iOS, consultez Configurer une licence sur iOS.

    Étape 3 : Activer la journalisation (Facultatif)

    Activez la journalisation pour faciliter le dépannage. Pour savoir comment récupérer les journaux, consultez Obtenir les journaux du SDK.

    // Enable logging.
[AliPlayer setEnableLog:YES];
// Set the log level. The default is LOG_LEVEL_INFO. For troubleshooting, set it to LOG_LEVEL_TRACE.
[AliPlayer setLogCallbackInfo:LOG_LEVEL_INFO callbackBlock:nil];

    Structure du projet

    Framework

    Description

    alivcffmpeg.framework

    Framework sous-jacent du lecteur. Obligatoire.

    AliyunMediaDownloader.framework

    Destiné au téléchargement hors ligne. Facultatif.

    AliyunPlayer.framework

    Framework du lecteur. Obligatoire.

    artcSource.framework

    Assure la prise en charge du protocole ARTC. Facultatif.

    Remarque

    Pour prendre en charge le protocole ARTC, ajoutez également RtsSDK.framework. Pour plus de détails sur l'intégration, consultez Mettre en œuvre la récupération de flux basée sur RTS sur iOS.

    aemFilter.framework

    Permet l'amélioration audio. Facultatif.

    libPluginSR.framework

    Active la super-résolution. Facultatif.

    normalsrFilter.framework

    Active la super-résolution. Facultatif.

    srFilter.framework

    Active la super-résolution. Facultatif.

    vfiFilter.framework

    Permet l'insertion de trames vidéo. Facultatif.

    vvcCodecPlugin.framework

    Plugin de décodage H.266. Facultatif.

    FAQ

    Utilisation de CocoaPods

    // Deintegrate your project from CocoaPods dependencies.
pod deintegrate 

// Update the index of your local CocoaPods source repositories.
// Use case:
// - When you add a new dependency, this ensures you can fetch the latest available version.
// - When a specific library version is unavailable or you know a new version exists but does not appear in your project, use this command to update.
pod repo update

// Update the project's Pods.
// Use case:
// - Use this when you want to update all pods in your project to the latest supported versions allowed by your Podfile.
pod update

// Performs the same function as 'pod install' but forces an update of the local CocoaPods repository index before installing.
// Use case:
// - This is a good command to use when you add new libraries or want to use the latest version of a library specified in your Podfile, especially if you see an error message indicating that a required library version is unavailable.
pod install --repo-update

// Clear the Pods cache.
// Note:
// 1. Clearing the cache does not modify your Podfile.lock or Podfile. When you run 'pod install' or 'pod update', CocoaPods re-downloads the required libraries based on your manifest and lockfile.
// 2. Clearing the cache is not a regular step and should only be used to resolve specific issues. Normally, CocoaPods manages its cache well.
pod cache clean --all

    Conflits de symboles avec AlivcFFmpeg

    Solution :

    • En cas de conflit de symboles avec AlivcFFmpeg, supprimez la dépendance redondante. Conservez la version fournie avec ApsaraVideo Player SDK for iOS et retirez la version tierce. Cela peut toutefois affecter les fonctionnalités du lecteur tiers.

    Erreur de sandbox

    • Problème :

      截屏2024-12-06 16

    • Solution :

      Dans UserSetting, définissez User Script SandBoxing sur NO.

      1735888658101-5633103e-468d-4341-adaa-f5f52814aa36

    Intégration du SDK vidéo courte

    Pour intégrer conjointement ApsaraVideo Player SDK for iOS et le SDK vidéo courte, utilisez le SDK tout-en-un pour iOS afin d'éviter les problèmes de classes dupliquées et les échecs de compilation.

    Pour découvrir d'autres problèmes liés au lecteur et leurs solutions, consultez FAQ sur ApsaraVideo Player.

    Références

    Fonctionnalités de base

    Fonctionnalités avancées