MediaCodec

public final class MediaCodec
extends Object

MediaCodec类可用于访问低级媒体编解码器，即编码器/解码器组件。 它是Android低电平多媒体支持基础设施的一部分（通常与一起使用MediaExtractor ， MediaSync ， MediaMuxer ， MediaCrypto ， MediaDrm ， Image ， Surface ，和AudioTrack ）。

广义而言，编解码器处理输入数据以生成输出数据。 它异步处理数据并使用一组输入和输出缓冲区。 在简单的层面上，您请求（或接收）一个空输入缓冲区，填充数据并将其发送到编解码器进行处理。 编解码器使用数据并将其转换为其空的输出缓冲区之一。 最后，您请求（或接收）一个填充的输出缓冲区，消耗其内容并将其释放回编解码器。

Data Types

编解码器对三种数据进行操作：压缩数据，原始音频数据和原始视频数据。 所有三种数据都可以使用ByteBuffers进行处理，但您应该使用Surface作为原始视频数据以提高编解码器的性能。 Surface使用本地视频缓冲区而不映射或将它们复制到ByteBuffers; 因此，它更有效率。 使用Surface时通常无法访问原始视频数据，但可以使用ImageReader类来访问不安全的已解码（原始）视频帧。 这可能仍然比使用ByteBuffers更高效，因为某些本地缓冲区可能映射到direct ByteBuffers中。 当使用ByteBuffer的模式，您可以使用访问原始视频帧Image类和getInput / OutputImage(int) 。

Compressed Buffers

根据format's type，输入缓冲器（用于解码器）和输出缓冲器（用于编码器）包含压缩数据。 对于视频类型，这是一个单一的压缩视频帧。 对于音频数据，这通常是单个访问单元（编码音频段通常包含由格式类型指示的几毫秒的音频），但是由于缓冲器可能包含多个编码的音频存取单元，所以这个要求稍微宽松。 无论哪种情况，缓冲区都不会以任意字节边界开始或结束，而是在帧/访问单元边界上开始或结束。

Raw Audio Buffers

原始音频缓冲区包含整个PCM音频数据帧，这是通道顺序中每个通道的一个样本。 每个样本都是16-bit signed integer in native byte order 。

 short[] getSamplesForChannel(MediaCodec codec, int bufferId, int channelIx) {
   ByteBuffer outputBuffer = codec.getOutputBuffer(bufferId);
   MediaFormat format = codec.getOutputFormat(bufferId);
   ShortBuffer samples = outputBuffer.order(ByteOrder.nativeOrder()).asShortBuffer();
   int numChannels = formet.getInteger(MediaFormat.KEY_CHANNEL_COUNT);
   if (channelIx < 0 || channelIx >= numChannels) {
     return null;
   }
   short[] res = new short[samples.remaining() / numChannels];
   for (int i = 0; i < res.length; ++i) {
     res[i] = samples.get(i * numChannels + channelIx);
   }
   return res;
 }

Raw Video Buffers

在ByteBuffer模式下，视频缓冲区按照其color format进行布局 。 您可以从getCodecInfo() . getCapabilitiesForType(…) . colorFormats获得支持的颜色格式。 视频编解码器可支持三种颜色格式：

• native raw video format: This is marked by COLOR_FormatSurface and it can be used with an input or output Surface.
• flexible YUV buffers (such as COLOR_FormatYUV420Flexible): These can be used with an input/output Surface, as well as in ByteBuffer mode, by using getInput/OutputImage(int).
• other, specific formats: These are normally only supported in ByteBuffer mode. Some color formats are vendor specific. Others are defined in MediaCodecInfo.CodecCapabilities. For color formats that are equivalent to a flexible format, you can still use getInput/OutputImage(int).

自 LOLLIPOP_MR1以来，所有视频编解码器都支持灵活的YUV 4：2：0缓冲区。

Accessing Raw Video ByteBuffers on Older Devices

在支持 LOLLIPOP和 Image之前，需要使用 KEY_STRIDE和 KEY_SLICE_HEIGHT输出格式值来了解原始输出缓冲区的布局。

