このトピックでは、ApsaraVideo Player SDK for Flutterの概要と、ApsaraVideo Player SDK for Flutterを統合する方法について説明します。
環境要件
項目 | 要件 |
Flutterバージョン | 安定したチャンネルのフラッター3.22.2 |
ダーツ版 | ダート3.4.3 |
オペレーティングシステム | Android 6.0以降 |
携帯電話プロセッサ | 建築: armeabi-v7aまたはarm64-v8a |
开発ツール |
SDK のダウンロード
特定のバージョンのApsaraVideo Player SDK for Flutterは、特定のバージョンのFlutter SDKをサポートしています。 たとえば、ApsaraVideo Player SDK For Flutter V5.4.0は、Flutter SDK 2.0以降のみをサポートします。 詳細については、「ApsaraVideo Player SDK For Flutterのリリースノート」をご参照ください。
Flutter SDKをダウンロードするには、Flutter SDKをご参照ください。
最新バージョンのApsaraVideo Player SDK for Flutterをダウンロードするには、「SDKの概要とダウンロード」をご参照ください。
ApsaraVideo Player SDK for Flutterのプラグイン (ApsaraVideo Player SDK for Flutterのパッチで提供) をダウンロードするには、ApsaraVideo Player SDK for Flutterプラグインをご参照ください。
プロジェクトの説明
ApsaraVideo Player SDK for Flutterのネイティブレイヤーは、ApsaraVideo Player SDK for AndroidおよびApsaraVideo Player SDK for iOSに基づいて開発されています。 ソースコードは、デモの依存関係に含まれています。 ビジネス要件に基づいてソースコードを変更できます。
プロジェクトのディレクトリ構造を次の図に示します。
ディレクトリ内のフォルダを次の表に示します。
フォルダ | 説明 | 必須 / 任意 |
android | AndroidおよびApsaraVideo Player SDK for Androidのネイティブコード。 | 可 |
ios | iOSおよびApsaraVideo Player SDK for iOSのネイティブコード。 | 可 |
lib | FlutterのAPIのコード。 | 可 |
example | Flutter用ApsaraVideo Playerのデモ。 | 不可 |
ApsaraVideo Player SDK for Flutterは、ライブストリーミング機能とプレーヤー機能の両方をサポートしています。 ライブストリーミング機能が必要ない場合は、ApsaraVideo Player SDK for Flutterのカーネルをマルチモジュール (ライブストリーミング + プレーヤー) からシングルモジュール (プレーヤー) に変更できます。 そうするには、次の手順を実行します。
Android
Alibaba Cloud MavenリポジトリのURLをプロジェクトレベルのbuild.gradleファイルに追加します。
maven { url "https://maven.aliyun.com/nexus/content/repositories/releases" }
マルチモジュールSDKを、プレーヤー機能のみをサポートするシングルモジュールSDKに置き換えます。
dependencies { // Multi-module SDK for interactive streaming: ApsaraVideo Player SDK and Push SDK that supports Real-Time Streaming (RTS) and real-time communication (RTC)-based co-streaming //implementation 'com.aliyun.aio:AliVCSDK_InteractiveLive:x.x.x' // ApsaraVideo Player SDK implementation 'com.aliyun.sdk.android:AliyunPlayer:x.x.x-full' implementation 'com.google.code.gson:gson:2.8.6' }
iOS
flutter_aliplayer.podspecファイルで、'AliVCSDK_InteractiveLive', 'x.x.x'
を 'AliPlayerSDK_iOS', 'x. x'
に置き換えます。
制限事項
ApsaraVideo Player SDK for Androidはシミュレーターでは実行できません。 ApsaraVideo Player SDK for Androidを統合したら、AndroidデバイスでSDKを実行する必要があります。
統合
次の手順では、ApsaraVideo Player SDK for FlutterをVS Code 1.65.2に統合する方法を示します。 他の開発ツールを使用してApsaraVideo Player SDK for Flutterを統合する手順も同様です。
VSコードを開始します。
を選択します。
フラッターを入力し、フラッター: 新しいプロジェクトを選択します。
myappなどのプロジェクト名を入力し、Enterキーを押します。
プロジェクトを保存する場所を指定し、[OK] をクリックします。
プロジェクトが作成されるのを待ちます。 main.dartファイルが表示されると、プロジェクトが作成されます。
ApsaraVideo Player SDK for Flutterをプロジェクトに統合します。
プロジェクトのpubspec.yamlファイルへの依存関係としてflutter_aliplayerを追加することで、ApsaraVideo Player SDK for Flutterを統合できます。
dependencies: flutter_aliplayer: ^version # version specifies the version number of ApsaraVideo Player SDK for Flutter, such as 5.4.0. Replace version with the actual version number.
オプション: ビジネスシナリオでRTSが必要な場合は、次の依存関係を追加します。 RTSの詳細については、「概要」をご参照ください。
次のいずれかの方法を使用して、依存関係を追加できます。
説明以下の例で使用されるバージョン番号は、参照のみのためである。
統合するRTS SDKのバージョンは、ApsaraVideo Player SDKのバージョンと一致する必要があります。 RTS SDKがサポートするApsaraVideo Player SDKのバージョンの詳細については、「リリースノート」をご参照ください。
AndroidおよびiOS用のApsaraVideo Player SDKのバージョンの詳細については、「ApsaraVideo Player SDK For Androidのリリースノート」および「ApsaraVideo Player SDK for iOSのリリースノート」をご参照ください。 RTS SDKのバージョンの詳細については、「リリースノート」をご参照ください。
方法1: AndroidまたはiOSデバイスのネイティブ層に統合を実装する
Android: build.gradleファイルに依存関係を含めます。 サンプルコード:
dependencies{ implementation 'com.aliyun.sdk.android:AlivcArtc:$version' implementation 'com.aliyun.rts.android:RtsSDK:$version' } # version specifies the version number of ApsaraVideo Player SDK for Android or RTS SDK for Android. Examples: 'com.aliyun.sdk.android:AlivcArtc:5.4.9.1' and 'com.aliyun.rts.android:RtsSDK:2.5.0'.
iOS: Podfileファイルに依存関係を含めます。 サンプルコード:
target 'Runner' do flutter_install_all_ios_pods File.dirname(File.realpath(__FILE__)) pod 'AliPlayerSDK_iOS_ARTC', '$version' #$version specifies the version number of ApsaraVideo Player SDK for iOS. Example: 5.4.9.1. pod 'RtsSDK', '$version' #$version specifies the version number of RTS SDK for iOS. Example: 2.5.0. end
方法2: Flutterプラグインを使用する (更新停止)
RTS SDKおよびApsaraVideo Player SDKのバージョンは、
flutter_aliplayer
プロジェクトのCHANGELOG.mdファイルから取得できます。flutter_aliplayer_artc: ^version flutter_aliplayer_rts: ^version # version specifies the version number. Examples: flutter_aliplayer_artc: ^5.2.3 and flutter_aliplayer_rts: ^1.5.0. Replace version with the actual version number.
よくある質問
ApsaraVideo Player SDKをiOSに統合した後、Xcodeシミュレーターでアプリをデバッグできますか?
デバッグには実際のiPhoneを使用することをお勧めします。 Xcode 14を使用してiOSシミュレーターでアプリをコンパイルするときに次の図に示すようなエラーが発生した場合は、setFilterConfig:
、updateFilterConfig:
、setFilterInvalid:
、およびApsaraVideo Player SDK for Flutterでこれらの操作を呼び出すために使用されるコードをコメントアウトします。