Tous les produits
Search
Centre de documentation

ApsaraVideo VOD:Intégrer le SDK

Dernière mise à jour :Aug 25, 2026

Découvrez les prérequis et les limites liés à l'intégration du SDK ApsaraVideo Player pour Flutter dans votre projet.

Prérequis environnementaux

Catégorie

Description

Version de Flutter

Compatible avec Flutter 3.22.2, canal stable.

Version de Dart

Compatible avec Dart 3.4.3.

Version du système d'exploitation

Compatible avec Android 6.0 et versions ultérieures.

Architecture du processeur

Architectures requises : armeabi-v7a et arm64-v8a.

Outils de développement

Nous vous recommandons d'utiliser Android Studio ou Visual Studio Code.

Téléchargements du SDK

Remarque

La version du SDK ApsaraVideo Player pour Flutter doit correspondre à celle de votre SDK Flutter. Par exemple, le SDK ApsaraVideo Player 5.4.0 nécessite le SDK Flutter 2.0 ou une version ultérieure. Pour plus de détails sur la compatibilité des versions, consultez Historique des versions du SDK Flutter.

Description du projet

Le SDK du lecteur Flutter encapsule les SDK natifs ApsaraVideo Player pour Android et iOS. La démo fournit le code source sous forme de dépendance à ajouter à votre projet.

Détails des dossiers :

Nom du fichier

Description

Requis

android

Code natif Android et SDK du lecteur.

Oui

ios

Code natif iOS et SDK du lecteur.

Oui

lib

Code API Flutter.

Oui

example

Démo du lecteur Flutter.

Non

Le SDK prend en charge la diffusion en direct et la lecture. Pour n'utiliser que la lecture, basculez le noyau du SDK de la version tout-en-un vers la version lecture seule. Les exemples suivants s'appuient sur le projet de démonstration.

Android

  1. Ajoutez le dépôt Maven Alibaba Cloud au fichier build.gradle racine du projet.

    maven { url "https://maven.aliyun.com/nexus/content/repositories/releases" }
  2. Remplacez le SDK ApsaraVideo for MediaBox (flux interactif) par le SDK ApsaraVideo Player.

    Définissez la variable useAIOFramework dans le fichier android/build.gradle de votre projet.

    Si useAIOFramework = false, le SDK lecture seule et la récupération de flux RTS pour Android sont utilisés. Si useAIOFramework = true, la version Android (flux interactif) est utilisée. Elle prend en charge l'ingestion de flux pour la diffusion en direct, y compris Real-Time Streaming (RTS) et la co-diffusion basée sur Alibaba Real-Time Communication (ARTC), ainsi que la lecture.

    Important

    Mettez à jour la version du SDK noyau si nécessaire. Dernières versions : SDK ApsaraVideo for MediaBox, SDK ApsaraVideo Player et Récupération de flux RTS.

    dependencies {
        // Define the SDK kernel.
        def useAIOFramework = false
    
        def aio_sdk_version = "x.x.x" // Latest version of ApsaraVideo for MediaBox SDK (interactive stream).
        def player_sdk_version = "x.x.x" // Latest version of ApsaraVideo Player SDK.
        def rts_sdk_version = "x.x.x" // Latest version of the RTS component.
    
        // Select the SDK based on the value of useAIOFramework.
        if (useAIOFramework) {
            // ApsaraVideo for MediaBox SDK (interactive stream): Supports stream ingest for live streaming (including RTS and RTC-based co-streaming) and playback.
            implementation "com.aliyun.aio:AliVCSDK_InteractiveLive:$aio_sdk_version"
        } else {
            // ApsaraVideo Player SDK.
            implementation "com.aliyun.sdk.android:AliyunPlayer:$player_sdk_version-full"
            // (Optional) RTS component SDK.
            implementation "com.aliyun.rts.android:RtsSDK:$rts_sdk_version"
            // (Optional) The AlivcArtc bridge layer between the player and RTS. The version number must be the same as the player SDK version. This layer must be integrated together with the RTS component.
            implementation "com.aliyun.sdk.android:AlivcArtc:$player_sdk_version" 
        }
    }

iOS

Définissez la variable useAIOFramework dans le fichier flutter_aliplayer.podspec de votre projet.

Si useAIOFramework = false, le SDK lecture seule et la récupération de flux RTS pour iOS sont utilisés.

Si useAIOFramework = true, la version iOS (flux interactif) est utilisée. Elle prend en charge l'ingestion de flux pour la diffusion en direct, y compris Real-Time Streaming (RTS) et la co-diffusion basée sur RTC, ainsi que la lecture.

Important

Mettez à jour la version du SDK noyau si nécessaire. Dernières versions : SDK ApsaraVideo for MediaBox, SDK ApsaraVideo Player et Récupération de flux RTS.

   # Define the SDK kernel.
  useAIOFramework = false

  # Define the SDK versions.
  aio_sdk_version = 'x.x.x'
  player_sdk_version = 'x.x.x'
  rts_sdk_version = 'x.x.x'

  # Select the SDK based on the value of useAIOFramework.
  if useAIOFramework
    s.subspec 'AliVCSDKFrameworks' do |ss|
    # ApsaraVideo for MediaBox SDK (interactive stream): Supports stream ingest for live streaming (including RTS and RTC-based co-streaming) and playback.
    ss.dependency 'AliVCSDK_InteractiveLive', aio_sdk_version
  end
  else
  s.subspec 'AliPlayerSDKFrameworks' do |ss|
    # Standalone ApsaraVideo Player SDK for iOS.
    ss.dependency 'AliPlayerSDK_iOS', player_sdk_version
    ss.dependency 'AliPlayerSDK_iOS_ARTC', player_sdk_version
    ss.dependency 'RtsSDK', rts_sdk_version
    end
  end

Limites

Le SDK ApsaraVideo Player pour Android ne prend pas en charge les émulateurs. Une fois l'intégration terminée, exécutez votre application sur un appareil physique.

Procédure d'intégration

Remarque

Ces étapes utilisent VS Code 1.65.2 à titre d'exemple. La procédure est similaire pour d'autres outils de développement.

  1. Démarrez VS Code.

  2. Choisissez View > Command Palette…

  3. Saisissez flutter et choisissez Flutter: New Project.

  4. Saisissez un nom de projet, tel que myapp, et appuyez sur Entrée.

  5. Après avoir spécifié l'emplacement du projet, cliquez sur le bouton bleu OK.

    Le projet est prêt lorsque le fichier main.dart apparaît.

  6. Intégrez le SDK ApsaraVideo Player pour Flutter.

    Pour intégrer rapidement le SDK ApsaraVideo Player pour Flutter, ajoutez la dépendance flutter_aliplayer au fichier pubspec.yaml de votre projet.

    dependencies:
      flutter_aliplayer: ^7.0.0
    # The version is the version number of the ApsaraVideo Player SDK for Flutter, for example, 7.0.0. Change the version number as needed.
  7. Facultatif : Si votre cas d'usage nécessite la prise en charge de RTS, ajoutez la dépendance requise. Pour plus d'informations, consultez ApsaraVideo Player pour Flutter.