Flutter播放器常见问题-视频点播(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。