3.7 MP4 模块 API 手册

1. 概述

本文详细介绍了 K230_CanMV MP4 模块 API 的功能与使用方法。MP4 模块主要用于生成 MP4 文件，开发者无需关注底层实现细节，只需调用所提供的 API 即可生成不同编码格式和视频分辨率的 MP4 文件。

2. API 介绍

该模块提供了 MP4Container 类，包含以下方法：

2.1 MP4Container.Create

描述

用于创建 MP4Container 实例。

语法

MP4Container.Create(mp4Cfg)

参数

参数名称	描述	输入/输出
mp4cfg	MP4Container 配置	输入

返回值

返回值	描述
0	成功
非 0	失败

2.2 MP4Container.Start

描述

启动 MP4Container 开始处理数据。

语法

MP4Container.Start()

参数

无

返回值

返回值	描述
0	成功
非0	失败

2.3 MP4Container.Process

描述

将一帧音频/视频数据写入 MP4 文件。

语法

MP4Container.Process()

参数

无

返回值

返回值	描述
0	成功
非0	失败

2.4 MP4Container.Stop

描述

停止 MP4Container 的数据处理。

语法

MP4Container.Stop()

参数

无

返回值

返回值	描述
0	成功
非0	失败

2.5 MP4Container.Destroy

描述

销毁创建的 MP4Container 实例。

语法

MP4Container.Destroy()

参数

无

返回值

返回值	描述
0	成功
非0	失败

3. 数据结构描述

3.1 Mp4CfgStr

说明

MP4Container 的配置属性。

定义

class Mp4CfgStr:
    def __init__(self, type):
        self.type = type
        self.muxerCfg = MuxerCfgStr()

    def SetMuxerCfg(self, fileName, videoPayloadType, picWidth, picHeight, audioPayloadType, fmp4Flag=0):
        self.muxerCfg.file_name = fileName
        self.muxerCfg.video_payload_type = videoPayloadType
        self.muxerCfg.pic_width = picWidth
        self.muxerCfg.pic_height = picHeight
        self.muxerCfg.audio_payload_type = audioPayloadType
        self.muxerCfg.fmp4_flag = fmp4Flag

成员

成员名称	描述
type	MP4Container 类型：muxer/demuxer，当前仅支持 muxer
muxerCfg	muxer 配置

相关数据类型及接口

• MP4Container.Create

3.2 MuxerCfgStr

说明

MP4Container muxer 类型的配置属性。

定义

class MuxerCfgStr:
    def __init__(self):
        self.file_name = 0
        self.video_payload_type = 0
        self.pic_width = 0
        self.pic_height = 0
        self.audio_payload_type = 0

成员

成员名称	描述
file_name	生成的 MP4 文件名
video_payload_type	视频编码格式
pic_width	视频帧宽度
pic_height	视频帧高度
audio_payload_type	音频编码格式

相关数据类型及接口

• MP4Container.Create

3.3 MP4Container 类型

说明

MP4Container 类型枚举。

成员

成员名称	描述
MP4_CONFIG_TYPE_MUXER	muxer 类型
MP4_CONFIG_TYPE_DEMUXER	demuxer 类型，目前不支持

3.4 video_payload_type

说明

视频编码类型。

成员

成员名称	描述
MP4_CODEC_ID_H264	H.264 视频编码类型
MP4_CODEC_ID_H265	H.265 视频编码类型

3.5 audio_payload_type

说明

音频编码类型。

成员

成员名称	描述
MP4_CODEC_ID_G711U	G.711U 音频编码类型
MP4_CODEC_ID_G711A	G.711A 音频编码类型

4. 示例程序

4.1 例程 1

from media.mp4format import *
import os

def canmv_mp4_muxer_test():
    print("mp4_muxer_test 开始")
    width = 1280
    height = 720
    # BPI 开发板请设置宽高为640*360
    # width=640
    # height=360
    # 实例化 MP4 Container
    mp4_muxer = Mp4Container()
    mp4_cfg = Mp4CfgStr(mp4_muxer.MP4_CONFIG_TYPE_MUXER)
    if mp4_cfg.type == mp4_muxer.MP4_CONFIG_TYPE_MUXER:
        file_name = "/sdcard/examples/test.mp4"
        mp4_cfg.SetMuxerCfg(file_name, mp4_muxer.MP4_CODEC_ID_H265, width, height, mp4_muxer.MP4_CODEC_ID_G711U)
    # 创建 MP4 muxer
    mp4_muxer.Create(mp4_cfg)
    # 启动 MP4 muxer
    mp4_muxer.Start()

    frame_count = 0
    try:
        while True:
            os.exitpoint()
            # 处理音视频数据，按 MP4 格式写入文件
            mp4_muxer.Process()
            frame_count += 1
            print("frame_count = ", frame_count)
            if frame_count >= 200:
                break
    except BaseException as e:
        print(e)
    # 停止 MP4 muxer
    mp4_muxer.Stop()
    # 销毁 MP4 muxer
    mp4_muxer.Destroy()
    print("mp4_muxer_test 停止")

canmv_mp4_muxer_test()