AndroidX Media3项目中的DRM UUID不匹配问题解析与解决方案

问题背景

在AndroidX Media3项目的最新主分支版本中，开发者在处理HLS流媒体播放时遇到了一个DRM相关的错误："Media does not support uuid: e2719d58-a985-b3c9-781a-b030af78d30e"。这个问题主要出现在使用ClearKey DRM方案播放特定HLS流时，在Android TV设备（如Onn Watch）和Android TV模拟器上可复现。

技术分析

问题本质

该问题的核心在于媒体流清单文件（m3u8）中没有正确包含ClearKey加密方案的信息。当Media3库尝试初始化DRM会话时，系统无法识别指定的UUID（e2719d58-a985-b3c9-781a-b030af78d30e），导致播放失败。

与Shaka Player的对比

值得注意的是，同样的DRM配置在Shaka Player中可以正常工作。这表明问题并非源于DRM配置本身，而是Media3库对HLS清单文件的解析处理方式存在差异。

解决方案

修改HlsPlaylistParser

通过在HlsPlaylistParser.java文件中添加特定代码段，可以解决这个问题。具体修改位于文件的1164行附近，主要处理KEYFORMAT_PRMNAGRA格式的DRM信息：

1. 解析URI字符串并提取Base64编码的数据
2. 将数据转换为JSON对象
3. 从JSON中获取key-id信息
4. 处理key-id字符串并转换为UUID数组
5. 构建PSSH原子数据

代码实现要点

} else if (KEYFORMAT_PRMNAGRA.equals(keyFormat) && "1".equals(keyFormatVersions)) {
    String uriString = parseStringAttr(line, REGEX_URI, variableDefinitions);
    byte[] data = Base64.decode(uriString.substring(uriString.indexOf(',')), Base64.DEFAULT);
    String str = new String(data, StandardCharsets.UTF_8);
    JSONObject json = new JSONObject(str);
    String defaultKid = (String) json.get("key-id");
    if (!TextUtils.isEmpty(defaultKid)
            && !"00000000-0000-0000-0000-000000000000".equals(defaultKid)) {
        String[] defaultKidStrings = defaultKid.split("\\s+");
        UUID[] defaultKids = new UUID[defaultKidStrings.length];
        for (int i = 0; i < defaultKidStrings.length; i++) {
            defaultKids[i] = UUID.fromString(defaultKidStrings[i]);
        }
        byte[] psshData = PsshAtomUtil.buildPsshAtom(C.COMMON_PSSH_UUID, defaultKids, null);
        return new SchemeData(C.COMMON_PSSH_UUID, MimeTypes.VIDEO_MP4, psshData);
    }
    return null;
}

技术原理

这段修改的核心在于正确处理PRMNAGRA格式的DRM信息。它通过：

1. 解析Base64编码的DRM信息
2. 提取关键密钥ID（KID）
3. 将KID转换为标准UUID格式
4. 构建PSSH（Protection System Specific Header）原子数据

这样处理后，Media3能够正确识别DRM方案并建立解密会话，从而解决原始错误。

适用场景

该解决方案特别适用于处理以下类型的HLS流：

• 使用ClearKey DRM方案
• 采用PRMNAGRA格式的密钥信息
• 密钥ID以特定格式编码在m3u8清单中

注意事项

1. 此修改是针对特定DRM格式的定制解决方案，可能不适用于所有ClearKey场景
2. 在实际应用中，应考虑对不同DRM方案做更全面的兼容处理
3. 修改核心库文件可能影响后续版本升级，建议在必要时才采用此方案

总结

AndroidX Media3库在处理某些特定格式的HLS DRM信息时存在兼容性问题。通过分析问题本质并修改HlsPlaylistParser的实现，可以有效解决UUID不识别的问题。这种解决方案展示了如何通过深入理解DRM信息格式和Media3内部处理机制来解决实际开发中的兼容性问题。