Codec.EncoderFactory

Artifact: androidx.media3:media3-transformer

Kotlin |Java

interface Codec.EncoderFactory

Known direct subclasses

DefaultEncoderFactory

DefaultEncoderFactory

A default implementation of Codec.EncoderFactory.

A factory for encoder instances.

Summary

Public functions
`Boolean`	`audioNeedsEncoding()` Returns whether the audio needs to be encoded because of encoder specific configuration.
`Codec!`	`createForAudioEncoding(format: Format!, logSessionId: LogSessionId?)` Returns a `Codec` for audio encoding.
`Codec!`	`createForVideoEncoding(format: Format!, logSessionId: LogSessionId?)` Returns a `Codec` for video encoding.
`Boolean`	`@ExperimentalApi isVideoFormatSupported(format: Format!)` Returns whether the requested video `Format` is supported by the encoder factory.
`Boolean`	`videoNeedsEncoding()` Returns whether the video needs to be encoded because of encoder specific configuration.

Public functions

audioNeedsEncoding

fun audioNeedsEncoding(): Boolean

Returns whether the audio needs to be encoded because of encoder specific configuration.

createForAudioEncoding

fun createForAudioEncoding(format: Format!, logSessionId: LogSessionId?): Codec!

Returns a Codec for audio encoding.

The caller should ensure the MIME type is supported on the device before calling this method.

Parameters
`format: Format!`	The `Format` (of the output data) used to determine the underlying encoder and its configuration values. `sampleMimeType`, `sampleRate`, `channelCount` and `bitrate` are set to those of the desired output video format.
`logSessionId: LogSessionId?`	The optional `LogSessionId` of the `android.media.metrics.EditingSession`.

Returns
`Codec!`	A `Codec` for encoding audio to the requested `MIME type`.

Throws
`androidx.media3.transformer.ExportException`	If no suitable `Codec` can be created.

createForVideoEncoding

fun createForVideoEncoding(format: Format!, logSessionId: LogSessionId?): Codec!

Returns a Codec for video encoding.

The caller should ensure the MIME type is supported on the device before calling this method. If encoding to HDR, the caller should also ensure the color characteristics are supported.

Parameters
`format: Format!`	The `Format` (of the output data) used to determine the underlying encoder and its configuration values. `sampleMimeType`, `width` and `height` are set to those of the desired output video format. `frameRate` is set to the requested output frame rate, if available. `colorInfo` is set to the requested output color characteristics, if available. `rotationDegrees` is always 0.
`logSessionId: LogSessionId?`	The optional `LogSessionId` of the `android.media.metrics.EditingSession`.

Returns
`Codec!`	A `Codec` for encoding video to the requested `MIME type`.

Throws
`androidx.media3.transformer.ExportException`	If no suitable `Codec` can be created.

isVideoFormatSupported

@ExperimentalApi
fun isVideoFormatSupported(format: Format!): Boolean

Returns whether the requested video Format is supported by the encoder factory.

This is an experimental API and is currently being used for FrameWriter specifically.

videoNeedsEncoding

fun videoNeedsEncoding(): Boolean

Returns whether the video needs to be encoded because of encoder specific configuration.