Update README for beta release.

PiperOrigin-RevId: 465318320
This commit is contained in:
tonihei 2022-08-04 15:17:56 +00:00
parent 7893531888
commit afc928330b

View File

@ -5,25 +5,24 @@ Android, including local playback (via ExoPlayer) and media sessions.
## Current status ## Current status
AndroidX Media is currently in alpha and we welcome your feedback via the AndroidX Media is currently in beta and we welcome your feedback via the
[issue tracker][]. Please consult the [release notes][] for more details about [issue tracker][]. Please consult the [release notes][] for more details about
the alpha release. the beta release.
ExoPlayer's new home will be in AndroidX Media, but for now we are publishing it ExoPlayer's new home will be in AndroidX Media, but for now we are publishing it
both in AndroidX Media and via the existing [ExoPlayer project][]. While both in AndroidX Media and via the existing [ExoPlayer project][]. While
AndroidX Media is in alpha we recommend that production apps using ExoPlayer AndroidX Media is in beta we recommend that production apps using ExoPlayer
continue to depend on the existing ExoPlayer project. We are still handling continue to depend on the existing ExoPlayer project. We are still handling
ExoPlayer issues on the [ExoPlayer issue tracker][]. ExoPlayer issues on the [ExoPlayer issue tracker][].
Updated documentation, including more information on migration and a developer You'll find some [Media3 documentation on developer.android.com][], including a
guide, is coming soon. For existing ExoPlayer users, the most important change [migration guide for existing ExoPlayer and MediaSession users][].
is that all classes have been moved to new packages under `androidx.media3`.
AndroidX Media alpha releases provide no guarantees about API stability, but the AndroidX Media releases provide API stability guarantees, ensuring that the API
codebase includes API stability marking for non-alpha releases. If you see lint surface remains backwards compatible for the most commonly used APIs. APIs
errors from using the unstable API surface, you can opt-in by annotating the intended for more advanced use cases are marked as unstable. To use an unstable
relevant code or disabling the lint check entirely. For more information see the method or class without lint warnings, youll need to add the OptIn annotation
[UnstableApi][] documentation. before using it. For more information see the [UnstableApi][] documentation.
For a high level overview of the initial version of AndroidX Media please see For a high level overview of the initial version of AndroidX Media please see
the Android Dev Summit talk [What's next for AndroidX Media and ExoPlayer][]. the Android Dev Summit talk [What's next for AndroidX Media and ExoPlayer][].
@ -34,6 +33,8 @@ the Android Dev Summit talk [What's next for AndroidX Media and ExoPlayer][].
[ExoPlayer issue tracker]: https://github.com/google/ExoPlayer/issues [ExoPlayer issue tracker]: https://github.com/google/ExoPlayer/issues
[UnstableApi]: https://github.com/androidx/media/blob/main/libraries/common/src/main/java/androidx/media3/common/util/UnstableApi.java [UnstableApi]: https://github.com/androidx/media/blob/main/libraries/common/src/main/java/androidx/media3/common/util/UnstableApi.java
[What's next for AndroidX Media and ExoPlayer]: https://youtu.be/sTIBDcyCmCg [What's next for AndroidX Media and ExoPlayer]: https://youtu.be/sTIBDcyCmCg
[Media3 documentation on developer.android.com]: https://developer.android.com/guide/topics/media/media3
[migration guide for existing ExoPlayer and MediaSession users]: https://developer.android.com/guide/topics/media/media3/getting-started/migration-guide
## Using the libraries ## Using the libraries