Data Sources

Starting a transcoding operation will require a source for our data, which is not necessarily a File. The DataSource objects will automatically take care about releasing streams / resources, which is convenient but it means that they can not be used twice.

kotlinCopy
Transcoder.into(filePath)
    .addDataSource(source1)
    .transcode()

Source Types

UriDataSource

The Android friendly source can be created with UriDataSource(context, uri) or simply using addDataSource(context, uri) in the transcoding builder.

FileDescriptorDataSource

A data source backed by a file descriptor. Use FileDescriptorDataSource(descriptor) or simply addDataSource(descriptor) in the transcoding builder. Note that it is the caller responsibility to close the file descriptor.

FilePathDataSource

A data source backed by a file absolute path. Use FilePathDataSource(path) or simply addDataSource(path) in the transcoding builder.

AssetFileDescriptorDataSource

A data source backed by Android's AssetFileDescriptor. Use AssetFileDescriptorDataSource(descriptor) or simply addDataSource(descriptor) in the transcoding builder. Note that it is the caller responsibility to close the file descriptor.

Track specific sources

Although a media source can have both audio and video, you can select a specific track for transcoding and exclude the other(s). For example, to select the video track only:

javaCopy
Transcoder.into(filePath)
    .addDataSource(TrackType.VIDEO, source)
    .transcode()

Related APIs