自定义配置

适用场景

• 设置全局 Option（如全局日志级别）。

• 启用 HTTP/2 多路复用。

• 其他需要在所有播放器实例创建前生效的全局行为。

机制说明

• 通过 AliPlayerKit.setOnGlobalInit() 注册回调。

• 回调在 AliPlayerKit.init() 内部全局初始化完成后触发，仅执行一次。

• 此时底层 SDK 已就绪，可安全调用全局 API。

使用方式

在 Application.onCreate() 中，调用 AliPlayerKit.init() 之前注册回调：

public class MyApplication extends Application {

    @Overridepublic void onCreate() {
        super.onCreate();

        // 1. 注册全局自定义配置回调（在 init 之前调用）
        AliPlayerKit.setOnGlobalInit(() -> {
            // 示例：启用 HTTP/2 多路复用
            AliPlayerFactory.setOption(
                AliPlayerGlobalSettings.ENABLE_H2_MULTIPLEX, 1
            );
            // 示例：设置全局日志级别// AliPlayerFactory.setOption(...);
        });

        // 2. 初始化（内部会在初始化完成后触发上面注册的回调）
        AliPlayerKit.init(this);
    }
}

注意事项

适用场景

• 自定义缓冲策略（maxBufferDuration、highBufferDuration等）。

• 设置 Referer 防盗链。

• 配置 HTTP Header。

• 设置实例级 Option。

• 其他 AliPlayerKit 未直接透出的播放器接口。

机制说明

• 通过 AliPlayerModel.Builder.onPlayerConfig() 传入回调。

• 在每次 controller.configure(model) 时触发。

• 回调在 setDataSource() 之后、prepare() 前执行。

• 回调参数为 IMediaPlayer 实例，可通过此实例访问底层 SDK 的全部配置能力。

使用方式

在构建 AliPlayerModel 时，通过onPlayerConfig()方法传入回调：

AliPlayerModel model = new AliPlayerModel.Builder()
        .videoSource(videoSource)
        .onPlayerConfig(player -> {
            // 先获取底层原生播放器实例
            AliPlayer aliPlayer = player.getInternalPlayer();

            // 示例 1：自定义缓冲策略和 Referer
            PlayerConfig config = aliPlayer.getConfig();
            config.mMaxBufferDuration = 50000;                  // 最大缓冲时长 50s
            config.mHighBufferDuration = 3000;                  // 高水位缓冲 3s
            config.mStartBufferDuration = 500;                  // 起播缓冲 500ms
            config.mReferrer = "https://your-domain.com";       // 设置 Referer 防盗链
            aliPlayer.setConfig(config);

            // 示例 2：设置实例级 Option
            aliPlayer.setOption(AliPlayer.ALLOW_PRE_RENDER, 1);
        })
        .build();

// 配置并播放
controller.configure(model);

注意事项

全局配置时序

Application.onCreate()
    │
    ├── AliPlayerKit.setOnGlobalInit(callback)   ← 注册回调
    │
    └── AliPlayerKit.init(context)
            │
            ├── GlobalManager.initialize()    ← 底层 SDK 初始化
            │
            └── callback.onGlobalInit()           ← 触发全局配置回调（仅一次）

实例配置时序

controller.configure(model)
    │
    ├── lifecycleStrategy.acquire()               ← 获取播放器实例
    │
    ├── player.setDataSource(model)               ← 配置视频源（内部已隐式调用 prepare()）
    │
    └── onPlayerConfig.onPlayerConfig(player)     ← 触发实例配置回调（此时已在 prepare() 之后）

完整生命周期

┌──────────────────────────────────────────────────────────────────┐
│                       Application 启动                           │
│                                                                  │
│  setOnGlobalInit(callback)  ──→  init(context)                  │
│                                      │                           │
│                               GlobalManager                  │
│                                      │                           │
│                               callback.onGlobalInit() ← 全局配置 │
└──────────────────────────────────────────────────────────────────┘
                              │
                              ▼
┌──────────────────────────────────────────────────────────────────┐
│                      播放器实例创建                               │
│                                                                  │
│  AliPlayerModel.Builder()                                        │
│      .videoSource(source)                                        │
│      .onPlayerConfig(callback)  ← 注册实例配置回调                │
│      .build()                                                    │
│                                                                  │
│  controller.configure(model)                                     │
│      │                                                           │
│      ├── setDataSource(model)  ← 内部已隐式调用 prepare()          │
│      └── callback.onPlayerConfig(player)  ← 实例配置（prepare 后） │
└──────────────────────────────────────────────────────────────────┘

核心接口

@FunctionalInterfacepublic interface OnGlobalInitCallback {
    /**
     * 全局初始化完成后的配置回调。
     */void onGlobalInit();
}

@FunctionalInterfacepublic interface OnPlayerConfigCallback {
    /**
     * 播放器自定义配置回调，在 prepare() 前调用。
     *
     * @param player 播放器实例，可通过此实例访问底层 SDK 配置能力
     */void onPlayerConfig(@NonNull IMediaPlayer player);
}

注册方法

相关文件

全局配置和实例配置的执行顺序是什么？

全局配置（setOnGlobalInit）在应用启动时执行一次；实例配置（onPlayerConfig）在每个播放器实例 prepare() 前执行。两者互不影响。

如果不设置自定义配置会怎样？

AliPlayerKit 已内置最佳实践配置，不设置任何自定义配置即可正常使用，适合大多数场景。

实例配置回调中可以做异步操作吗？

不建议。Android 端的回调是同步执行的，回调完成后才会继续执行 prepare()。如果在回调中执行耗时操作，会阻塞播放器的启动流程。

可以在实例配置中修改视频源吗？

不建议。视频源在回调前已通过 setDataSource() 设置完成，在回调中修改视频源可能导致不可预期的行为。实例配置回调应仅用于设置播放参数（如缓冲策略、Referer 等）。