请注意，在某些设备上，切片高度被广告为0.这可能意味着切片高度与帧高度相同，或者切片高度是与某个值对齐的帧高度（通常是2）。 不幸的是，在这种情况下无法分辨实际的切片高度。 此外，平面格式的U平面的垂直跨度也未被指定或定义，尽管通常它是切片高度的一半。

KEY_WIDTH和KEY_HEIGHT键指定视频帧的大小; 然而，对于大多数情况，视频（图片）只占据视频帧的一部分。 这由“裁剪矩形”表示。

您需要使用以下键从output format获取原始输出图像的裁剪矩形。 如果这些键不存在，则视频占据整个视频帧。 在应用任何rotation 之前 ，在输出帧的上下文中理解裁剪矩形。

视频帧的大小（旋转之前）可以这样计算：

 MediaFormat format = decoder.getOutputFormat(…);
 int width = format.getInteger(MediaFormat.KEY_WIDTH);
 if (format.containsKey("crop-left") && format.containsKey("crop-right")) {
     width = format.getInteger("crop-right") + 1 - format.getInteger("crop-left");
 }
 int height = format.getInteger(MediaFormat.KEY_HEIGHT);
 if (format.containsKey("crop-top") && format.containsKey("crop-bottom")) {
     height = format.getInteger("crop-bottom") + 1 - format.getInteger("crop-top");
 }
 

另请注意， BufferInfo.offset的含义在各个设备上并不一致。 在某些设备上，偏移指向裁剪矩形的左上角像素，而在大多数设备上，它指向整个帧的左上角像素。

States

在其生命周期中，编解码器概念上存在三种状态之一：停止，执行或释放。 停止的集体状态实际上是三种状态的集合：未初始化，已配置和错误，而执行状态在概念上通过三个子状态：刷新，运行和结束流。

当您使用其中一种工厂方法创建编解码器时，编解码器处于未初始化状态。 首先，您需要通过configure(…)进行配置，使其进入Configured状态，然后调用start()将其移至Executing状态。 在这种状态下，您可以通过上述的缓冲区队列处理来处理数据。

执行状态有三个子状态：刷新，运行和结束流。 紧接在start()之后，编解码器处于Flushed子状态，它保存所有缓冲区。 只要第一个输入缓冲区出列，编解码器就会转移到运行子状态，在该状态下它大部分时间都在使用。 当您使用end-of-stream marker对输入缓冲区进行排队时 ，编解码器将转换为流结束子状态。 在这种状态下，编解码器不再接受进一步的输入缓冲器，但仍然产生输出缓冲器，直到输出端达到输出端。 您可以在处于Executing状态时使用flush()随时移回Flushed子状态。

调用stop()可将编解码器返回到未初始化状态，然后可再次进行配置。 当您完成使用编解码器时，您必须通过拨打release()来释放它。

在极少数情况下，编解码器可能会遇到错误并进入错误状态。 这是使用来自排队操作的无效返回值或有时通过异常传递的。 致电reset()以使编解码器再次可用。 您可以从任何状态调用它以将编解码器移回未初始化状态。 否则，请致电release()移至终端发布状态。

Creation

使用MediaCodecList为特定的MediaFormat创建MediaCodec。 解码文件或流时，您可以从MediaExtractor.getTrackFormat获得所需的格式。 使用MediaFormat.setFeatureEnabled注入要添加的任何特定功能，然后调用MediaCodecList.findDecoderForFormat以获取可以处理该特定媒体格式的编解码器的名称。 最后，使用createByCodecName(String)创建编解码器。

注意：在LOLLIPOP ，该格式MediaCodecList.findDecoder / EncoderForFormat不得包含frame rate 。 使用format.setString(MediaFormat.KEY_FRAME_RATE, null)清除格式中的任何现有帧速率设置。

您还可以创建首选的编解码器使用特定的MIME类型createDecoder / EncoderByType(String) 。 但是，这不能用于注入功能，并且可能会创建无法处理特定所需媒体格式的编解码器。

Creating secure decoders

在版本KITKAT_WATCH和更早的版本上，安全编解码器可能不会在MediaCodecList列出，但仍可能在系统上可用。 通过将".secure"附加到常规编解码器的名称（所有安全编解码器的名称必须以".secure"结尾），可以通过名称仅实例化存在的安全编解码器。如果编解码器不存在于系统上， createByCodecName(String)将抛出IOException 。

