# 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
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/kotlin/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) annotation https://developer.android.com/reference/kotlin/androidx/media3/effect/DebugTraceUtil.Component` Components logged by `https://developer.android.com/reference/kotlin/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/kotlin/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) annotation https://developer.android.com/reference/kotlin/androidx/media3/effect/DebugTraceUtil.Event` Events logged by `https://developer.android.com/reference/kotlin/androidx/media3/effect/DebugTraceUtil#logEvent(java.lang.String,java.lang.String,long,java.lang.String,java.lang.Object...)`. |

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

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

| ### Public functions |
|---|---|
| `synchronized java-static https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-string/index.html!` | `https://developer.android.com/reference/kotlin/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 java-static https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-unit/index.html` | `https://developer.android.com/reference/kotlin/androidx/media3/effect/DebugTraceUtil#logCodecEvent(boolean,boolean,java.lang.String,long,java.lang.String,java.lang.Object...)( isDecoder: https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-boolean/index.html, isVideo: https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-boolean/index.html, @https://developer.android.com/reference/kotlin/androidx/media3/effect/DebugTraceUtil.Event eventName: @https://developer.android.com/reference/kotlin/androidx/media3/effect/DebugTraceUtil.Event https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-string/index.html!, presentationTimeUs: https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-long/index.html, extraFormat: https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-string/index.html!, extraArgs: https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-array/index.html<https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-any/index.html!>! )` Logs an `https://developer.android.com/reference/kotlin/androidx/media3/effect/DebugTraceUtil.Event` for a codec, if debug logging is enabled. |
| `synchronized java-static https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-unit/index.html` | `https://developer.android.com/reference/kotlin/androidx/media3/effect/DebugTraceUtil#logEvent(java.lang.String,java.lang.String,long)( @https://developer.android.com/reference/kotlin/androidx/media3/effect/DebugTraceUtil.Component component: @https://developer.android.com/reference/kotlin/androidx/media3/effect/DebugTraceUtil.Component https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-string/index.html!, @https://developer.android.com/reference/kotlin/androidx/media3/effect/DebugTraceUtil.Event event: @https://developer.android.com/reference/kotlin/androidx/media3/effect/DebugTraceUtil.Event https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-string/index.html!, presentationTimeUs: https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-long/index.html )` Logs a new event, if debug logging is enabled. |
| `synchronized java-static https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-unit/index.html` | `https://developer.android.com/reference/kotlin/androidx/media3/effect/DebugTraceUtil#logEvent(java.lang.String,java.lang.String,long,java.lang.String,java.lang.Object...)( @https://developer.android.com/reference/kotlin/androidx/media3/effect/DebugTraceUtil.Component component: @https://developer.android.com/reference/kotlin/androidx/media3/effect/DebugTraceUtil.Component https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-string/index.html!, @https://developer.android.com/reference/kotlin/androidx/media3/effect/DebugTraceUtil.Event event: @https://developer.android.com/reference/kotlin/androidx/media3/effect/DebugTraceUtil.Event https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-string/index.html!, presentationTimeUs: https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-long/index.html, extraFormat: https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-string/index.html!, extraArgs: https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-array/index.html<https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-any/index.html!>! )` Logs a new event, if debug logging is enabled. |
| `synchronized java-static https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-unit/index.html` | `https://developer.android.com/reference/kotlin/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/kotlin/androidx/media3/effect/DebugTraceUtil.Component component: @https://developer.android.com/reference/kotlin/androidx/media3/effect/DebugTraceUtil.Component https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-string/index.html!, componentId: https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-string/index.html!, @https://developer.android.com/reference/kotlin/androidx/media3/effect/DebugTraceUtil.Event event: @https://developer.android.com/reference/kotlin/androidx/media3/effect/DebugTraceUtil.Event https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-string/index.html!, presentationTimeUs: https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-long/index.html, extraFormat: https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-string/index.html!, extraArgs: https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-array/index.html<https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-any/index.html!>! )` Logs a new event, if debug logging is enabled. |
| `synchronized java-static https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-unit/index.html` | `https://developer.android.com/reference/kotlin/androidx/media3/effect/DebugTraceUtil#reset()()` |

| ### Public properties |
|---|---|
| `java-static https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-boolean/index.html` | `https://developer.android.com/reference/kotlin/androidx/media3/effect/DebugTraceUtil#enableTracing()` Whether to store tracing events for debug logging. |

## Constants

### COMPONENT_ASSET_LOADER

```
const val COMPONENT_ASSET_LOADER = "AssetLoader": String!
```

