Android/frameworks_base
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

Merge "media: clarify frame dropping behavior for decoder output" into qt-dev

Browse Source 
am: cfb6f93443

Change-Id: I069b15b05fc1032177c4874cd7ff2d2041076e22
This commit is contained in:
Lajos Molnar
2019-06-21 12:50:37 -07:00
committed by android-build-merger
parent 7cfda2b91c cfb6f93443
commit ba0ce1d6a9
1 changed files with 10 additions and 0 deletions
Download Patch File Download Diff File Expand all files Collapse all files

10
media/java/android/media/MediaCodec.java
View File

@@ -644,6 +644,16 @@ import java.util.concurrent.locks.ReentrantLock;
<p>
Also since {@link android.os.Build.VERSION_CODES#M}, you can change the output Surface
dynamically using {@link #setOutputSurface setOutputSurface}.
<p>
When rendering output to a Surface, the Surface may be configured to drop excessive frames (that
are not consumed by the Surface in a timely manner). Or it may be configured to not drop excessive
frames. In the latter mode if the Surface is not consuming output frames fast enough, it will
eventually block the decoder. Prior to {@link android.os.Build.VERSION_CODES#Q} the exact behavior
was undefined, with the exception that View surfaces (SuerfaceView or TextureView) always dropped
excessive frames. Since {@link android.os.Build.VERSION_CODES#Q} the default behavior is to drop
excessive frames. Applications can opt out of this behavior for non-View surfaces (such as
ImageReader or SurfaceTexture) by targeting SDK {@link android.os.Build.VERSION_CODES#Q} and
setting the key {@code "allow-frame-drop"} to {@code 0} in their configure format.
<h4>Transformations When Rendering onto Surface</h4>