Tous les produits
Search
Centre de documentation

ApsaraVideo Live:ApsaraVideo Player SDK for Flutter

Dernière mise à jour :Aug 08, 2026

Le SDK ApsaraVideo Player pour Flutter permet d'intégrer la diffusion en direct et la lecture de vidéos à la demande (VOD) dans les applications mobiles. Cette rubrique décrit la fonctionnalité de lecture de flux en direct.

Lecture standard de flux en direct

  1. Intégrez le SDK.

    Pour plus d'informations, consultez la page Intégration du SDK ApsaraVideo Player pour Flutter.

  2. Implémentez la lecture de flux en direct.

    1. Prise en main.

      Pour mettre en œuvre les fonctionnalités de base, consultez la page Prise en main.

    2. Définissez la source du flux en direct.

      Le SDK ApsaraVideo Player pour Flutter prend uniquement en charge la méthode UrlSource.

      UrlSource

      Pour lire un flux en direct, définissez la propriété setUrl avec une URL de streaming. L'URL peut provenir d'un tiers ou être générée par ApsaraVideo Live.

      Générez des URLs de streaming depuis la console ApsaraVideo Live à l'aide du Générateur d'URL.

      void onViewPlayerCreated(viewId) async {
        // Set the rendering view for the player.
        fAliplayer.setPlayerView(viewId);
        // Set the playback source.
        switch (_playMode) {
          // UrlSource playback method.
          case ModeType.URL:
            this.fAliplayer.setUrl("Enter the streaming URL"); // It can be a third-party streaming URL or a streaming URL from ApsaraVideo Live.
            break;
          default:
        }
      }

Lecture RTS

Remarque
  • Intégrez le SDK natif pour Android ou iOS.

    Pour Android, ajoutez les dépendances suivantes au fichier build.gradle.

    dependencies{
        def player_sdk_version = "7.2.0"
        def rts_sdk_version = "7.2.0"
        
        // The bridge layer between the player and RTS (AlivcArtc). The version number must match the player's version number. This must be integrated with the RTS component.
        implementation 'com.aliyun.sdk.android:AlivcArtc:$player_sdk_version'
        // The RTS component. It has an independent version number.
        implementation 'com.aliyun.rts.android:RtsSDK:$rts_sdk_version'
    }

    Pour iOS, ajoutez les dépendances suivantes au Podfile.

    # player_sdk_version is the version number of the ApsaraVideo Player SDK for iOS, for example, 7.2.0.
    player_sdk_version = '7.2.0'
    # rts_sdk_version is the version number of the RTS SDK, which is independent, for example, 7.2.0.
    rts_sdk_version = '7.2.0'
    
    target 'Runner' do
      flutter_install_all_ios_pods File.dirname(File.realpath(__FILE__))
      # The bridge layer between the player and RTS (AlivcArtc). The version number must match the player's version number. This must be integrated with the RTS component.
      pod 'AliPlayerSDK_iOS_ARTC', player_sdk_version 
      # The RTS component.
      pod 'RtsSDK', rts_sdk_version  
    
    end

Pour lire un flux ApsaraVideo Real-Time Communication (ARTC), importez les dépendances RTS lors de l'intégration. Sur Android, appelez également FlutterAliPlayerFactory.loadRtsLibrary(); pour charger la bibliothèque dynamique du SDK RTS avant de créer le lecteur.

  1. Configurez le fichier pubspec.yaml.

    name: your_project
    description: A new Flutter project.
    version:  1.0.0+1
    
    # The following line prevents the package from being accidentally published to
    # pub.dev using `pub publish`. This is preferred for private packages.
    publish_to: 'none' # Remove this line if you want to publish to pub.dev
    
    environment:
      sdk: ">=2.15.0 <4.0.0"
    
    dependencies:
      flutter:
        sdk: flutter
    
      // Add flutter_aliplayer.
      flutter_aliplayer: "7.3.1"
    
    dev_dependencies:
      flutter_test:
        sdk: flutter
    
    # For information on the generic Dart part of this file, see the
    # following page: https://dart.dev/tools/pub/pubspec
    
    # The following section is specific to Flutter.
    flutter:
    
      # The following line ensures that the Material Icons font is
      # included with your application, so that you can use the icons in
      # the material Icons class.
      uses-material-design: true
  2. Chargez le SDK RTS.

    Remarque
    1. Si vous utilisez ApsaraVideo Player pour Android V7.3.1 ou une version antérieure, vous devez charger manuellement le SDK RTS.

    2. Si useAIOFramework=true, le SDK tout-en-un ApsaraVideo MediaBox est utilisé. Sinon, le SDK ApsaraVideo Player et le SDK RTS sont utilisés. La valeur par défaut est false.

    3. Utilisez les dernières versions du SDK :

      1. Pour le SDK ApsaraVideo MediaBox, consultez les pages Intégration du SDK ApsaraVideo MediaBox pour Android et Intégration du SDK ApsaraVideo MediaBox pour iOS.

      2. Pour le SDK ApsaraVideo Player, consultez la page Téléchargement du SDK ApsaraVideo Player.

      3. Pour le composant RTS, consultez les pages Implémentation de la récupération de flux RTS sur Android et Implémentation de la récupération de flux basée sur RTS sur iOS.

    dependencies {
        // Define the SDK kernel.
        def useAIOFramework = false
    
        // Define the SDK versions.
        // ApsaraVideo MediaBox SDK.
        def aio_sdk_version = "7.1.0"
        // ApsaraVideo Player SDK.
        def player_sdk_version = "7.2.0"
        // RTS component.
        def rts_sdk_version = "7.2.0"
    
        // Select the SDK based on the value of useAIOFramework.
        if (useAIOFramework) {
            // ApsaraVideo MediaBox SDK (interactive version): Push SDK (including RTS and ARTC co-streaming) + ApsaraVideo Player SDK.
            implementation "com.aliyun.aio:AliVCSDK_InteractiveLive:$aio_sdk_version"
        } else {
            // ApsaraVideo Player SDK.
            implementation "com.aliyun.sdk.android:AliyunPlayer:$player_sdk_version-full"
            implementation "com.aliyun.sdk.android:AlivcArtc:$player_sdk_version"
            implementation "com.aliyun.rts.android:RtsSDK:$rts_sdk_version"
        }
    
        implementation 'com.google.code.gson:gson:2.10.1'
    }
    

    Chargez manuellement le SDK RTS.

    FlutterAliPlayerFactory.loadRtsLibrary(true);
  3. Lancez la lecture de la vidéo.

    FlutterAliplayer player = FlutterAliPlayerFactory.createAliPlayer();
    player.setUrl("artc://xxxx");
    
    player.prepare();
    player.play();