-

场景介绍

视频编解码的主要工作是将视频进行编码和解码。

接口说明

接口名 功能描述
createDecoder() 创建解码器Codec实例。
createEncoder() 创建编码器Codec实例。
registerCodecListener(ICodecListener listener) 注册侦听器用来异步接收编码或解码后的数据。
setSource(Source source, TrackInfo trackInfo) 根据解码器的源轨道信息设置数据源,对于编码器trackInfo无效。
setSourceFormat(Format format) 编码器的管道模式下,设置编码器编码格式。
setCodecFormat(Format format) 普通模式设置编/解码器参数。
setVideoSurface(Surface surface) 设置解码器的Surface。
getAvailableBuffer(long timeout) 普通模式获取可用ByteBuffer。
writeBuffer(ByteBuffer buffer, BufferInfo info) 推送源数据给Codec。
getBufferFormat(ByteBuffer buffer) 获取输出Buffer数据格式。
start() 启动编/解码。
stop() 停止编/解码。
release() 释放所有资源。

普通模式开发步骤

在普通模式下进行编解码,应用必须持续地传输数据到 Codec 实例。

编码的具体开发步骤如下

  1. 创建编码 Codec 实例,可调用 createEncoder() 创建。

   final Codec encoder = Codec.createEncoder();

  1. 构造数据源格式,并设置给 Codec 实例,调用 setCodecFormat(),代码示例如下:

   Format fmt = new Format();
   fmt.putStringValue(Format.MIME, Format.VIDEO_AVC);
   fmt.putIntValue(Format.WIDTH, 1920);
   fmt.putIntValue(Format.HEIGHT, 1080);
   fmt.putIntValue(Format.BIT_RATE, 392000);
   fmt.putIntValue(Format.FRAME_RATE, 30);
   fmt.putIntValue(Format.FRAME_INTERVAL, -1);
   codec.setCodecFormat(fmt);

  1. 如果需要编码过程中,检测是否读取到 Buffer 数据以及是否发生异常,可以构造 ICodecListener, ICodecListener 需要实现两个方法,实现读到 Buffer 数据时、编码发生异常时做相应的操作。举例中读到 buffer 时,获取 buffer 的 format 格式,异常时抛出运行时异常,代码示例如下:

   Codec.ICodecListener listener = new Codec.ICodecListener() {
       @Override
       public void onReadBuffer(ByteBuffer byteBuffer, BufferInfo bufferInfo, int trackId) {
           Format fmt = codec.getBufferFormat(byteBuffer);
       }

    
       @Override
       public void onError(int errorCode, int act, int trackId) {
           throw new RuntimeException();
       }
   };

  1. 调用 start() 方法开始编码。

  1. 调用 getAvailableBuffer() 取到一个可用的 ByteBuffer,把数据填入 ByteBuffer 里,然后再调用 writeBuffer() 把 ByteBuffer 写入编码器实例。

  1. 调用 stop() 方法停止编码。

  1. 编码任务结束后,调用 release() 释放资源。

解码的具体开发步骤如下:

  1. 创建解码 Codec 实例,可调用 createDecoder() 创建。

  1. 构造数据源格式,并设置给 Codec 实例,调用 setCodecFormat(),代码示例如下:

   Format fmt = new Format();
   fmt.putStringValue(Format.MIME, Format.VIDEO_AVC);
   fmt.putIntValue(Format.WIDTH, 1920);
   fmt.putIntValue(Format.HEIGHT, 1080);
   fmt.putIntValue(Format.BIT_RATE, 392000);
   fmt.putIntValue(Format.FRAME_RATE, 30);
   fmt.putIntValue(Format.FRAME_INTERVAL, -1);
   codec.setCodecFormat(fmt);

  1. (可选)如果需要解码过程中,检测是否读取到 Buffer 数据以及是否发生异常,可以构造 ICodecListener,ICodecListener 需要实现两个方法,实现读到 Buffer 数据时、解码发生异常时做相应的操作。举例中读到 buffer 时,获取 buffer 的 format 格式,异常时抛出运行时异常,代码示例如下:

   Codec.ICodecListener listener = new Codec.ICodecListener() {
       @Override
       public void onReadBuffer(ByteBuffer byteBuffer, BufferInfo bufferInfo, int trackId) {
           Format fmt = codec.getBufferFormat(byteBuffer);
       }

    
       @Override
       public void onError(int errorCode, int act, int trackId) {
           throw new RuntimeException();
       }
   };

  1. 调用 start() 方法开始解码。

  1. 调用 getAvailableBuffer 取到一个可用的 ByteBuffer,把数据填入 ByteBuffer 里,然后再调用 writeBuffer 把 ByteBuffer 写入解码器实例。

  1. 调用 stop() 方法停止解码。

  1. 解码任务结束后,调用 release() 释放资源。