从 LOLLIPOP开始，您应该使用媒体格式中的 FEATURE_SecurePlayback功能来创建安全解码器。

Initialization

创建编解码器后，如果要异步处理数据，可以使用setCallback设置回调。 然后， configure使用特定的媒体格式的编解码器。 这是您可以为视频制作者指定输出Surface生成原始视频数据的编解码器（例如视频解码器）。 这也是您可以设置安全编解码器的解密参数时的情况（请参阅MediaCrypto ）。 最后，由于一些编解码器可以在多种模式下运行，因此您必须指定是否要将其用作解码器或编码器。

从LOLLIPOP ，您可以在Configured状态下查询生成的输入和输出格式。 在启动编解码器之前，您可以使用它来验证生成的配置，例如颜色格式。

如果您想要使用视频使用者本地处理原始输入视频缓冲区 - 处理原始视频输入的编解码器（例如视频编码器） - 在配置后使用createInputSurface()为输入数据创建目标表面。 或者，建立了编解码器使用以前创建persistent input surface致电setInputSurface(Surface) 。

Codec-specific Data

某些格式，特别是AAC音频和MPEG4，H.264和H.265视频格式要求实际数据前缀包含设置数据或编解码器特定数据的多个缓冲区。 处理这种压缩格式时，必须在start()之后和任何帧数据之前将此数据提交给编解码器。 此类数据必须在致电queueInputBuffer使用标志BUFFER_FLAG_CODEC_CONFIG进行标记。

特定于编解码器的数据也可以包含在以“csd-0”，“csd-1”等键在ByteBuffer条目中传递给configure的格式中。这些键总是包含在从MediaFormat获得的轨道MediaExtractor 。 格式中的编解码器专用数据在start()自动提交给编解码器; 你绝不能明确地提交这些数据。 如果格式不包含编解码器特定数据，则可以根据格式要求，选择使用指定数量的缓冲区以正确的顺序提交它。 在H.264 AVC的情况下，您还可以连接所有编解码器专用数据并将其作为单个编解码器配置缓冲区提交。

Android使用以下编解码器特定的数据缓冲区。 这些也需要设置为轨道格式以适合MediaMuxer轨道配置。 标有（ ^* ）的每个参数集和编码解码器特定数据部分必须以"\x00\x00\x00\x01"的起始码开始。

注意：如果编解码器在启动之后立即刷新或在输出缓冲区或输出格式更改返回之前不久， 请注意 ，因为在刷新期间编解码器特定的数据可能会丢失。 在这种刷新之后，您必须使用标有BUFFER_FLAG_CODEC_CONFIG缓冲区重新提交数据，以确保正确的编解码器操作。

编码器（或生成压缩数据的编解码器）将在用codec-config flag标记的输出缓冲区中的任何有效输出缓冲区之前创建并返回编解码器特定数据。 包含编解码器专用数据的缓冲器没有有意义的时间戳。

Data Processing

每个编解码器都维护一组由API调用中的缓冲区ID引用的输入和输出缓冲区。 在成功调用start() ，客户端“拥有”既没有输入也没有输出缓冲区。 在同步模式中，呼叫dequeueInput / OutputBuffer(…)获得（获得的所有权）从编解码器的输入或输出缓冲区。 在异步模式下，您将自动通过接收可用缓冲区MediaCodec.Callback.onInput / OutputBufferAvailable(…)回调。

在获得输入缓冲区时，填充数据并使用queueInputBuffer或queueSecureInputBuffer如果使用解密）将其提交给编解码器。 不要使用相同的时间戳提交多个输入缓冲区（除非它被标记为codec-specific data ）。

编解码器将通过异步模式下的onOutputBufferAvailable回调或者响应同步模式下的dequeuOutputBuffer调用返回一个只读输出缓冲区。 输出缓冲区处理完毕后，调用其中一个releaseOutputBuffer方法将缓冲区返回给编解码器。

