HarmonyOS-鸿蒙app开发 —基于java视频编解码开发指导

场景介绍

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

接口说明

普通模式开发步骤

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

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

1. 创建编码Codec实例，可调用createEncoder()创建。
   1. final Codec encoder = Codec.createEncoder();
2. 构造数据源格式，并设置给Codec实例，调用setCodecFormat()，代码示例如下：
   1. Format fmt = new Format();
   2. fmt.putStringValue(Format.MIME, Format.VIDEO_AVC);
   3. fmt.putIntValue(Format.WIDTH, 1920);
   4. fmt.putIntValue(Format.HEIGHT, 1080);
   5. fmt.putIntValue(Format.BIT_RATE, 392000);
   6. fmt.putIntValue(Format.FRAME_RATE, 30);
   7. fmt.putIntValue(Format.FRAME_INTERVAL, 30);
   8. fmt.putIntValue(Format.COLOR_MODEL, 21);
   9. encoder.setCodecFormat(fmt);
3. 如果需要编码过程中，检测是否读取到Buffer数据以及是否发生异常，可以构造ICodecListener，ICodecListener需要实现两个方法，实现读到Buffer数据时、编码发生异常时做相应的操作。举例中读到Buffer时，获取buffer的format格式，异常时抛出运行时异常，代码示例如下：
   1. private HiLogLabel TAG = new HiLogLabel(HiLog.DEBUG, 0xD000500, “MainAblityTest”);
   2. Codec.ICodecListener listener = new Codec.ICodecListener() {
   3. @Override
   4. public void onReadBuffer(ByteBuffer byteBuffer, BufferInfo bufferInfo, int trackId) {
   5. Format fmt = codec.getBufferFormat(byteBuffer);
   6. }
   8. @Override
   9. public void onError(int errorCode, int act, int trackId) {
   10. HiLog.error(TAG, “CodeListener onError errorCode: %{public}d, act: %{public}d”, errorCode, act);
   11. }
   12. };
4. 调用start()方法开始编码。
   1. encoder.start();
5. 调用getAvailableBuffer()取到一个可用的ByteBuffer，把数据填入ByteBuffer里，然后再调用writeBuffer()把ByteBuffer写入编码器实例。
6. 调用stop()方法停止编码。
   1. encoder.stop();
7. 编码任务结束后，调用release()释放资源。
   1. encoder.release();

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

1. 创建解码Codec实例，可调用createDecoder()创建。
   1. Codec codec = Codec.createDecoder();
2. 构造数据源格式，并设置给Codec实例，调用setCodecFormat()，代码示例如下：
   1. Format fmt = new Format();
   2. fmt.putStringValue(Format.MIME, Format.VIDEO_AVC);
   3. fmt.putIntValue(Format.WIDTH, 1920);
   4. fmt.putIntValue(Format.HEIGHT, 1080);
   5. fmt.putIntValue(Format.BIT_RATE, 392000);
   6. fmt.putIntValue(Format.FRAME_RATE, 30);
   7. fmt.putIntValue(Format.FRAME_INTERVAL, –1);
   8. fmt.putIntValue(Format.COLOR_MODEL, 21);
   9. codec.setCodecFormat(fmt);
3. （可选）如果需要解码过程中，检测是否读取到Buffer数据以及是否发生异常，可以构造ICodecListener，ICodecListener需要实现两个方法，实现读到Buffer数据时、解码发生异常时做相应的操作。举例中读到buffer时，获取buffer的format格式，异常时抛出运行时异常，代码示例如下：
   1. Codec.ICodecListener listener = new Codec.ICodecListener() {
   2. @Override
   3. public void onReadBuffer(ByteBuffer byteBuffer, BufferInfo bufferInfo, int trackId) {
   4. Format fmt = codec.getBufferFormat(byteBuffer);
   5. }
   7. @Override
   8. public void onError(int errorCode, int act, int trackId) {
   9. throw new RuntimeException();
   10. }
   11. };
4. 调用 start()方法开始解码。
   1. codec.start();
5. 调用getAvailableBuffer取到一个可用的ByteBuffer，把数据填入ByteBuffer里，然后再调用writeBuffer把ByteBuffer写入解码器实例。
6. 调用 stop()方法停止解码。
   1. codec.stop();
7. 解码任务结束后，调用release()释放资源。
   1. codec.release();

管道模式开发步骤

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

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

1. 调用createEncoder()创建编码Codec实例。
2. 调用setSource()设置数据源，支持设定文件路径或者文件File Descriptor。
3. 构造数据源格式或者从Extractor中读取数据源格式，并设置给Codec实例，调用setSourceFormat()，构造数据源格式代码示例如下：
   1. String path = “/xxx/xxx//asd.mp4”;
   2. boolean ret = decoder.setSource(new Source(path), null);
   3. final Codec encoder = Codec.createEncoder();
   4. Format fmt = new Format();
   5. fmt.putStringValue(Format.MIME, Format.VIDEO_AVC);
   6. fmt.putIntValue(Format.WIDTH, 1920);
   7. fmt.putIntValue(Format.HEIGHT, 1080);
   8. fmt.putIntValue(Format.BIT_RATE, 392000);
   9. fmt.putIntValue(Format.FRAME_RATE, 30);
   10. encoder.setSourceFormat(fmt);
4. （可选）如果需要编码过程中，检测是否读取到Buffer数据以及是否发生异常，可以构造ICodecListener，ICodecListener需要实现两个方法，实现读到Buffer数据时、编码发生异常时做相应的操作。举例中读到buffer时，获取buffer的format格式，异常时抛出运行时异常，代码示例如下：
   1. Codec.ICodecListener listener = new Codec.ICodecListener() {
   2. @Override
   3. public void onReadBuffer(ByteBuffer byteBuffer, BufferInfo bufferInfo, int trackId) {
   4. Format fmt = codec.getBufferFormat(byteBuffer);
   5. }
   7. @Override
   8. public void onError(int errorCode, int act, int trackId) {
   9. HiLog.error(TAG, “PlayerCallback onError errorCode: %{public}d, trackId: %{public}d”, errorCode, trackId);
   10. }
   11. };
5. 调用start()方法开始编码。
6. 调用stop()方法停止编码。
7. 编码任务结束后，调用release()释放资源。

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

1. 调用createDecoder()创建解码Codec实例。
2. 调用setSource()设置数据源，支持设定文件路径或者文件File Descriptor。
3. （可选）如果需要解码过程中，检测是否读取到Buffer数据以及是否发生异常，可以构造ICodecListener，ICodecListener需要实现两个方法，实现读到Buffer数据时、解码发生异常时做相应的操作。举例中读到buffer时，获取buffer的format格式，异常时抛出运行时异常，代码示例如下：
   1. Codec.ICodecListener listener = new Codec.ICodecListener() {
   2. @Override
   3. public void onReadBuffer(ByteBuffer byteBuffer, BufferInfo bufferInfo, int trackId) {
   4. Format fmt = codec.getBufferFormat(byteBuffer);
   5. }
   7. @Override
   8. public void onError(int errorCode, int act, int trackId) {
   9. throw new RuntimeException();
   10. }
   11. };
4. 调用start()方法开始解码。
5. 调用stop()方法停止解码。
6. 解码任务结束后，调用release()释放资源。