add avscreencapture

Signed-off-by: Nzengyawen <zengyawen1@huawei.com>

zh-cn/application-dev/reference/native-apis/Readme-CN.md

@@ -24,6 +24,7 @@
   - [AVDemuxer](_a_v_demuxer.md)
   - [AVSource](_a_v_source.md)
   - [OHAudio](_o_h_audio.md)
+  - [AVScreenCapture](_a_v_screen_capture.md)
   - [HuksKeyApi](_huks_key_api.md)
   - [HuksParamSetApi](_huks_param_set_api.md)
   - [HuksTypeApi](_huks_type_api.md)
@@ -85,6 +86,9 @@
   - [native_audiorenderer.h](native__audiorenderer_8h.md)
   - [native_audiostream_base.h](native__audiostream__base_8h.md)
   - [native_audiostreambuilder.h](native__audiostreambuilder_8h.md)
+  - [native_avscreen_capture.h](native__avscreen__capture_8h.md)
+  - [native_avscreen_capture_base.h](native__avscreen__capture__base_8h.md)
+  - [native_avscreen_capture_errors.h](native__avscreen__capture__errors_8h.md)
   - [native_huks_api.h](native__huks__api_8h.md)
   - [native_huks_param.h](native__huks__param_8h.md)
   - [native_huks_type.h](native__huks__type_8h.md)
@@ -142,6 +146,17 @@
   - [OH_AVRange](_o_h___a_v_range.md)
   - [OH_AudioCapturer_Callbacks_Struct](_o_h___audio_capturer___callbacks___struct.md)
   - [OH_AudioRenderer_Callbacks_Struct](_o_h___audio_renderer___callbacks___struct.md)
+  - [OH_AudioBuffer](_o_h___audio_buffer.md)
+  - [OH_AudioCaptureInfo](_o_h___audio_capture_info.md)
+  - [OH_AudioEncInfo](_o_h___audio_enc_info.md)
+  - [OH_AudioInfo](_o_h___audio_info.md)
+  - [OH_AVScreenCaptureCallback](_o_h___a_v_screen_capture_callback.md)
+  - [OH_AVScreenCaptureConfig](_o_h___a_v_screen_capture_config.md)
+  - [OH_RecorderInfo](_o_h___recorder_info.md)
+  - [OH_Rect](_o_h___rect.md)
+  - [OH_VideoCaptureInfo](_o_h___video_capture_info.md)
+  - [OH_VideoEncInfo](_o_h___video_enc_info.md)
+  - [OH_VideoInfo](_o_h___video_info.md)
   - [OH_Huks_Blob](_o_h___huks___blob.md)
   - [OH_Huks_CertChain](_o_h___huks___cert_chain.md)
   - [OH_Huks_KeyInfo](_o_h___huks___key_info.md)

zh-cn/application-dev/reference/native-apis/_o_h___a_v_screen_capture_callback.md