虽然您不需要立即重新提交/释放缓冲区到编解码器，但握住输入和/或输出缓冲区可能会使编解码器停顿，并且此行为取决于设备。 特别是，编解码器有可能在产生输出缓冲区之前暂缓，直到所有未完成的缓冲区被释放/重新提交。 因此，尽可能少地尝试保留可用的缓冲区。

根据API版本，您可以通过三种方式处理数据：

Asynchronous Processing using Buffers

由于LOLLIPOP ，首选方法是在调用configure之前通过设置回调来异步处理数据。 异步模式改变的状态转换咯，因为你必须调用start()后flush()过渡编解码器的跑分状态，并开始接收输入缓冲器。 同样，在初始调用start ，编解码器将直接移至Running子状态，并通过回调开始传递可用的输入缓冲区。

MediaCodec通常以异步模式使用：

 MediaCodec codec = MediaCodec.createByCodecName(name);
 MediaFormat mOutputFormat; // member variable
 codec.setCallback(new MediaCodec.Callback() {
   @Override
   void onInputBufferAvailable(MediaCodec mc, int inputBufferId) {
     ByteBuffer inputBuffer = codec.getInputBuffer(inputBufferId);
     // fill inputBuffer with valid data
     …
     codec.queueInputBuffer(inputBufferId, …);
   }

   @Override
   void onOutputBufferAvailable(MediaCodec mc, int outputBufferId, …) {
     ByteBuffer outputBuffer = codec.getOutputBuffer(outputBufferId);
     MediaFormat bufferFormat = codec.getOutputFormat(outputBufferId); // option A
     // bufferFormat is equivalent to mOutputFormat
     // outputBuffer is ready to be processed or rendered.
     …
     codec.releaseOutputBuffer(outputBufferId, …);
   }

   @Override
   void onOutputFormatChanged(MediaCodec mc, MediaFormat format) {
     // Subsequent data will conform to new format.
     // Can ignore if using getOutputFormat(outputBufferId)
     mOutputFormat = format; // option B
   }

   @Override
   void onError(…) {
     …
   }
 });
 codec.configure(format, …);
 mOutputFormat = codec.getOutputFormat(); // option B
 codec.start();
 // wait for processing to complete
 codec.stop();
 codec.release();

Synchronous Processing using Buffers

由于LOLLIPOP ，你应该使用检索输入和输出缓冲器getInput / OutputBuffer(int)和/或getInput / OutputImage(int)使用同步模式编解码器也是如此。 这允许框架进行某些优化，例如在处理动态内容时。 如果调用此优化禁用getInput / OutputBuffers() 。

注意：不要混合同时使用缓冲区和缓冲区数组的方法。 具体而言，只调用getInput / OutputBuffers后直接start()或具有与出列的值的输出缓冲器ID后INFO_OUTPUT_FORMAT_CHANGED 。

MediaCodec通常以同步模式使用：

 MediaCodec codec = MediaCodec.createByCodecName(name);
 codec.configure(format, …);
 MediaFormat outputFormat = codec.getOutputFormat(); // option B
 codec.start();
 for (;;) {
   int inputBufferId = codec.dequeueInputBuffer(timeoutUs);
   if (inputBufferId >= 0) {
     ByteBuffer inputBuffer = codec.getInputBuffer(…);
     // fill inputBuffer with valid data
     …
     codec.queueInputBuffer(inputBufferId, …);
   }
   int outputBufferId = codec.dequeueOutputBuffer(…);
   if (outputBufferId >= 0) {
     ByteBuffer outputBuffer = codec.getOutputBuffer(outputBufferId);
     MediaFormat bufferFormat = codec.getOutputFormat(outputBufferId); // option A
     // bufferFormat is identical to outputFormat
     // outputBuffer is ready to be processed or rendered.
     …
     codec.releaseOutputBuffer(outputBufferId, …);
   } else if (outputBufferId == MediaCodec.INFO_OUTPUT_FORMAT_CHANGED) {
     // Subsequent data will conform to new format.
     // Can ignore if using getOutputFormat(outputBufferId)
     outputFormat = codec.getOutputFormat(); // option B
   }
 }
 codec.stop();
 codec.release();

Synchronous Processing using Buffer Arrays (deprecated)

