# DiscardingTrackOutput

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

*** ** * ** ***


```
@UnstableApi
public final class DiscardingTrackOutput implements TrackOutput
```

<br />

*** ** * ** ***

A `https://developer.android.com/reference/androidx/media3/extractor/TrackOutput` that consumes and discards all reported samples.

## Summary

| ### Public constructors |
|---|
| `https://developer.android.com/reference/androidx/media3/extractor/DiscardingTrackOutput#DiscardingTrackOutput()()` Creates discarding track output. |

| ### Public methods |
|---|---|
| `void` | `https://developer.android.com/reference/androidx/media3/extractor/DiscardingTrackOutput#format(androidx.media3.common.Format)(https://developer.android.com/reference/androidx/media3/common/Format format)` Called when the `https://developer.android.com/reference/androidx/media3/common/Format` of the track has been extracted from the stream. |
| `void` | `https://developer.android.com/reference/androidx/media3/extractor/DiscardingTrackOutput#sampleData(androidx.media3.common.util.ParsableByteArray,int,int)( https://developer.android.com/reference/androidx/media3/common/util/ParsableByteArray data, int length, @https://developer.android.com/reference/androidx/media3/extractor/TrackOutput.SampleDataPart int sampleDataPart )` Called to write sample data to the output. |
| `int` | `https://developer.android.com/reference/androidx/media3/extractor/DiscardingTrackOutput#sampleData(androidx.media3.common.DataReader,int,boolean,int)( https://developer.android.com/reference/androidx/media3/common/DataReader input, int length, boolean allowEndOfInput, @https://developer.android.com/reference/androidx/media3/extractor/TrackOutput.SampleDataPart int sampleDataPart )` Called to write sample data to the output. |
| `void` | `https://developer.android.com/reference/androidx/media3/extractor/DiscardingTrackOutput#sampleMetadata(long,int,int,int,androidx.media3.extractor.TrackOutput.CryptoData)( long timeUs, @https://developer.android.com/reference/androidx/media3/common/C.BufferFlags int flags, int size, int offset, @https://developer.android.com/reference/androidx/annotation/Nullable https://developer.android.com/reference/androidx/media3/extractor/TrackOutput.CryptoData cryptoData )` Called when metadata associated with a sample has been extracted from the stream. |

