支持的设备
使用集合让一切井井有条
根据您的偏好保存内容并对其进行分类。
核心 ExoPlayer 用例所需的最低 Android 版本如下:
用例 |
Android 版本 |
API 级别 |
音频播放 |
5.0 |
21 |
音频播放(使用分流) |
10 |
29 |
视频播放 |
5.0 |
21 |
视频播放(带效果) |
5.0 |
21 |
视频播放(HDR) |
7.0 |
24 |
DASH(无 DRM) |
5.0 |
21 |
DASH(Widevine CENC;“cenc”方案) |
5.0 |
21 |
DASH(Widevine CENC;“cbcs”方案) |
7.1 |
25 |
DASH(ClearKey;“cenc”方案) |
5.0 |
21 |
SmoothStreaming(无 DRM) |
4.4 |
19 |
SmoothStreaming(PlayReady;“cenc”方案) |
Android TV |
Android TV |
HLS(无 DRM) |
5.0 |
21 |
HLS(AES-128 加密) |
5.0 |
21 |
HLS(Widevine CENC;“cenc”方案) |
4.4 |
19 |
HLS(Widevine CENC;“cbcs”方案) |
7.1 |
25 |
对于给定的用例,我们的目标是在满足最低版本要求的所有 Android 设备上支持 ExoPlayer。Media3 GitHub 问题跟踪器或旧版 ExoPlayer GitHub 问题跟踪器中列出了特定于设备的已知问题。
模拟器
某些 Android 模拟器未正确实现 Android 媒体堆栈的组件,因此不支持 ExoPlayer。这是模拟器的问题,而不是 ExoPlayer 的问题。Android 的官方模拟器(Android Studio 中的“虚拟设备”)支持 ExoPlayer,前提是系统映像的 API 级别至少为 23。较低 API 级别的系统映像不支持 ExoPlayer。第三方模拟器提供的支持服务等级各不相同。在第三方模拟器上运行 ExoPlayer 时遇到的问题应报告给模拟器的开发者,而不是 ExoPlayer 团队。我们建议您尽可能在实体设备(而非模拟器)上测试媒体应用。
本页面上的内容和代码示例受内容许可部分所述许可的限制。Java 和 OpenJDK 是 Oracle 和/或其关联公司的注册商标。
最后更新时间 (UTC):2025-07-27。
[null,null,["最后更新时间 (UTC):2025-07-27。"],[],[],null,["# Supported devices\n\nThe minimum Android versions required for core ExoPlayer use cases are:\n\n| Use case | Android version | API level |\n|--------------------------------------------|-----------------|------------|\n| Audio playback | 5.0 | 21 |\n| Audio playback (using offload) | 10 | 29 |\n| Video playback | 5.0 | 21 |\n| Video playback (with effects) | 5.0 | 21 |\n| Video playback (HDR) | 7.0 | 24 |\n| DASH (no DRM) | 5.0 | 21 |\n| DASH (Widevine CENC; \"cenc\" scheme) | 5.0 | 21 |\n| DASH (Widevine CENC; \"cbcs\" scheme) | 7.1 | 25 |\n| DASH (ClearKey; \"cenc\" scheme) | 5.0 | 21 |\n| SmoothStreaming (no DRM) | 4.4 | 19 |\n| SmoothStreaming (PlayReady; \"cenc\" scheme) | Android TV | Android TV |\n| HLS (no DRM) | 5.0 | 21 |\n| HLS (AES-128 encryption) | 5.0 | 21 |\n| HLS (Widevine CENC; \"cenc\" scheme) | 4.4 | 19 |\n| HLS (Widevine CENC; \"cbcs\" scheme) | 7.1 | 25 |\n\nFor a given use case, we aim to support ExoPlayer on all Android devices that\nsatisfy the minimum version requirement. Known device-specific issues are listed\non the [Media3 GitHub issue tracker](https://github.com/androidx/media/labels/bug%3A%20device%20specific) or the\n[legacy ExoPlayer GitHub issue tracker](https://github.com/google/ExoPlayer/labels/bug%3A%20device%20specific).\n\nEmulators\n---------\n\nSome Android emulators don't properly implement components of Android's media\nstack, and as a result don't support ExoPlayer. This is an issue with the\nemulator, not with ExoPlayer. Android's official emulator (\"Virtual Devices\" in\nAndroid Studio) supports ExoPlayer provided the system image has an API level of\nat least 23. System images with earlier API levels don't support ExoPlayer. The\nlevel of support provided by third-party emulators varies. Issues running\nExoPlayer on third-party emulators should be reported to the developer of the\nemulator rather than to the ExoPlayer team. Where possible, we recommend testing\nmedia apps on physical devices rather than emulators."]]