管道模式开发步骤

管道模式下应用只需要调用 Source 类的 setSource() 方法,数据会自动解析并传输给 Codec 实例。管道模式编码支持视频流编码和音频流编码。

编码的具体开发步骤如下:

  1. 调用 createEncoder() 创建编码 Codec 实例。

  1. 调用 setSource() 设置数据源,支持设定文件路径或者文件 File Descriptor。

  1. 构造数据源格式或者从 Extractor 中读取数据源格式,并设置给 Codec 实例,调用 setSourceFormat(),构造数据原格式代码示例如下:

   Format fmt = new Format();
   fmt.putStringValue(Format.MIME, Format.VIDEO_AVC);
   fmt.putIntValue(Format.WIDTH, 1920);
   fmt.putIntValue(Format.HEIGHT, 1080);
   fmt.putIntValue(Format.BIT_RATE, 392000);
   fmt.putIntValue(Format.FRAME_RATE, 30);
   fmt.putIntValue(Format.FRAME_INTERVAL, -1);
   codec.setSourceFormat(fmt);

  1. (可选)如果需要编码过程中,检测是否读取到 Buffer 数据以及是否发生异常,可以构造 ICodecListener,ICodecListener 需要实现两个方法,实现读到 Buffer 数据时、编码发生异常时做相应的操作。举例中读到 buffer 时,获取 buffer 的 format 格式,异常时抛出运行时异常,代码示例如下:

   Codec.ICodecListener listener = new Codec.ICodecListener() {
       @Override
       public void onReadBuffer(ByteBuffer byteBuffer, BufferInfo bufferInfo, int trackId) {
           Format fmt = codec.getBufferFormat(byteBuffer);
       }

    
       @Override
       public void onError(int errorCode, int act, int trackId) {
           throw new RuntimeException();
       }
   };

  1. 调用 start() 方法开始编码。

  1. 调用 stop() 方法停止编码。

  1. 编码任务结束后,调用 release() 释放资源。

解码的具体开发步骤如下:

  1. 调用 createDecoder()创建解码 Codec 实例。

  1. 调用 setSource()设置数据源,支持设定文件路径或者文件 File Descriptor。

  1. (可选)如果需要解码过程中,检测是否读取到 Buffer数据以及是否发生异常,可以构造 ICodecListener,ICodecListener 需要实现两个方法,实现读到 Buffer 数据时、解码发生异常时做相应的操作。举例中读到 buffer 时,获取 buffer 的 format 格式,异常时抛出运行时异常,代码示例如下:

   Codec.ICodecListener listener = new Codec.ICodecListener() {
       @Override
       public void onReadBuffer(ByteBuffer byteBuffer, BufferInfo bufferInfo, int trackId) {
           Format fmt = codec.getBufferFormat(byteBuffer);
       }

    
       @Override
       public void onError(int errorCode, int act, int trackId) {
           throw new RuntimeException();
       }
   };

  1. 调用 start() 方法开始解码。

  1. 调用 stop() 方法停止解码。

  1. 解码任务结束后,调用 release() 释放资源。