如何为Google Cast的RemoteMediaClient和MediaMetaData设置自定义User Agent

我完全懂你的困扰——自己的应用有自定义User Agent，服务器还拦截非指定UA，但用Google Cast在Android TV上播放时，设备居然用的是浏览器默认UA，导致媒体请求被卡。下面给你说清楚怎么解决这个问题：

首先明确两个关键点：

• MediaMetaData不能设置User Agent：它只是用来存储媒体的元数据（比如标题、封面图），和HTTP请求头完全不沾边，所以不用在这上面白费功夫。
• RemoteMediaClient本身没有直接设置UA的API，但我们可以通过修改媒体加载请求的HTTP头来实现目标。

具体实现步骤 #

核心思路是在构建媒体加载请求时，通过MediaLoadRequestData.Builder的setHeaders()方法，把自定义User Agent作为HTTP头传递给Chromecast设备，设备请求媒体资源时会自动带上这个头。

结合你提供的代码，修改后的完整示例如下：

private void loadRemoteMedia(boolean autoPlay) {
    if (mCastSession == null) {
        return;
    }
    RemoteMediaClient remoteMediaClient = mCastSession.getRemoteMediaClient();
    if (remoteMediaClient == null) {
        // 这里处理RemoteMediaClient为空的情况
        return;
    }

    // 1. 构建你的媒体元数据（保留你原有设置即可）
    MediaMetadata mediaMetadata = new MediaMetadata(MediaMetadata.MEDIA_TYPE_MOVIE);
    mediaMetadata.putString(MediaMetadata.KEY_TITLE, "你的媒体标题");
    // 可以继续添加其他元数据字段，比如封面、副标题等

    // 2. 构建媒体信息对象
    MediaInfo mediaInfo = new MediaInfo.Builder("你的媒体资源URL")
            .setContentType("video/mp4") // 根据你的媒体类型调整，比如audio/mpeg对应音频
            .setMetadata(mediaMetadata)
            .build();

    // 3. 创建自定义HTTP请求头，添加你的User Agent
    HashMap<String, String> customHeaders = new HashMap<>();
    customHeaders.put("User-Agent", "你的自定义User Agent字符串");

    // 4. 构建媒体加载请求，并注入自定义头
    MediaLoadRequestData loadRequest = new MediaLoadRequestData.Builder()
            .setMediaInfo(mediaInfo)
            .setAutoplay(autoPlay)
            .setHeaders(customHeaders) // 关键步骤：设置自定义HTTP头
            .build();

    // 5. 发送加载请求
    remoteMediaClient.load(loadRequest)
            .addOnSuccessListener(aVoid -> {
                // 媒体加载成功后的逻辑
            })
            .addOnFailureListener(e -> {
                // 加载失败时的错误处理
                Log.e("CastPlayer", "媒体加载失败: " + e.getMessage());
            });
}

额外注意事项 #

• 如果你使用的是Google默认的媒体Receiver应用，不需要额外配置，它会自动转发你设置的HTTP头给媒体服务器。
• 如果你用的是自定义Receiver应用，要确保Receiver端在请求媒体资源时，正确传递这些自定义头（一般通过load方法的headers参数处理即可）。
• 测试时可以抓包验证一下，确认Chromecast设备发送的请求里确实包含了你设置的自定义User Agent，避免服务器端的逻辑问题导致拦截。

内容的提问来源于stack exchange，提问作者Anton