onPlayerConfig property

播放器自定义配置回调

Player custom configuration callback.

在播放器 prepare() 之前调用，允许用户对播放器实例进行自定义配置，例如通过 setPlayConfig 设置缓冲策略、refer 等。支持异步操作（如 getConfig/setConfig），Widget 会等待回调完成后再执行 prepare()。

对于未通过 AliPlayerWidgetController 直接透出的播放器接口（如 setConfig、setOption、setFilterConfig 等），建议在此回调中自行调用实现。

Called before player prepare(), allowing users to customize the player instance, such as setting buffer strategy, referer via setPlayConfig, etc. Supports async operations (e.g., getConfig/setConfig). The Widget will await the callback completion before calling prepare().

For player APIs not directly exposed by AliPlayerWidgetController (e.g., setConfig, setOption, setFilterConfig, etc.), it is recommended to call them within this callback.

使用示例 / Usage example:

AliPlayerWidgetData(
  videoSource: ...,
  onPlayerConfig: (player) async {
    // 设置缓冲策略和 Referer
    var config = await player.getConfig();
    config.maxBufferDuration = 2000;
    config.referer = "your referer";
    await player.setConfig(config);

    // 设置其他选项
    player.setOption(FlutterAvpdef.ALLOW_PRE_RENDER, 1);
  },
);

Implementation

AliPlayerWidgetData class