From b2eaed338576c3a4fb68bdfde0558cb5678e2a0a Mon Sep 17 00:00:00 2001 From: Brian Lindahl Date: Fri, 9 Jun 2023 10:45:19 -0600 Subject: [PATCH] Update documentation for MediaCodec onFrameRendered Bug: 234833109 Test: build Change-Id: I1e8dac2f9d58b6b0f79e7f9b506425b15cf26533 --- media/java/android/media/MediaCodec.java | 8 ++++++-- 1 file changed, 6 insertions(+), 2 deletions(-) diff --git a/media/java/android/media/MediaCodec.java b/media/java/android/media/MediaCodec.java index 32680dae75b95..dc25a5140934a 100644 --- a/media/java/android/media/MediaCodec.java +++ b/media/java/android/media/MediaCodec.java @@ -4888,8 +4888,12 @@ final public class MediaCodec { * Called when an output frame has rendered on the output surface. *

* Note: This callback is for informational purposes only: to get precise - * render timing samples, and can be significantly delayed and batched. Some frames may have - * been rendered even if there was no callback generated. + * render timing samples, and can be significantly delayed and batched. Starting with + * Android {@link android.os.Build.VERSION_CODES#UPSIDE_DOWN_CAKE}, a callback will always + * be received for each rendered frame providing the MediaCodec is still in the executing + * state when the callback is dispatched. Prior to Android + * {@link android.os.Build.VERSION_CODES#UPSIDE_DOWN_CAKE}, some frames may have been + * rendered even if there was no callback generated. * * @param codec the MediaCodec instance * @param presentationTimeUs the presentation time (media time) of the frame rendered.