使用AVTranscoder进行视频转码失败
======================

#### 问题现象

开发过程中，使用AVTranscoder进行视频转码时，会出现转码失败的场景，如何解决？

#### 背景知识

*   [AVTranscoder](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/media-kit-intro#avtranscoder)主要用于将已压缩编码的视频文件按照指定参数转换为另一种格式的视频。
*   支持修改源视频文件的编码参数（格式、码率）和封装格式。源视频的音视频编码和封装格式为系统AVCodec支持的解码和解封装格式，目标视频的音视频编码和封装格式为系统AVCodec支持的编码和封装格式，详情可以参考[AVCodec支持的格式](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/avcodec-support-formats)。

#### 解决方案

下面列举转码过程中，常见的一些错误场景。

*   **场景一**：视频转码失败并报错。
    
    code = 5400103 message = "IO Error: unknown error"
    

IO错误原因通常有：

*   源文件、输出文件配置错误，不可是同一个文件。
*   目标文件格式错误，当前输出视频文件仅支持mp4，可参考[AVTranscoderConfig.fileFormat](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/arkts-apis-media-i#avtranscoderconfig12)参数说明，核心代码如下，完整代码可[参考官网](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/using-avtranscoder-for-transcodering)。
    
    private avConfig: media.AVTranscoderConfig = {
      audioBitrate: 100000, _// 音频比特率。_
      audioCodec: media.CodecMimeType.AUDIO\_AAC, _// 音频编码格式。_
      fileFormat: media.ContainerFormatType.CFT\_MPEG\_4, _// 封装格式。_
      videoBitrate: 200000, _// 视频比特率。_
      videoCodec: media.CodecMimeType.VIDEO\_AVC, _// 视频编码格式。_
      videoFrameWidth: 640, _// 视频分辨率的宽为640。_
      videoFrameHeight: 480, _// 视频分辨率的高为480。_
    };
    
*   文件路径设置错误，如果使用本地资源转码，必须确认资源文件可用，并使用应用沙箱路径访问对应资源，参考[获取应用文件路径](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/application-context-stage#获取应用文件路径)。应用沙箱的介绍及如何向应用沙箱推送文件，请参考[应用沙箱目录](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/app-sandbox-directory)。完整示例代码可以参考[使用AVTranscoder实现视频转码示例工程](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/using-avtranscoder-for-transcodering#运行示例工程)。

*   **场景二：**视频转码失败并报错：
    
    #223 errCode: 5400103, errMsg: IO error happened due to Prepare.
    
    #64 SendErrorCallback:errorCode 401, errorMsg Invalid Parameter: invalid argument
    #67 can not find error callback!
    #83 StateChange, currentState: idle to state: error
    #213 failed to Prepare, param , errCode = -7
    #223 errCode: 5400103, errMsg: IO error happened due to Prepare.
    #755 SignedError: IO error happened due to Prepare.
    
    此错误通常是由于目标视频宽、高分辨率大于源视频宽、高，或设置为奇数导致，可以通过[AVTranscoderConfig](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/arkts-apis-media-i#avtranscoderconfig12)配置合适的视频的宽高分辨率（不配置默认采用源视频的宽高）：
    
    private avConfig: media.AVTranscoderConfig = {
      audioBitrate: 100000, _// 音频比特率。_
      audioCodec: media.CodecMimeType.AUDIO\_AAC, _// 音频编码格式。_
      fileFormat: media.ContainerFormatType.CFT\_MPEG\_4, _// 封装格式。_
      videoBitrate: 200000, _// 视频比特率。_
      videoCodec: media.CodecMimeType.VIDEO\_AVC, _// 视频编码格式。_
      videoFrameWidth: 640, _// 视频分辨率的宽为640。_
      videoFrameHeight: 480, _// 视频分辨率的高为480。_
    };
    
*   **场景三**：用户媒体相册里的文件怎么转码，需要复制到沙箱再转码吗？
    
    用户使用[photoViewPicker](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/photoaccesshelper-photoviewpicker)选择视频文件获取uri后，可通过[fs.opensync](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/js-apis-file-fs#fsopensync)获取源视频文件fd后直接转码，不用复制到沙箱再转，示例代码如下，完整代码可[参考官网](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/using-avtranscoder-for-transcodering)。
    
    async picture() {
      let PhotoSelectOptions = new photoAccessHelper.PhotoSelectOptions();
      PhotoSelectOptions.MIMEType = photoAccessHelper.PhotoViewMIMETypes.VIDEO\_TYPE;
      PhotoSelectOptions.maxSelectNumber = 1;
      let photoPicker = new photoAccessHelper.PhotoViewPicker();
      let pathDir = this.context?.filesDir;
      photoPicker.select(PhotoSelectOptions).then((PhotoSelectResult: photoAccessHelper.PhotoSelectResult) => {
        let photouri: Array<string> = PhotoSelectResult.photoUris;
        let file = fs.openSync(photouri\[0\], fs.OpenMode.READ\_ONLY);
        let file2 = fs.openSync(pathDir + '/h264\_1280\_720.mp4', fs.OpenMode.READ\_WRITE | fs.OpenMode.CREATE);
        this.filePath = pathDir + '/h264\_1280\_720.mp4';
        fs.copyFileSync(file.fd, file2.fd);
        fs.closeSync(file);
        fs.closeSync(file2);
      });
    }
    
*   **场景四**：需要提取mp4视频中音频到mp3音频文件怎么实现？
    
    AVTranscoder当前不支持mp4转mp3文件，可以使用三方库[@ohos/mp4parser](https://ohpm.openharmony.cn/#/cn/detail/@ohos%2Fmp4parser)通过执行FFmpeg命令实现。
    
*   **场景五**：在传入文件入参不变的情况下，调用avTranscoder.prepare，有时会报错，有时正常，报错code：5400106。
    
    该错误是因为在设置输入文件fd句柄后，又将同一个资源句柄传递给一个或多个AVPlayer / AVMetadataExtractor / AVImageGenerator / AVTranscoder实例。这是不允许的，可以查看[AVTranscoder属性](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/arkts-apis-media-avtranscoder)文档的fdSrc属性。如果需要用到原文件，可以将其复制进沙箱目录后再用复制后的文件fd句柄来代替原来的句柄fd。
    

#### 常见FAQ

Q：是否支持MOV格式视频转码？

A：支持的，可参考[使用AVTranscoder实现视频转码](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/using-avtranscoder-for-transcodering)。

Q：参数设置不正常，如目标宽高参数小于源视频宽高，且码率设置远超源视频码率，转码后视频打开后没有画面，宽高分辨率均为0，并且码率也是0，这个压缩后的视频理论上说已经异常了，为什么回调的不是error方法呢？

A：根据[on('error')](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/arkts-apis-media-avtranscoder#onerror12)可知，该回调仅用于错误提示。虽然参数不正常，但根据参数转码压缩并未出现错误提示，最终压缩转码成功，所以并未走error回调。