Add plumbing for decoderReleased analytics events

A subsequent CL will plumb a release reason through these
event paths.

PiperOrigin-RevId: 338655603

library/core/src/main/java/com/google/android/exoplayer2/Renderer.java

@@ -215,9 +215,9 @@ public interface Renderer extends PlayerMessage.Target {
   @IntDef({STATE_DISABLED, STATE_ENABLED, STATE_STARTED})
   @IntDef({STATE_DISABLED, STATE_ENABLED, STATE_STARTED})
   @interface State {}
   @interface State {}
   /**
   /**
-   * The renderer is disabled. A renderer in this state may hold resources that it requires for
-   * rendering (e.g. media decoders), for use if it's subsequently enabled. {@link #reset()} can be
-   * called to force the renderer to release these resources.
+   * The renderer is disabled. A renderer in this state will not proactively acquire resources that
+   * it requires for rendering (e.g., media decoders), but may continue to hold any that it already
+   * has. {@link #reset()} can be called to force the renderer to release such resources.
    */
    */
   int STATE_DISABLED = 0;
   int STATE_DISABLED = 0;
   /**
   /**

library/core/src/main/java/com/google/android/exoplayer2/SimpleExoPlayer.java

@@ -2286,6 +2286,13 @@ public class SimpleExoPlayer extends BasePlayer
     }
     }
 
 
     @Override
     @Override
+    public void onVideoDecoderReleased(String decoderName) {
+      for (VideoRendererEventListener videoDebugListener : videoDebugListeners) {
+        videoDebugListener.onVideoDecoderReleased(decoderName);
+      }
+    }
+
+    @Override
     public void onVideoDisabled(DecoderCounters counters) {
     public void onVideoDisabled(DecoderCounters counters) {
       for (VideoRendererEventListener videoDebugListener : videoDebugListeners) {
       for (VideoRendererEventListener videoDebugListener : videoDebugListeners) {
         videoDebugListener.onVideoDisabled(counters);
         videoDebugListener.onVideoDisabled(counters);
@@ -2352,6 +2359,13 @@ public class SimpleExoPlayer extends BasePlayer
     }
     }
 
 
     @Override
     @Override
+    public void onAudioDecoderReleased(String decoderName) {
+      for (AudioRendererEventListener audioDebugListener : audioDebugListeners) {
+        audioDebugListener.onAudioDecoderReleased(decoderName);
+      }
+    }
+
+    @Override
     public void onAudioDisabled(DecoderCounters counters) {
     public void onAudioDisabled(DecoderCounters counters) {
       for (AudioRendererEventListener audioDebugListener : audioDebugListeners) {
       for (AudioRendererEventListener audioDebugListener : audioDebugListeners) {
         audioDebugListener.onAudioDisabled(counters);
         audioDebugListener.onAudioDisabled(counters);

library/core/src/main/java/com/google/android/exoplayer2/analytics/AnalyticsCollector.java

@@ -220,6 +220,12 @@ public class AnalyticsCollector
             listener.onAudioUnderrun(eventTime, bufferSize, bufferSizeMs, elapsedSinceLastFeedMs));
             listener.onAudioUnderrun(eventTime, bufferSize, bufferSizeMs, elapsedSinceLastFeedMs));
   }
   }
 
 
+  @Override
+  public final void onAudioDecoderReleased(String decoderName) {
+    EventTime eventTime = generateReadingMediaPeriodEventTime();
+    listeners.sendEvent(listener -> listener.onAudioDecoderReleased(eventTime, decoderName));
+  }
+
   @SuppressWarnings("deprecation")
   @SuppressWarnings("deprecation")
   @Override
   @Override
   public final void onAudioDisabled(DecoderCounters counters) {
   public final void onAudioDisabled(DecoderCounters counters) {
@@ -307,6 +313,12 @@ public class AnalyticsCollector
     listeners.sendEvent(listener -> listener.onDroppedVideoFrames(eventTime, count, elapsedMs));
     listeners.sendEvent(listener -> listener.onDroppedVideoFrames(eventTime, count, elapsedMs));
   }
   }
 
 
+  @Override
+  public final void onVideoDecoderReleased(String decoderName) {
+    EventTime eventTime = generateReadingMediaPeriodEventTime();
+    listeners.sendEvent(listener -> listener.onVideoDecoderReleased(eventTime, decoderName));
+  }
+
   @SuppressWarnings("deprecation")
   @SuppressWarnings("deprecation")
   @Override
   @Override
   public final void onVideoDisabled(DecoderCounters counters) {
   public final void onVideoDisabled(DecoderCounters counters) {

library/core/src/main/java/com/google/android/exoplayer2/analytics/AnalyticsListener.java

@@ -513,6 +513,14 @@ public interface AnalyticsListener {
       EventTime eventTime, int bufferSize, long bufferSizeMs, long elapsedSinceLastFeedMs) {}
       EventTime eventTime, int bufferSize, long bufferSizeMs, long elapsedSinceLastFeedMs) {}
 
 
   /**
   /**
+   * Called when an audio renderer releases a decoder.
+   *
+   * @param eventTime The event time.
+   * @param decoderName The decoder that was released.
+   */
+  default void onAudioDecoderReleased(EventTime eventTime, String decoderName) {}
+
+  /**
    * Called when an audio renderer is disabled.
    * Called when an audio renderer is disabled.
    *
    *
    * @param eventTime The event time.
    * @param eventTime The event time.
@@ -601,6 +609,14 @@ public interface AnalyticsListener {
   default void onDroppedVideoFrames(EventTime eventTime, int droppedFrames, long elapsedMs) {}
   default void onDroppedVideoFrames(EventTime eventTime, int droppedFrames, long elapsedMs) {}
 
 
   /**
   /**
+   * Called when a video renderer releases a decoder.
+   *
+   * @param eventTime The event time.
+   * @param decoderName The decoder that was released.
+   */
+  default void onVideoDecoderReleased(EventTime eventTime, String decoderName) {}
+
+  /**
    * Called when a video renderer is disabled.
    * Called when a video renderer is disabled.
    *
    *
    * @param eventTime The event time.
    * @param eventTime The event time.

library/core/src/main/java/com/google/android/exoplayer2/audio/AudioRendererEventListener.java

@@ -88,6 +88,13 @@ public interface AudioRendererEventListener {
   default void onAudioUnderrun(int bufferSize, long bufferSizeMs, long elapsedSinceLastFeedMs) {}
   default void onAudioUnderrun(int bufferSize, long bufferSizeMs, long elapsedSinceLastFeedMs) {}
 
 
   /**
   /**
+   * Called when a decoder is released.
+   *
+   * @param decoderName The decoder that was released.
+   */
+  default void onAudioDecoderReleased(String decoderName) {}
+
+  /**
    * Called when the renderer is disabled.
    * Called when the renderer is disabled.
    *
    *
    * @param counters {@link DecoderCounters} that were updated by the renderer.
    * @param counters {@link DecoderCounters} that were updated by the renderer.
@@ -184,6 +191,13 @@ public interface AudioRendererEventListener {
       }
       }
     }
     }
 
 
+    /** Invokes {@link AudioRendererEventListener#onAudioDecoderReleased(String)}. */
+    public void decoderReleased(String decoderName) {
+      if (handler != null) {
+        handler.post(() -> castNonNull(listener).onAudioDecoderReleased(decoderName));
+      }
+    }
+
     /** Invokes {@link AudioRendererEventListener#onAudioDisabled(DecoderCounters)}. */
     /** Invokes {@link AudioRendererEventListener#onAudioDisabled(DecoderCounters)}. */
     public void disabled(DecoderCounters counters) {
     public void disabled(DecoderCounters counters) {
       counters.ensureUpdated();
       counters.ensureUpdated();

library/core/src/main/java/com/google/android/exoplayer2/audio/DecoderAudioRenderer.java

@@ -632,9 +632,10 @@ public abstract class DecoderAudioRenderer<
     decoderReinitializationState = REINITIALIZATION_STATE_NONE;
     decoderReinitializationState = REINITIALIZATION_STATE_NONE;
     decoderReceivedBuffers = false;
     decoderReceivedBuffers = false;
     if (decoder != null) {
     if (decoder != null) {
+      decoderCounters.decoderReleaseCount++;
       decoder.release();
       decoder.release();
+      eventDispatcher.decoderReleased(decoder.getName());
       decoder = null;
       decoder = null;
-      decoderCounters.decoderReleaseCount++;
     }
     }
     setDecoderDrmSession(null);
     setDecoderDrmSession(null);
   }
   }

library/core/src/main/java/com/google/android/exoplayer2/audio/MediaCodecAudioRenderer.java

@@ -392,6 +392,11 @@ public class MediaCodecAudioRenderer extends MediaCodecRenderer implements Media
   }
   }
 
 
   @Override
   @Override
