在AndroidX Media3中为媒体通知控制器设置自定义请求头

在AndroidX Media3库中，当我们需要从受保护的API获取媒体内容时，经常会遇到需要添加认证头信息的情况。本文将详细介绍如何为媒体通知控制器的图片请求设置自定义HTTP头信息。

问题背景

在开发媒体应用时，我们通常会使用ExoPlayer来播放音视频内容。当应用处于开发阶段时，后端API可能需要基本的HTTP认证(Basic Auth)。虽然我们可以为媒体播放设置自定义请求头，但媒体通知控制器显示的封面图片请求却无法自动继承这些设置，导致401未授权错误。

解决方案

AndroidX Media3提供了灵活的架构来定制图片加载行为。我们可以通过实现自定义的BitmapLoader来解决这个问题。

核心实现步骤

1. 创建可解析的数据源工厂：使用ResolvingDataSource.Factory包装默认的HTTP数据源工厂，并实现Resolver接口来修改请求头。

2. 配置BitmapLoader：将上述数据源工厂用于DataSourceBitmapLoader，并可选地添加缓存层。

3. 应用到MediaLibrarySession：在构建MediaLibrarySession时设置自定义的BitmapLoader。

代码实现

以下是一个完整的Kotlin实现示例：

// 1. 创建可解析的数据源工厂
val resolvingDataSourceFactory = ResolvingDataSource.Factory(
    DefaultHttpDataSource.Factory()
        .setAllowCrossProtocolRedirects(true), // 允许跨协议重定向
    object : ResolvingDataSource.Resolver {
        override fun resolveDataSpec(dataSpec: DataSpec): DataSpec {
            // 添加认证头信息
            val credentials = "${BuildConfig.DEV_ENV_AUTH_USERNAME}:${BuildConfig.DEV_ENV_AUTH_PASSWORD}"
            val authHeader = "Basic " + Base64.encodeToString(credentials.toByteArray(), Base64.DEFAULT)
            
            return dataSpec.buildUpon()
                .setHttpRequestHeaders("Authorization", authHeader)
                .build()
        }
    }
)

// 2. 创建带缓存的BitmapLoader
val bitmapLoader = CacheBitmapLoader(
    DataSourceBitmapLoader(
        MoreExecutors.listeningDecorator(Executors.newSingleThreadExecutor()),
        resolvingDataSourceFactory
    )
)

// 3. 应用到MediaLibrarySession
mediaLibrarySession = MediaLibrarySession.Builder(this, player, callback)
    .setBitmapLoader(bitmapLoader)
    .build()

技术要点解析

1. ResolvingDataSource：这是一个强大的工具，允许我们在数据请求发出前修改请求参数。除了添加头信息，还可以修改URL、请求方法等。

2. BitmapLoader层次结构：我们使用了CacheBitmapLoader包装DataSourceBitmapLoader，这为图片加载添加了缓存层，可以提高性能并减少网络请求。

3. 线程管理：通过MoreExecutors.listeningDecorator和单线程执行器，我们确保了图片加载操作在专用线程中执行，避免阻塞主线程。

进阶优化

1. 动态认证：如果认证信息可能变化，可以在Resolver实现中添加逻辑来获取最新的认证凭证。

2. 错误处理：可以在Resolver中添加错误处理逻辑，比如在认证失败时尝试刷新令牌。

3. 性能优化：根据应用需求，可以调整缓存策略或使用更高效的图片加载库。

总结

通过自定义BitmapLoader，我们成功解决了AndroidX Media3中媒体通知控制器图片加载的认证问题。这种解决方案不仅灵活，而且保持了代码的整洁性和可维护性。开发者可以根据实际需求进一步扩展和优化这一方案，以适应各种复杂的媒体应用场景。