MediaMuxer Classe

Definizione

[Android.Runtime.Register("android/media/MediaMuxer", DoNotGenerateAcw=true)]
public sealed class MediaMuxer : Java.Lang.Object

[<Android.Runtime.Register("android/media/MediaMuxer", DoNotGenerateAcw=true)>]
type MediaMuxer = class
    inherit Object

Ereditarietà

Object

JavaObject

Object

MediaMuxer

Attributi

RegisterAttribute

Commenti

MediaMuxer facilita il multiplexing dei flussi elementari. Attualmente MediaMuxer supporta MP4, Webm e 3GP come output. Supporta anche il multiplexing dei fotogrammi B in MP4 da Android Nougat MR1.

In genere viene usato come segue:

MediaMuxer muxer = new MediaMuxer("temp.mp4", OutputFormat.MUXER_OUTPUT_MPEG_4);
            // More often, the MediaFormat will be retrieved from MediaCodec.getOutputFormat()
            // or MediaExtractor.getTrackFormat().
            MediaFormat audioFormat = new MediaFormat(...);
            MediaFormat videoFormat = new MediaFormat(...);
            int audioTrackIndex = muxer.addTrack(audioFormat);
            int videoTrackIndex = muxer.addTrack(videoFormat);
            ByteBuffer inputBuffer = ByteBuffer.allocate(bufferSize);
            boolean finished = false;
            BufferInfo bufferInfo = new BufferInfo();

            muxer.start();
            while(!finished) {
              // getInputBuffer() will fill the inputBuffer with one frame of encoded
              // sample from either MediaCodec or MediaExtractor, set isAudioSample to
              // true when the sample is audio data, set up all the fields of bufferInfo,
              // and return true if there are no more samples.
              finished = getInputBuffer(inputBuffer, isAudioSample, bufferInfo);
              if (!finished) {
                int currentTrackIndex = isAudioSample ? audioTrackIndex : videoTrackIndex;
                muxer.writeSampleData(currentTrackIndex, inputBuffer, bufferInfo);
              }
            };
            muxer.stop();
            muxer.release();

<h4>Metadata Track</h4>

I metadati per frame contengono informazioni correlate a video o audio per facilitare l'elaborazione offline. Ad esempio, i segnali gyro del sensore possono aiutare la stabilizzazione video durante l'elaborazione offline. Le tracce dei metadati sono supportate solo quando si esegue il multiplexing nel formato del contenitore MP4. Quando si aggiunge una nuova traccia di metadati, il formato del tipo MIME deve iniziare con il prefisso "application/" (ad esempio, "application/gyro"). Il formato dei metadati è definito dall'applicazione. I timestamp dei metadati devono trovarsi nella stessa base temporale dei timestamp video e audio. Il file MP4 generato usa TextMetaDataSampleEntry (definito nella sezione 12.3.3.2 della specifica ISOBMFF) per segnalare il tipo MIME dei metadati.

MediaMuxer muxer = new MediaMuxer("temp.mp4", OutputFormat.MUXER_OUTPUT_MPEG_4);
               // SetUp Video/Audio Tracks.
               MediaFormat audioFormat = new MediaFormat(...);
               MediaFormat videoFormat = new MediaFormat(...);
               int audioTrackIndex = muxer.addTrack(audioFormat);
               int videoTrackIndex = muxer.addTrack(videoFormat);

               // Setup Metadata Track
               MediaFormat metadataFormat = new MediaFormat(...);
               metadataFormat.setString(KEY_MIME, "application/gyro");
               int metadataTrackIndex = muxer.addTrack(metadataFormat);

               muxer.start();
               while(..) {
                   // Allocate bytebuffer and write gyro data(x,y,z) into it.
                   ByteBuffer metaData = ByteBuffer.allocate(bufferSize);
                   metaData.putFloat(x);
                   metaData.putFloat(y);
                   metaData.putFloat(z);
                   BufferInfo metaInfo = new BufferInfo();
                   // Associate this metadata with the video frame by setting
                   // the same timestamp as the video frame.
                   metaInfo.presentationTimeUs = currentVideoTrackTimeUs;
                   metaInfo.offset = 0;
                   metaInfo.flags = 0;
                   metaInfo.size = bufferSize;
                   muxer.writeSampleData(metadataTrackIndex, metaData, metaInfo);
               };
               muxer.stop();
               muxer.release();
             }

<h2 id=History"History>">Features and API History</h2>

La tabella seguente riepiloga il supporto delle funzionalità in diverse versioni e contenitori dell'API. Per i numeri di versione dell'API, vedere android.os.Build.VERSION_CODES.

<style> .api > tr > th, .api > tr > td { text-align: center; padding: 4px 4px; } .api > tr > th { vertical-align: bottom; } .api > tr > td { vertical-align: middle; } .sml tr > th, .sml >> tr > td { text-align: center; padding: 2px 4px; } .fn { text-align: center; }</style>

<table align="right" style="width: 0%">thead<>tbody class=api<>tr<th><Symbol>/th th<><Meaning>/th</tr><>/tbody/thead<>tbody<> class=sml<>tr<td><●></td td><>Supported</td></tr tr><><td>○</td td><>Non supportato</td></tr tr><><td>▧</td td><>supportato in MP4/WebM/3GP</td></tr td><><>⁕</td td Supportato solo in MP4></td>/tr<></tbody></table table><align="center" style="width: 100%;"><><thead class=api><tr><th rowspan=2>Feature</th th><colspan="24">SDK Version</th></tr><><th 18></th th><>19</th><>20</th><>21</th><>22</th><>23</><th>24/th<>24</th>25</th><26>+</th></tr></thead><tbody class=api><tr><td align="center">MP4 container</td td><>●</td td><>●</td td><>●</td td><>●</td td><>●</td td><>●</td td><>●</td td><>●</td td><>●</td></tr><td align="center">WebM container</td td><>○</td td><>○</td td><>○</td td><>●</td td><>●</td td><>●</td td><>●</td td><>●</td td><>●</td></tr><td align="center">3GP container</td td><>○</td td><>○</td td><>○</td td><>○</td td><>○</td td><>○</td td><>○</td td><>○</td td><>●</td></tr><td align="center">Muxing B-Frames (fotogrammi stimati bidirezionali)</td td><>○</td td><>○</td td><>○</td td><>○</td td><>○</td td><>○</td td><>○</td td><>⁕</td td><>⁕</td></tr></tr><td align="center">Muxing Single Video/Audio Track</td td><>▧</td td><>▧</td td><>▧</td td><>▧</td td><>▧</td td><>▧</td td><>▧</td td><>▧</td td><>▧</td></tr></tr><td align="center">Muxing Multiple Video/Audio Tracks</td td><>○</td td><>○</td td><>○</td td><>○</td td><>○</td td><>○</td td><>○</td td><>○</td td><>⁕</td></tr></tr><td align="center">Muxing Metadata Tracks</td td><>○</td td><>○</td td><>○</td td><>○</td td><>○</td td><>○</td td><>○</td td><>○</td td><>⁕</td></tr></tbody></table>

per android.media.MediaMuxer.

Le parti di questa pagina sono modifiche basate sul lavoro creato e condiviso dalla e usati in base ai termini descritti in Creative License 2.5 Attribution License.