在版本KITKAT_WATCH和之前，输入和输出缓冲区组由ByteBuffer[]阵列表示。 成功调用后start() ，检索使用缓存阵列getInput / OutputBuffers() 。 如以下示例所示，使用缓冲区ID-s作为这些数组中的索引（非负数时）。 请注意，尽管数组大小提供了上限，但阵列大小与系统使用的输入和输出缓冲区数量之间没有固有的相关性。

 MediaCodec codec = MediaCodec.createByCodecName(name);
 codec.configure(format, …);
 codec.start();
 ByteBuffer[] inputBuffers = codec.getInputBuffers();
 ByteBuffer[] outputBuffers = codec.getOutputBuffers();
 for (;;) {
   int inputBufferId = codec.dequeueInputBuffer(…);
   if (inputBufferId >= 0) {
     // fill inputBuffers[inputBufferId] with valid data
     …
     codec.queueInputBuffer(inputBufferId, …);
   }
   int outputBufferId = codec.dequeueOutputBuffer(…);
   if (outputBufferId >= 0) {
     // outputBuffers[outputBufferId] is ready to be processed or rendered.
     …
     codec.releaseOutputBuffer(outputBufferId, …);
   } else if (outputBufferId == MediaCodec.INFO_OUTPUT_BUFFERS_CHANGED) {
     outputBuffers = codec.getOutputBuffers();
   } else if (outputBufferId == MediaCodec.INFO_OUTPUT_FORMAT_CHANGED) {
     // Subsequent data will conform to new format.
     MediaFormat format = codec.getOutputFormat();
   }
 }
 codec.stop();
 codec.release();

End-of-stream Handling

当你到达输入数据的最后，你必须通过指定其信号编解码器BUFFER_FLAG_END_OF_STREAM呼叫标志queueInputBuffer 。 您可以在最后一个有效的输入缓冲区上执行此操作，或者通过提交一个额外的空输入缓冲区并设置流结束标志。 如果使用空缓冲区，时间戳将被忽略。

编解码器将继续返回输出缓冲区，直到它最终通过在MediaCodec.BufferInfo设置的dequeueOutputBuffer指定的相同流结束标志或通过onOutputBufferAvailable返回来发onOutputBufferAvailable输出流的结束。 这可以在最后一个有效的输出缓冲区上设置，或者在最后一个有效的输出缓冲区之后的空缓冲区上设置。 这个空缓冲区的时间戳应该被忽略。

除非编解码器已被刷新，停止或重新启动，否则在发出输入流结束信号后，请勿提交其他输入缓冲区。

Using an Output Surface

在使用输出Surface时，数据处理与ByteBuffer模式几乎相同; 但是，输出缓冲区将不可访问，并表示为null值。 例如getOutputBuffer / Image(int)将返回null和getOutputBuffers()将返回仅含有一个数组null -s。

使用输出曲面时，可以选择是否渲染曲面上的每个输出缓冲区。 你有三个选择：

• Do not render the buffer: Call releaseOutputBuffer(bufferId, false).
• Render the buffer with the default timestamp: Call releaseOutputBuffer(bufferId, true).
• Render the buffer with a specific timestamp: Call releaseOutputBuffer(bufferId, timestamp).

由于M ，默认时间戳是缓冲区的presentation timestamp （转换为纳秒）。 在此之前没有定义。

另外由于 M ，您可以使用 setOutputSurface动态更改输出曲面。

Transformations When Rendering onto Surface

在M版本之前，软件解码器在渲染到Surface上时可能未应用旋转。 不幸的是，没有办法识别软件解码器，或者如果他们应用轮换而不是通过尝试它。

也有一些警告。

请注意，将输出显示在Surface上时，不考虑像素纵横比。 这意味着如果您使用的是VIDEO_SCALING_MODE_SCALE_TO_FIT模式，则必须定位输出Surface，以使其具有适当的最终显示宽高比。 相反，对于正方形像素（像素宽高比或1：1）的内容，您只能使用VIDEO_SCALING_MODE_SCALE_TO_FIT_WITH_CROPPING模式。

另请注意，从 N版本开始，对于旋转90度或270度的视频， VIDEO_SCALING_MODE_SCALE_TO_FIT_WITH_CROPPING模式可能无法正常工作。

