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
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.
SDK Flutter : SDK Flutter
Dernière version du SDK ApsaraVideo Player pour Flutter : SDK ApsaraVideo Player
Plugin du SDK ApsaraVideo Player pour Flutter (pour les mises à jour correctives) : Plugin du SDK ApsaraVideo Player pour 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
-
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" } -
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.
ImportantMettez à 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.
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
Ces étapes utilisent VS Code 1.65.2 à titre d'exemple. La procédure est similaire pour d'autres outils de développement.
Démarrez VS Code.
Choisissez View > Command Palette…
Saisissez flutter et choisissez Flutter: New Project.
Saisissez un nom de projet, tel que myapp, et appuyez sur Entrée.
-
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.
-
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. 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.