Flutter 向け ApsaraVideo Player SDK をプロジェクトに統合するための要件と制限事項について説明します。
環境要件
カテゴリ | 説明 |
Flutter バージョン | Flutter 3.22.2 (stable チャネル) をサポートします。 |
Dart バージョン | Dart 3.4.3 をサポートします。 |
OS バージョン | Android 6.0 以降をサポートします。 |
CPU アーキテクチャ | 必須のアーキテクチャ:armeabi-v7a および arm64-v8a。 |
開発ツール | Android Studio または Visual Studio Code の使用を推奨します。 |
SDK のダウンロード
Flutter 向け ApsaraVideo Player SDK は、Flutter SDK のバージョンと一致させる必要があります。たとえば、ApsaraVideo Player SDK 5.4.0 には Flutter SDK 2.0 以降が必要です。バージョン互換性の詳細については、「Flutter SDK release history」をご参照ください。
Flutter SDK: Flutter SDK
最新の Flutter 向け ApsaraVideo Player SDK: ApsaraVideo Player SDK
Flutter 向け ApsaraVideo Player SDK プラグイン (パッチ更新用): ApsaraVideo Player SDK for Flutter plugin
プロジェクトの説明
Flutter 向けプレーヤー SDK は、Android および iOS 向けのネイティブ ApsaraVideo Player SDK をラップします。デモでは、ソースコードが依存関係として提供されており、プロジェクトに追加できます。
フォルダーの詳細:
ファイル名 | 説明 | 必須 |
android | Android ネイティブコードとプレーヤー SDK。 | はい |
ios | iOS ネイティブコードとプレーヤー SDK。 | はい |
lib | Flutter API コード。 | はい |
example | Flutter プレーヤー デモ。 | いいえ |
SDK はライブストリーミングと再生の両方をサポートします。再生のみを使用する場合は、SDK カーネルをオールインワンバージョンから再生専用バージョンに切り替えます。以降の例ではデモプロジェクトを使用します。
Android
プロジェクトレベルの build.gradle ファイルに Alibaba Cloud Maven リポジトリを追加します。
maven { url "https://maven.aliyun.com/nexus/content/repositories/releases" }ApsaraVideo for MediaBox SDK (インタラクティブストリーム) を ApsaraVideo Player SDK に置き換えます。
プロジェクトの android/build.gradle ファイルで useAIOFramework 変数を設定します。
If useAIOFramework = false, the playback-only SDK and Android 用 RTS ストリームプルが使用されます。If useAIOFramework = true, the Android version (interactive stream) is used, which supports stream ingest for live streaming, including Real-Time Streaming (RTS) and Alibaba Real-Time Communication (ARTC)-based co-streaming, and playback.
重要必要に応じてカーネル SDK のバージョンを更新してください。最新バージョン:ApsaraVideo for MediaBox SDK、ApsaraVideo Player SDK、およびRTS Stream Pulling。
dependencies { // SDK カーネルを定義します。 def useAIOFramework = false def aio_sdk_version = "x.x.x" // ApsaraVideo for MediaBox SDK (インタラクティブストリーム) の最新バージョン。 def player_sdk_version = "x.x.x" // ApsaraVideo Player SDK の最新バージョン。 def rts_sdk_version = "x.x.x" // RTS コンポーネントの最新バージョン。 // useAIOFramework の値に基づいて SDK を選択します。 if (useAIOFramework) { // ApsaraVideo for MediaBox SDK (インタラクティブストリーム):RTS および RTC ベースの共同ストリーミングを含むライブストリーミング向けのストリームインジェスト、および再生をサポートします。 implementation "com.aliyun.aio:AliVCSDK_InteractiveLive:$aio_sdk_version" } else { // ApsaraVideo Player SDK。 implementation "com.aliyun.sdk.android:AliyunPlayer:$player_sdk_version-full" // (オプション) RTS コンポーネント SDK。 implementation "com.aliyun.rts.android:RtsSDK:$rts_sdk_version" // (オプション) プレーヤーと RTS 間の AlivcArtc ブリッジレイヤー。バージョン番号はプレーヤー SDK のバージョン番号と同じである必要があります。このレイヤーは RTS コンポーネントと併せて統合する必要があります。 implementation "com.aliyun.sdk.android:AlivcArtc:$player_sdk_version" } }
iOS
プロジェクトの flutter_aliplayer.podspec ファイルで useAIOFramework 変数を設定します。
useAIOFramework = false の場合、再生専用 SDK および iOS 用 RTS ストリームプリング が使用されます。
useAIOFramework = true の場合、リアルタイムストリーミング (RTS) と RTC ベースの同時ストリーミングを含むライブストリーミング用のストリームインジェスト、および再生をサポートするiOS バージョン (インタラクティブストリーム) が使用されます。
必要に応じてカーネル SDK のバージョンを更新してください。最新バージョン:ApsaraVideo for MediaBox SDK、ApsaraVideo Player SDK、およびRTS Stream Pulling。
# SDK カーネルを定義します。
useAIOFramework = false
# SDK のバージョンを定義します。
aio_sdk_version = 'x.x.x'
player_sdk_version = 'x.x.x'
rts_sdk_version = 'x.x.x'
# useAIOFramework の値に基づいて SDK を選択します。
if useAIOFramework
s.subspec 'AliVCSDKFrameworks' do |ss|
# ApsaraVideo for MediaBox SDK (インタラクティブストリーム):RTS および RTC ベースの共同ストリーミングを含むライブストリーミング向けのストリームインジェスト、および再生をサポートします。
ss.dependency 'AliVCSDK_InteractiveLive', aio_sdk_version
end
else
s.subspec 'AliPlayerSDKFrameworks' do |ss|
# スタンドアロンの iOS 向け ApsaraVideo Player SDK。
ss.dependency 'AliPlayerSDK_iOS', player_sdk_version
# (オプション) RTS コンポーネント SDK。
ss.dependency 'RtsSDK', rts_sdk_version
# (オプション) プレーヤーと RTS 間の AlivcArtc ブリッジレイヤー。バージョン番号はプレーヤー SDK のバージョン番号と同じである必要があります。このレイヤーは RTS コンポーネントと併せて統合する必要があります。
ss.dependency 'AliPlayerSDK_iOS_ARTC', player_sdk_version
end
end制限事項
Android 向け ApsaraVideo Player SDK はエミュレーターをサポートしていません。統合が完了したら、実機でアプリを実行してください。
統合手順
ここでは例として VS Code 1.65.2 を使用します。他の開発ツールでも手順は同様です。
VS Code を起動します。
[表示] > [コマンドパレット…] を選択します
flutter と入力し、[Flutter: New Project] を選択します。
myapp などのプロジェクト名を入力し、Enter キーを押します。
プロジェクトの場所を指定したら、青色の [OK] ボタンをクリックします。
main.dart ファイルが表示されると、プロジェクトは準備完了です。
Flutter 用 ApsaraVideo Player SDK を統合します。
ApsaraVideo Player SDK for Flutter を迅速に組み込むには、プロジェクトの pubspec.yaml ファイルに flutter_aliplayer 依存関係を追加します。
dependencies: flutter_aliplayer: ^7.0.0 # バージョンは Flutter 向け ApsaraVideo Player SDK のバージョン番号です (例:7.0.0)。必要に応じてバージョン番号を変更してください。任意: ビジネスで RTS のサポートが必要な場合は、必要な依存関係を追加します。詳細については、「ApsaraVideo Player for Flutter」をご参照ください。