设置视频缩放模式时，请注意每次输出缓冲区更改后必须重置。 由于INFO_OUTPUT_BUFFERS_CHANGED事件已被弃用，因此每次输出格式更改后都可以这样做。

Using an Input Surface

当使用输入表面时，没有可访问的输入缓冲区，因为缓冲区会自动从输入表面传递到编解码器。 调用dequeueInputBuffer将抛出一个IllegalStateException ，并且getInputBuffers()返回一个不能写入的伪造的ByteBuffer[]数组。

致电signalEndOfInputStream()以表示流结束。 此通话后，输入表面将立即停止向编解码器提交数据。

Seeking & Adaptive Playback Support

视频解码器（以及一般使用压缩视频数据的编解码器）在搜索和格式更改方面表现不同，无论它们是否支持并配置为自适应播放。 您可以检查解码器支持adaptive playback通过CodecCapabilities.isFeatureSupported(String) 。 只有将编解码器配置为解码到Surface才会激活对视频解码器的自适应播放支持。

Stream Boundary and Key Frames

start()或flush()之后的输入数据始于合适的流边界很重要：第一个帧必须是关键帧。 关键帧可以完全自行解码（对于大多数编解码器来说，这意味着I帧），并且在关键帧之后没有要显示的帧指的是关键帧之前的帧。

下表总结了各种视频格式的合适关键帧。

For decoders that do not support adaptive playback (including when not decoding onto a Surface)

为了开始解码与先前提交的数据不相邻的数据（即，在寻找之后），您必须清空解码器。 由于所有输出缓冲区在冲洗点立即被撤销，因此您可能需要首先发出信号，然后等待数据流结束，然后再致电flush 。 冲洗后的输入数据始于合适的流边界/关键帧，这一点很重要。

注意：刷新后提交的数据格式不能改变; flush()不支持格式不连续; 为此，完整的stop() - configure(…) - start()周期是必要的。

另请注意：如果您在start()之后start()刷新编解码器 - 通常在收到第一个输出缓冲区或输出格式更改之前 - 您将需要重新提交编解码器特定数据到编解码器。 有关更多信息，请参阅codec-specific-data section 。

For decoders that support and are configured for adaptive playback

为了开始解码与先前提交的数据不相邻的数据（即，在寻找之后）， 不需要刷新解码器; 然而，不连续性之后的输入数据必须从合适的流边界/关键帧开始。

对于某些视频格式（即H.264，H.265，VP8和VP9），也可以在中途更改图片大小或配置。 为此，您必须将全部新的编解码器专用配置数据与关键帧一起打包到单个缓冲区（包括任何启动代码）中，并将其作为常规输入缓冲区提交。

您将收到来自 dequeueOutputBuffer的 INFO_OUTPUT_FORMAT_CHANGED返回值或 onOutputFormatChanged在图片大小更改发生后以及任何具有新大小的帧返回之前的回 INFO_OUTPUT_FORMAT_CHANGED值。

注意：就像编解码器专用数据的情况一样，在更改图片尺寸后不久请致电flush()时请小心。 如果您还没有收到图片尺寸更改的确认，则需要重新请求新图片尺寸。

Error handling

该工厂方法createByCodecName和createDecoder / EncoderByType掷IOException失败，你必须赶上或申报错过。 当方法从不允许的编解码器状态调用时，MediaCodec方法抛出IllegalStateException ; 这通常是由于不正确的应用程序API使用。 涉及安全缓冲区的方法可能会抛出MediaCodec.CryptoException ，它具有可从getErrorCode()获得的更多错误信息。

内部编解码器错误导致MediaCodec.CodecException ，这可能是由于媒体内容损坏，硬件故障，资源耗尽等等，即使应用程序正确使用API。 通过拨打isRecoverable()和isTransient()可以确定收到CodecException时的建议操作：

• recoverable errors: If isRecoverable() returns true, then call stop(), configure(…), and start() to recover.
• transient errors: If isTransient() returns true, then resources are temporarily unavailable and the method may be retried at a later time.
• fatal errors: If both isRecoverable() and isTransient() return false, then the CodecException is fatal and the codec must be reset or released.