### COMPONENT_AUDIO_DECODER

```
const val COMPONENT_AUDIO_DECODER = "AudioDecoder": String!
```

### COMPONENT_AUDIO_ENCODER

```
const val COMPONENT_AUDIO_ENCODER = "AudioEncoder": String!
```

### COMPONENT_AUDIO_GRAPH

```
const val COMPONENT_AUDIO_GRAPH = "AudioGraph": String!
```

### COMPONENT_AUDIO_GRAPH_INPUT

```
const val COMPONENT_AUDIO_GRAPH_INPUT = "AudioGraphInput": String!
```

### COMPONENT_AUDIO_GRAPH_INPUT_AUDIO_SINK

```
const val COMPONENT_AUDIO_GRAPH_INPUT_AUDIO_SINK = "AGIAudioSink": String!
```

### COMPONENT_AUDIO_MIXER

```
const val COMPONENT_AUDIO_MIXER = "AudioMixer": String!
```

### COMPONENT_BITMAP_TEXTURE_MANAGER

```
const val COMPONENT_BITMAP_TEXTURE_MANAGER = "BitmapTextureManager": String!
```

### COMPONENT_COMPOSITION_PLAYER

```
const val COMPONENT_COMPOSITION_PLAYER = "CompositionPlayer": String!
```

### COMPONENT_COMPOSITOR

```
const val COMPONENT_COMPOSITOR = "Compositor": String!
```

### COMPONENT_EXTERNAL_TEXTURE_MANAGER

```
const val COMPONENT_EXTERNAL_TEXTURE_MANAGER = "ExternalTextureManager": String!
```

### COMPONENT_MUXER

```
const val COMPONENT_MUXER = "Muxer": String!
```

### COMPONENT_TEX_ID_TEXTURE_MANAGER

```
const val COMPONENT_TEX_ID_TEXTURE_MANAGER = "TexIdTextureManager": String!
```

### COMPONENT_TRANSFORMER_INTERNAL

```
const val COMPONENT_TRANSFORMER_INTERNAL = "TransformerInternal": String!
```

### COMPONENT_VFP

```
const val COMPONENT_VFP = "VideoFrameProcessor": String!
```

### COMPONENT_VIDEO_DECODER

```
const val COMPONENT_VIDEO_DECODER = "VideoDecoder": String!
```

### COMPONENT_VIDEO_ENCODER

```
const val COMPONENT_VIDEO_ENCODER = "VideoEncoder": String!
```

### EVENT_ACCEPTED_INPUT

```
const val EVENT_ACCEPTED_INPUT = "AcceptedInput": String!
```

### EVENT_BLOCK_INPUT

```
const val EVENT_BLOCK_INPUT = "BlockInput": String!
```

### EVENT_CAN_WRITE_SAMPLE

```
const val EVENT_CAN_WRITE_SAMPLE = "CanWriteSample": String!
```

### EVENT_DISCONTINUITY

```
const val EVENT_DISCONTINUITY = "Discontinuity": String!
```

### EVENT_FLUSH

```
const val EVENT_FLUSH = "Flush": String!
```

### EVENT_INPUT_ENDED

```
const val EVENT_INPUT_ENDED = "InputEnded": String!
```

### EVENT_INPUT_FORMAT

```
const val EVENT_INPUT_FORMAT = "InputFormat": String!
```

### EVENT_OUTPUT_ENDED

```
const val EVENT_OUTPUT_ENDED = "OutputEnded": String!
```

### EVENT_OUTPUT_FORMAT

```
const val EVENT_OUTPUT_FORMAT = "OutputFormat": String!
```

### EVENT_OUTPUT_TEXTURE_RENDERED

```
const val EVENT_OUTPUT_TEXTURE_RENDERED = "OutputTextureRendered": String!
```

### EVENT_PRODUCED_OUTPUT

```
const val EVENT_PRODUCED_OUTPUT = "ProducedOutput": String!
```

### EVENT_QUEUE_BITMAP

```
const val EVENT_QUEUE_BITMAP = "QueueBitmap": String!
```

### EVENT_QUEUE_FRAME

```
const val EVENT_QUEUE_FRAME = "QueueFrame": String!
```

### EVENT_QUEUE_TEXTURE

```
const val EVENT_QUEUE_TEXTURE = "QueueTexture": String!
```

### EVENT_RECEIVE_END_OF_ALL_INPUT

```
const val EVENT_RECEIVE_END_OF_ALL_INPUT = "ReceiveEndOfAllInput": String!
```

### EVENT_REGISTER_NEW_INPUT_STREAM

