From 1493dcce21e2ae92b0b8dbef590aba6ad26f4fc1 Mon Sep 17 00:00:00 2001 From: tianmuhao Date: Sun, 27 Apr 2025 17:40:24 +0800 Subject: [PATCH 1/8] =?UTF-8?q?=E8=93=9D=E5=8C=BAavrecorder=E6=96=87?= =?UTF-8?q?=E6=A1=A3AI=E5=91=8A=E8=AD=A6=E4=BF=AE=E5=A4=8D?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Signed-off-by: tianmuhao --- .../reference/apis-media-kit/_a_v_recorder.md | 148 +++++++++--------- .../_o_h___a_v_recorder___config.md | 4 +- .../_o_h___a_v_recorder___encoder_info.md | 4 +- .../_o_h___a_v_recorder___location.md | 4 +- .../_o_h___a_v_recorder___range.md | 2 +- 5 files changed, 81 insertions(+), 81 deletions(-) diff --git a/zh-cn/application-dev/reference/apis-media-kit/_a_v_recorder.md b/zh-cn/application-dev/reference/apis-media-kit/_a_v_recorder.md index 3450806139a..0249924202f 100644 --- a/zh-cn/application-dev/reference/apis-media-kit/_a_v_recorder.md +++ b/zh-cn/application-dev/reference/apis-media-kit/_a_v_recorder.md @@ -20,47 +20,47 @@ ### 文件 -| 名称 | 描述 | -| -------- | -------- | -| [avrecorder.h](avrecorder_8h.md) | 定义AVRecorder接口。应用可使用Media AVRecorder提供的接口录制媒体数据。 | -| [avrecorder_base.h](avrecorder__base_8h.md) | 定义了媒体 AVRecorder 的结构体和枚举。 | +| 名称 | 描述 | +| -------- |------------------------------------------------| +| [avrecorder.h](avrecorder_8h.md) | 定义AVRecorder接口。应用可使用媒体 AVRecorder 提供的接口录制媒体数据。 | +| [avrecorder_base.h](avrecorder__base_8h.md) | 定义了媒体 AVRecorder 的结构体和枚举。 | -### 结构体 +### 类型定义 -| 名称 | 描述 | -| -------- | -------- | -| struct [OH_AVRecorder_Profile](_o_h___a_v_recorder___profile.md) | 定义音视频录制的详细参数。
可以通过参数设置选择只录制音频或只录制视频：当 audioBitrate 或 audioChannels 为 0 时，不录制音频；当 videoFrameWidth 或 videoFrameHeight 为 0 时，不录制视频。 | -| struct [OH_AVRecorder_Location](_o_h___a_v_recorder___location.md) | 提供媒体资源的地理位置信息。 | -| struct [OH_AVRecorder_MetadataTemplate](_o_h___a_v_recorder___metadata_template.md) | 定义元数据的基本模板。 | -| struct [OH_AVRecorder_Metadata](_o_h___a_v_recorder___metadata.md) | 设置元数据信息。 | -| struct [OH_AVRecorder_Config](_o_h___a_v_recorder___config.md) | 提供媒体AVRecorder的配置定义。 | -| struct [OH_AVRecorder_Range](_o_h___a_v_recorder___range.md) | 表示一个类型的范围。 | -| struct [OH_AVRecorder_EncoderInfo](_o_h___a_v_recorder___encoder_info.md) | 提供编码器信息。 | +| 名称 | 描述 | +| -------- |------------------------------------------------------------------------------------------------------------------------------| +| typedef struct [OH_AVRecorder](#oh_avrecorder) [OH_AVRecorder](#oh_avrecorder) | 初始化AVRecorder。 | +| typedef enum [OH_AVRecorder_AudioSourceType](#oh_avrecorder_audiosourcetype-1) [OH_AVRecorder_AudioSourceType](#oh_avrecorder_audiosourcetype) | AVRecorder的音频源类型。 | +| typedef enum [OH_AVRecorder_VideoSourceType](#oh_avrecorder_videosourcetype-1) [OH_AVRecorder_VideoSourceType](#oh_avrecorder_videosourcetype) | AVRecorder的视频源类型。 | +| typedef enum [OH_AVRecorder_CodecMimeType](#oh_avrecorder_codecmimetype-1) [OH_AVRecorder_CodecMimeType](#oh_avrecorder_codecmimetype) | 编码器 MIME 类型。 | +| typedef enum [OH_AVRecorder_ContainerFormatType](#oh_avrecorder_containerformattype-1) [OH_AVRecorder_ContainerFormatType](#oh_avrecorder_containerformattype) | 容器格式类型（容器格式类型的缩写是 CFT）。 | +| typedef enum [OH_AVRecorder_State](#oh_avrecorder_state-1) [OH_AVRecorder_State](#oh_avrecorder_state) | AVRecorder状态。 | +| typedef enum [OH_AVRecorder_StateChangeReason](#oh_avrecorder_statechangereason-1) [OH_AVRecorder_StateChangeReason](#oh_avrecorder_statechangereason) | AVRecorder状态变化的原因。 | +| typedef enum [OH_AVRecorder_FileGenerationMode](#oh_avrecorder_filegenerationmode-1) [OH_AVRecorder_FileGenerationMode](#oh_avrecorder_filegenerationmode) | 创建录制文件的模式。 | +| typedef struct [OH_AVRecorder_Profile](_o_h___a_v_recorder___profile.md) [OH_AVRecorder_Profile](#oh_avrecorder_profile) | 定义音视频录制的详细参数。
通过参数设置可以选择只录制音频或只录制视频：当 audioBitrate 或 audioChannels 为 0 时，不录制音频；当 videoFrameWidth 或 videoFrameHeight 为 0 时，不录制视频。 | +| typedef struct [OH_AVRecorder_Location](_o_h___a_v_recorder___location.md) [OH_AVRecorder_Location](#oh_avrecorder_location) | 提供媒体资源的地理位置信息。 | +| typedef struct [OH_AVRecorder_MetadataTemplate](_o_h___a_v_recorder___metadata_template.md) [OH_AVRecorder_MetadataTemplate](#oh_avrecorder_metadatatemplate) | 定义元数据的基本模板。 | +| typedef struct [OH_AVRecorder_Metadata](_o_h___a_v_recorder___metadata.md) [OH_AVRecorder_Metadata](#oh_avrecorder_metadata) | 元数据信息数据结构。 | +| typedef struct [OH_AVRecorder_Config](_o_h___a_v_recorder___config.md) [OH_AVRecorder_Config](#oh_avrecorder_config) | 提供媒体AVRecorder的配置定义。 | +| typedef struct [OH_AVRecorder_Range](_o_h___a_v_recorder___range.md) [OH_AVRecorder_Range](#oh_avrecorder_range) | 表示类型的范围。 | +| typedef struct [OH_AVRecorder_EncoderInfo](_o_h___a_v_recorder___encoder_info.md) [OH_AVRecorder_EncoderInfo](#oh_avrecorder_encoderinfo) | 提供编码器信息。 | +| typedef void(\* [OH_AVRecorder_OnStateChange](#oh_avrecorder_onstatechange)) ([OH_AVRecorder](#oh_avrecorder) \*recorder, [OH_AVRecorder_State](#oh_avrecorder_state) state, [OH_AVRecorder_StateChangeReason](#oh_avrecorder_statechangereason) reason, void \*userData) | 当录制状态发生变化时调用。 | +| typedef void(\* [OH_AVRecorder_OnError](#oh_avrecorder_onerror)) ([OH_AVRecorder](#oh_avrecorder) \*recorder, int32_t errorCode, const char \*errorMsg, void \*userData) | 当录制过程中发生错误时调用。 | +| typedef void(\* [OH_AVRecorder_OnUri](#oh_avrecorder_onuri)) ([OH_AVRecorder](#oh_avrecorder) \*recorder, OH_MediaAsset \*asset, void \*userData) | 当录制在 OH_AVRecorder_FileGenerationMode.AVRECORDER_AUTO_CREATE_CAMERA_SCENE模式下时调用。 | -### 类型定义 +### 结构体 -| 名称 | 描述 | -| -------- | -------- | -| typedef struct [OH_AVRecorder](#oh_avrecorder) [OH_AVRecorder](#oh_avrecorder) | 初始化AVRecorder。 | -| typedef enum [OH_AVRecorder_AudioSourceType](#oh_avrecorder_audiosourcetype-1) [OH_AVRecorder_AudioSourceType](#oh_avrecorder_audiosourcetype) | AVRecorder的音频源类型。 | -| typedef enum [OH_AVRecorder_VideoSourceType](#oh_avrecorder_videosourcetype-1) [OH_AVRecorder_VideoSourceType](#oh_avrecorder_videosourcetype) | AVRecorder的视频源类型。 | -| typedef enum [OH_AVRecorder_CodecMimeType](#oh_avrecorder_codecmimetype-1) [OH_AVRecorder_CodecMimeType](#oh_avrecorder_codecmimetype) | 枚举编码器 MIME 类型。 | -| typedef enum [OH_AVRecorder_ContainerFormatType](#oh_avrecorder_containerformattype-1) [OH_AVRecorder_ContainerFormatType](#oh_avrecorder_containerformattype) | 枚举容器格式类型（容器格式类型的缩写是 CFT）。 | -| typedef enum [OH_AVRecorder_State](#oh_avrecorder_state-1) [OH_AVRecorder_State](#oh_avrecorder_state) | AVRecorder状态。 | -| typedef enum [OH_AVRecorder_StateChangeReason](#oh_avrecorder_statechangereason-1) [OH_AVRecorder_StateChangeReason](#oh_avrecorder_statechangereason) | AVRecorder状态变化的原因。 | -| typedef enum [OH_AVRecorder_FileGenerationMode](#oh_avrecorder_filegenerationmode-1) [OH_AVRecorder_FileGenerationMode](#oh_avrecorder_filegenerationmode) | 创建录制文件的模式。 | -| typedef struct [OH_AVRecorder_Profile](_o_h___a_v_recorder___profile.md) [OH_AVRecorder_Profile](#oh_avrecorder_profile) | 定义音视频录制的详细参数。
可以通过参数设置选择只录制音频或只录制视频：当 audioBitrate 或 audioChannels 为 0 时，不录制音频；当 videoFrameWidth 或 videoFrameHeight 为 0 时，不录制视频。 | -| typedef struct [OH_AVRecorder_Location](_o_h___a_v_recorder___location.md) [OH_AVRecorder_Location](#oh_avrecorder_location) | 提供媒体资源的地理位置信息。 | -| typedef struct [OH_AVRecorder_MetadataTemplate](_o_h___a_v_recorder___metadata_template.md) [OH_AVRecorder_MetadataTemplate](#oh_avrecorder_metadatatemplate) | 定义元数据的基本模板。 | -| typedef struct [OH_AVRecorder_Metadata](_o_h___a_v_recorder___metadata.md) [OH_AVRecorder_Metadata](#oh_avrecorder_metadata) | 设置元数据信息。 | -| typedef struct [OH_AVRecorder_Config](_o_h___a_v_recorder___config.md) [OH_AVRecorder_Config](#oh_avrecorder_config) | 提供媒体AVRecorder的配置定义。 | -| typedef struct [OH_AVRecorder_Range](_o_h___a_v_recorder___range.md) [OH_AVRecorder_Range](#oh_avrecorder_range) | 表示一个类型的范围。 | -| typedef struct [OH_AVRecorder_EncoderInfo](_o_h___a_v_recorder___encoder_info.md) [OH_AVRecorder_EncoderInfo](#oh_avrecorder_encoderinfo) | 提供编码器信息。 | -| typedef void(\* [OH_AVRecorder_OnStateChange](#oh_avrecorder_onstatechange)) ([OH_AVRecorder](#oh_avrecorder) \*recorder, [OH_AVRecorder_State](#oh_avrecorder_state) state, [OH_AVRecorder_StateChangeReason](#oh_avrecorder_statechangereason) reason, void \*userData) | 当录制状态发生变化时调用。 | -| typedef void(\* [OH_AVRecorder_OnError](#oh_avrecorder_onerror)) ([OH_AVRecorder](#oh_avrecorder) \*recorder, int32_t errorCode, const char \*errorMsg, void \*userData) | 当录制过程中发生错误时调用。 | -| typedef void(\* [OH_AVRecorder_OnUri](#oh_avrecorder_onuri)) ([OH_AVRecorder](#oh_avrecorder) \*recorder, OH_MediaAsset \*asset, void \*userData) | 当录制在 OH_AVRecorder_FileGenerationMode.AVRECORDER_AUTO_CREATE_CAMERA_SCENE模式下时调用。 | +| 名称 | 描述 | +| -------- |----------------------------------------------------------------------------------------------------------------------------------| +| struct [OH_AVRecorder_Profile](_o_h___a_v_recorder___profile.md) | 定义音视频录制的详细参数。
通过参数设置可以选择只录制音频或只录制视频：当 audioBitrate 或 audioChannels 为 0 时，不录制音频；当 videoFrameWidth 或 videoFrameHeight 为 0 时，不录制视频。 | +| struct [OH_AVRecorder_Location](_o_h___a_v_recorder___location.md) | 提供媒体资源的地理位置信息。 | +| struct [OH_AVRecorder_MetadataTemplate](_o_h___a_v_recorder___metadata_template.md) | 定义元数据的基本模板。 | +| struct [OH_AVRecorder_Metadata](_o_h___a_v_recorder___metadata.md) | 元数据信息数据结构。 | +| struct [OH_AVRecorder_Config](_o_h___a_v_recorder___config.md) | 提供媒体AVRecorder的配置定义。 | +| struct [OH_AVRecorder_Range](_o_h___a_v_recorder___range.md) | 表示类型的范围。 | +| struct [OH_AVRecorder_EncoderInfo](_o_h___a_v_recorder___encoder_info.md) | 提供编码器信息。 | ### 枚举 @@ -69,8 +69,8 @@ | -------- | -------- | | [OH_AVRecorder_AudioSourceType](#oh_avrecorder_audiosourcetype-1) {
AVRECORDER_DEFAULT = 0,
AVRECORDER_MIC = 1,
AVRECORDER_VOICE_RECOGNITION = 2,
AVRECORDER_VOICE_COMMUNICATION = 7,
AVRECORDER_VOICE_MESSAGE = 10,
AVRECORDER_CAMCORDER = 13
} | AVRecorder的音频源类型。 | | [OH_AVRecorder_VideoSourceType](#oh_avrecorder_videosourcetype-1) {
AVRECORDER_SURFACE_YUV = 0,
AVRECORDER_SURFACE_ES = 1 } | AVRecorder的视频源类型。 | -| [OH_AVRecorder_CodecMimeType](#oh_avrecorder_codecmimetype-1) {
AVRECORDER_VIDEO_AVC = 2,
AVRECORDER_AUDIO_AAC = 3,
AVRECORDER_AUDIO_MP3 = 4,
AVRECORDER_AUDIO_G711MU = 5,
AVRECORDER_VIDEO_MPEG4 = 6,
AVRECORDER_VIDEO_HEVC = 8,
AVRECORDER_AUDIO_AMR_NB = 9,
AVRECORDER_AUDIO_AMR_WB = 10
} | 枚举编码器 MIME 类型。 | -| [OH_AVRecorder_ContainerFormatType](#oh_avrecorder_containerformattype-1) {
AVRECORDER_CFT_MPEG_4 = 2,
AVRECORDER_CFT_MPEG_4A = 6,
AVRECORDER_CFT_AMR = 8,
AVRECORDER_CFT_MP3 = 9,
AVRECORDER_CFT_WAV = 10
} | 枚举容器格式类型（容器格式类型的缩写是 CFT）。 | +| [OH_AVRecorder_CodecMimeType](#oh_avrecorder_codecmimetype-1) {
AVRECORDER_VIDEO_AVC = 2,
AVRECORDER_AUDIO_AAC = 3,
AVRECORDER_AUDIO_MP3 = 4,
AVRECORDER_AUDIO_G711MU = 5,
AVRECORDER_VIDEO_MPEG4 = 6,
AVRECORDER_VIDEO_HEVC = 8,
AVRECORDER_AUDIO_AMR_NB = 9,
AVRECORDER_AUDIO_AMR_WB = 10
} | 编码器 MIME 类型。 | +| [OH_AVRecorder_ContainerFormatType](#oh_avrecorder_containerformattype-1) {
AVRECORDER_CFT_MPEG_4 = 2,
AVRECORDER_CFT_MPEG_4A = 6,
AVRECORDER_CFT_AMR = 8,
AVRECORDER_CFT_MP3 = 9,
AVRECORDER_CFT_WAV = 10
} | 容器格式类型（容器格式类型的缩写是 CFT）。 | | [OH_AVRecorder_State](#oh_avrecorder_state-1) {
AVRECORDER_IDLE = 0,
AVRECORDER_PREPARED = 1,
AVRECORDER_STARTED = 2,
AVRECORDER_PAUSED = 3,
AVRECORDER_STOPPED = 4,
AVRECORDER_RELEASED = 5, AVRECORDER_ERROR = 6
} | AVRecorder状态。 | | [OH_AVRecorder_StateChangeReason](#oh_avrecorder_statechangereason-1) {
AVRECORDER_USER = 0,
AVRECORDER_BACKGROUND = 1
} | AVRecorder状态变化的原因。 | | [OH_AVRecorder_FileGenerationMode](#oh_avrecorder_filegenerationmode-1) {
AVRECORDER_APP_CREATE = 0, AVRECORDER_AUTO_CREATE_CAMERA_SCENE = 1
} | 创建录制文件的模式。 | @@ -138,7 +138,7 @@ typedef enum OH_AVRecorder_CodecMimeType OH_AVRecorder_CodecMimeType **描述** -枚举编码器 MIME 类型。 +编码器 MIME 类型。 **系统能力：** SystemCapability.Multimedia.Media.AVRecorder @@ -168,7 +168,7 @@ typedef enum OH_AVRecorder_ContainerFormatType OH_AVRecorder_ContainerFormatType **描述** -枚举容器格式类型（容器格式类型的缩写是 CFT）。 +容器格式类型（容器格式类型的缩写是 CFT）。 **系统能力：** SystemCapability.Multimedia.Media.AVRecorder @@ -228,7 +228,7 @@ typedef struct OH_AVRecorder_Metadata OH_AVRecorder_Metadata **描述** -设置元数据信息。 +元数据信息数据结构。 **系统能力：** SystemCapability.Multimedia.Media.AVRecorder @@ -258,7 +258,7 @@ typedef void (*OH_AVRecorder_OnError)(OH_AVRecorder *recorder, int32_t errorCode **描述** -当录制过程中发生错误时调用。错误码的详细说明请参见[AVErrorCode](js-apis-media.md#averrorcode9)。 +当录制过程中发生错误时调用，错误码的详细说明请参见[AVErrorCode](js-apis-media.md#averrorcode9)。 **系统能力：** SystemCapability.Multimedia.Media.AVRecorder @@ -306,7 +306,7 @@ typedef void (*OH_AVRecorder_OnUri)(OH_AVRecorder *recorder, OH_MediaAsset *asse **描述** -当录制在 OH_AVRecorder_FileGenerationMode.AVRECORDER_AUTO_CREATE_CAMERA_SCENE 模式下时调用。 +当录制在 OH_AVRecorder_FileGenerationMode.AVRECORDER_AUTO_CREATE_CAMERA_SCENE 模式时调用。 **系统能力：** SystemCapability.Multimedia.Media.AVRecorder @@ -331,7 +331,7 @@ typedef struct OH_AVRecorder_Profile OH_AVRecorder_Profile 定义音视频录制的详细参数。 -可以通过参数设置选择只录制音频或只录制视频：当 audioBitrate 或 audioChannels 为 0 时，不录制音频；当 videoFrameWidth 或 videoFrameHeight 为 0 时，不录制视频。 +通过参数设置可以选择只录制音频或只录制视频：当 audioBitrate 或 audioChannels 为 0 时，不录制音频；当 videoFrameWidth 或 videoFrameHeight 为 0 时，不录制视频。 各参数的范围请参见[AVRecorderProfile](js-apis-media.md#avrecorderprofile9)。 @@ -348,7 +348,7 @@ typedef struct OH_AVRecorder_Range OH_AVRecorder_Range **描述** -表示一个类型的范围。 +表示类型的范围。 **系统能力：** SystemCapability.Multimedia.Media.AVRecorder @@ -435,7 +435,7 @@ enum OH_AVRecorder_CodecMimeType **描述** -枚举编码器 MIME 类型。 +编码器 MIME 类型。 **系统能力：** SystemCapability.Multimedia.Media.AVRecorder @@ -461,7 +461,7 @@ enum OH_AVRecorder_ContainerFormatType **描述** -枚举容器格式类型（容器格式类型的缩写是 CFT）。 +容器格式类型（容器格式类型的缩写是 CFT）。 **系统能力：** SystemCapability.Multimedia.Media.AVRecorder @@ -490,9 +490,9 @@ enum OH_AVRecorder_FileGenerationMode **起始版本：** 18 -| 枚举值 | 描述 | -| -------- | -------- | -| AVRECORDER_APP_CREATE | 由应用自行在沙箱创建媒体文件。 | +| 枚举值 | 描述 | +| -------- |--------------------------| +| AVRECORDER_APP_CREATE | 由应用自行在沙箱中创建媒体文件。 | | AVRECORDER_AUTO_CREATE_CAMERA_SCENE | 由系统创建媒体文件，当前仅在相机录制场景下生效。 | @@ -591,7 +591,7 @@ OH_AVErrCode OH_AVRecorder_Prepare(OH_AVRecorder *recorder, OH_AVRecorder_Config **描述** -配置AVRecorder参数，准备录制。必须在[OH_AVRecorder_Start](#oh_avrecorder_start)成功触发之后调用，调用成功之后进入AVRECORDER_PREPARED状态。 +配置AVRecorder参数，准备录制。必须在[OH_AVRecorder_Create](#oh_avrecorder_create)成功触发之后调用，调用成功之后进入AVRECORDER_PREPARED状态。 若只录制音频，则无需配置视频相关参数；同理，若只录制视频，则无需配置音频相关参数。 @@ -612,7 +612,7 @@ OH_AVErrCode OH_AVRecorder_Prepare(OH_AVRecorder *recorder, OH_AVRecorder_Config AV_ERR_OK：执行成功。 -AV_ERR_INVALID_VAL：如果输入的 recorder 为 nullptr 或者准备失败。 +AV_ERR_INVALID_VAL：输入的 recorder 为 nullptr 或者准备失败。 ### OH_AVRecorder_GetAVRecorderConfig() @@ -623,7 +623,7 @@ OH_AVErrCode OH_AVRecorder_GetAVRecorderConfig(OH_AVRecorder *recorder, OH_AVRec **描述** -获取当前的录制参数。此接口必须在录制准备完成后调用。传入的 \*config 必须为 nullptr，由框架层统一分配和释放内存，以避免内存管理混乱，防止内存泄漏或重复释放等问题。 +获取当前的录制参数。此接口必须在录制准备完成后调用。传入的 *config 必须为 nullptr，由框架层统一分配和释放内存，以避免内存管理混乱，防止内存泄漏或重复释放等问题。 **系统能力：** SystemCapability.Multimedia.Media.AVRecorder @@ -642,9 +642,9 @@ OH_AVErrCode OH_AVRecorder_GetAVRecorderConfig(OH_AVRecorder *recorder, OH_AVRec AV_ERR_OK：执行成功。 -AV_ERR_INVALID_VAL：如果输入的 recorder 为 nullptr 或 \*config 不为 nullptr； +AV_ERR_INVALID_VAL：输入的 recorder 为 nullptr 或 *config 不为 nullptr； -AV_ERR_NO_MEMORY：如果内存不足，\*config 内存分配失败。 +AV_ERR_NO_MEMORY：内存不足，*config 内存分配失败。 ### OH_AVRecorder_GetInputSurface() @@ -665,9 +665,9 @@ OH_AVErrCode OH_AVRecorder_GetInputSurface(OH_AVRecorder *recorder, OHNativeWind **参数:** -| 名称 | 描述 | -| -------- | -------- | -| recorder | 指向 OH_AVRecorder 实例的指针。 | +| 名称 | 描述 | +| -------- |-----------------------------------------------| +| recorder | 指向 OH_AVRecorder 实例的指针。 | | window | 指向 OHNativeWindow 实例的指针，见 **OHNativeWindow**。 | **返回：** @@ -676,7 +676,7 @@ OH_AVErrCode OH_AVRecorder_GetInputSurface(OH_AVRecorder *recorder, OHNativeWind AV_ERR_OK：执行成功。 -AV_ERR_INVALID_VAL：如果输入的 recorder 为 nullptr。 +AV_ERR_INVALID_VAL：输入的 recorder 为 nullptr。 ### OH_AVRecorder_UpdateRotation() @@ -706,7 +706,7 @@ OH_AVErrCode OH_AVRecorder_UpdateRotation(OH_AVRecorder *recorder, int32_t rotat AV_ERR_OK：执行成功。 -AV_ERR_INVALID_VAL：如果输入的 recorder 为 nullptr 或输入的 rotation 不符合要求或更新方向失败。 +AV_ERR_INVALID_VAL：输入的 recorder 为 nullptr 或输入的 rotation 不符合要求或更新方向失败。 ### OH_AVRecorder_Start() @@ -735,9 +735,9 @@ OH_AVErrCode OH_AVRecorder_Start(OH_AVRecorder *recorder) AV_ERR_OK：执行成功。 -AV_ERR_INVALID_VAL：如果输入的 recorder 为 nullptr 或启动失败。 +AV_ERR_INVALID_VAL：输入的 recorder 为 nullptr 或启动失败。 -(备注：请勿使用未在本文档中声明的错误码。) +备注：请勿使用未在本文档中声明的错误码。 ### OH_AVRecorder_Pause() @@ -767,7 +767,7 @@ OH_AVErrCode OH_AVRecorder_Pause(OH_AVRecorder *recorder) AV_ERR_OK：执行成功。 -AV_ERR_INVALID_VAL：如果输入的 recorder 为 nullptr 或暂停失败。 +AV_ERR_INVALID_VAL：输入的 recorder 为 nullptr 或暂停失败。 ### OH_AVRecorder_Resume() @@ -796,7 +796,7 @@ OH_AVErrCode OH_AVRecorder_Resume(OH_AVRecorder *recorder) AV_ERR_OK：执行成功。 -AV_ERR_INVALID_VAL：如果输入的 recorder 为 nullptr 或恢复失败。 +AV_ERR_INVALID_VAL：输入的 recorder 为 nullptr 或恢复失败。 ### OH_AVRecorder_Stop() @@ -827,7 +827,7 @@ OH_AVErrCode OH_AVRecorder_Stop(OH_AVRecorder *recorder) AV_ERR_OK：执行成功。 -AV_ERR_INVALID_VAL：如果输入的 recorder 为 nullptr 或停止失败。 +AV_ERR_INVALID_VAL：输入的 recorder 为 nullptr 或停止失败。 ### OH_AVRecorder_Reset() @@ -858,7 +858,7 @@ OH_AVErrCode OH_AVRecorder_Reset(OH_AVRecorder *recorder) AV_ERR_OK：执行成功。 -AV_ERR_INVALID_VAL：如果输入的 recorder 为 nullptr 或重置失败。 +AV_ERR_INVALID_VAL：输入的 recorder 为 nullptr 或重置失败。 ### OH_AVRecorder_Release() @@ -889,7 +889,7 @@ OH_AVErrCode OH_AVRecorder_Release(OH_AVRecorder *recorder) AV_ERR_OK：执行成功。 -AV_ERR_INVALID_VAL：如果输入的 recorder 为 nullptr 或释放失败。 +AV_ERR_INVALID_VAL：输入的 recorder 为 nullptr 或释放失败。 ### OH_AVRecorder_GetAvailableEncoder() @@ -900,7 +900,7 @@ OH_AVErrCode OH_AVRecorder_GetAvailableEncoder(OH_AVRecorder *recorder, OH_AVRec **描述** -获取 AVRecorder 可用的编码器和编码器信息。参数 \*info 必须为 nullptr，由框架层统一分配和释放内存，以避免内存管理混乱，防止内存泄漏或重复释放等问题。 +获取 AVRecorder 可用的编码器和编码器信息。参数 *info 必须为 nullptr，由框架层统一分配和释放内存，以避免内存管理混乱，防止内存泄漏或重复释放等问题。 **系统能力：** SystemCapability.Multimedia.Media.AVRecorder @@ -909,7 +909,7 @@ OH_AVErrCode OH_AVRecorder_GetAvailableEncoder(OH_AVRecorder *recorder, OH_AVRec **参数:** | 名称 | 描述 | -| -------- | -------- | +| -------- | -------- |[_o_h___a_v_recorder___config.md](_o_h___a_v_recorder___config.md) | recorder | 指向 OH_AVRecorder 实例的指针。 | | info | 指向 [OH_AVRecorder_EncoderInfo](_o_h___a_v_recorder___encoder_info.md) 实例的指针，见 [OH_AVRecorder_EncoderInfo](_o_h___a_v_recorder___encoder_info.md)。 | | length | 可用编码器的长度。 | @@ -933,7 +933,7 @@ OH_AVErrCode OH_AVRecorder_SetStateCallback( OH_AVRecorder *recorder, OH_AVRecor **描述** -设置状态回调函数，以便应用能够响应AVRecorder生成的状态变化事件。此接口必须在[OH_AVRecorder_Start](#oh_avrecorder_start)调用之前调用。 +设置状态回调函数，使应用能够响应AVRecorder生成的状态变化事件。此接口必须在[OH_AVRecorder_Start](#oh_avrecorder_start)调用之前调用。 **系统能力：** SystemCapability.Multimedia.Media.AVRecorder @@ -953,7 +953,7 @@ OH_AVErrCode OH_AVRecorder_SetStateCallback( OH_AVRecorder *recorder, OH_AVRecor AV_ERR_OK：执行成功。 -AV_ERR_INVALID_VAL：如果输入的 recorder 为 nullptr 或回调函数为 nullptr。 +AV_ERR_INVALID_VAL：输入的 recorder 为 nullptr 或回调函数为 nullptr。 ### OH_AVRecorder_SetErrorCallback() @@ -964,7 +964,7 @@ OH_AVErrCode OH_AVRecorder_SetErrorCallback(OH_AVRecorder *recorder, OH_AVRecord **描述** -设置错误回调函数，以便应用能够响应AVRecorder生成的错误事件。此接口必须在[OH_AVRecorder_Start](#oh_avrecorder_start)调用之前调用。 +设置错误回调函数，使应用能够响应AVRecorder生成的错误事件。此接口必须在[OH_AVRecorder_Start](#oh_avrecorder_start)调用之前调用。 **系统能力：** SystemCapability.Multimedia.Media.AVRecorder @@ -984,7 +984,7 @@ OH_AVErrCode OH_AVRecorder_SetErrorCallback(OH_AVRecorder *recorder, OH_AVRecord AV_ERR_OK：执行成功。 -AV_ERR_INVALID_VAL：如果输入的 recorder 为 nullptr 或回调函数为 nullptr。 +AV_ERR_INVALID_VAL：输入的 recorder 为 nullptr 或回调函数为 nullptr。 ### OH_AVRecorder_SetUriCallback() @@ -995,7 +995,7 @@ OH_AVErrCode OH_AVRecorder_SetUriCallback(OH_AVRecorder *recorder, OH_AVRecorder **描述** -设置 URI 回调函数，以便应用能够响应AVRecorder生成的 URI 事件。此接口必须在 [OH_AVRecorder_Start](#oh_avrecorder_start) 调用之前调用。 +设置 URI 回调函数，使应用能够响应AVRecorder生成的 URI 事件。此接口必须在 [OH_AVRecorder_Start](#oh_avrecorder_start) 调用之前调用。 **系统能力：** SystemCapability.Multimedia.Media.AVRecorder @@ -1015,4 +1015,4 @@ OH_AVErrCode OH_AVRecorder_SetUriCallback(OH_AVRecorder *recorder, OH_AVRecorder AV_ERR_OK：执行成功。 -AV_ERR_INVALID_VAL：如果输入的 recorder 为 nullptr 或回调函数为 nullptr。 +AV_ERR_INVALID_VAL：输入的 recorder 为 nullptr 或回调函数为 nullptr。 diff --git a/zh-cn/application-dev/reference/apis-media-kit/_o_h___a_v_recorder___config.md b/zh-cn/application-dev/reference/apis-media-kit/_o_h___a_v_recorder___config.md index 3d4353e1049..a63b17bd0a5 100644 --- a/zh-cn/application-dev/reference/apis-media-kit/_o_h___a_v_recorder___config.md +++ b/zh-cn/application-dev/reference/apis-media-kit/_o_h___a_v_recorder___config.md @@ -84,7 +84,7 @@ OH_AVRecorder_FileGenerationMode fileGenerationMode **描述** -指定录制输出文件的生成模式。 +指定录制文件的生成模式。 ### metadata @@ -95,4 +95,4 @@ OH_AVRecorder_Metadata metadata **描述** -包含录制媒体的附加元数据。 +包含录制的附加元数据。 diff --git a/zh-cn/application-dev/reference/apis-media-kit/_o_h___a_v_recorder___encoder_info.md b/zh-cn/application-dev/reference/apis-media-kit/_o_h___a_v_recorder___encoder_info.md index 345f5f3f68c..85170478fd9 100644 --- a/zh-cn/application-dev/reference/apis-media-kit/_o_h___a_v_recorder___encoder_info.md +++ b/zh-cn/application-dev/reference/apis-media-kit/_o_h___a_v_recorder___encoder_info.md @@ -21,7 +21,7 @@ | 名称 | 描述 | | -------- | -------- | -| [OH_AVRecorder_CodecMimeType](_a_v_recorder.md#oh_avrecorder_codecmimetype) [mimeType](#mimetype) | 编码器MIME类型名称。 | +| [OH_AVRecorder_CodecMimeType](_a_v_recorder.md#oh_avrecorder_codecmimetype) [mimeType](#mimetype) | 编码器MIME类型。 | | char \*[type](#type) | 编码器类型，audio表示音频编码器，video表示视频编码器。 | | [OH_AVRecorder_Range](_o_h___a_v_recorder___range.md) [bitRate](#bitrate) | 比特率，包含该编码器的最大和最小值。 | | [OH_AVRecorder_Range](_o_h___a_v_recorder___range.md) [frameRate](#framerate) | 视频帧率，包含帧率的最大和最小值，仅视频编码器拥有。 | @@ -43,7 +43,7 @@ OH_AVRecorder_CodecMimeType mimeType **描述** -编码器MIME类型名称。 +编码器MIME类型。 ### type diff --git a/zh-cn/application-dev/reference/apis-media-kit/_o_h___a_v_recorder___location.md b/zh-cn/application-dev/reference/apis-media-kit/_o_h___a_v_recorder___location.md index cac92c333aa..b7ff7d08284 100644 --- a/zh-cn/application-dev/reference/apis-media-kit/_o_h___a_v_recorder___location.md +++ b/zh-cn/application-dev/reference/apis-media-kit/_o_h___a_v_recorder___location.md @@ -19,8 +19,8 @@ ### 成员变量 -| 名称 | 描述 | -| -------- | -------- | +| 名称 | 描述 | +| -------- |----------| | float [latitude](#latitude) | 地理位置的纬度。 | | float [longitude](#longitude) | 地理位置的经度。 | diff --git a/zh-cn/application-dev/reference/apis-media-kit/_o_h___a_v_recorder___range.md b/zh-cn/application-dev/reference/apis-media-kit/_o_h___a_v_recorder___range.md index 416121b8b7f..4eb8dee30a0 100644 --- a/zh-cn/application-dev/reference/apis-media-kit/_o_h___a_v_recorder___range.md +++ b/zh-cn/application-dev/reference/apis-media-kit/_o_h___a_v_recorder___range.md @@ -3,7 +3,7 @@ ## 概述 -表示一个类型的范围。 +表示类型的范围。 **系统能力：** SystemCapability.Multimedia.Media.AVRecorder -- Gitee From a2ac23719f248cda4c7eb59943d60c87452682e6 Mon Sep 17 00:00:00 2001 From: tianmuhao Date: Sun, 27 Apr 2025 09:54:32 +0000 Subject: [PATCH 2/8] update zh-cn/application-dev/reference/apis-media-kit/_o_h___a_v_recorder___metadata.md. Signed-off-by: tianmuhao --- .../reference/apis-media-kit/_o_h___a_v_recorder___metadata.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/zh-cn/application-dev/reference/apis-media-kit/_o_h___a_v_recorder___metadata.md b/zh-cn/application-dev/reference/apis-media-kit/_o_h___a_v_recorder___metadata.md index e320b13ee7d..73d23ed2d36 100644 --- a/zh-cn/application-dev/reference/apis-media-kit/_o_h___a_v_recorder___metadata.md +++ b/zh-cn/application-dev/reference/apis-media-kit/_o_h___a_v_recorder___metadata.md @@ -3,7 +3,7 @@ ## 概述 -设置元数据信息。 +元数据信息数据结构。 **系统能力：** SystemCapability.Multimedia.Media.AVRecorder -- Gitee From 184485fa96eddcfc82ec0cb13c3e6b8ec87b8923 Mon Sep 17 00:00:00 2001 From: tianmuhao Date: Sun, 27 Apr 2025 09:55:18 +0000 Subject: [PATCH 3/8] update zh-cn/application-dev/reference/apis-media-kit/_o_h___a_v_recorder___location.md. Signed-off-by: tianmuhao --- .../reference/apis-media-kit/_o_h___a_v_recorder___location.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/zh-cn/application-dev/reference/apis-media-kit/_o_h___a_v_recorder___location.md b/zh-cn/application-dev/reference/apis-media-kit/_o_h___a_v_recorder___location.md index b7ff7d08284..a2329718857 100644 --- a/zh-cn/application-dev/reference/apis-media-kit/_o_h___a_v_recorder___location.md +++ b/zh-cn/application-dev/reference/apis-media-kit/_o_h___a_v_recorder___location.md @@ -19,7 +19,7 @@ ### 成员变量 -| 名称 | 描述 | +| 名称 | 描述 | | -------- |----------| | float [latitude](#latitude) | 地理位置的纬度。 | | float [longitude](#longitude) | 地理位置的经度。 | -- Gitee From be25eac5f80369e2db15aee84546bc0becee8aae Mon Sep 17 00:00:00 2001 From: tianmuhao Date: Sun, 27 Apr 2025 09:55:56 +0000 Subject: [PATCH 4/8] update zh-cn/application-dev/reference/apis-media-kit/_o_h___a_v_recorder___location.md. Signed-off-by: tianmuhao --- .../reference/apis-media-kit/_o_h___a_v_recorder___location.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/zh-cn/application-dev/reference/apis-media-kit/_o_h___a_v_recorder___location.md b/zh-cn/application-dev/reference/apis-media-kit/_o_h___a_v_recorder___location.md index a2329718857..cac92c333aa 100644 --- a/zh-cn/application-dev/reference/apis-media-kit/_o_h___a_v_recorder___location.md +++ b/zh-cn/application-dev/reference/apis-media-kit/_o_h___a_v_recorder___location.md @@ -20,7 +20,7 @@ ### 成员变量 | 名称 | 描述 | -| -------- |----------| +| -------- | -------- | | float [latitude](#latitude) | 地理位置的纬度。 | | float [longitude](#longitude) | 地理位置的经度。 | -- Gitee From 157e1b5ca54ce00aa46c6e292218acf4b925f2f1 Mon Sep 17 00:00:00 2001 From: tianmuhao Date: Sun, 27 Apr 2025 09:57:57 +0000 Subject: [PATCH 5/8] update zh-cn/application-dev/reference/apis-media-kit/_a_v_recorder.md. Signed-off-by: tianmuhao --- .../application-dev/reference/apis-media-kit/_a_v_recorder.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/zh-cn/application-dev/reference/apis-media-kit/_a_v_recorder.md b/zh-cn/application-dev/reference/apis-media-kit/_a_v_recorder.md index 0249924202f..707bf71c964 100644 --- a/zh-cn/application-dev/reference/apis-media-kit/_a_v_recorder.md +++ b/zh-cn/application-dev/reference/apis-media-kit/_a_v_recorder.md @@ -20,8 +20,8 @@ ### 文件 -| 名称 | 描述 | -| -------- |------------------------------------------------| +| 名称 | 描述 | +| -------- | -------- | | [avrecorder.h](avrecorder_8h.md) | 定义AVRecorder接口。应用可使用媒体 AVRecorder 提供的接口录制媒体数据。 | | [avrecorder_base.h](avrecorder__base_8h.md) | 定义了媒体 AVRecorder 的结构体和枚举。 | -- Gitee From b8960cb17063322a9d91a1cef196e88d29b43e0a Mon Sep 17 00:00:00 2001 From: tianmuhao Date: Sun, 27 Apr 2025 09:59:35 +0000 Subject: [PATCH 6/8] update zh-cn/application-dev/reference/apis-media-kit/_a_v_recorder.md. Signed-off-by: tianmuhao --- zh-cn/application-dev/reference/apis-media-kit/_a_v_recorder.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/zh-cn/application-dev/reference/apis-media-kit/_a_v_recorder.md b/zh-cn/application-dev/reference/apis-media-kit/_a_v_recorder.md index 707bf71c964..8c5543f3865 100644 --- a/zh-cn/application-dev/reference/apis-media-kit/_a_v_recorder.md +++ b/zh-cn/application-dev/reference/apis-media-kit/_a_v_recorder.md @@ -909,7 +909,7 @@ OH_AVErrCode OH_AVRecorder_GetAvailableEncoder(OH_AVRecorder *recorder, OH_AVRec **参数:** | 名称 | 描述 | -| -------- | -------- |[_o_h___a_v_recorder___config.md](_o_h___a_v_recorder___config.md) +| -------- | -------- | | recorder | 指向 OH_AVRecorder 实例的指针。 | | info | 指向 [OH_AVRecorder_EncoderInfo](_o_h___a_v_recorder___encoder_info.md) 实例的指针，见 [OH_AVRecorder_EncoderInfo](_o_h___a_v_recorder___encoder_info.md)。 | | length | 可用编码器的长度。 | -- Gitee From 089db73e35099f7d88b990e117c494cde61f8751 Mon Sep 17 00:00:00 2001 From: tianmuhao Date: Sun, 27 Apr 2025 10:08:24 +0000 Subject: [PATCH 7/8] update zh-cn/application-dev/reference/apis-media-kit/_a_v_recorder.md. Signed-off-by: tianmuhao --- .../reference/apis-media-kit/_a_v_recorder.md | 56 +++++++++---------- 1 file changed, 28 insertions(+), 28 deletions(-) diff --git a/zh-cn/application-dev/reference/apis-media-kit/_a_v_recorder.md b/zh-cn/application-dev/reference/apis-media-kit/_a_v_recorder.md index 8c5543f3865..8c48a3f3635 100644 --- a/zh-cn/application-dev/reference/apis-media-kit/_a_v_recorder.md +++ b/zh-cn/application-dev/reference/apis-media-kit/_a_v_recorder.md @@ -23,37 +23,37 @@ | 名称 | 描述 | | -------- | -------- | | [avrecorder.h](avrecorder_8h.md) | 定义AVRecorder接口。应用可使用媒体 AVRecorder 提供的接口录制媒体数据。 | -| [avrecorder_base.h](avrecorder__base_8h.md) | 定义了媒体 AVRecorder 的结构体和枚举。 | +| [avrecorder_base.h](avrecorder__base_8h.md) | 定义了媒体 AVRecorder 的结构体和枚举。 | ### 类型定义 -| 名称 | 描述 | -| -------- |------------------------------------------------------------------------------------------------------------------------------| -| typedef struct [OH_AVRecorder](#oh_avrecorder) [OH_AVRecorder](#oh_avrecorder) | 初始化AVRecorder。 | -| typedef enum [OH_AVRecorder_AudioSourceType](#oh_avrecorder_audiosourcetype-1) [OH_AVRecorder_AudioSourceType](#oh_avrecorder_audiosourcetype) | AVRecorder的音频源类型。 | -| typedef enum [OH_AVRecorder_VideoSourceType](#oh_avrecorder_videosourcetype-1) [OH_AVRecorder_VideoSourceType](#oh_avrecorder_videosourcetype) | AVRecorder的视频源类型。 | -| typedef enum [OH_AVRecorder_CodecMimeType](#oh_avrecorder_codecmimetype-1) [OH_AVRecorder_CodecMimeType](#oh_avrecorder_codecmimetype) | 编码器 MIME 类型。 | -| typedef enum [OH_AVRecorder_ContainerFormatType](#oh_avrecorder_containerformattype-1) [OH_AVRecorder_ContainerFormatType](#oh_avrecorder_containerformattype) | 容器格式类型（容器格式类型的缩写是 CFT）。 | -| typedef enum [OH_AVRecorder_State](#oh_avrecorder_state-1) [OH_AVRecorder_State](#oh_avrecorder_state) | AVRecorder状态。 | -| typedef enum [OH_AVRecorder_StateChangeReason](#oh_avrecorder_statechangereason-1) [OH_AVRecorder_StateChangeReason](#oh_avrecorder_statechangereason) | AVRecorder状态变化的原因。 | -| typedef enum [OH_AVRecorder_FileGenerationMode](#oh_avrecorder_filegenerationmode-1) [OH_AVRecorder_FileGenerationMode](#oh_avrecorder_filegenerationmode) | 创建录制文件的模式。 | +| 名称 | 描述 | +| -------- | -------- | +| typedef struct [OH_AVRecorder](#oh_avrecorder) [OH_AVRecorder](#oh_avrecorder) | 初始化AVRecorder。 | +| typedef enum [OH_AVRecorder_AudioSourceType](#oh_avrecorder_audiosourcetype-1) [OH_AVRecorder_AudioSourceType](#oh_avrecorder_audiosourcetype) | AVRecorder的音频源类型。 | +| typedef enum [OH_AVRecorder_VideoSourceType](#oh_avrecorder_videosourcetype-1) [OH_AVRecorder_VideoSourceType](#oh_avrecorder_videosourcetype) | AVRecorder的视频源类型。 | +| typedef enum [OH_AVRecorder_CodecMimeType](#oh_avrecorder_codecmimetype-1) [OH_AVRecorder_CodecMimeType](#oh_avrecorder_codecmimetype) | 编码器 MIME 类型。 | +| typedef enum [OH_AVRecorder_ContainerFormatType](#oh_avrecorder_containerformattype-1) [OH_AVRecorder_ContainerFormatType](#oh_avrecorder_containerformattype) | 容器格式类型（容器格式类型的缩写是 CFT）。 | +| typedef enum [OH_AVRecorder_State](#oh_avrecorder_state-1) [OH_AVRecorder_State](#oh_avrecorder_state) | AVRecorder状态。 | +| typedef enum [OH_AVRecorder_StateChangeReason](#oh_avrecorder_statechangereason-1) [OH_AVRecorder_StateChangeReason](#oh_avrecorder_statechangereason) | AVRecorder状态变化的原因。 | +| typedef enum [OH_AVRecorder_FileGenerationMode](#oh_avrecorder_filegenerationmode-1) [OH_AVRecorder_FileGenerationMode](#oh_avrecorder_filegenerationmode) | 创建录制文件的模式。 | | typedef struct [OH_AVRecorder_Profile](_o_h___a_v_recorder___profile.md) [OH_AVRecorder_Profile](#oh_avrecorder_profile) | 定义音视频录制的详细参数。
通过参数设置可以选择只录制音频或只录制视频：当 audioBitrate 或 audioChannels 为 0 时，不录制音频；当 videoFrameWidth 或 videoFrameHeight 为 0 时，不录制视频。 | -| typedef struct [OH_AVRecorder_Location](_o_h___a_v_recorder___location.md) [OH_AVRecorder_Location](#oh_avrecorder_location) | 提供媒体资源的地理位置信息。 | -| typedef struct [OH_AVRecorder_MetadataTemplate](_o_h___a_v_recorder___metadata_template.md) [OH_AVRecorder_MetadataTemplate](#oh_avrecorder_metadatatemplate) | 定义元数据的基本模板。 | -| typedef struct [OH_AVRecorder_Metadata](_o_h___a_v_recorder___metadata.md) [OH_AVRecorder_Metadata](#oh_avrecorder_metadata) | 元数据信息数据结构。 | -| typedef struct [OH_AVRecorder_Config](_o_h___a_v_recorder___config.md) [OH_AVRecorder_Config](#oh_avrecorder_config) | 提供媒体AVRecorder的配置定义。 | -| typedef struct [OH_AVRecorder_Range](_o_h___a_v_recorder___range.md) [OH_AVRecorder_Range](#oh_avrecorder_range) | 表示类型的范围。 | -| typedef struct [OH_AVRecorder_EncoderInfo](_o_h___a_v_recorder___encoder_info.md) [OH_AVRecorder_EncoderInfo](#oh_avrecorder_encoderinfo) | 提供编码器信息。 | -| typedef void(\* [OH_AVRecorder_OnStateChange](#oh_avrecorder_onstatechange)) ([OH_AVRecorder](#oh_avrecorder) \*recorder, [OH_AVRecorder_State](#oh_avrecorder_state) state, [OH_AVRecorder_StateChangeReason](#oh_avrecorder_statechangereason) reason, void \*userData) | 当录制状态发生变化时调用。 | -| typedef void(\* [OH_AVRecorder_OnError](#oh_avrecorder_onerror)) ([OH_AVRecorder](#oh_avrecorder) \*recorder, int32_t errorCode, const char \*errorMsg, void \*userData) | 当录制过程中发生错误时调用。 | -| typedef void(\* [OH_AVRecorder_OnUri](#oh_avrecorder_onuri)) ([OH_AVRecorder](#oh_avrecorder) \*recorder, OH_MediaAsset \*asset, void \*userData) | 当录制在 OH_AVRecorder_FileGenerationMode.AVRECORDER_AUTO_CREATE_CAMERA_SCENE模式下时调用。 | +| typedef struct [OH_AVRecorder_Location](_o_h___a_v_recorder___location.md) [OH_AVRecorder_Location](#oh_avrecorder_location) | 提供媒体资源的地理位置信息。 | +| typedef struct [OH_AVRecorder_MetadataTemplate](_o_h___a_v_recorder___metadata_template.md) [OH_AVRecorder_MetadataTemplate](#oh_avrecorder_metadatatemplate) | 定义元数据的基本模板。 | +| typedef struct [OH_AVRecorder_Metadata](_o_h___a_v_recorder___metadata.md) [OH_AVRecorder_Metadata](#oh_avrecorder_metadata) | 元数据信息数据结构。 | +| typedef struct [OH_AVRecorder_Config](_o_h___a_v_recorder___config.md) [OH_AVRecorder_Config](#oh_avrecorder_config) | 提供媒体AVRecorder的配置定义。 | +| typedef struct [OH_AVRecorder_Range](_o_h___a_v_recorder___range.md) [OH_AVRecorder_Range](#oh_avrecorder_range) | 表示类型的范围。 | +| typedef struct [OH_AVRecorder_EncoderInfo](_o_h___a_v_recorder___encoder_info.md) [OH_AVRecorder_EncoderInfo](#oh_avrecorder_encoderinfo) | 提供编码器信息。 | +| typedef void(\* [OH_AVRecorder_OnStateChange](#oh_avrecorder_onstatechange)) ([OH_AVRecorder](#oh_avrecorder) \*recorder, [OH_AVRecorder_State](#oh_avrecorder_state) state, [OH_AVRecorder_StateChangeReason](#oh_avrecorder_statechangereason) reason, void \*userData) | 当录制状态发生变化时调用。 | +| typedef void(\* [OH_AVRecorder_OnError](#oh_avrecorder_onerror)) ([OH_AVRecorder](#oh_avrecorder) \*recorder, int32_t errorCode, const char \*errorMsg, void \*userData) | 当录制过程中发生错误时调用。 | +| typedef void(\* [OH_AVRecorder_OnUri](#oh_avrecorder_onuri)) ([OH_AVRecorder](#oh_avrecorder) \*recorder, OH_MediaAsset \*asset, void \*userData) | 当录制在 OH_AVRecorder_FileGenerationMode.AVRECORDER_AUTO_CREATE_CAMERA_SCENE模式下时调用。 | ### 结构体 -| 名称 | 描述 | -| -------- |----------------------------------------------------------------------------------------------------------------------------------| +| 名称 | 描述 | +| -------- | -------- | | struct [OH_AVRecorder_Profile](_o_h___a_v_recorder___profile.md) | 定义音视频录制的详细参数。
通过参数设置可以选择只录制音频或只录制视频：当 audioBitrate 或 audioChannels 为 0 时，不录制音频；当 videoFrameWidth 或 videoFrameHeight 为 0 时，不录制视频。 | | struct [OH_AVRecorder_Location](_o_h___a_v_recorder___location.md) | 提供媒体资源的地理位置信息。 | | struct [OH_AVRecorder_MetadataTemplate](_o_h___a_v_recorder___metadata_template.md) | 定义元数据的基本模板。 | @@ -490,9 +490,9 @@ enum OH_AVRecorder_FileGenerationMode **起始版本：** 18 -| 枚举值 | 描述 | -| -------- |--------------------------| -| AVRECORDER_APP_CREATE | 由应用自行在沙箱中创建媒体文件。 | +| 枚举值 | 描述 | +| -------- | -------- | +| AVRECORDER_APP_CREATE | 由应用自行在沙箱中创建媒体文件。 | | AVRECORDER_AUTO_CREATE_CAMERA_SCENE | 由系统创建媒体文件，当前仅在相机录制场景下生效。 | @@ -665,9 +665,9 @@ OH_AVErrCode OH_AVRecorder_GetInputSurface(OH_AVRecorder *recorder, OHNativeWind **参数:** -| 名称 | 描述 | -| -------- |-----------------------------------------------| -| recorder | 指向 OH_AVRecorder 实例的指针。 | +| 名称 | 描述 | +| -------- | -------- | +| recorder | 指向 OH_AVRecorder 实例的指针。 | | window | 指向 OHNativeWindow 实例的指针，见 **OHNativeWindow**。 | **返回：** -- Gitee From 23810c55ac2de5342c5b1b304183ed59cd99e998 Mon Sep 17 00:00:00 2001 From: tianmuhao Date: Tue, 29 Apr 2025 09:56:17 +0000 Subject: [PATCH 8/8] update zh-cn/application-dev/reference/apis-media-kit/_a_v_recorder.md. Signed-off-by: tianmuhao --- zh-cn/application-dev/reference/apis-media-kit/_a_v_recorder.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/zh-cn/application-dev/reference/apis-media-kit/_a_v_recorder.md b/zh-cn/application-dev/reference/apis-media-kit/_a_v_recorder.md index 8c48a3f3635..721be206309 100644 --- a/zh-cn/application-dev/reference/apis-media-kit/_a_v_recorder.md +++ b/zh-cn/application-dev/reference/apis-media-kit/_a_v_recorder.md @@ -45,7 +45,7 @@ | typedef struct [OH_AVRecorder_Config](_o_h___a_v_recorder___config.md) [OH_AVRecorder_Config](#oh_avrecorder_config) | 提供媒体AVRecorder的配置定义。 | | typedef struct [OH_AVRecorder_Range](_o_h___a_v_recorder___range.md) [OH_AVRecorder_Range](#oh_avrecorder_range) | 表示类型的范围。 | | typedef struct [OH_AVRecorder_EncoderInfo](_o_h___a_v_recorder___encoder_info.md) [OH_AVRecorder_EncoderInfo](#oh_avrecorder_encoderinfo) | 提供编码器信息。 | -| typedef void(\* [OH_AVRecorder_OnStateChange](#oh_avrecorder_onstatechange)) ([OH_AVRecorder](#oh_avrecorder) \*recorder, [OH_AVRecorder_State](#oh_avrecorder_state) state, [OH_AVRecorder_StateChangeReason](#oh_avrecorder_statechangereason) reason, void \*userData) | 当录制状态发生变化时调用。 | +| typedef void(\* [OH_AVRecorder_OnStateChange](#oh_avrecorder_onstatechange)) ([OH_AVRecorder](#oh_avrecorder) \*recorder, [OH_AVRecorder_State](#oh_avrecorder_state) state, [OH_AVRecorder_StateChangeReason](#oh_avrecorder_statechangereason) reason, void \*userData) | 当录制状态发生变化时调用。 | | typedef void(\* [OH_AVRecorder_OnError](#oh_avrecorder_onerror)) ([OH_AVRecorder](#oh_avrecorder) \*recorder, int32_t errorCode, const char \*errorMsg, void \*userData) | 当录制过程中发生错误时调用。 | | typedef void(\* [OH_AVRecorder_OnUri](#oh_avrecorder_onuri)) ([OH_AVRecorder](#oh_avrecorder) \*recorder, OH_MediaAsset \*asset, void \*userData) | 当录制在 OH_AVRecorder_FileGenerationMode.AVRECORDER_AUTO_CREATE_CAMERA_SCENE模式下时调用。 | -- Gitee