1*30877f79SAndroid Build Coastguard Worker---
2*30877f79SAndroid Build Coastguard Workertitle: Supported devices
3*30877f79SAndroid Build Coastguard Worker---
4*30877f79SAndroid Build Coastguard Worker
5*30877f79SAndroid Build Coastguard WorkerThe minimum Android versions required for core ExoPlayer use cases are:
6*30877f79SAndroid Build Coastguard Worker
7*30877f79SAndroid Build Coastguard Worker| Use case | Android version number | Android API level |
8*30877f79SAndroid Build Coastguard Worker|----------|:------------:|:------------:|
9*30877f79SAndroid Build Coastguard Worker| Audio playback | 4.1 | 16 |
10*30877f79SAndroid Build Coastguard Worker| Video playback | 4.1 | 16 |
11*30877f79SAndroid Build Coastguard Worker| DASH (no DRM) | 4.1 | 16 |
12*30877f79SAndroid Build Coastguard Worker| DASH (Widevine CENC; "cenc" scheme) | 4.4 | 19 |
13*30877f79SAndroid Build Coastguard Worker| DASH (Widevine CENC; "cbcs" scheme) | 7.1 | 25 |
14*30877f79SAndroid Build Coastguard Worker| DASH (ClearKey; "cenc" scheme) | 5.0 | 21 |
15*30877f79SAndroid Build Coastguard Worker| SmoothStreaming (no DRM) | 4.1 | 16 |
16*30877f79SAndroid Build Coastguard Worker| SmoothStreaming (PlayReady SL2000; "cenc" scheme) | AndroidTV | AndroidTV |
17*30877f79SAndroid Build Coastguard Worker| HLS (no DRM) | 4.1 | 16 |
18*30877f79SAndroid Build Coastguard Worker| HLS (AES-128 encryption) | 4.1 | 16 |
19*30877f79SAndroid Build Coastguard Worker| HLS (Widevine CENC; "cenc" scheme) | 4.4 | 19 |
20*30877f79SAndroid Build Coastguard Worker| HLS (Widevine CENC; "cbcs" scheme) | 7.1 | 25 |
21*30877f79SAndroid Build Coastguard Worker
22*30877f79SAndroid Build Coastguard WorkerFor a given use case, we aim to support ExoPlayer on all Android devices that
23*30877f79SAndroid Build Coastguard Workersatisfy the minimum version requirement. Known device specific compatibility
24*30877f79SAndroid Build Coastguard Workerissues are listed below. Device specific issues on our GitHub issue tracker can
25*30877f79SAndroid Build Coastguard Workerbe found
26*30877f79SAndroid Build Coastguard Worker[here](https://github.com/google/ExoPlayer/labels/bug%3A%20device%20specific).
27*30877f79SAndroid Build Coastguard Worker
28*30877f79SAndroid Build Coastguard Worker* **FireOS (version 4 and earlier)** - Whilst we endeavour to support FireOS
29*30877f79SAndroid Build Coastguard Worker  devices, FireOS is a fork of Android and as a result we are unable to
30*30877f79SAndroid Build Coastguard Worker  guarantee support. Device specific issues encountered on FireOS are normally
31*30877f79SAndroid Build Coastguard Worker  caused by incompatibilities in the support that FireOS provides for running
32*30877f79SAndroid Build Coastguard Worker  Android applications. Such issues should be reported to Amazon in the first
33*30877f79SAndroid Build Coastguard Worker  instance. We are aware of issues affecting FireOS version 4 and earlier. We
34*30877f79SAndroid Build Coastguard Worker  believe FireOS version 5 resolved these issues.
35*30877f79SAndroid Build Coastguard Worker* **Nexus Player (only when using an HDMI to DVI cable)** - There is a known
36*30877f79SAndroid Build Coastguard Worker  issue affecting Nexus Player, only when the device is connected to a monitor
37*30877f79SAndroid Build Coastguard Worker  using a certain type of HDMI to DVI cable, which causes video being played too
38*30877f79SAndroid Build Coastguard Worker  quickly. Use of an HDMI to DVI cable is not realistic for an end user setup
39*30877f79SAndroid Build Coastguard Worker  because such cables cannot carry audio. Hence this issue can be safely
40*30877f79SAndroid Build Coastguard Worker  ignored. We suggest using a realistic end user setup (e.g., the device
41*30877f79SAndroid Build Coastguard Worker  connected to a TV using a standard HDMI cable) for development and testing.
42*30877f79SAndroid Build Coastguard Worker* **Emulators** - Some Android emulators do not properly implement components of
43*30877f79SAndroid Build Coastguard Worker  Android's media stack, and as a result do not support ExoPlayer. This is an
44*30877f79SAndroid Build Coastguard Worker  issue with the emulator, not with ExoPlayer. Android's official emulator
45*30877f79SAndroid Build Coastguard Worker  ("Virtual Devices" in Android Studio) supports ExoPlayer provided the system
46*30877f79SAndroid Build Coastguard Worker  image has an API level of at least 23. System images with earlier API levels
47*30877f79SAndroid Build Coastguard Worker  do not support ExoPlayer. The level of support provided by third party
48*30877f79SAndroid Build Coastguard Worker  emulators varies. Issues running ExoPlayer on third party emulators should be
49*30877f79SAndroid Build Coastguard Worker  reported to the developer of the emulator rather than to the ExoPlayer team.
50*30877f79SAndroid Build Coastguard Worker  Where possible, we recommend testing media applications on physical devices
51*30877f79SAndroid Build Coastguard Worker  rather than emulators.
52