Player SDK for Flutter に関するよくある質問 - ApsaraVideo VOD

このドキュメントでは、Player SDK for Flutter に関するよくある質問 (ライセンス、コンパイル、パッケージング、再生など) とその回答をまとめています。

ライセンス関連の問題

無効または期限切れのライセンスの問題については、「ライセンスに関するよくある質問」をご参照ください。

プラットフォーム共通の問題

プラットフォームに依存しない問題については、「クロスプラットフォームプレーヤーのよくある質問」をご参照ください。
経験豊富な開発者の方は、ご自身で再生エラーをトラブルシューティングすることも可能です。

コンパイルに関する問題

Player SDK for Flutter を使用した Android デバイスでのパッケージングとコンパイルが失敗した場合、どうすればよいですか？

Gradle Scripts ディレクトリに proguard-rules.pro ファイルを作成し、以下のルールを追加して flutter_aliplayer 関連の難読化を無効にします：

-keep class com.alivc.**{*;}
-keep class com.aliyun.**{*;}
-keep class com.cicada.**{*;}
-dontwarn com.alivc.**
-dontwarn com.aliyun.**
-dontwarn com.cicada.**

build.gradle(:app) ファイルで、release ビルドタイプでコードの難読化を有効にし、proguard-rules.pro ファイルを参照します：

buildTypes {
        release {
            minifyEnabled true
            proguardFiles getDefaultProguardFile('proguard-android.txt'), '../proguard-rules.pro'
        }
    }

再生に関する問題

Player SDK for Flutter が SDK カーネルとして単一のプレーヤーを使用している場合に、Android デバイスで RTS ストリームを再生できない場合は、どうすればよいですか？

再生ページで RTS ライブラリをロードし、RTS のプロパティを設定します：

import 'package:flutter_aliplayer/flutter_aliplayer_factory.dart';
// このメソッドは Android デバイスにのみ適用されます。
FlutterAliPlayerFactory.loadRtsLibrary(true);

Player SDK for Flutter が VidAuth を使用して再生する際に、エラーが表示されずに再生が失敗する場合、どうすればよいですか？

この問題は通常、再生設定の呼び出し順序が正しくないことが原因で発生します。まず、FlutterAliPlayer.createVidPlayerConfigGenerator() を呼び出して再生設定を生成し、次にこの設定をプレーヤーに設定します。この手順をスキップしたり、呼び出し順序を間違えたりすると、プレーヤーに有効な再生設定がないため、明示的なエラーが表示されることなく再生が失敗します。正しい呼び出し順序の詳細については、「公式ドキュメントとデモプロジェクト」をご参照ください。