```
const val EVENT_REGISTER_NEW_INPUT_STREAM = "RegisterNewInputStream": String!
```

### EVENT_RELEASE

```
const val EVENT_RELEASE = "Release": String!
```

### EVENT_RENDERED_TO_OUTPUT_SURFACE

```
const val EVENT_RENDERED_TO_OUTPUT_SURFACE = "RenderedToOutputSurface": String!
```

### EVENT_RESET

```
const val EVENT_RESET = "Reset": String!
```

### EVENT_SEEK_TO

```
const val EVENT_SEEK_TO = "SeekTo": String!
```

### EVENT_SET_COMPOSITION

```
const val EVENT_SET_COMPOSITION = "SetComposition": String!
```

### EVENT_SET_VIDEO_OUTPUT

```
const val EVENT_SET_VIDEO_OUTPUT = "SetVideoOutput": String!
```

### EVENT_SIGNAL_ENDED

```
const val EVENT_SIGNAL_ENDED = "SignalEnded": String!
```

### EVENT_SIGNAL_EOS

```
const val EVENT_SIGNAL_EOS = "SignalEOS": String!
```

### EVENT_START

```
const val EVENT_START = "Start": String!
```

### EVENT_SURFACE_TEXTURE_INPUT

```
const val EVENT_SURFACE_TEXTURE_INPUT = "SurfaceTextureInput": String!
```

### EVENT_SURFACE_TEXTURE_TRANSFORM_FIX

```
const val EVENT_SURFACE_TEXTURE_TRANSFORM_FIX = "SurfaceTextureTransformFix": String!
```

### EVENT_UNBLOCK_INPUT

```
const val EVENT_UNBLOCK_INPUT = "UnblockInput": String!
```

## Public constructors

### DebugTraceUtil

```
DebugTraceUtil()
```

## Public functions

### generateTraceSummary

```
synchronized java-static fun generateTraceSummary(): String!
```

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 java-static fun logCodecEvent(
    isDecoder: Boolean,
    isVideo: Boolean,
    @DebugTraceUtil.Event eventName: @DebugTraceUtil.Event String!,
    presentationTimeUs: Long,
    extraFormat: String!,
    extraArgs: Array<Any!>!
): Unit
```

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

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

### logEvent

```
synchronized java-static fun logEvent(
    @DebugTraceUtil.Component component: @DebugTraceUtil.Component String!,
    @DebugTraceUtil.Event event: @DebugTraceUtil.Event String!,
    presentationTimeUs: Long
): Unit
```

Logs a new event, if debug logging is enabled.

| Parameters |
|---|---|
| `@https://developer.android.com/reference/kotlin/androidx/media3/effect/DebugTraceUtil.Component component: @https://developer.android.com/reference/kotlin/androidx/media3/effect/DebugTraceUtil.Component https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-string/index.html!` | The `https://developer.android.com/reference/kotlin/androidx/media3/effect/DebugTraceUtil.Component` to log. |
| `@https://developer.android.com/reference/kotlin/androidx/media3/effect/DebugTraceUtil.Event event: @https://developer.android.com/reference/kotlin/androidx/media3/effect/DebugTraceUtil.Event https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-string/index.html!` | The `https://developer.android.com/reference/kotlin/androidx/media3/effect/DebugTraceUtil.Event` to log. |
| `presentationTimeUs: https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-long/index.html` | The current presentation time of the media. Use `https://developer.android.com/reference/kotlin/androidx/media3/common/C#TIME_UNSET()` if unknown, `https://developer.android.com/reference/kotlin/androidx/media3/common/C#TIME_END_OF_SOURCE()` if EOS. |

### logEvent

```
synchronized java-static fun logEvent(
    @DebugTraceUtil.Component component: @DebugTraceUtil.Component String!,
    @DebugTraceUtil.Event event: @DebugTraceUtil.Event String!,
    presentationTimeUs: Long,
    extraFormat: String!,
    extraArgs: Array<Any!>!
): Unit
```

Logs a new event, if debug logging is enabled.

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

### logEvent

```
synchronized java-static fun logEvent(
    @DebugTraceUtil.Component component: @DebugTraceUtil.Component String!,
    componentId: String!,
    @DebugTraceUtil.Event event: @DebugTraceUtil.Event String!,
    presentationTimeUs: Long,
    extraFormat: String!,
    extraArgs: Array<Any!>!
): Unit
```

Logs a new event, if debug logging is enabled.

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

### reset

```
synchronized java-static fun reset(): Unit
```

## Public properties

### enableTracing

```
java-static val enableTracing: Boolean
```

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