このトピックでは、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 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でこれらの操作を呼び出すために使用されるコードをコメントアウトします。