| ### Inherited Constants |
|---|
| From [androidx.media3.extractor.TrackOutput](https://developer.android.com/reference/androidx/media3/extractor/TrackOutput) |---|---| | `static final int` | `https://developer.android.com/reference/androidx/media3/extractor/TrackOutput#SAMPLE_DATA_PART_ENCRYPTION() = 1` Sample encryption data. | | `static final int` | `https://developer.android.com/reference/androidx/media3/extractor/TrackOutput#SAMPLE_DATA_PART_MAIN() = 0` Main media sample data. | | `static final int` | `https://developer.android.com/reference/androidx/media3/extractor/TrackOutput#SAMPLE_DATA_PART_SUPPLEMENTAL() = 2` Sample supplemental data. | |

| ### Inherited methods |
|---|
| From [androidx.media3.extractor.TrackOutput](https://developer.android.com/reference/androidx/media3/extractor/TrackOutput) |---|---| | `void` | `https://developer.android.com/reference/androidx/media3/extractor/TrackOutput#durationUs(long)(long durationUs)` Called to set the duration of the track in microseconds. | | `void` | `https://developer.android.com/reference/androidx/media3/extractor/TrackOutput#sampleData(androidx.media3.common.util.ParsableByteArray,int)(https://developer.android.com/reference/androidx/media3/common/util/ParsableByteArray data, int length)` Equivalent to `https://developer.android.com/reference/androidx/media3/extractor/TrackOutput#sampleData(androidx.media3.common.util.ParsableByteArray,int,int)` sampleData(data, length, SAMPLE_DATA_PART_MAIN)}. | | `int` | `https://developer.android.com/reference/androidx/media3/extractor/TrackOutput#sampleData(androidx.media3.common.DataReader,int,boolean)(https://developer.android.com/reference/androidx/media3/common/DataReader input, int length, boolean allowEndOfInput)` Equivalent to `https://developer.android.com/reference/androidx/media3/extractor/TrackOutput#sampleData(androidx.media3.common.DataReader,int,boolean,int)`. | |

## Public constructors

### DiscardingTrackOutput

```
public DiscardingTrackOutput()
```

Creates discarding track output.

## Public methods

### format

```
public void format(Format format)
```

Called when the `https://developer.android.com/reference/androidx/media3/common/Format` of the track has been extracted from the stream.

| Parameters |
|---|---|
| `https://developer.android.com/reference/androidx/media3/common/Format format` | The extracted `https://developer.android.com/reference/androidx/media3/common/Format`. |

### sampleData

```
public void sampleData(
    ParsableByteArray data,
    int length,
    @TrackOutput.SampleDataPart int sampleDataPart
)
```

Called to write sample data to the output.

| Parameters |
|---|---|
| `https://developer.android.com/reference/androidx/media3/common/util/ParsableByteArray data` | A `https://developer.android.com/reference/androidx/media3/common/util/ParsableByteArray` from which to read the sample data. |
| `int length` | The number of bytes to read, starting from `data.getPosition()`. |
| `@https://developer.android.com/reference/androidx/media3/extractor/TrackOutput.SampleDataPart int sampleDataPart` | The part of the sample data to which this call corresponds. |

### sampleData

```
public int sampleData(
    DataReader input,
    int length,
    boolean allowEndOfInput,
    @TrackOutput.SampleDataPart int sampleDataPart
)
```

Called to write sample data to the output.

| Parameters |
|---|---|
| `https://developer.android.com/reference/androidx/media3/common/DataReader input` | A `https://developer.android.com/reference/androidx/media3/common/DataReader` from which to read the sample data. |
| `int length` | The maximum length to read from the input. |
| `boolean allowEndOfInput` | True if encountering the end of the input having read no data is allowed, and should result in `https://developer.android.com/reference/androidx/media3/common/C#RESULT_END_OF_INPUT()` being returned. False if it should be considered an error, causing an `https://developer.android.com/reference/java/io/EOFException.html` to be thrown. |
| `@https://developer.android.com/reference/androidx/media3/extractor/TrackOutput.SampleDataPart int sampleDataPart` | The part of the sample data to which this call corresponds. |

| Returns |
|---|---|
| `int` | The number of bytes appended. |

| Throws |
|---|---|
| `https://developer.android.com/reference/java/io/IOException.html` | If an error occurred reading from the input. |

### sampleMetadata

```
public void sampleMetadata(
    long timeUs,
    @C.BufferFlags int flags,
    int size,
    int offset,
    @Nullable TrackOutput.CryptoData cryptoData
)
```

Called when metadata associated with a sample has been extracted from the stream.

The corresponding sample data will have already been passed to the output via calls to `https://developer.android.com/reference/androidx/media3/extractor/TrackOutput#sampleData(androidx.media3.common.DataReader,int,boolean)` or `https://developer.android.com/reference/androidx/media3/extractor/TrackOutput#sampleData(androidx.media3.common.util.ParsableByteArray,int)`.

| Parameters |
|---|---|
| `long timeUs` | The media timestamp associated with the sample, in microseconds. |
| `@https://developer.android.com/reference/androidx/media3/common/C.BufferFlags int flags` | Flags associated with the sample. See `C.BUFFER_FLAG_*`. |
| `int size` | The size of the sample data, in bytes. |
| `int offset` | The number of bytes that have been passed to `https://developer.android.com/reference/androidx/media3/extractor/TrackOutput#sampleData(androidx.media3.common.DataReader,int,boolean)` or `https://developer.android.com/reference/androidx/media3/extractor/TrackOutput#sampleData(androidx.media3.common.util.ParsableByteArray,int)` since the last byte belonging to the sample whose metadata is being passed. |
| `@https://developer.android.com/reference/androidx/annotation/Nullable https://developer.android.com/reference/androidx/media3/extractor/TrackOutput.CryptoData cryptoData` | The encryption data required to decrypt the sample. May be null. |