loliball/media3
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

Update documentation of supported Compositions

Browse Source 
Account for features implemented recently.

PiperOrigin-RevId: 519113898
This commit is contained in:
kimvde 2023-03-24 11:56:42 +00:00 committed by Tianyi Feng
parent b70e7ca9e7
commit 710b462b5f
1 changed files with 17 additions and 18 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

35
libraries/transformer/src/main/java/androidx/media3/transformer/Transformer.java
View File

@ -662,26 +662,25 @@ public final class Transformer {
/** /**
* Starts an asynchronous operation to export the given {@link Composition}. * Starts an asynchronous operation to export the given {@link Composition}.
* *
* <p>This method is under implementation. Concatenating audio/video inputs with the same format * <p>This method is under implementation. Only the {@linkplain Composition compositions} meeting
* and the same {@link Effects} applied is the only supported use case. More precisely: * the below conditions are supported:
* *
* <ul> * <ul>
* <li>The {@link Composition} must contain exactly one {@link Composition#sequences * <li>There must be no overlapping track corresponding to the same track type in the output.
* EditedMediaItemSequence}. Its {@link Composition#effects Effects} must * More precisely, the composition must either contain a single {@linkplain
* <ul> * EditedMediaItemSequence sequence}, or contain one audio-only sequence and one
* <li>Contain no {@linkplain Effects#audioProcessors audio effects}. * video/image-only sequence.
* <li>Either contain no {@linkplain Effects#videoEffects video effects}, or exactly one * <li>A sequence cannot contain both video and image input.
* {@link Presentation}. * <li>A sequence cannot contain both HDR and SDR video input.
* </ul> * <li>A sequence cannot have gaps in its video or image samples. In other words, if a sequence
* <li>The {@link EditedMediaItem} instances in the {@link EditedMediaItemSequence} must: * contains video or image data, it must contain this type of data in the entire sequence.
* <ul> * <li>All the {@link EditedMediaItem} instances in a sequence must have the same audio format.
* <li>have identical tracks of the same format (after {@linkplain * <li>All the {@link EditedMediaItem} instances in a sequence must have the same effects
* EditedMediaItem#removeAudio audio} or {@linkplain EditedMediaItem#removeVideo * applied.
* video} removal and {@linkplain EditedMediaItem#flattenForSlowMotion slow motion * <li>The {@linkplain Composition#effects composition effects} must contain no {@linkplain
* flattening}). * Effects#audioProcessors audio effects}.
* <li>have identical {@link EditedMediaItem#effects Effects} applied. * <li>The composition effects must either contain no {@linkplain Effects#videoEffects video
* <li>not represent an image. * effects}, or exactly one {@link Presentation}.
* </ul>
* </ul> * </ul>
* *
* <p>The export state is notified through the {@linkplain Builder#addListener(Listener) * <p>The export state is notified through the {@linkplain Builder#addListener(Listener)