isRecoverable()和 isTransient()都不会同时返回true。

Valid API Calls and API History

本部分总结了每种状态下有效的API调用和MediaCodec类的API历史记录。 有关API版本号，请参阅Build.VERSION_CODES 。

Summary

Inherited methods

From class java.lang.Object Object clone() 创建并返回此对象的副本。 boolean equals(Object obj) 指示其他某个对象是否“等于”这一个。 void finalize() 当垃圾收集确定没有更多对该对象的引用时，由对象上的垃圾回收器调用。 final Class<?> getClass() 返回此 Object的运行时类。 int hashCode() 返回对象的哈希码值。 final void notify() 唤醒正在等待该对象监视器的单个线程。 final void notifyAll() 唤醒在该对象监视器上等待的所有线程。 String toString() 返回对象的字符串表示形式。 final void wait(long millis, int nanos) 导致当前线程等待，直到其他线程调用 notify()方法或 notifyAll()方法此对象，或一些其它线程中断当前线程，或实时一定量已过去。 final void wait(long millis) 导致当前线程等待，直到另一个线程调用此对象的 notify()方法或 notifyAll()方法或经过了指定的时间量。 final void wait() 导致当前线程等待，直到另一个线程调用此对象的方法 notify()或方法 notifyAll() 。

Constants

int BUFFER_FLAG_CODEC_CONFIG

int BUFFER_FLAG_END_OF_STREAM

int BUFFER_FLAG_KEY_FRAME

int BUFFER_FLAG_SYNC_FRAME

int CONFIGURE_FLAG_ENCODE

int CRYPTO_MODE_AES_CBC

int CRYPTO_MODE_AES_CTR

int CRYPTO_MODE_UNENCRYPTED

int INFO_OUTPUT_BUFFERS_CHANGED

int INFO_OUTPUT_FORMAT_CHANGED

int INFO_TRY_AGAIN_LATER

String PARAMETER_KEY_REQUEST_SYNC_FRAME

String PARAMETER_KEY_SUSPEND

String PARAMETER_KEY_VIDEO_BITRATE

int VIDEO_SCALING_MODE_SCALE_TO_FIT

int VIDEO_SCALING_MODE_SCALE_TO_FIT_WITH_CROPPING

Public methods

void configure (MediaFormat format, 
                Surface surface, 
                MediaCrypto crypto, 
                int flags)

MediaCodec createByCodecName (String name)

MediaCodec createDecoderByType (String type)

MediaCodec createEncoderByType (String type)

Surface createInputSurface ()

Surface createPersistentInputSurface ()

int dequeueInputBuffer (long timeoutUs)

int dequeueOutputBuffer (MediaCodec.BufferInfo info, 
                long timeoutUs)

void flush ()

MediaCodecInfo getCodecInfo ()

ByteBuffer getInputBuffer (int index)

ByteBuffer[] getInputBuffers ()

MediaFormat getInputFormat ()

Image getInputImage (int index)

String getName ()

ByteBuffer getOutputBuffer (int index)

ByteBuffer[] getOutputBuffers ()

MediaFormat getOutputFormat (int index)

MediaFormat getOutputFormat ()

Image getOutputImage (int index)

void queueInputBuffer (int index, 
                int offset, 
                int size, 
                long presentationTimeUs, 
                int flags)

void queueSecureInputBuffer (int index, 
                int offset, 
                MediaCodec.CryptoInfo info, 
                long presentationTimeUs, 
                int flags)

void release ()

void releaseOutputBuffer (int index, 
                boolean render)

void releaseOutputBuffer (int index, 
                long renderTimestampNs)

void reset ()

void setCallback (MediaCodec.Callback cb, 
                Handler handler)

void setCallback (MediaCodec.Callback cb)

void setInputSurface (Surface surface)

void setOnFrameRenderedListener (MediaCodec.OnFrameRenderedListener listener, 
                Handler handler)

void setOutputSurface (Surface surface)

void setParameters (Bundle params)

void setVideoScalingMode (int mode)

void signalEndOfInputStream ()

void start ()

void stop ()

Protected methods

void finalize ()