Merge pull request #6752 from google/dev-v2-r2.11.0

r2.11.0

.gitignore

@@ -57,6 +57,9 @@ extensions/vp9/src/main/jni/libvpx
 extensions/vp9/src/main/jni/libvpx_android_configs
 extensions/vp9/src/main/jni/libyuv
 
+# AV1 extension
+extensions/av1/src/main/jni/libgav1
+
 # Opus extension
 extensions/opus/src/main/jni/libopus
 

.hgignore

@@ -62,6 +62,9 @@ extensions/vp9/src/main/jni/libvpx
 extensions/vp9/src/main/jni/libvpx_android_configs
 extensions/vp9/src/main/jni/libyuv
 
+# AV1 extension
+extensions/av1/src/main/jni/libgav1
+
 # Opus extension
 extensions/opus/src/main/jni/libopus
 

RELEASENOTES.md

@@ -1,5 +1,167 @@
 # Release notes #
 
+### 2.11.0 (2019-12-11) ###
+
+* Core library:
+  * Replace `ExoPlayerFactory` by `SimpleExoPlayer.Builder` and
+    `ExoPlayer.Builder`.
+  * Add automatic `WakeLock` handling to `SimpleExoPlayer`, which can be enabled
+    by calling `SimpleExoPlayer.setHandleWakeLock`
+    ([#5846](https://github.com/google/ExoPlayer/issues/5846)). To use this
+    feature, you must add the
+    [WAKE_LOCK](https://developer.android.com/reference/android/Manifest.permission.html#WAKE_LOCK)
+    permission to your application's manifest file.
+  * Add automatic "audio becoming noisy" handling to `SimpleExoPlayer`, which
+    can be enabled by calling `SimpleExoPlayer.setHandleAudioBecomingNoisy`.
+  * Wrap decoder exceptions in a new `DecoderException` class and report them as
+    renderer errors.
+  * Add `Timeline.Window.isLive` to indicate that a window is a live stream
+    ([#2668](https://github.com/google/ExoPlayer/issues/2668) and
+    [#5973](https://github.com/google/ExoPlayer/issues/5973)).
+  * Add `Timeline.Window.uid` to uniquely identify window instances.
+  * Deprecate `setTag` parameter of `Timeline.getWindow`. Tags will always be
+    set.
+  * Deprecate passing the manifest directly to
+    `Player.EventListener.onTimelineChanged`. It can be accessed through
+    `Timeline.Window.manifest` or `Player.getCurrentManifest()`
+  * Add `MediaSource.enable` and `MediaSource.disable` to improve resource
+    management in playlists.
+  * Add `MediaPeriod.isLoading` to improve `Player.isLoading` state.
+  * Fix issue where player errors are thrown too early at playlist transitions
+    ([#5407](https://github.com/google/ExoPlayer/issues/5407)).
+  * Add `Format` and renderer support flags to renderer `ExoPlaybackException`s.
+* DRM:
+  * Inject `DrmSessionManager` into the `MediaSources` instead of `Renderers`.
+    This allows each `MediaSource` in a `ConcatenatingMediaSource` to use a
+    different `DrmSessionManager`
+    ([#5619](https://github.com/google/ExoPlayer/issues/5619)).
+  * Add `DefaultDrmSessionManager.Builder`, and remove
+    `DefaultDrmSessionManager` static factory methods that leaked
+    `ExoMediaDrm` instances
+    ([#4721](https://github.com/google/ExoPlayer/issues/4721)).
+  * Add support for the use of secure decoders when playing clear content
+    ([#4867](https://github.com/google/ExoPlayer/issues/4867)). This can
+    be enabled using `DefaultDrmSessionManager.Builder`'s
+    `setUseDrmSessionsForClearContent` method.
+  * Add support for custom `LoadErrorHandlingPolicies` in key and provisioning
+    requests ([#6334](https://github.com/google/ExoPlayer/issues/6334)). Custom
+    policies can be passed via `DefaultDrmSessionManager.Builder`'s
+    `setLoadErrorHandlingPolicy` method.
+  * Use `ExoMediaDrm.Provider` in `OfflineLicenseHelper` to avoid leaking
+    `ExoMediaDrm` instances
+    ([#4721](https://github.com/google/ExoPlayer/issues/4721)).
+* Track selection:
+  * Update `DefaultTrackSelector` to set a viewport constraint for the default
+    display by default.
+  * Update `DefaultTrackSelector` to set text language and role flag
+    constraints for the device's accessibility settings by default
+    ([#5749](https://github.com/google/ExoPlayer/issues/5749)).
+  * Add option to set preferred text role flags using
+    `DefaultTrackSelector.ParametersBuilder.setPreferredTextRoleFlags`.
+* Android 10:
+  * Set `compileSdkVersion` to 29 to enable use of Android 10 APIs.
+  * Expose new `isHardwareAccelerated`, `isSoftwareOnly` and `isVendor` flags
+    in `MediaCodecInfo`
+    ([#5839](https://github.com/google/ExoPlayer/issues/5839)).
+  * Add `allowedCapturePolicy` field to `AudioAttributes` to allow to
+    configuration of the audio capture policy.
+* Video:
+  * Pass the codec output `MediaFormat` to `VideoFrameMetadataListener`.
+  * Fix byte order of HDR10+ static metadata to match CTA-861.3.
+  * Support out-of-band HDR10+ dynamic metadata for VP9 in WebM/Matroska.
+  * Assume that protected content requires a secure decoder when evaluating
+    whether `MediaCodecVideoRenderer` supports a given video format
+    ([#5568](https://github.com/google/ExoPlayer/issues/5568)).
+  * Fix Dolby Vision fallback to AVC and HEVC.
+  * Fix early end-of-stream detection when using video tunneling, on API level
+    23 and above.
+  * Fix an issue where a keyframe was rendered rather than skipped when
+    performing an exact seek to a non-zero position close to the start of the
+    stream.
+* Audio:
+  * Fix the start of audio getting truncated when transitioning to a new
+    item in a playlist of Opus streams.
+  * Workaround broken raw audio decoding on Oppo R9
+    ([#5782](https://github.com/google/ExoPlayer/issues/5782)).
+  * Reconfigure audio sink when PCM encoding changes
+    ([#6601](https://github.com/google/ExoPlayer/issues/6601)).
+  * Allow `AdtsExtractor` to encounter EOF when calculating average frame size
+    ([#6700](https://github.com/google/ExoPlayer/issues/6700)).
+* Text:
+  * Add support for position and overlapping start/end times in SSA/ASS
+    subtitles ([#6320](https://github.com/google/ExoPlayer/issues/6320)).
+  * Require an end time or duration for SubRip (SRT) and SubStation Alpha
+    (SSA/ASS) subtitles. This applies to both sidecar files & subtitles
+    [embedded in Matroska streams](https://matroska.org/technical/specs/subtitles/index.html).
+* UI:
+  * Make showing and hiding player controls accessible to TalkBack in
+    `PlayerView`.
+  * Rename `spherical_view` surface type to `spherical_gl_surface_view`.
+  * Make it easier to override the shuffle, repeat, fullscreen, VR and small
+    notification icon assets
+    ([#6709](https://github.com/google/ExoPlayer/issues/6709)).
+* Analytics:
+  * Remove `AnalyticsCollector.Factory`. Instances should be created directly,
+    and the `Player` should be set by calling `AnalyticsCollector.setPlayer`.
+  * Add `PlaybackStatsListener` to collect `PlaybackStats` for analysis and
+    analytics reporting.
+* DataSource
+  * Add `DataSpec.httpRequestHeaders` to support setting per-request headers for
+    HTTP and HTTPS.
+  * Remove the `DataSpec.FLAG_ALLOW_ICY_METADATA` flag. Use is replaced by
+    setting the `IcyHeaders.REQUEST_HEADER_ENABLE_METADATA_NAME` header in
+    `DataSpec.httpRequestHeaders`.
+  * Fail more explicitly when local file URIs contain invalid parts (e.g. a
+    fragment) ([#6470](https://github.com/google/ExoPlayer/issues/6470)).
+* DASH: Support negative @r values in segment timelines
+  ([#1787](https://github.com/google/ExoPlayer/issues/1787)).
+* HLS:
+  * Use peak bitrate rather than average bitrate for adaptive track selection.
+  * Fix issue where streams could get stuck in an infinite buffering state
+    after a postroll ad
+    ([#6314](https://github.com/google/ExoPlayer/issues/6314)).
+* Matroska: Support lacing in Blocks
+  ([#3026](https://github.com/google/ExoPlayer/issues/3026)).
+* AV1 extension:
+  * New in this release. The AV1 extension allows use of the
+    [libgav1 software decoder](https://chromium.googlesource.com/codecs/libgav1/)
+    in ExoPlayer. You can read more about playing AV1 videos with ExoPlayer
+    [here](https://medium.com/google-exoplayer/playing-av1-videos-with-exoplayer-a7cb19bedef9).
+* VP9 extension:
+  * Update to use NDK r20.
+  * Rename `VpxVideoSurfaceView` to `VideoDecoderSurfaceView` and move it to the
+    core library.
+  * Move `LibvpxVideoRenderer.MSG_SET_OUTPUT_BUFFER_RENDERER` to
+    `C.MSG_SET_OUTPUT_BUFFER_RENDERER`.
+  * Use `VideoDecoderRenderer` as an implementation of
+    `VideoDecoderOutputBufferRenderer`, instead of `VideoDecoderSurfaceView`.
+* Flac extension: Update to use NDK r20.
+* Opus extension: Update to use NDK r20.
+* FFmpeg extension:
+  * Update to use NDK r20.
+  * Update to use FFmpeg version 4.2. It is necessary to rebuild the native part
+    of the extension after this change, following the instructions in the
+    extension's readme.
+* MediaSession extension: Add `MediaSessionConnector.setCaptionCallback` to
+  support `ACTION_SET_CAPTIONING_ENABLED` events.
+* GVR extension: This extension is now deprecated.
+* Demo apps:
+  * Add [SurfaceControl demo app](https://github.com/google/ExoPlayer/tree/r2.11.0/demos/surface)
+    to show how to use the Android 10 `SurfaceControl` API with ExoPlayer
+    ([#677](https://github.com/google/ExoPlayer/issues/677)).
+  * Add support for subtitle files to the
+    [Main demo app](https://github.com/google/ExoPlayer/tree/r2.11.0/demos/main)
+    ([#5523](https://github.com/google/ExoPlayer/issues/5523)).
+  * Remove the IMA demo app. IMA functionality is demonstrated by the
+    [main demo app](https://github.com/google/ExoPlayer/tree/r2.11.0/demos/main).
+  * Add basic DRM support to the
+    [Cast demo app](https://github.com/google/ExoPlayer/tree/r2.11.0/demos/cast).
+* TestUtils: Publish the `testutils` module to simplify unit testing with
+  ExoPlayer ([#6267](https://github.com/google/ExoPlayer/issues/6267)).
+* IMA extension: Remove `AdsManager` listeners on release to avoid leaking an
+  `AdEventListener` provided by the app
+  ([#6687](https://github.com/google/ExoPlayer/issues/6687)).
+
 ### 2.10.8 (2019-11-19) ###
 
 * E-AC3 JOC
@@ -23,7 +185,7 @@
 * MediaSession extension: Update shuffle and repeat modes when playback state
   is invalidated ([#6582](https://github.com/google/ExoPlayer/issues/6582)).
 * Fix the start of audio getting truncated when transitioning to a new
-  item in a playlist of opus streams.
+  item in a playlist of Opus streams.
 
 ### 2.10.6 (2019-10-17) ###
 
@@ -264,6 +426,7 @@
   * Update `TrackSelection.Factory` interface to support creating all track
     selections together.
   * Allow to specify a selection reason for a `SelectionOverride`.
+  * Select audio track based on system language if no preference is provided.
   * When no text language preference matches, only select forced text tracks
     whose language matches the selected audio language.
 * UI:
@@ -592,7 +755,7 @@
     and `AnalyticsListener` callbacks
     ([#4361](https://github.com/google/ExoPlayer/issues/4361) and
     [#4615](https://github.com/google/ExoPlayer/issues/4615)).
-* UI components:
+* UI:
   * Add option to `PlayerView` to show buffering view when playWhenReady is
     false ([#4304](https://github.com/google/ExoPlayer/issues/4304)).
   * Allow any `Drawable` to be used as `PlayerView` default artwork.
@@ -748,7 +911,7 @@
 * OkHttp extension: Fix to correctly include response headers in thrown
   `InvalidResponseCodeException`s.
 * Add possibility to cancel `PlayerMessage`s.
-* UI components:
+* UI:
   * Add `PlayerView.setKeepContentOnPlayerReset` to keep the currently displayed
     video frame or media artwork visible when the player is reset
     ([#2843](https://github.com/google/ExoPlayer/issues/2843)).
@@ -798,7 +961,7 @@
   * Support live stream clipping with `ClippingMediaSource`.
   * Allow setting tags for all media sources in their factories. The tag of the
     current window can be retrieved with `Player.getCurrentTag`.
-* UI components:
+* UI:
   * Add support for displaying error messages and a buffering spinner in
     `PlayerView`.
   * Add support for listening to `AspectRatioFrameLayout`'s aspect ratio update
@@ -962,7 +1125,7 @@
     `SsMediaSource.Factory`, and `MergingMediaSource`.
   * Play out existing buffer before retrying for progressive live streams
     ([#1606](https://github.com/google/ExoPlayer/issues/1606)).
-* UI components:
+* UI:
   * Generalized player and control views to allow them to bind with any
     `Player`, and renamed them to `PlayerView` and `PlayerControlView`
     respectively.

constants.gradle

@@ -13,17 +13,30 @@
 // limitations under the License.
 project.ext {
     // ExoPlayer version and version code.
-    releaseVersion = '2.10.8'
-    releaseVersionCode = 2010008
+    releaseVersion = '2.11.0'
+    releaseVersionCode = 2011000
     minSdkVersion = 16
-    targetSdkVersion = 28
-    compileSdkVersion = 28
+    appTargetSdkVersion = 29
+    targetSdkVersion = 28 // TODO: Bump once b/143232359 is resolved
+    compileSdkVersion = 29
     dexmakerVersion = '2.21.0'
+    guavaVersion = '23.5-android'
     mockitoVersion = '2.25.0'
-    robolectricVersion = '4.2'
+    robolectricVersion = '4.3'
     autoValueVersion = '1.6'
+    autoServiceVersion = '1.0-rc4'
     checkerframeworkVersion = '2.5.0'
-    androidXTestVersion = '1.1.0'
+    jsr305Version = '3.0.2'
+    kotlinAnnotationsVersion = '1.3.31'
+    androidxAnnotationVersion = '1.1.0'
+    androidxAppCompatVersion = '1.1.0'
+    androidxCollectionVersion = '1.1.0'
+    androidxMediaVersion = '1.0.1'
+    androidxTestCoreVersion = '1.2.0'
+    androidxTestJUnitVersion = '1.1.1'
+    androidxTestRunnerVersion = '1.2.0'
+    androidxTestRulesVersion = '1.2.0'
+    truthVersion = '0.44'
     modulePrefix = ':'
     if (gradle.ext.has('exoplayerModulePrefix')) {
         modulePrefix += gradle.ext.exoplayerModulePrefix

core_settings.gradle

@@ -24,7 +24,7 @@ include modulePrefix + 'library-hls'
 include modulePrefix + 'library-smoothstreaming'
 include modulePrefix + 'library-ui'
 include modulePrefix + 'testutils'
-include modulePrefix + 'testutils-robolectric'
+include modulePrefix + 'extension-av1'
 include modulePrefix + 'extension-ffmpeg'
 include modulePrefix + 'extension-flac'
 include modulePrefix + 'extension-gvr'
@@ -47,7 +47,7 @@ project(modulePrefix + 'library-hls').projectDir = new File(rootDir, 'library/hl
 project(modulePrefix + 'library-smoothstreaming').projectDir = new File(rootDir, 'library/smoothstreaming')
 project(modulePrefix + 'library-ui').projectDir = new File(rootDir, 'library/ui')
 project(modulePrefix + 'testutils').projectDir = new File(rootDir, 'testutils')
-project(modulePrefix + 'testutils-robolectric').projectDir = new File(rootDir, 'testutils_robolectric')
+project(modulePrefix + 'extension-av1').projectDir = new File(rootDir, 'extensions/av1')
 project(modulePrefix + 'extension-ffmpeg').projectDir = new File(rootDir, 'extensions/ffmpeg')
 project(modulePrefix + 'extension-flac').projectDir = new File(rootDir, 'extensions/flac')
 project(modulePrefix + 'extension-gvr').projectDir = new File(rootDir, 'extensions/gvr')

demos/cast/build.gradle

@@ -26,7 +26,7 @@ android {
         versionName project.ext.releaseVersion
         versionCode project.ext.releaseVersionCode
         minSdkVersion project.ext.minSdkVersion
-        targetSdkVersion project.ext.targetSdkVersion
+        targetSdkVersion project.ext.appTargetSdkVersion
     }
 
     buildTypes {
@@ -56,10 +56,9 @@ dependencies {
     implementation project(modulePrefix + 'library-smoothstreaming')
     implementation project(modulePrefix + 'library-ui')
     implementation project(modulePrefix + 'extension-cast')
-    implementation 'com.google.android.material:material:1.0.0'
-    implementation 'androidx.legacy:legacy-support-v4:1.0.0'
-    implementation 'androidx.appcompat:appcompat:1.0.2'
+    implementation 'androidx.appcompat:appcompat:' + androidxAppCompatVersion
     implementation 'androidx.recyclerview:recyclerview:1.0.0'
+    implementation 'com.google.android.material:material:1.0.0'
 }
 
 apply plugin: 'com.google.android.gms.strict-version-matcher-plugin'