Added in [API level 30](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels) Summary: [Methods](https://developer.android.com/reference/android/media/MediaCodec.OutputFrame#pubmethods) \| [Inherited Methods](https://developer.android.com/reference/android/media/MediaCodec.OutputFrame#inhmethods)

# MediaCodec.OutputFrame

*** ** * ** ***

` public static final class MediaCodec.OutputFrame `   
` extends https://developer.android.com/reference/java/lang/Object ` ` `

|---|---|
| [java.lang.Object](https://developer.android.com/reference/java/lang/Object) ||
| ↳ | android.media.MediaCodec.OutputFrame |

<br />

*** ** * ** ***

A single output frame and its associated metadata.

## Summary

| ### Public methods ||
|---|---|
| ` https://developer.android.com/reference/java/util/ArrayDeque<https://developer.android.com/reference/android/media/MediaCodec.BufferInfo>` | ` https://developer.android.com/reference/android/media/MediaCodec.OutputFrame#getBufferInfos()() ` |
| ` https://developer.android.com/reference/java/util/Set<https://developer.android.com/reference/java/lang/String>` | ` https://developer.android.com/reference/android/media/MediaCodec.OutputFrame#getChangedKeys()() ` Returns an unmodifiable set of the names of entries that has changed from the previous frame. |
| ` int` | ` https://developer.android.com/reference/android/media/MediaCodec.OutputFrame#getFlags()() ` Returns the buffer flags. |
| ` https://developer.android.com/reference/android/media/MediaFormat` | ` https://developer.android.com/reference/android/media/MediaCodec.OutputFrame#getFormat()() ` Returns a read-only `https://developer.android.com/reference/android/media/MediaFormat` for this frame. |
| ` https://developer.android.com/reference/android/hardware/HardwareBuffer` | ` https://developer.android.com/reference/android/media/MediaCodec.OutputFrame#getHardwareBuffer()() ` Returns the output hardware graphic buffer, or null if this frame is empty. |
| ` https://developer.android.com/reference/android/media/MediaCodec.LinearBlock` | ` https://developer.android.com/reference/android/media/MediaCodec.OutputFrame#getLinearBlock()() ` Returns the output linear block, or null if this frame is empty. |
| ` long` | ` https://developer.android.com/reference/android/media/MediaCodec.OutputFrame#getPresentationTimeUs()() ` Returns the presentation timestamp in microseconds. |

### Inherited methods

From class ` https://developer.android.com/reference/java/lang/Object ` ` https://developer.android.com/reference/java/lang/Object` ` https://developer.android.com/reference/java/lang/Object#clone()() `

Creates and returns a copy of this object.
` boolean` ` https://developer.android.com/reference/java/lang/Object#equals(java.lang.Object)(https://developer.android.com/reference/java/lang/Object obj) `

Indicates whether some other object is "equal to" this one.
` void` ` https://developer.android.com/reference/java/lang/Object#finalize()() `

Called by the garbage collector on an object when garbage collection determines that there are no more references to the object.
` final https://developer.android.com/reference/java/lang/Class<?>` ` https://developer.android.com/reference/java/lang/Object#getClass()() `

Returns the runtime class of this `Object`.
` int` ` https://developer.android.com/reference/java/lang/Object#hashCode()() `

Returns a hash code value for the object.
` final void` ` https://developer.android.com/reference/java/lang/Object#notify()() `

Wakes up a single thread that is waiting on this object's monitor.
` final void` ` https://developer.android.com/reference/java/lang/Object#notifyAll()() `

Wakes up all threads that are waiting on this object's monitor.
` https://developer.android.com/reference/java/lang/String` ` https://developer.android.com/reference/java/lang/Object#toString()() `

Returns a string representation of the object.
` final void` ` https://developer.android.com/reference/java/lang/Object#wait(long,%20int)(long timeoutMillis, int nanos) `

Causes the current thread to wait until it is awakened, typically by being *notified* or *interrupted*, or until a certain amount of real time has elapsed.
` final void` ` https://developer.android.com/reference/java/lang/Object#wait(long)(long timeoutMillis) `

Causes the current thread to wait until it is awakened, typically by being *notified* or *interrupted*, or until a certain amount of real time has elapsed.
` final void` ` https://developer.android.com/reference/java/lang/Object#wait()() `

Causes the current thread to wait until it is awakened, typically by being *notified* or *interrupted*.

## Public methods

### getBufferInfos

Added in [API level 35](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)

```
public ArrayDeque<MediaCodec.BufferInfo> getBufferInfos ()
```

<br />

<br />

| Returns ||
|---|---|
| `https://developer.android.com/reference/java/util/ArrayDeque<https://developer.android.com/reference/android/media/MediaCodec.BufferInfo>` | This value cannot be `null`. <br /> |

### getChangedKeys

Added in [API level 30](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)

```
public Set<String> getChangedKeys ()
```

Returns an unmodifiable set of the names of entries that has changed from the previous frame. The entries may have been removed/changed/added. Client can find out what the change is by querying `https://developer.android.com/reference/android/media/MediaFormat` object returned from `https://developer.android.com/reference/android/media/MediaCodec.OutputFrame#getFormat()`.

<br />

| Returns ||
|---|---|
| `https://developer.android.com/reference/java/util/Set<https://developer.android.com/reference/java/lang/String>` | This value cannot be `null`. <br /> |

### getFlags

Added in [API level 30](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)

```
public int getFlags ()
```

Returns the buffer flags.

<br />

| Returns ||
|---|---|
| `int` | Value is either `0` or a combination of the following: - `https://developer.android.com/reference/android/media/MediaCodec#BUFFER_FLAG_SYNC_FRAME` - `https://developer.android.com/reference/android/media/MediaCodec#BUFFER_FLAG_KEY_FRAME` - `https://developer.android.com/reference/android/media/MediaCodec#BUFFER_FLAG_CODEC_CONFIG` - `https://developer.android.com/reference/android/media/MediaCodec#BUFFER_FLAG_END_OF_STREAM` - `https://developer.android.com/reference/android/media/MediaCodec#BUFFER_FLAG_PARTIAL_FRAME` - `https://developer.android.com/reference/android/media/MediaCodec#BUFFER_FLAG_DECODE_ONLY` |

### getFormat

Added in [API level 30](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)

```
public MediaFormat getFormat ()
```

Returns a read-only `https://developer.android.com/reference/android/media/MediaFormat` for this frame. The returned object is valid only until the client calls `https://developer.android.com/reference/android/media/MediaCodec#releaseOutputBuffer(int,%20boolean)`.

<br />

| Returns ||
|---|---|
| `https://developer.android.com/reference/android/media/MediaFormat` | This value cannot be `null`. <br /> |

### getHardwareBuffer

Added in [API level 30](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)

```
public HardwareBuffer getHardwareBuffer ()
```

Returns the output hardware graphic buffer, or null if this frame is empty.

<br />

| Returns ||
|---|---|
| `https://developer.android.com/reference/android/hardware/HardwareBuffer` | <br /> |

| Throws ||
|---|---|
| `https://developer.android.com/reference/java/lang/IllegalStateException` | if this output frame is not graphic. |

### getLinearBlock

Added in [API level 30](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)

```
public MediaCodec.LinearBlock getLinearBlock ()
```

Returns the output linear block, or null if this frame is empty.

<br />

| Returns ||
|---|---|
| `https://developer.android.com/reference/android/media/MediaCodec.LinearBlock` | <br /> |

| Throws ||
|---|---|
| `https://developer.android.com/reference/java/lang/IllegalStateException` | if this output frame is not linear. |

### getPresentationTimeUs

Added in [API level 30](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)

```
public long getPresentationTimeUs ()
```

Returns the presentation timestamp in microseconds.

<br />

| Returns ||
|---|---|
| `long` | <br /> |