# DebugTraceUtil

Artifact: [androidx.media3:media3-effect](https://developer.android.com/jetpack/androidx/releases/media3) [View Source](https://cs.android.com/search?q=file:androidx/media3/effect/DebugTraceUtil.java+class:androidx.media3.effect.DebugTraceUtil)

*** ** * ** ***

<br />

```
@UnstableApi
public final class DebugTraceUtil
```

<br />

*** ** * ** ***

A debugging tracing utility. Debug logging is disabled at compile time by default.

## Summary

| ### Nested types |
|---|
| `@https://developer.android.com/reference/java/lang/annotation/Documented.html @https://developer.android.com/reference/java/lang/annotation/Retention.html(value = https://developer.android.com/reference/java/lang/annotation/RetentionPolicy.html#SOURCE) @https://developer.android.com/reference/androidx/annotation/StringDef(value = ) @https://developer.android.com/reference/java/lang/annotation/Target.html(value = https://developer.android.com/reference/java/lang/annotation/ElementType.html#TYPE_USE) public annotation https://developer.android.com/reference/androidx/media3/effect/DebugTraceUtil.Component` Components logged by `https://developer.android.com/reference/androidx/media3/effect/DebugTraceUtil#logEvent(java.lang.String,java.lang.String,long,java.lang.String,java.lang.Object...)`. |
| `@https://developer.android.com/reference/java/lang/annotation/Documented.html @https://developer.android.com/reference/java/lang/annotation/Retention.html(value = https://developer.android.com/reference/java/lang/annotation/RetentionPolicy.html#SOURCE) @https://developer.android.com/reference/androidx/annotation/StringDef(value = ) @https://developer.android.com/reference/java/lang/annotation/Target.html(value = https://developer.android.com/reference/java/lang/annotation/ElementType.html#TYPE_USE) public annotation https://developer.android.com/reference/androidx/media3/effect/DebugTraceUtil.Event` Events logged by `https://developer.android.com/reference/androidx/media3/effect/DebugTraceUtil#logEvent(java.lang.String,java.lang.String,long,java.lang.String,java.lang.Object...)`. |

| ### Constants |
|---|---|
| `static final https://developer.android.com/reference/java/lang/String.html` | `https://developer.android.com/reference/androidx/media3/effect/DebugTraceUtil#COMPONENT_ASSET_LOADER() = "AssetLoader"` |
| `static final https://developer.android.com/reference/java/lang/String.html` | `https://developer.android.com/reference/androidx/media3/effect/DebugTraceUtil#COMPONENT_AUDIO_DECODER() = "AudioDecoder"` |
| `static final https://developer.android.com/reference/java/lang/String.html` | `https://developer.android.com/reference/androidx/media3/effect/DebugTraceUtil#COMPONENT_AUDIO_ENCODER() = "AudioEncoder"` |
| `static final https://developer.android.com/reference/java/lang/String.html` | `https://developer.android.com/reference/androidx/media3/effect/DebugTraceUtil#COMPONENT_AUDIO_GRAPH() = "AudioGraph"` |
| `static final https://developer.android.com/reference/java/lang/String.html` | `https://developer.android.com/reference/androidx/media3/effect/DebugTraceUtil#COMPONENT_AUDIO_GRAPH_INPUT() = "AudioGraphInput"` |
| `static final https://developer.android.com/reference/java/lang/String.html` | `https://developer.android.com/reference/androidx/media3/effect/DebugTraceUtil#COMPONENT_AUDIO_GRAPH_INPUT_AUDIO_SINK() = "AGIAudioSink"` |
| `static final https://developer.android.com/reference/java/lang/String.html` | `https://developer.android.com/reference/androidx/media3/effect/DebugTraceUtil#COMPONENT_AUDIO_MIXER() = "AudioMixer"` |
| `static final https://developer.android.com/reference/java/lang/String.html` | `https://developer.android.com/reference/androidx/media3/effect/DebugTraceUtil#COMPONENT_BITMAP_TEXTURE_MANAGER() = "BitmapTextureManager"` |
| `static final https://developer.android.com/reference/java/lang/String.html` | `https://developer.android.com/reference/androidx/media3/effect/DebugTraceUtil#COMPONENT_COMPOSITION_PLAYER() = "CompositionPlayer"` |
| `static final https://developer.android.com/reference/java/lang/String.html` | `https://developer.android.com/reference/androidx/media3/effect/DebugTraceUtil#COMPONENT_COMPOSITOR() = "Compositor"` |
| `static final https://developer.android.com/reference/java/lang/String.html` | `https://developer.android.com/reference/androidx/media3/effect/DebugTraceUtil#COMPONENT_EXTERNAL_TEXTURE_MANAGER() = "ExternalTextureManager"` |
| `static final https://developer.android.com/reference/java/lang/String.html` | `https://developer.android.com/reference/androidx/media3/effect/DebugTraceUtil#COMPONENT_MUXER() = "Muxer"` |
| `static final https://developer.android.com/reference/java/lang/String.html` | `https://developer.android.com/reference/androidx/media3/effect/DebugTraceUtil#COMPONENT_TEX_ID_TEXTURE_MANAGER() = "TexIdTextureManager"` |
| `static final https://developer.android.com/reference/java/lang/String.html` | `https://developer.android.com/reference/androidx/media3/effect/DebugTraceUtil#COMPONENT_TRANSFORMER_INTERNAL() = "TransformerInternal"` |
| `static final https://developer.android.com/reference/java/lang/String.html` | `https://developer.android.com/reference/androidx/media3/effect/DebugTraceUtil#COMPONENT_VFP() = "VideoFrameProcessor"` |
| `static final https://developer.android.com/reference/java/lang/String.html` | `https://developer.android.com/reference/androidx/media3/effect/DebugTraceUtil#COMPONENT_VIDEO_DECODER() = "VideoDecoder"` |
| `static final https://developer.android.com/reference/java/lang/String.html` | `https://developer.android.com/reference/androidx/media3/effect/DebugTraceUtil#COMPONENT_VIDEO_ENCODER() = "VideoEncoder"` |
| `static final https://developer.android.com/reference/java/lang/String.html` | `https://developer.android.com/reference/androidx/media3/effect/DebugTraceUtil#EVENT_ACCEPTED_INPUT() = "AcceptedInput"` |
| `static final https://developer.android.com/reference/java/lang/String.html` | `https://developer.android.com/reference/androidx/media3/effect/DebugTraceUtil#EVENT_BLOCK_INPUT() = "BlockInput"` |
| `static final https://developer.android.com/reference/java/lang/String.html` | `https://developer.android.com/reference/androidx/media3/effect/DebugTraceUtil#EVENT_CAN_WRITE_SAMPLE() = "CanWriteSample"` |
| `static final https://developer.android.com/reference/java/lang/String.html` | `https://developer.android.com/reference/androidx/media3/effect/DebugTraceUtil#EVENT_DISCONTINUITY() = "Discontinuity"` |
| `static final https://developer.android.com/reference/java/lang/String.html` | `https://developer.android.com/reference/androidx/media3/effect/DebugTraceUtil#EVENT_FLUSH() = "Flush"` |
| `static final https://developer.android.com/reference/java/lang/String.html` | `https://developer.android.com/reference/androidx/media3/effect/DebugTraceUtil#EVENT_INPUT_ENDED() = "InputEnded"` |
| `static final https://developer.android.com/reference/java/lang/String.html` | `https://developer.android.com/reference/androidx/media3/effect/DebugTraceUtil#EVENT_INPUT_FORMAT() = "InputFormat"` |
| `static final https://developer.android.com/reference/java/lang/String.html` | `https://developer.android.com/reference/androidx/media3/effect/DebugTraceUtil#EVENT_OUTPUT_ENDED() = "OutputEnded"` |
| `static final https://developer.android.com/reference/java/lang/String.html` | `https://developer.android.com/reference/androidx/media3/effect/DebugTraceUtil#EVENT_OUTPUT_FORMAT() = "OutputFormat"` |
| `static final https://developer.android.com/reference/java/lang/String.html` | `https://developer.android.com/reference/androidx/media3/effect/DebugTraceUtil#EVENT_OUTPUT_TEXTURE_RENDERED() = "OutputTextureRendered"` |
| `static final https://developer.android.com/reference/java/lang/String.html` | `https://developer.android.com/reference/androidx/media3/effect/DebugTraceUtil#EVENT_PRODUCED_OUTPUT() = "ProducedOutput"` |
| `static final https://developer.android.com/reference/java/lang/String.html` | `https://developer.android.com/reference/androidx/media3/effect/DebugTraceUtil#EVENT_QUEUE_BITMAP() = "QueueBitmap"` |
| `static final https://developer.android.com/reference/java/lang/String.html` | `https://developer.android.com/reference/androidx/media3/effect/DebugTraceUtil#EVENT_QUEUE_FRAME() = "QueueFrame"` |
| `static final https://developer.android.com/reference/java/lang/String.html` | `https://developer.android.com/reference/androidx/media3/effect/DebugTraceUtil#EVENT_QUEUE_TEXTURE() = "QueueTexture"` |
| `static final https://developer.android.com/reference/java/lang/String.html` | `https://developer.android.com/reference/androidx/media3/effect/DebugTraceUtil#EVENT_RECEIVE_END_OF_ALL_INPUT() = "ReceiveEndOfAllInput"` |
| `static final https://developer.android.com/reference/java/lang/String.html` | `https://developer.android.com/reference/androidx/media3/effect/DebugTraceUtil#EVENT_REGISTER_NEW_INPUT_STREAM() = "RegisterNewInputStream"` |
| `static final https://developer.android.com/reference/java/lang/String.html` | `https://developer.android.com/reference/androidx/media3/effect/DebugTraceUtil#EVENT_RELEASE() = "Release"` |
| `static final https://developer.android.com/reference/java/lang/String.html` | `https://developer.android.com/reference/androidx/media3/effect/DebugTraceUtil#EVENT_RENDERED_TO_OUTPUT_SURFACE() = "RenderedToOutputSurface"` |
| `static final https://developer.android.com/reference/java/lang/String.html` | `https://developer.android.com/reference/androidx/media3/effect/DebugTraceUtil#EVENT_RESET() = "Reset"` |
| `static final https://developer.android.com/reference/java/lang/String.html` | `https://developer.android.com/reference/androidx/media3/effect/DebugTraceUtil#EVENT_SEEK_TO() = "SeekTo"` |
| `static final https://developer.android.com/reference/java/lang/String.html` | `https://developer.android.com/reference/androidx/media3/effect/DebugTraceUtil#EVENT_SET_COMPOSITION() = "SetComposition"` |
| `static final https://developer.android.com/reference/java/lang/String.html` | `https://developer.android.com/reference/androidx/media3/effect/DebugTraceUtil#EVENT_SET_VIDEO_OUTPUT() = "SetVideoOutput"` |
| `static final https://developer.android.com/reference/java/lang/String.html` | `https://developer.android.com/reference/androidx/media3/effect/DebugTraceUtil#EVENT_SIGNAL_ENDED() = "SignalEnded"` |
| `static final https://developer.android.com/reference/java/lang/String.html` | `https://developer.android.com/reference/androidx/media3/effect/DebugTraceUtil#EVENT_SIGNAL_EOS() = "SignalEOS"` |
| `static final https://developer.android.com/reference/java/lang/String.html` | `https://developer.android.com/reference/androidx/media3/effect/DebugTraceUtil#EVENT_START() = "Start"` |
| `static final https://developer.android.com/reference/java/lang/String.html` | `https://developer.android.com/reference/androidx/media3/effect/DebugTraceUtil#EVENT_SURFACE_TEXTURE_INPUT() = "SurfaceTextureInput"` |
| `static final https://developer.android.com/reference/java/lang/String.html` | `https://developer.android.com/reference/androidx/media3/effect/DebugTraceUtil#EVENT_SURFACE_TEXTURE_TRANSFORM_FIX() = "SurfaceTextureTransformFix"` |
| `static final https://developer.android.com/reference/java/lang/String.html` | `https://developer.android.com/reference/androidx/media3/effect/DebugTraceUtil#EVENT_UNBLOCK_INPUT() = "UnblockInput"` |

| ### Public fields |
|---|---|
| `static boolean` | `https://developer.android.com/reference/androidx/media3/effect/DebugTraceUtil#enableTracing()` Whether to store tracing events for debug logging. |

| ### Public constructors |
|---|
| `https://developer.android.com/reference/androidx/media3/effect/DebugTraceUtil#DebugTraceUtil()()` |

| ### Public methods |
|---|---|
| `synchronized static https://developer.android.com/reference/java/lang/String.html` | `https://developer.android.com/reference/androidx/media3/effect/DebugTraceUtil#generateTraceSummary()()` Generate a summary of the logged events, containing the total number of times an event happened and the detailed log of a window of the oldest and newest events. |
| `synchronized static void` | `https://developer.android.com/reference/androidx/media3/effect/DebugTraceUtil#logCodecEvent(boolean,boolean,java.lang.String,long,java.lang.String,java.lang.Object...)( boolean isDecoder, boolean isVideo, @https://developer.android.com/reference/androidx/media3/effect/DebugTraceUtil.Event @https://developer.android.com/reference/androidx/media3/effect/DebugTraceUtil.Event https://developer.android.com/reference/java/lang/String.html eventName, long presentationTimeUs, https://developer.android.com/reference/java/lang/String.html extraFormat, Object[] extraArgs )` Logs an `https://developer.android.com/reference/androidx/media3/effect/DebugTraceUtil.Event` for a codec, if debug logging is enabled. |
| `synchronized static void` | `https://developer.android.com/reference/androidx/media3/effect/DebugTraceUtil#logEvent(java.lang.String,java.lang.String,long)( @https://developer.android.com/reference/androidx/media3/effect/DebugTraceUtil.Component @https://developer.android.com/reference/androidx/media3/effect/DebugTraceUtil.Component https://developer.android.com/reference/java/lang/String.html component, @https://developer.android.com/reference/androidx/media3/effect/DebugTraceUtil.Event @https://developer.android.com/reference/androidx/media3/effect/DebugTraceUtil.Event https://developer.android.com/reference/java/lang/String.html event, long presentationTimeUs )` Logs a new event, if debug logging is enabled. |
| `synchronized static void` | `https://developer.android.com/reference/androidx/media3/effect/DebugTraceUtil#logEvent(java.lang.String,java.lang.String,long,java.lang.String,java.lang.Object...)( @https://developer.android.com/reference/androidx/media3/effect/DebugTraceUtil.Component @https://developer.android.com/reference/androidx/media3/effect/DebugTraceUtil.Component https://developer.android.com/reference/java/lang/String.html component, @https://developer.android.com/reference/androidx/media3/effect/DebugTraceUtil.Event @https://developer.android.com/reference/androidx/media3/effect/DebugTraceUtil.Event https://developer.android.com/reference/java/lang/String.html event, long presentationTimeUs, https://developer.android.com/reference/java/lang/String.html extraFormat, Object[] extraArgs )` Logs a new event, if debug logging is enabled. |
| `synchronized static void` | `https://developer.android.com/reference/androidx/media3/effect/DebugTraceUtil#logEvent(java.lang.String,java.lang.String,java.lang.String,long,java.lang.String,java.lang.Object...)( @https://developer.android.com/reference/androidx/media3/effect/DebugTraceUtil.Component @https://developer.android.com/reference/androidx/media3/effect/DebugTraceUtil.Component https://developer.android.com/reference/java/lang/String.html component, https://developer.android.com/reference/java/lang/String.html componentId, @https://developer.android.com/reference/androidx/media3/effect/DebugTraceUtil.Event @https://developer.android.com/reference/androidx/media3/effect/DebugTraceUtil.Event https://developer.android.com/reference/java/lang/String.html event, long presentationTimeUs, https://developer.android.com/reference/java/lang/String.html extraFormat, Object[] extraArgs )` Logs a new event, if debug logging is enabled. |
| `synchronized static void` | `https://developer.android.com/reference/androidx/media3/effect/DebugTraceUtil#reset()()` |

## Constants

### COMPONENT_ASSET_LOADER

```
public static final String COMPONENT_ASSET_LOADER = "AssetLoader"
```

### COMPONENT_AUDIO_DECODER

```
public static final String COMPONENT_AUDIO_DECODER = "AudioDecoder"
```

### COMPONENT_AUDIO_ENCODER

```
public static final String COMPONENT_AUDIO_ENCODER = "AudioEncoder"
```

### COMPONENT_AUDIO_GRAPH

```
public static final String COMPONENT_AUDIO_GRAPH = "AudioGraph"
```

### COMPONENT_AUDIO_GRAPH_INPUT

```
public static final String COMPONENT_AUDIO_GRAPH_INPUT = "AudioGraphInput"
```

### COMPONENT_AUDIO_GRAPH_INPUT_AUDIO_SINK

```
public static final String COMPONENT_AUDIO_GRAPH_INPUT_AUDIO_SINK = "AGIAudioSink"
```

### COMPONENT_AUDIO_MIXER

```
public static final String COMPONENT_AUDIO_MIXER = "AudioMixer"
```

### COMPONENT_BITMAP_TEXTURE_MANAGER

```
public static final String COMPONENT_BITMAP_TEXTURE_MANAGER = "BitmapTextureManager"
```

### COMPONENT_COMPOSITION_PLAYER

```
public static final String COMPONENT_COMPOSITION_PLAYER = "CompositionPlayer"
```

### COMPONENT_COMPOSITOR

```
public static final String COMPONENT_COMPOSITOR = "Compositor"
```

### COMPONENT_EXTERNAL_TEXTURE_MANAGER

```
public static final String COMPONENT_EXTERNAL_TEXTURE_MANAGER = "ExternalTextureManager"
```

### COMPONENT_MUXER

```
public static final String COMPONENT_MUXER = "Muxer"
```

### COMPONENT_TEX_ID_TEXTURE_MANAGER

```
public static final String COMPONENT_TEX_ID_TEXTURE_MANAGER = "TexIdTextureManager"
```

### COMPONENT_TRANSFORMER_INTERNAL

```
public static final String COMPONENT_TRANSFORMER_INTERNAL = "TransformerInternal"
```

### COMPONENT_VFP

```
public static final String COMPONENT_VFP = "VideoFrameProcessor"
```

### COMPONENT_VIDEO_DECODER

```
public static final String COMPONENT_VIDEO_DECODER = "VideoDecoder"
```

### COMPONENT_VIDEO_ENCODER

```
public static final String COMPONENT_VIDEO_ENCODER = "VideoEncoder"
```

### EVENT_ACCEPTED_INPUT

```
public static final String EVENT_ACCEPTED_INPUT = "AcceptedInput"
```

### EVENT_BLOCK_INPUT

```
public static final String EVENT_BLOCK_INPUT = "BlockInput"
```

### EVENT_CAN_WRITE_SAMPLE

```
public static final String EVENT_CAN_WRITE_SAMPLE = "CanWriteSample"
```

### EVENT_DISCONTINUITY

```
public static final String EVENT_DISCONTINUITY = "Discontinuity"
```

### EVENT_FLUSH

```
public static final String EVENT_FLUSH = "Flush"
```

### EVENT_INPUT_ENDED

```
public static final String EVENT_INPUT_ENDED = "InputEnded"
```

### EVENT_INPUT_FORMAT

```
public static final String EVENT_INPUT_FORMAT = "InputFormat"
```

### EVENT_OUTPUT_ENDED

```
public static final String EVENT_OUTPUT_ENDED = "OutputEnded"
```

### EVENT_OUTPUT_FORMAT

```
public static final String EVENT_OUTPUT_FORMAT = "OutputFormat"
```

### EVENT_OUTPUT_TEXTURE_RENDERED

```
public static final String EVENT_OUTPUT_TEXTURE_RENDERED = "OutputTextureRendered"
```

### EVENT_PRODUCED_OUTPUT

```
public static final String EVENT_PRODUCED_OUTPUT = "ProducedOutput"
```

### EVENT_QUEUE_BITMAP

```
public static final String EVENT_QUEUE_BITMAP = "QueueBitmap"
```

### EVENT_QUEUE_FRAME

```
public static final String EVENT_QUEUE_FRAME = "QueueFrame"
```

### EVENT_QUEUE_TEXTURE

```
public static final String EVENT_QUEUE_TEXTURE = "QueueTexture"
```

### EVENT_RECEIVE_END_OF_ALL_INPUT

```
public static final String EVENT_RECEIVE_END_OF_ALL_INPUT = "ReceiveEndOfAllInput"
```

### EVENT_REGISTER_NEW_INPUT_STREAM

```
public static final String EVENT_REGISTER_NEW_INPUT_STREAM = "RegisterNewInputStream"
```

### EVENT_RELEASE

```
public static final String EVENT_RELEASE = "Release"
```

### EVENT_RENDERED_TO_OUTPUT_SURFACE

```
public static final String EVENT_RENDERED_TO_OUTPUT_SURFACE = "RenderedToOutputSurface"
```

### EVENT_RESET

```
public static final String EVENT_RESET = "Reset"
```

### EVENT_SEEK_TO

```
public static final String EVENT_SEEK_TO = "SeekTo"
```

### EVENT_SET_COMPOSITION

```
public static final String EVENT_SET_COMPOSITION = "SetComposition"
```

### EVENT_SET_VIDEO_OUTPUT

```
public static final String EVENT_SET_VIDEO_OUTPUT = "SetVideoOutput"
```

### EVENT_SIGNAL_ENDED

```
public static final String EVENT_SIGNAL_ENDED = "SignalEnded"
```

### EVENT_SIGNAL_EOS

```
public static final String EVENT_SIGNAL_EOS = "SignalEOS"
```

### EVENT_START

```
public static final String EVENT_START = "Start"
```

### EVENT_SURFACE_TEXTURE_INPUT

```
public static final String EVENT_SURFACE_TEXTURE_INPUT = "SurfaceTextureInput"
```

### EVENT_SURFACE_TEXTURE_TRANSFORM_FIX

```
public static final String EVENT_SURFACE_TEXTURE_TRANSFORM_FIX = "SurfaceTextureTransformFix"
```

### EVENT_UNBLOCK_INPUT

```
public static final String EVENT_UNBLOCK_INPUT = "UnblockInput"
```

## Public fields

### enableTracing

```
public static boolean enableTracing
```

Whether to store tracing events for debug logging. Should be set to `true` for testing and debugging purposes only.

## Public constructors

### DebugTraceUtil

```
public DebugTraceUtil()
```

## Public methods

### generateTraceSummary

```
synchronized public static String generateTraceSummary()
```

Generate a summary of the logged events, containing the total number of times an event happened and the detailed log of a window of the oldest and newest events.

### logCodecEvent

```
synchronized public static void logCodecEvent(
    boolean isDecoder,
    boolean isVideo,
    @DebugTraceUtil.Event @DebugTraceUtil.Event String eventName,
    long presentationTimeUs,
    String extraFormat,
    Object[] extraArgs
)
```

Logs an `https://developer.android.com/reference/androidx/media3/effect/DebugTraceUtil.Event` for a codec, if debug logging is enabled.

| Parameters |
|---|---|
| `boolean isDecoder` | Whether the codec is a decoder. |
| `boolean isVideo` | Whether the codec is for video. |
| `@https://developer.android.com/reference/androidx/media3/effect/DebugTraceUtil.Event @https://developer.android.com/reference/androidx/media3/effect/DebugTraceUtil.Event https://developer.android.com/reference/java/lang/String.html eventName` | The `https://developer.android.com/reference/androidx/media3/effect/DebugTraceUtil.Event` to log. |
| `long presentationTimeUs` | The current presentation time of the media. Use `https://developer.android.com/reference/androidx/media3/common/C#TIME_UNSET()` if unknown, `https://developer.android.com/reference/androidx/media3/common/C#TIME_END_OF_SOURCE()` if EOS. |
| `https://developer.android.com/reference/java/lang/String.html extraFormat` | Format string for optional extra information. See `https://developer.android.com/reference/androidx/media3/common/util/Util#formatInvariant(java.lang.String,java.lang.Object...)`. |
| `Object[] extraArgs` | Arguments for optional extra information. |

### logEvent

```
synchronized public static void logEvent(
    @DebugTraceUtil.Component @DebugTraceUtil.Component String component,
    @DebugTraceUtil.Event @DebugTraceUtil.Event String event,
    long presentationTimeUs
)
```

Logs a new event, if debug logging is enabled.

| Parameters |
|---|---|
| `@https://developer.android.com/reference/androidx/media3/effect/DebugTraceUtil.Component @https://developer.android.com/reference/androidx/media3/effect/DebugTraceUtil.Component https://developer.android.com/reference/java/lang/String.html component` | The `https://developer.android.com/reference/androidx/media3/effect/DebugTraceUtil.Component` to log. |
| `@https://developer.android.com/reference/androidx/media3/effect/DebugTraceUtil.Event @https://developer.android.com/reference/androidx/media3/effect/DebugTraceUtil.Event https://developer.android.com/reference/java/lang/String.html event` | The `https://developer.android.com/reference/androidx/media3/effect/DebugTraceUtil.Event` to log. |
| `long presentationTimeUs` | The current presentation time of the media. Use `https://developer.android.com/reference/androidx/media3/common/C#TIME_UNSET()` if unknown, `https://developer.android.com/reference/androidx/media3/common/C#TIME_END_OF_SOURCE()` if EOS. |

### logEvent

```
synchronized public static void logEvent(
    @DebugTraceUtil.Component @DebugTraceUtil.Component String component,
    @DebugTraceUtil.Event @DebugTraceUtil.Event String event,
    long presentationTimeUs,
    String extraFormat,
    Object[] extraArgs
)
```

Logs a new event, if debug logging is enabled.

| Parameters |
|---|---|
| `@https://developer.android.com/reference/androidx/media3/effect/DebugTraceUtil.Component @https://developer.android.com/reference/androidx/media3/effect/DebugTraceUtil.Component https://developer.android.com/reference/java/lang/String.html component` | The `https://developer.android.com/reference/androidx/media3/effect/DebugTraceUtil.Component` to log. |
| `@https://developer.android.com/reference/androidx/media3/effect/DebugTraceUtil.Event @https://developer.android.com/reference/androidx/media3/effect/DebugTraceUtil.Event https://developer.android.com/reference/java/lang/String.html event` | The `https://developer.android.com/reference/androidx/media3/effect/DebugTraceUtil.Event` to log. |
| `long presentationTimeUs` | The current presentation time of the media. Use `https://developer.android.com/reference/androidx/media3/common/C#TIME_UNSET()` if unknown, `https://developer.android.com/reference/androidx/media3/common/C#TIME_END_OF_SOURCE()` if EOS. |
| `https://developer.android.com/reference/java/lang/String.html extraFormat` | Format string for optional extra information. See `https://developer.android.com/reference/androidx/media3/common/util/Util#formatInvariant(java.lang.String,java.lang.Object...)`. |
| `Object[] extraArgs` | Arguments for optional extra information. |

### logEvent

```
synchronized public static void logEvent(
    @DebugTraceUtil.Component @DebugTraceUtil.Component String component,
    String componentId,
    @DebugTraceUtil.Event @DebugTraceUtil.Event String event,
    long presentationTimeUs,
    String extraFormat,
    Object[] extraArgs
)
```

Logs a new event, if debug logging is enabled.

| Parameters |
|---|---|
| `@https://developer.android.com/reference/androidx/media3/effect/DebugTraceUtil.Component @https://developer.android.com/reference/androidx/media3/effect/DebugTraceUtil.Component https://developer.android.com/reference/java/lang/String.html component` | The `https://developer.android.com/reference/androidx/media3/effect/DebugTraceUtil.Component` to log. |
| `https://developer.android.com/reference/java/lang/String.html componentId` | The identifier of the logging `https://developer.android.com/reference/androidx/media3/effect/DebugTraceUtil.Component`. |
| `@https://developer.android.com/reference/androidx/media3/effect/DebugTraceUtil.Event @https://developer.android.com/reference/androidx/media3/effect/DebugTraceUtil.Event https://developer.android.com/reference/java/lang/String.html event` | The `https://developer.android.com/reference/androidx/media3/effect/DebugTraceUtil.Event` to log. |
| `long presentationTimeUs` | The current presentation time of the media. Use `https://developer.android.com/reference/androidx/media3/common/C#TIME_UNSET()` if unknown, `https://developer.android.com/reference/androidx/media3/common/C#TIME_END_OF_SOURCE()` if EOS. |
| `https://developer.android.com/reference/java/lang/String.html extraFormat` | Format string for optional extra information. See `https://developer.android.com/reference/androidx/media3/common/util/Util#formatInvariant(java.lang.String,java.lang.Object...)`. |
| `Object[] extraArgs` | Arguments for optional extra information. |

### reset

```
synchronized public static void reset()
```