Donate to e Foundation | Murena handsets with /e/OS | Own a part of Murena! Learn more

Commit 09ca8217 authored by Treehugger Robot's avatar Treehugger Robot Committed by Automerger Merge Worker
Browse files

Merge "MediaCodec: fix javadoc on onMetricsFlushed" into main am: f06c5627 

Original change: https://android-review.googlesource.com/c/platform/frameworks/base/+/3440359



Change-Id: I093ac91822504c3b20acc8e2a9d6e698a2e4a5b9
Signed-off-by: default avatarAutomerger Merge Worker <android-build-automerger-merge-worker@system.gserviceaccount.com>
parents 2af482fa f06c5627

media/java/android/media/MediaCodec.java

+14 −7
Original line number Diff line number Diff line
@@ -5866,14 +5866,21 @@ final public class MediaCodec { 
                @NonNull MediaCodec codec, @NonNull MediaFormat format);



        /**

         * Called when the metrics for this codec have been flushed due to the

         * start of a new subsession.

         * Called when the metrics for this codec have been flushed "mid-stream"

         * due to the start of a new subsession during execution.

         * <p>

         * This can happen when the codec is reconfigured after stop(), or

         * mid-stream e.g. if the video size changes. When this happens, the

         * metrics for the previous subsession are flushed, and

         * {@link MediaCodec#getMetrics} will return the metrics for the

         * new subsession. This happens just before the {@link Callback#onOutputFormatChanged}

         * A new codec subsession normally starts when the codec is reconfigured

         * after stop(), but it can also happen mid-stream e.g. if the video size

         * changes. When this happens, the metrics for the previous subsession

         * are flushed, and {@link MediaCodec#getMetrics} will return the metrics

         * for the new subsession.

         * <p>

         * For subsessions that begin due to a reconfiguration, the metrics for

         * the prior subsession can be retrieved via {@link MediaCodec#getMetrics}

         * prior to calling {@link #configure}.

         * <p>

         * When a new subsession begins "mid-stream", the metrics for the prior

         * subsession are flushed just before the {@link Callback#onOutputFormatChanged}

         * event, so this <b>optional</b> callback is provided to be able to

         * capture the final metrics for the previous subsession.

         *