Flutter播放器常見問題 - ApsaraVideo VOD

本文匯總 Flutter 播放器 SDK 使用過程中的常見問題及解決方案，涵蓋 License、編譯打包、播放等情境。

License相關問題

License無效、到期等問題請參見License相關常見問題。

各端播放器共性問題

各端都有可能出現的問題，匯總在各端播放器公用常見問題。
如果您有一定的開發經驗，也可進行播放異常自主排查。

編譯相關問題

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'
        }
    }

播放相關問題

Flutter SDK 使用單播放器作為 SDK 核心時，Android 端無法播放 RTS 流怎麼辦？

在相關播放頁面載入 RTS 庫並設定 RTS 配置屬性。樣本如下：

import 'package:flutter_aliplayer/flutter_aliplayer_factory.dart';
// 此方法僅適用於 Android 端，iOS 無需調用
FlutterAliPlayerFactory.loadRtsLibrary(true);

Flutter 播放器使用 VidAuth 方式播放失敗且無報錯怎麼辦？

此問題多因播放配置的調用順序錯誤導致。需先調用 FlutterAliplayer.createVidPlayerConfigGenerator() 產生播放配置，再將該配置設定到播放器。若跳過此步驟或調用順序錯誤，播放器會因缺少有效播放配置而播放失敗，且不會拋出明確報錯。具體調用順序可參考官方文檔樣本及 Demo。