+  protected void onCodecReleased(String name) {
+    eventDispatcher.decoderReleased(name);
+  }
+
+  @Override
   protected void onInputFormatChanged(FormatHolder formatHolder) throws ExoPlaybackException {
   protected void onInputFormatChanged(FormatHolder formatHolder) throws ExoPlaybackException {
     super.onInputFormatChanged(formatHolder);
     super.onInputFormatChanged(formatHolder);
     eventDispatcher.inputFormatChanged(formatHolder.format);
     eventDispatcher.inputFormatChanged(formatHolder.format);

library/core/src/main/java/com/google/android/exoplayer2/mediacodec/MediaCodecRenderer.java

@@ -745,6 +745,7 @@ public abstract class MediaCodecRenderer extends BaseRenderer {
       if (codec != null) {
       if (codec != null) {
         decoderCounters.decoderReleaseCount++;
         decoderCounters.decoderReleaseCount++;
         codec.release();
         codec.release();
+        onCodecReleased(codecInfo.name);
       }
       }
     } finally {
     } finally {
       codec = null;
       codec = null;
@@ -1385,6 +1386,17 @@ public abstract class MediaCodecRenderer extends BaseRenderer {
   }
   }
 
 
   /**
   /**
+   * Called when a {@link MediaCodec} has been released.
+   *
+   * <p>The default implementation is a no-op.
+   *
+   * @param name The name of the codec that was released.
+   */
+  protected void onCodecReleased(String name) {
+    // Do nothing.
+  }
+
+  /**
    * Called when a new {@link Format} is read from the upstream {@link MediaPeriod}.
    * Called when a new {@link Format} is read from the upstream {@link MediaPeriod}.
    *
    *
    * @param formatHolder A {@link FormatHolder} that holds the new {@link Format}.
    * @param formatHolder A {@link FormatHolder} that holds the new {@link Format}.

library/core/src/main/java/com/google/android/exoplayer2/util/EventLogger.java

@@ -343,6 +343,11 @@ public class EventLogger implements AnalyticsListener {
   }
   }
 
 
   @Override
   @Override
+  public void onAudioDecoderReleased(EventTime eventTime, String decoderName) {
+    logd(eventTime, "audioDecoderReleased", decoderName);
+  }
+
+  @Override
   public void onAudioDisabled(EventTime eventTime, DecoderCounters counters) {
   public void onAudioDisabled(EventTime eventTime, DecoderCounters counters) {
     logd(eventTime, "audioDisabled");
     logd(eventTime, "audioDisabled");
   }
   }
@@ -398,6 +403,11 @@ public class EventLogger implements AnalyticsListener {
   }
   }
 
 
   @Override
   @Override
+  public void onVideoDecoderReleased(EventTime eventTime, String decoderName) {
+    logd(eventTime, "videoDecoderReleased", decoderName);
+  }
+
+  @Override
   public void onVideoDisabled(EventTime eventTime, DecoderCounters counters) {
   public void onVideoDisabled(EventTime eventTime, DecoderCounters counters) {
     logd(eventTime, "videoDisabled");
     logd(eventTime, "videoDisabled");
   }
   }

library/core/src/main/java/com/google/android/exoplayer2/video/DecoderVideoRenderer.java

@@ -312,22 +312,6 @@ public abstract class DecoderVideoRenderer extends BaseRenderer {
   }
   }
 
 
   /**
   /**
-   * Called when a decoder has been created and configured.
-   *
-   * <p>The default implementation is a no-op.
-   *
-   * @param name The name of the decoder that was initialized.
-   * @param initializedTimestampMs {@link SystemClock#elapsedRealtime()} when initialization
-   *     finished.
-   * @param initializationDurationMs The time taken to initialize the decoder, in milliseconds.
-   */
-  @CallSuper
-  protected void onDecoderInitialized(
-      String name, long initializedTimestampMs, long initializationDurationMs) {
-    eventDispatcher.decoderInitialized(name, initializedTimestampMs, initializationDurationMs);
-  }
-
-  /**
    * Flushes the decoder.
    * Flushes the decoder.
    *
    *
    * @throws ExoPlaybackException If an error occurs reinitializing a decoder.
    * @throws ExoPlaybackException If an error occurs reinitializing a decoder.
@@ -358,9 +342,10 @@ public abstract class DecoderVideoRenderer extends BaseRenderer {
     decoderReceivedBuffers = false;
     decoderReceivedBuffers = false;
     buffersInCodecCount = 0;
     buffersInCodecCount = 0;
     if (decoder != null) {
     if (decoder != null) {
+      decoderCounters.decoderReleaseCount++;
       decoder.release();
       decoder.release();
+      eventDispatcher.decoderReleased(decoder.getName());
       decoder = null;
       decoder = null;
-      decoderCounters.decoderReleaseCount++;
     }
     }
     setDecoderDrmSession(null);
     setDecoderDrmSession(null);
   }
   }
@@ -690,7 +675,7 @@ public abstract class DecoderVideoRenderer extends BaseRenderer {
       decoder = createDecoder(inputFormat, mediaCrypto);
       decoder = createDecoder(inputFormat, mediaCrypto);
       setDecoderOutputMode(outputMode);
       setDecoderOutputMode(outputMode);
       long decoderInitializedTimestamp = SystemClock.elapsedRealtime();
       long decoderInitializedTimestamp = SystemClock.elapsedRealtime();
-      onDecoderInitialized(
+      eventDispatcher.decoderInitialized(
           decoder.getName(),
           decoder.getName(),
           decoderInitializedTimestamp,
           decoderInitializedTimestamp,
           decoderInitializedTimestamp - decoderInitializingTimestamp);
           decoderInitializedTimestamp - decoderInitializingTimestamp);

library/core/src/main/java/com/google/android/exoplayer2/video/MediaCodecVideoRenderer.java

@@ -617,6 +617,11 @@ public class MediaCodecVideoRenderer extends MediaCodecRenderer {
   }
   }
 
 
   @Override
   @Override
+  protected void onCodecReleased(String name) {
+    eventDispatcher.decoderReleased(name);
+  }
+
+  @Override
   protected void onInputFormatChanged(FormatHolder formatHolder) throws ExoPlaybackException {
   protected void onInputFormatChanged(FormatHolder formatHolder) throws ExoPlaybackException {
     super.onInputFormatChanged(formatHolder);
     super.onInputFormatChanged(formatHolder);
     eventDispatcher.inputFormatChanged(formatHolder.format);
     eventDispatcher.inputFormatChanged(formatHolder.format);

library/core/src/main/java/com/google/android/exoplayer2/video/VideoRendererEventListener.java

@@ -121,6 +121,13 @@ public interface VideoRendererEventListener {
   default void onRenderedFirstFrame(@Nullable Surface surface) {}
   default void onRenderedFirstFrame(@Nullable Surface surface) {}
 
 
   /**
   /**
+   * Called when a decoder is released.
+   *
+   * @param decoderName The decoder that was released.
+   */
+  default void onVideoDecoderReleased(String decoderName) {}
+
+  /**
    * Called when the renderer is disabled.
    * Called when the renderer is disabled.
    *
    *
    * @param counters {@link DecoderCounters} that were updated by the renderer.
    * @param counters {@link DecoderCounters} that were updated by the renderer.
@@ -211,6 +218,13 @@ public interface VideoRendererEventListener {
       }
       }
     }
     }
 
 
+    /** Invokes {@link VideoRendererEventListener#onVideoDecoderReleased(String)}. */
+    public void decoderReleased(String decoderName) {
+      if (handler != null) {
+        handler.post(() -> castNonNull(listener).onVideoDecoderReleased(decoderName));
+      }
+    }
+
     /** Invokes {@link VideoRendererEventListener#onVideoDisabled(DecoderCounters)}. */
     /** Invokes {@link VideoRendererEventListener#onVideoDisabled(DecoderCounters)}. */
     public void disabled(DecoderCounters counters) {
     public void disabled(DecoderCounters counters) {
       counters.ensureUpdated();
       counters.ensureUpdated();