このトピックでは、ApsaraVideo Player SDK for Flutter の制限事項と統合方法について説明します。
環境要件
カテゴリ | 説明 |
Flutter バージョン | Flutter 3.22.2 • channel stable をサポートします。 |
Dart バージョン | Dart 3.4.3 をサポートします。 |
OS バージョン | Android 6.0 以降をサポートします。 |
携帯電話のチップ | 必須アーキテクチャ: armeabi-v7a および arm64-v8a。 |
開発ツール | Android Studio または Visual Studio Code を使用します。 |
SDK のダウンロード
ApsaraVideo Player SDK for Flutter は、お使いの Flutter SDK バージョンと互換性がある必要があります。たとえば、ApsaraVideo Player SDK for Flutter のバージョン 5.4.0 は、Flutter SDK 2.0 以降のみをサポートします。バージョンの互換性の詳細については、「Flutter SDK リリース履歴」をご参照ください。
Flutter SDK: Flutter SDK
最新の ApsaraVideo Player SDK for Flutter: ApsaraVideo Player SDK
ApsaraVideo Player SDK for Flutter プラグイン (パッチ更新用): ApsaraVideo Player SDK for Flutter プラグイン
プロジェクトの説明
ApsaraVideo Player SDK for Flutter のネイティブレイヤーは、ApsaraVideo Player SDKs for Android および iOS に基づいています。ソースコードは、プロジェクトに追加できるデモの依存関係として利用できます。
プロジェクトフォルダの構造を次の図に示します。
次の表に、フォルダとその特徴を示します。
ファイル名 | 説明 | 必須 |
android | Android ネイティブコードとプレーヤー SDK。 | はい |
ios | iOS ネイティブコードとプレーヤー SDK。 | はい |
lib | Flutter API コード。 | はい |
example | ApsaraVideo Player for Flutter デモ。 | いいえ |
ApsaraVideo Player SDK for Flutter には、ライブストリーミングと再生の両方の機能が含まれています。プロジェクトでライブストリーミング機能が不要な場合は、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 変数を変更します。
useAIOFramework = false の場合、再生専用 SDK と Android 用 RTS ストリームフェッチング が使用されます。useAIOFramework = true の場合、Android バージョン (インタラクティブストリーム) が使用されます。このバージョンは、リアルタイムストリーミング (RTS) と RTC ベースの共同ストリーミングを含むライブストリーミングのアップストリーミング、および再生をサポートします。
重要必要に応じてカーネル SDK のバージョンを変更してください。最新バージョンについては、「ApsaraVideo for MediaBox SDK」、「ApsaraVideo Player SDK」、および「RTS ストリームフェッチング」をご参照ください。
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 の場合、iOS バージョン (インタラクティブストリーム) が使用されます。このバージョンは、リアルタイムストリーミング (RTS) と RTC ベースの共同ストリーミングを含むライブストリーミングのアップストリーミング、および再生をサポートします。
必要に応じてカーネル SDK のバージョンを変更してください。最新バージョンについては、「ApsaraVideo for MediaBox SDK」、「ApsaraVideo Player SDK」、および「RTS ストリームフェッチング」をご参照ください。
# 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|
# スタンドアロンの 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制限事項
ApsaraVideo Player SDK for Android はエミュレーターをサポートしていません。統合後、物理デバイスでアプリケーションを実行する必要があります。
統合プロシージャ
以下のステップでは、VS Code V1.65.2 を例として使用します。プロシージャは他の開発ツールでも同様です。
VS Code を起動します。
を選択します。
flutter と入力し、[Flutter: 新規プロジェクト] を選択します。
myapp などのプロジェクト名を入力し、Enter キーを押します。
プロジェクトの場所を選択し、ボタンをクリックして確定します。
プロジェクトが作成されるまで待ちます。main.dart ファイルが表示されると、プロセスは完了です。
ApsaraVideo Player SDK for Flutter を統合します。
ApsaraVideo Player SDK for Flutter を迅速に統合するには、プロジェクトの pubspec.yaml ファイルに flutter_aliplayer の依存関係を追加します。
dependencies: flutter_aliplayer: ^7.0.0 # バージョンは ApsaraVideo Player SDK for Flutter のバージョン番号です (例: 7.0.0)。必要に応じてバージョン番号を変更してください。オプション:ビジネスで RTS (RTS) のサポートが必要な場合は、必要な依存関係を追加します。詳細については、「ApsaraVideo Player for Flutter」をご参照ください。