+# OH_AVScreenCaptureCallback
+
+
+## 概述
+
+OH_AVScreenCapture中所有异步回调函数指针的集合。将该结构体的实例注册到OH_AVScreenCapture实例中， 并处理回调上报的信息，以保证OH_AVScreenCapture的正常运行。
+
+**系统能力**：SystemCapability.Multimedia.Media.AVScreenCapture
+
+**起始版本：**
+
+10
+
+**相关模块:**
+
+[AVScreenCapture](_a_v_screen_capture.md)
+
+
+## 汇总
+
+
+### 成员变量
+
+| 名称 | 描述 | 
+| -------- | -------- |
+| **onError** | [OH_AVScreenCaptureOnError](_a_v_screen_capture.md#oh_avscreencaptureonerror) | 
+| **onAudioBufferAvailable** | [OH_AVScreenCaptureOnAudioBufferAvailable](_a_v_screen_capture.md#oh_avscreencaptureonaudiobufferavailable) | 
+| **onVideoBufferAvailable** | [OH_AVScreenCaptureOnVideoBufferAvailable](_a_v_screen_capture.md#oh_avscreencaptureonvideobufferavailable) | 

zh-cn/application-dev/reference/native-apis/_o_h___a_v_screen_capture_config.md

+# OH_AVScreenCaptureConfig
+
+
+## 概述
+
+屏幕录制配置参数。
+
+**系统能力**：SystemCapability.Multimedia.Media.AVScreenCapture
+
+**起始版本：**
+
+10
+
+**相关模块:**
+
+[AVScreenCapture](_a_v_screen_capture.md)
+
+
+## 汇总
+
+
+### 成员变量
+
+| 名称 | 描述 | 
+| -------- | -------- |
+| [captureMode](#capturemode) | [OH_CaptureMode](_a_v_screen_capture.md#oh_capturemode)<br/>屏幕录制的模式。 | 
+| [dataType](#datatype) | [OH_DataType](_a_v_screen_capture.md#oh_datatype)<br/>屏幕录制流的数据格式。 | 
+| [audioInfo](#audioinfo) | [OH_AudioInfo](_o_h___audio_info.md)<br/>音频录制参数。 | 
+| [videoInfo](#videoinfo) | [OH_VideoInfo](_o_h___video_info.md)<br/>视频录制参数。 | 
+| [recorderInfo](#recorderinfo) | [OH_RecorderInfo](_o_h___recorder_info.md)<br/>录制文件参数，当数据格式为OH_CAPTURE_FILE时，必须设置。<br>**说明：** 预留接口，将在后续版本提供。 | 
+
+
+## 结构体成员变量说明
+
+
+### audioInfo
+
+```
+OH_AudioInfo OH_AVScreenCaptureConfig::audioInfo
+```
+
+**描述:**
+
+音频录制参数。
+
+
+### captureMode
+
+```
+OH_CaptureMode OH_AVScreenCaptureConfig::captureMode
+```
+
+**描述:**
+
+屏幕录制的模式。
+
+
+### dataType
+
+```
+OH_DataType OH_AVScreenCaptureConfig::dataType
+```
+
+**描述:**
+
+屏幕录制流的数据格式。
+
+
+### recorderInfo
+
+```
+OH_RecorderInfo OH_AVScreenCaptureConfig::recorderInfo
+```
+
+**描述:**
+
+录制文件参数，当数据格式为OH_CAPTURE_FILE时，必须设置。
+
+> **说明：** 
+> 
+> 预留接口，将在后续版本提供。
+
+
+### videoInfo
+
+```
+OH_VideoInfo OH_AVScreenCaptureConfig::videoInfo
+```
+
+**描述:**
+
+视频录制参数。

zh-cn/application-dev/reference/native-apis/_o_h___audio_buffer.md

+# OH_AudioBuffer
+
+
+## 概述
+
+定义了音频数据的大小，类型，时间戳等配置信息。
+
+**系统能力**：SystemCapability.Multimedia.Media.AVScreenCapture
+
+**起始版本：**
+
+10
+
+**相关模块:**
+
+[AVScreenCapture](_a_v_screen_capture.md)
+
+
+## 汇总
+
+
+### 成员变量
+
+| 名称 | 描述 | 
+| -------- | -------- |
+| [buf](#buf) | 音频buffer内存。 | 
+| [size](#size) | 音频buffer内存大小。 | 
+| [timestamp](#timestamp) | 音频buffer时间戳。 | 
+| [type](#type) | 音频录制源类型。 | 
+
+
+## 结构体成员变量说明
+
+
+### buf
+
+```
+uint8_t* OH_AudioBuffer::buf
+```
+
+**描述：**
+
+音频buffer内存。
+
+
+### size
+
+```
+int32_t OH_AudioBuffer::size
+```
+
+**描述：**
+
+音频buffer内存大小。
+
+
+### timestamp
+
+```
+int64_t OH_AudioBuffer::timestamp
+```
+
+**描述：**
+
+音频buffer时间戳。
+
+
+### type
+
+```
+OH_AudioCaptureSourceType OH_AudioBuffer::type
+```
+
+**描述：**
+
+音频录制源类型。

zh-cn/application-dev/reference/native-apis/_o_h___audio_capture_info.md

+# OH_AudioCaptureInfo
+
+
+## 概述
+
+音频录制信息。
+
+**系统能力**：SystemCapability.Multimedia.Media.AVScreenCapture
+
+**起始版本：**
+
+10
+
+**相关模块:**
+
+[AVScreenCapture](_a_v_screen_capture.md)
+
+
+## 汇总
+
+
+### 成员变量
+
+| 名称 | 描述 | 
+| -------- | -------- |
+| [audioSampleRate](#audiosamplerate) | int32_t<br/>音频采样率，支持列表参考**OH_AudioCapturer_GetSamplingRate**。 | 
+| [audioChannels](#audiochannels) | int32_t<br/>音频声道数。 | 
+| [audioSource](#audiosource) | [OH_AudioCaptureSourceType](_a_v_screen_capture.md#oh_audiocapturesourcetype)<br/>音频源。 | 
+
+
+## 结构体成员变量说明
+
+
+### audioChannels
+
+```
+int32_t OH_AudioCaptureInfo::audioChannels
+```
+
+**描述:**
+
+音频声道数。
+
+
+### audioSampleRate
+
+```
+int32_t OH_AudioCaptureInfo::audioSampleRate
+```
+
+**描述:**
+
+音频采样率，支持列表参考**OH_AudioCapturer_GetSamplingRate**。
+
+
+### audioSource
+
+```
+OH_AudioCaptureSourceType OH_AudioCaptureInfo::audioSource
+```
+
+**描述:**
+
+音频源。

zh-cn/application-dev/reference/native-apis/_o_h___audio_enc_info.md

+# OH_AudioEncInfo
+
+
+## 概述
+
+音频编码信息。
+
+> **说明：** 
+> 
+> 预留接口，将在后续版本提供。
+
+**系统能力**：SystemCapability.Multimedia.Media.AVScreenCapture
+
+**起始版本：**
+
+10
+
+**相关模块:**
+
+[AVScreenCapture](_a_v_screen_capture.md)
+
+
+## 汇总
+
+
+### 成员变量
+
+| 名称 | 描述 | 
+| -------- | -------- |
+| [audioBitrate](#audiobitrate) | int32_t<br/>音频录制比特率。 | 
+| [audioCodecformat](#audiocodecformat) | [OH_AudioCodecFormat](_a_v_screen_capture.md#oh_audiocodecformat)<br/>音频编码格式。 | 
+
+
+## 结构体成员变量说明
+
+
+### audioBitrate
+
+```
+int32_t OH_AudioEncInfo::audioBitrate
+```
+
+**描述:**
+
+音频录制比特率。
+
+
+### audioCodecformat
+
+```
+OH_AudioCodecFormat OH_AudioEncInfo::audioCodecformat
+```
+
+**描述:**
+
+音频编码格式。

zh-cn/application-dev/reference/native-apis/_o_h___audio_info.md

+# OH_AudioInfo
+
+
+## 概述
+
+音频录制参数。
+
+**系统能力**：SystemCapability.Multimedia.Media.AVScreenCapture
+
+**起始版本：**
+
+10
+
+**相关模块:**
+
+[AVScreenCapture](_a_v_screen_capture.md)
+
+
+## 汇总
+
+
+### 成员变量
+
+| 名称 | 描述 | 
+| -------- | -------- |
+| [micCapInfo](#miccapinfo) | [OH_AudioCaptureInfo](_o_h___audio_capture_info.md)<br/>麦克风的音频参数。 | 
+| [innerCapInfo](#innercapinfo) | [OH_AudioCaptureInfo](_o_h___audio_capture_info.md)<br/>内录的音频参数。 | 
+| [audioEncInfo](#audioencinfo) | [OH_AudioEncInfo](_o_h___audio_enc_info.md)<br/>音频录制信息， 当dataType为OH_ORIGINAL_STREAM时不需要设置。<br>**说明：** 预留接口，将在后续版本提供。 | 
+
+
+## 结构体成员变量说明
+
+
+### audioEncInfo
+
+```
+OH_AudioEncInfo OH_AudioInfo::audioEncInfo
+```
+
+**描述:**
+
+音频录制信息， 当dataType为OH_ORIGINAL_STREAM时不需要设置。
+
+> **说明：** 
+> 
+> 预留接口，将在后续版本提供。
+
+
+### innerCapInfo
+
+```
+OH_AudioCaptureInfo OH_AudioInfo::innerCapInfo
+```
+
+**描述:**
+
+内录的音频参数。
+
+
+### micCapInfo
+
+```
+OH_AudioCaptureInfo OH_AudioInfo::micCapInfo
+```
+
+**描述:**
+
+麦克风的音频参数。

zh-cn/application-dev/reference/native-apis/_o_h___recorder_info.md

+# OH_RecorderInfo
+
+
+## 概述
+
+录制文件信息。
+
+> **说明：**
+>
+> 预留接口，将在后续版本提供支持。
+
+**系统能力**：SystemCapability.Multimedia.Media.AVScreenCapture
+
+**起始版本：**
+
+10
+
+**相关模块:**
+
+[AVScreenCapture](_a_v_screen_capture.md)
+
+
+## 汇总
+
+
+### 成员变量
+
+| 名称 | 描述 | 
+| -------- | -------- |
+| [url](#url) | 录制文件的URL。 | 
+| [urlLen](#urllen) | 录制文件的URL长度。 | 
+| [fileFormat](#fileformat) | 录制文件的格式。 | 
+
+
+## 结构体成员变量说明
+
+
+### fileFormat
+
+```
+OH_ContainerFormatType OH_RecorderInfo::fileFormat
+```
+
+**描述:**
+
+录制文件的格式。
+
+
+### url
+
+```
+char* OH_RecorderInfo::url
+```
+
+**描述:**
+
+录制文件的URL。
+
+
+### urlLen
+
+```
+uint32_t OH_RecorderInfo::urlLen
+```
+
+**描述:**
+
+录制文件的URL长度。

zh-cn/application-dev/reference/native-apis/_o_h___rect.md

+# OH_Rect
+
+
+## 概述
+
+定义录屏界面的宽高以及画面信息。
+
+**系统能力**：SystemCapability.Multimedia.Media.AVScreenCapture
+
+**起始版本：**
+
+10
+
+**相关模块:**
+
+[AVScreenCapture](_a_v_screen_capture.md)
+
+
+## 汇总
+
+
+### 成员变量
+
+| 名称 | 描述 | 
+| -------- | -------- |
+| [x](#x) | int32_t<br/>录屏界面的X坐标。 | 
+| [y](#y) | int32_t<br/>录屏界面的Y坐标。 | 
+| [width](#width) | int32_t<br/>录屏界面的宽度。 | 
+| [height](#height) | int32_t<br/>录屏界面的高度。 | 
+
+
+## 结构体成员变量说明
+
+
+### height
+
+```
+int32_t OH_Rect::height
+```
+
+**描述:**
+
+录屏界面的高度。
+
+
+### width
+
+```
+int32_t OH_Rect::width
+```
+
+**描述:**
+
+录屏界面的宽度。
+
+
+### x
+
+```
+int32_t OH_Rect::x
+```
+
+**描述:**
+
+录屏界面的X坐标。
+
+
+### y
+
+```
+int32_t OH_Rect::y
+```
+
+**描述:**
+
+录屏界面的Y坐标。

zh-cn/application-dev/reference/native-apis/_o_h___video_capture_info.md

+# OH_VideoCaptureInfo
+
+
+## 概述
+
+视频采集信息。
+
+**系统能力**：SystemCapability.Multimedia.Media.AVScreenCapture
+
+**起始版本：**
+
+10
+
+**相关模块:**
+
+[AVScreenCapture](_a_v_screen_capture.md)
+
+
+## 汇总
+
+
+### 成员变量
+
+| 名称 | 描述 | 
+| -------- | -------- |
+| [displayId](#displayid) | uint64_t<br/>录制物理屏id，使用该参数需要在capturemode为CAPTURE_SPECIFIED_SCREEN模式下使用。<br>**说明：** 预留接口，将在后续版本提供。 | 
+| [missionIDs](#missionids) | int32_t \*<br/>指定窗口id列表，使用该参数需要在capturemode为CAPTURE_SPECIFIED_WINDOW模式下使用。 <br>**说明：** 预留接口，将在后续版本提供。| 
+| [missionIDsLen](#missionidslen) | int32_t<br/>指定窗口ID长度，使用该参数需要在capturemode为CAPTURE_SPECIFIED_WINDOW模式下使用。<br>**说明：** 预留接口，将在后续版本提供。 | 
+| [videoFrameWidth](#videoframewidth) | int32_t<br/>采集视频的宽度设置。 | 
+| [videoFrameHeight](#videoframeheight) | int32_t<br/>采集视频的高度设置。 | 
+| [videoSource](#videosource) | [OH_VideoSourceType](_a_v_screen_capture.md#oh_videosourcetype)<br/>视频采集格式设置，目前仅支持RGBA格式。 | 
+
+
+## 结构体成员变量说明
+
+
+### displayId
+
+```
+uint64_t OH_VideoCaptureInfo::displayId
+```
+
+**描述:**
+
+录制物理屏id，使用该参数需要在capturemode为CAPTURE_SPECIFIED_SCREEN模式下使用。
+
+> **说明：** 
+> 
+> 预留接口，将在后续版本提供。
+
+
+### missionIDs
+
+```
+int32_t* OH_VideoCaptureInfo::missionIDs
+```
+
+**描述:**
+
+指定窗口id列表，使用该参数需要在capturemode为CAPTURE_SPECIFIED_WINDOW模式下使用。
+
+> **说明：** 
+> 
+> 预留接口，将在后续版本提供。
+
+### missionIDsLen
+
+```
+int32_t OH_VideoCaptureInfo::missionIDsLen
+```
+
+**描述:**
+
+指定窗口ID长度，使用该参数需要在capturemode为CAPTURE_SPECIFIED_WINDOW模式下使用。
+
+> **说明：** 
+> 
+> 预留接口，将在后续版本提供。
+
+
+### videoFrameHeight
+
+```
+int32_t OH_VideoCaptureInfo::videoFrameHeight
+```
+
+**描述:**
+
+采集视频的高度设置。
+
+
+### videoFrameWidth
+
+```
+int32_t OH_VideoCaptureInfo::videoFrameWidth
+```
+
+**描述:**
+
+采集视频的宽度设置。
+
+
+### videoSource
+
+```
+OH_VideoSourceType OH_VideoCaptureInfo::videoSource
+```
+
+**描述:**
+
+视频采集格式设置，目前仅支持RGBA格式。

zh-cn/application-dev/reference/native-apis/_o_h___video_enc_info.md

+# OH_VideoEncInfo
+
+
+## 概述
+
+视频编码参数。
+
+> **说明：** 
+> 
+> 预留接口，将在后续版本提供。
+
+**系统能力**：SystemCapability.Multimedia.Media.AVScreenCapture
+
+**起始版本：**
+
+10
+
+**相关模块:**
+
+[AVScreenCapture](_a_v_screen_capture.md)
+
+
+## 汇总
+
+
+### 成员变量
+
+| 名称 | 描述 | 
+| -------- | -------- |
+| [videoCodec](#videocodec) | [OH_VideoCodecFormat](_a_v_screen_capture.md#oh_videocodecformat)<br/>视频采集编码格式。 | 
+| [videoBitrate](#videobitrate) | int32_t<br/>视频采集比特率。 | 
+| [videoFrameRate](#videoframerate) | int32_t<br/>视频采集帧率。 | 
+
+
+## 结构体成员变量说明
+
+
+### videoBitrate
+
+```
+int32_t OH_VideoEncInfo::videoBitrate
+```
+
+**描述:**
+
+视频采集比特率。
+
+
+### videoCodec
+
+```
+OH_VideoCodecFormat OH_VideoEncInfo::videoCodec
+```
+
+**描述:**
+
+视频采集编码格式。
+
+
+### videoFrameRate
+
+```
+int32_t OH_VideoEncInfo::videoFrameRate
+```
+
+**描述:**
+
+视频采集帧率。

zh-cn/application-dev/reference/native-apis/_o_h___video_info.md

+# OH_VideoInfo
+
+
+## 概述
+
+视频录制参数。
+
+**系统能力**：SystemCapability.Multimedia.Media.AVScreenCapture
+
+**起始版本：**
+
+10
+
+**相关模块:**
+
+[AVScreenCapture](_a_v_screen_capture.md)
+
+
+## 汇总
+
+
+### 成员变量
+
+| 名称 | 描述 | 
+| -------- | -------- |
+| [videoCapInfo](#videocapinfo) | [OH_VideoCaptureInfo](_o_h___video_capture_info.md)<br/>视频采集信息。 | 
+| [videoEncInfo](#videoencinfo) | [OH_VideoEncInfo](_o_h___video_enc_info.md)<br/>视频编码参数。 <br>**说明：** 预留接口，将在后续版本提供。| 
+
+
+## 结构体成员变量说明
+
+
+### videoCapInfo
+
+```
+OH_VideoCaptureInfo OH_VideoInfo::videoCapInfo
+```
+
+**描述:**
+
+视频采集信息。
+
+
+### videoEncInfo
+
+```
+OH_VideoEncInfo OH_VideoInfo::videoEncInfo
+```
+
+**描述:**
+
+视频编码参数。
+
+> **说明：** 
+> 
+> 预留接口，将在后续版本提供。

zh-cn/application-dev/reference/native-apis/native__avscreen__capture_8h.md

+# native_avscreen_capture.h
+
+
+## 概述
+
+声明用于构造屏幕录制对象的Native API。
+
+**起始版本：**
+
+10
+
+**相关模块:**
+
+[AVScreenCapture](_a_v_screen_capture.md)
+
+
+## 汇总
+
+
+### 函数
+
+| 名称 | 描述 | 
+| -------- | -------- |
+| [OH_AVScreenCapture_Create](_a_v_screen_capture.md#oh_avscreencapture_create) (void) | 实例化对象，创建OH_AVScreenCapture。 | 
+| [OH_AVScreenCapture_Init](_a_v_screen_capture.md#oh_avscreencapture_init) (struct [OH_AVScreenCapture](_a_v_screen_capture.md#oh_avscreencapture) \*capture, [OH_AVScreenCaptureConfig](_o_h___a_v_screen_capture_config.md) config) | 初始化OH_AVScreenCapture相关参数。 | 
+| [OH_AVScreenCapture_StartScreenCapture](_a_v_screen_capture.md#oh_avscreencapture_startscreencapture) (struct [OH_AVScreenCapture](_a_v_screen_capture.md#oh_avscreencapture) \*capture) | 开始录屏，采集原始码流。调用后可以通过回调的监听(OH_AVScreenCaptureOnAudioBufferAvailable，OH_AVScreenCaptureOnVideoBufferAvailable)来监听当前是否有码流的产生。 | 
+| [OH_AVScreenCapture_StopScreenCapture](_a_v_screen_capture.md#oh_avscreencapture_stopscreencapture) (struct [OH_AVScreenCapture](_a_v_screen_capture.md#oh_avscreencapture) \*capture) | 结束录屏，与OH_AVScreenCapture_StartScreenCapture配合使用。调用后针对调用该接口的应用会停止录屏或屏幕共享，释放麦克风。 | 
+| [OH_AVScreenCapture_StartScreenRecording](_a_v_screen_capture.md#oh_avscreencapture_startscreenrecording) (struct [OH_AVScreenCapture](_a_v_screen_capture.md#oh_avscreencapture) \*capture) | 启动录屏，调用此接口，可采集编码后的码流。<br>**说明：** 预留接口，将在后续版本提供。 | 
+| [OH_AVScreenCapture_StopScreenRecording](_a_v_screen_capture.md#oh_avscreencapture_stopscreenrecording) (struct [OH_AVScreenCapture](_a_v_screen_capture.md#oh_avscreencapture) \*capture) | 停止录屏，与OH_AVScreenCapture_StartScreenRecording配合使用。<br>**说明：** 预留接口，将在后续版本提供。 | 
+| [OH_AVScreenCapture_AcquireAudioBuffer](_a_v_screen_capture.md#oh_avscreencapture_acquireaudiobuffer) (struct [OH_AVScreenCapture](_a_v_screen_capture.md#oh_avscreencapture) \*capture, [OH_AudioBuffer](_o_h___audio_buffer.md) \*\*audiobuffer, [OH_AudioCaptureSourceType](_a_v_screen_capture.md#oh_audiocapturesourcetype) type) | 获取音频buffer，应用在调用时，需要对audiobuffer分配对应结构体大小的内存，否则会影响拿到音频buffer的获取。 | 
+| [OH_AVScreenCapture_AcquireVideoBuffer](_a_v_screen_capture.md#oh_avscreencapture_acquirevideobuffer) (struct [OH_AVScreenCapture](_a_v_screen_capture.md#oh_avscreencapture) \*capture, int32_t \*fence, int64_t \*timestamp, struct [OH_Rect](_o_h___rect.md) \*region) | 获取视频buffer，应用在调用时，通过此接口来获取到视频的buffer以及时间戳等信息。 | 
+| [OH_AVScreenCapture_ReleaseAudioBuffer](_a_v_screen_capture.md#oh_avscreencapture_releaseaudiobuffer) (struct [OH_AVScreenCapture](_a_v_screen_capture.md#oh_avscreencapture) \*capture, [OH_AudioCaptureSourceType](_a_v_screen_capture.md#oh_audiocapturesourcetype) type) | 根据音频类型释放buffer。 | 
+| [OH_AVScreenCapture_ReleaseVideoBuffer](_a_v_screen_capture.md#oh_avscreencapture_releasevideobuffer) (struct [OH_AVScreenCapture](_a_v_screen_capture.md#oh_avscreencapture) \*capture) | 根据视频类型释放buffer。 | 
+| [OH_AVScreenCapture_SetCallback](_a_v_screen_capture.md#oh_avscreencapture_setcallback) (struct [OH_AVScreenCapture](_a_v_screen_capture.md#oh_avscreencapture) \*capture, struct [OH_AVScreenCaptureCallback](_o_h___a_v_screen_capture_callback.md) callback) | 设置监听接口，通过设置监听，可以监听到调用过程中的错误信息，以及是否有可用的视频buffer和音频buffer。 | 
+| [OH_AVScreenCapture_Release](_a_v_screen_capture.md#oh_avscreencapture_release) (struct [OH_AVScreenCapture](_a_v_screen_capture.md#oh_avscreencapture) \*capture) | 释放创建的OH_AVScreenCapture实例，对应OH_AVScreenCapture_Create。 | 
+| [OH_AVScreenCapture_SetMicrophoneEnabled](_a_v_screen_capture.md#oh_avscreencapture_setmicrophoneenabled) (struct [OH_AVScreenCapture](_a_v_screen_capture.md#oh_avscreencapture) \*capture, bool isMicrophone) | 设置麦克风开关。 | 

zh-cn/application-dev/reference/native-apis/native__avscreen__capture__base_8h.md

+# native_avscreen_capture_base.h
+
+
+## 概述
+
+声明用于运行屏幕录制通用的结构体、字符常量、枚举。
+
+**起始版本：**
+
+10
+
+**相关模块:**
+
+[AVScreenCapture](_a_v_screen_capture.md)
+
+
+## 汇总
+
+
+### 结构体
+
+| 名称 | 描述 | 
+| -------- | -------- |
+| [OH_AudioCaptureInfo](_o_h___audio_capture_info.md) | 音频录制信息。 | 
+| [OH_AudioEncInfo](_o_h___audio_enc_info.md) | 音频编码信息。<br>**说明：** 预留接口，将在后续版本提供。 | 
+| [OH_AudioInfo](_o_h___audio_info.md) | 音频录制参数。 | 
+| [OH_VideoCaptureInfo](_o_h___video_capture_info.md) | 视频采集信息。 | 
+| [OH_VideoEncInfo](_o_h___video_enc_info.md) | 视频编码信息。<br>**说明：** 预留接口，将在后续版本提供。 | 
+| [OH_VideoInfo](_o_h___video_info.md) | 视频录制参数。 | 
+| [OH_RecorderInfo](_o_h___recorder_info.md) | 录制文件信息。 | 
+| [OH_AVScreenCaptureConfig](_o_h___a_v_screen_capture_config.md) | 屏幕录制配置参数。 | 
+| [OH_AVScreenCaptureCallback](_o_h___a_v_screen_capture_callback.md) | OH_AVScreenCapture中所有异步回调函数指针的集合。 | 
+| [OH_Rect](_o_h___rect.md) | 定义录屏界面的宽高以及画面信息。 | 
+| [OH_AudioBuffer](_o_h___audio_buffer.md) | 定义了音频数据的大小，类型，时间戳等配置信息。 | 
+
+
+### 类型定义
+
+| 名称 | 描述 | 
+| -------- | -------- |
+| [OH_NativeBuffer](_a_v_screen_capture.md#oh_nativebuffer) | 提供录屏的视频原始码流类。 | 
+| [OH_AVScreenCapture](_a_v_screen_capture.md#oh_avscreencapture) | 通过OH_AVScreenCapture可以获取视频与音频的原始码流。 | 
+| [OH_CaptureMode](_a_v_screen_capture.md#oh_capturemode) | 枚举，表示屏幕录制的不同模式。 | 
+| [OH_AudioCaptureSourceType](_a_v_screen_capture.md#oh_audiocapturesourcetype) | 枚举，表示屏幕录制时的音频源类型。 | 
+| [OH_AudioCodecFormat](_a_v_screen_capture.md#oh_audiocodecformat) | 枚举，表示音频编码格式。 | 
+| [OH_VideoCodecFormat](_a_v_screen_capture.md#oh_videocodecformat) | 枚举，表示视频编码格式。 | 
+| [OH_DataType](_a_v_screen_capture.md#oh_datatype) | 枚举，表示屏幕录制流的数据格式。 | 
+| [OH_VideoSourceType](_a_v_screen_capture.md#oh_videosourcetype) | 枚举，表示视频源格式。 | 
+| [OH_ContainerFormatType](_a_v_screen_capture.md#oh_containerformattype) | 枚举，表示屏幕录制生成的文件类型。<br>**说明：** 预留接口，将在后续版本提供。 | 
+| [OH_AudioCaptureInfo](_a_v_screen_capture.md#oh_audiocaptureinfo) | 音频录制信息。 | 
+| [OH_AudioEncInfo](_a_v_screen_capture.md#oh_audioencinfo) | 音频编码信息。<br>**说明：** 预留接口，将在后续版本提供。 | 
+| [OH_AudioInfo](_a_v_screen_capture.md#oh_audioinfo) | 音频录制参数。 | 
+| [OH_VideoCaptureInfo](_a_v_screen_capture.md#oh_videocaptureinfo) | 视频采集信息。 | 
+| [OH_VideoEncInfo](_a_v_screen_capture.md#oh_videoencinfo) | 视频编码信息。 <br>**说明：** 预留接口，将在后续版本提供。| 
+| [OH_VideoInfo](_a_v_screen_capture.md#oh_videoinfo) | 视频录制参数。 | 
+| [OH_RecorderInfo](_a_v_screen_capture.md#oh_recorderinfo) | 录制文件信息。 | 
+| [OH_AVScreenCaptureConfig](_a_v_screen_capture.md#oh_avscreencaptureconfig) | 屏幕录制配置参数。 | 
+| (\*[OH_AVScreenCaptureOnError](_a_v_screen_capture.md#oh_avscreencaptureonerror)) ([OH_AVScreenCapture](_a_v_screen_capture.md#oh_avscreencapture) \*capture, int32_t errorCode) | 当OH_AVScreenCapture实例运行出错时，将调用函数指针。 | 
+| (\*[OH_AVScreenCaptureOnAudioBufferAvailable](_a_v_screen_capture.md#oh_avscreencaptureonaudiobufferavailable)) ([OH_AVScreenCapture](_a_v_screen_capture.md#oh_avscreencapture) \*capture, bool isReady, [OH_AudioCaptureSourceType](_a_v_screen_capture.md#oh_audiocapturesourcetype) type) | 当OH_AVScreenCapture操作期间音频缓冲区可用时，将调用函数指针。 | 
+| (\*[OH_AVScreenCaptureOnVideoBufferAvailable](_a_v_screen_capture.md#oh_avscreencaptureonvideobufferavailable)) ([OH_AVScreenCapture](_a_v_screen_capture.md#oh_avscreencapture) \*capture, bool isReady) | 当OH_AVScreenCapture操作期间视频缓冲区可用时，将调用函数指针。 | 
+| [OH_AVScreenCaptureCallback](_a_v_screen_capture.md#oh_avscreencapturecallback) | OH_AVScreenCapture中所有异步回调函数指针的集合。 | 
+| [OH_Rect](_a_v_screen_capture.md#oh_rect) | 定义录屏界面的宽高以及画面信息。 | 
+| [OH_AudioBuffer](_a_v_screen_capture.md#oh_audiobuffer) | 定义了音频数据的大小，类型，时间戳等配置信息。 | 
+
+
+### 枚举
+
+| 名称 | 描述 | 
+| -------- | -------- |
+| [OH_CaptureMode](_a_v_screen_capture.md#oh_capturemode) { [OH_CAPTURE_HOME_SCREEN](_a_v_screen_capture.md) = 0, [OH_CAPTURE_SPECIFIED_SCREEN](_a_v_screen_capture.md) = 1, [OH_CAPTURE_SPECIFIED_WINDOW](_a_v_screen_capture.md) = 2, [OH_CAPTURE_INVAILD](_a_v_screen_capture.md) = -1 } | 枚举，表示屏幕录制的不同模式。 | 
+| [OH_AudioCaptureSourceType](_a_v_screen_capture.md#oh_audiocapturesourcetype) {<br/>[OH_SOURCE_INVALID](_a_v_screen_capture.md) = -1, [OH_SOURCE_DEFAULT](_a_v_screen_capture.md) = 0, [OH_MIC](_a_v_screen_capture.md) = 1, [OH_ALL_PLAYBACK](_a_v_screen_capture.md) = 2,<br/>[OH_APP_PLAYBACK](_a_v_screen_capture.md) = 3<br/>} | 枚举，表示屏幕录制时的音频源类型。 | 
+| [OH_AudioCodecFormat](_a_v_screen_capture.md#oh_audiocodecformat) { [OH_AUDIO_DEFAULT](_a_v_screen_capture.md) = 0, [OH_AAC_LC](_a_v_screen_capture.md) = 3, [OH_AUDIO_CODEC_FORMAT_BUTT](_a_v_screen_capture.md) } | 枚举，表示音频编码格式。 | 
+| [OH_VideoCodecFormat](_a_v_screen_capture.md#oh_videocodecformat) {<br/>[OH_VIDEO_DEFAULT](_a_v_screen_capture.md) = 0, [OH_H264](_a_v_screen_capture.md) = 2, [OH_H265](_a_v_screen_capture.md) = 4, [OH_MPEG4](_a_v_screen_capture.md) = 6,<br/>[OH_VP8](_a_v_screen_capture.md) = 8, [OH_VP9](_a_v_screen_capture.md) = 10, [OH_VIDEO_CODEC_FORMAT_BUTT](_a_v_screen_capture.md)<br/>} | 枚举，表示视频编码格式。 | 
+| [OH_DataType](_a_v_screen_capture.md#oh_datatype) { [OH_ORIGINAL_STREAM](_a_v_screen_capture.md) = 0, [OH_ENCODED_STREAM](_a_v_screen_capture.md) = 1, [OH_CAPTURE_FILE](_a_v_screen_capture.md) = 2, OH_INVAILD = -1 } | 枚举，表示屏幕录制流的数据格式。 | 
+| [OH_VideoSourceType](_a_v_screen_capture.md#oh_videosourcetype) { [OH_VIDEO_SOURCE_SURFACE_YUV](_a_v_screen_capture.md) = 0, [OH_VIDEO_SOURCE_SURFACE_ES](_a_v_screen_capture.md), [OH_VIDEO_SOURCE_SURFACE_RGBA](_a_v_screen_capture.md), [OH_VIDEO_SOURCE_BUTT](_a_v_screen_capture.md) } | 枚举，表示视频源格式。 | 
+| [OH_ContainerFormatType](_a_v_screen_capture.md#oh_containerformattype) { [CFT_MPEG_4A](_a_v_screen_capture.md) = 0, [CFT_MPEG_4](_a_v_screen_capture.md) = 1 } | 枚举，表示屏幕录制生成的文件类型。<br>**说明：** 预留接口，将在后续版本提供。 | 

zh-cn/application-dev/reference/native-apis/native__avscreen__capture__errors_8h.md

+# native_avscreen_capture_errors.h
+
+
+## 概述
+
+声明用于运行屏幕录制过程中接口调用的错误码说明。
+
+**起始版本：**
+
+10
+
+**相关模块:**
+
+[AVScreenCapture](_a_v_screen_capture.md)
+
+
+## 汇总
+
+
+### 类型定义
+
+| 名称 | 描述 | 
+| -------- | -------- |
+| [OH_AVSCREEN_CAPTURE_ErrCode](_a_v_screen_capture.md#oh_avscreen_capture_errcode) | 屏幕录制过程中产生的不同结果码。 | 
+
+
+### 枚举
+
+| 名称 | 描述 | 
+| -------- | -------- |
+| [OH_AVSCREEN_CAPTURE_ErrCode](_a_v_screen_capture.md#oh_avscreen_capture_errcode) {<br/>[AV_SCREEN_CAPTURE_ERR_BASE](_a_v_screen_capture.md) = 0, [AV_SCREEN_CAPTURE_ERR_OK](_a_v_screen_capture.md) = AV_SCREEN_CAPTURE_ERR_BASE, [AV_SCREEN_CAPTURE_ERR_NO_MEMORY](_a_v_screen_capture.md) = AV_SCREEN_CAPTURE_ERR_BASE + 1, [AV_SCREEN_CAPTURE_ERR_OPERATE_NOT_PERMIT](_a_v_screen_capture.md) = AV_SCREEN_CAPTURE_ERR_BASE + 2,<br/>[AV_SCREEN_CAPTURE_ERR_INVALID_VAL](_a_v_screen_capture.md) = AV_SCREEN_CAPTURE_ERR_BASE + 3, [AV_SCREEN_CAPTURE_ERR_IO](_a_v_screen_capture.md) = AV_SCREEN_CAPTURE_ERR_BASE + 4, [AV_SCREEN_CAPTURE_ERR_TIMEOUT](_a_v_screen_capture.md) = AV_SCREEN_CAPTURE_ERR_BASE + 5, [AV_SCREEN_CAPTURE_ERR_UNKNOWN](_a_v_screen_capture.md) = AV_SCREEN_CAPTURE_ERR_BASE + 6,<br/>[AV_SCREEN_CAPTURE_ERR_SERVICE_DIED](_a_v_screen_capture.md) = AV_SCREEN_CAPTURE_ERR_BASE + 7, [AV_SCREEN_CAPTURE_ERR_INVALID_STATE](_a_v_screen_capture.md) = AV_SCREEN_CAPTURE_ERR_BASE + 8, [AV_SCREEN_CAPTURE_ERR_UNSUPPORT](_a_v_screen_capture.md) = AV_SCREEN_CAPTURE_ERR_BASE + 9, [AV_SCREEN_CAPTURE_ERR_EXTEND_START](_a_v_screen_capture.md) = AV_SCREEN_CAPTURE_ERR_BASE + 100<br/>} | 屏幕录制过程中产生的不同结果码。 |