Skip to content

D
Docs

OpenHarmony / Docs
大约 2 年 前同步成功

通知 161
Star 293
Fork 28
D
Docs
提交 4c9faf21 编写于 作者: B bird_j
浏览文件
操作

add syscaps 

Signed-off-by: Nbird_j <jianghongpeng@huawei.com>
上级 b918c265
隐藏空白更改
内联 并排
Showing with 292 addition and 154 deletion
zh-cn/application-dev/reference/apis/js-apis-media.md
浏览文件 @ 4c9faf21
...@@ -29,7 +29,7 @@ createAudioPlayer(): [AudioPlayer](#audioplayer) ...@@ -29,7 +29,7 @@ createAudioPlayer(): [AudioPlayer](#audioplayer)
| 类型 | 说明 | | 类型 | 说明 |
| --------------------------- | ------------------------------------------------------------ | | --------------------------- | ------------------------------------------------------------ |
| [AudioPlayer](#audioplayer) | 返回AudioPlayer类实例，失败时返回null。可用于音频播放、暂停、停止等操作。 | | [AudioPlayer](#audioplayer) | 返回AudioPlayer类实例，失败时返回null。可用于音频播放、暂停、停止等操作。<br/> **系统能力：** SystemCapability.Multimedia.Media.AudioPlayer |
**示例：** **示例：**
...@@ -45,9 +45,9 @@ createVideoPlayer(callback: AsyncCallback\<[VideoPlayer](#videoplayer8)>): void ...@@ -45,9 +45,9 @@ createVideoPlayer(callback: AsyncCallback\<[VideoPlayer](#videoplayer8)>): void
**参数：** **参数：**
| 参数名 | 类型 | 必填 | 说明 | | 参数名 | 类型 | 必填 | 说明 |
| -------- | ------------------------------------------- | ---- | ------------------------------ | | -------- | ------------------------------------------- | ---- | ------------------------------------------------------------ |
| callback | AsyncCallback<[VideoPlayer](#videoplayer8)> | 是 | 异步创建视频播放实例回调方法。 | | callback | AsyncCallback<[VideoPlayer](#videoplayer8)> | 是 | 异步创建视频播放实例回调方法。<br/>**系统能力：** SystemCapability.Multimedia.Media.VideoPlayer |
**示例：** **示例：**
...@@ -72,9 +72,9 @@ createVideoPlayer: Promise<[VideoPlayer](#videoplayer8)> ...@@ -72,9 +72,9 @@ createVideoPlayer: Promise<[VideoPlayer](#videoplayer8)>
**返回值：** **返回值：**
| 类型 | 说明 | | 类型 | 说明 |
| ------------------------------------- | ----------------------------------- | | ------------------------------------- | ------------------------------------------------------------ |
| Promise<[VideoPlayer](#videoplayer8)> | 异步创建视频播放实例Promise返回值。 | | Promise<[VideoPlayer](#videoplayer8)> | 异步创建视频播放实例Promise返回值。<br/>**系统能力：** SystemCapability.Multimedia.Media.VideoPlayer |
**示例：** **示例：**
...@@ -106,9 +106,9 @@ createAudioRecorder(): AudioRecorder ...@@ -106,9 +106,9 @@ createAudioRecorder(): AudioRecorder
**返回值:** **返回值:**
| 类型 | 说明 | | 类型 | 说明 |
| ------------------------------- | ----------------------------------------- | | ------------------------------- | ------------------------------------------------------------ |
| [AudioRecorder](#audiorecorder) | 返回AudioRecorder类实例，失败时返回null。 | | [AudioRecorder](#audiorecorder) | 返回AudioRecorder类实例，失败时返回null。<br/>**系统能力：** SystemCapability.Multimedia.Media.AudioRecorder |
**示例：** **示例：**
...@@ -124,9 +124,9 @@ createVideoRecorder(callback: AsyncCallback\<[VideoRecorder](#videorecorder8)>): ...@@ -124,9 +124,9 @@ createVideoRecorder(callback: AsyncCallback\<[VideoRecorder](#videorecorder8)>):
**参数：** **参数：**
| 参数名 | 类型 | 必填 | 说明 | | 参数名 | 类型 | 必填 | 说明 |
| -------- | ----------------------------------------------------------- | ---- | ------------------------------ | | -------- | ----------------------------------------------- | ---- | ------------------------------------------------------------ |
| callback | AsyncCallback<[VideoRecorder](#videorecorder8)> | 是 | 异步创建视频录制实例回调方法。 | | callback | AsyncCallback<[VideoRecorder](#videorecorder8)> | 是 | 异步创建视频录制实例回调方法。<br/>**系统能力：** SystemCapability.Multimedia.Media.VideoRecorder |
**示例：** **示例：**
...@@ -151,9 +151,9 @@ createVideoRecorder: Promise<[VideoRecorder](#videorecorder8)> ...@@ -151,9 +151,9 @@ createVideoRecorder: Promise<[VideoRecorder](#videorecorder8)>
**返回值：** **返回值：**
| 类型 | 说明 | | 类型 | 说明 |
| ----------------------------------------------------- | ----------------------------------- | | ----------------------------------------- | ------------------------------------------------------------ |
| Promise<[VideoRecorder](#videorecorder8)> | 异步创建视频录制实例Promise返回值。 | | Promise<[VideoRecorder](#videorecorder8)> | 异步创建视频录制实例Promise返回值。<br/>**系统能力：** SystemCapability.Multimedia.Media.VideoRecorder |
**示例：** **示例：**
...@@ -183,40 +183,38 @@ await media.createVideoRecorder.then((video) => { ...@@ -183,40 +183,38 @@ await media.createVideoRecorder.then((video) => {
媒体服务错误类型枚举 媒体服务错误类型枚举
| 名称 | 值 | 说明 | | 名称 | 值 | 说明 |
| -------------------------- | ---- | -------------------------------------- | | -------------------------- | ---- | ------------------------------------------------------------ |
| MSERR_OK | 0 | 表示操作成功。 | | MSERR_OK | 0 | 表示操作成功。<br/>**系统能力：** SystemCapability.Multimedia.Media.Core |
| MSERR_NO_MEMORY | 1 | 表示申请内存失败，系统可能无可用内存。 | | MSERR_NO_MEMORY | 1 | 表示申请内存失败，系统可能无可用内存。<br/>**系统能力：** SystemCapability.Multimedia.Media.Core |
| MSERR_OPERATION_NOT_PERMIT | 2 | 表示无权限执行此操作。 | | MSERR_OPERATION_NOT_PERMIT | 2 | 表示无权限执行此操作。<br/>**系统能力：** SystemCapability.Multimedia.Media.Core |
| MSERR_INVALID_VAL | 3 | 表示传入入参无效。 | | MSERR_INVALID_VAL | 3 | 表示传入入参无效。<br/>**系统能力：** SystemCapability.Multimedia.Media.Core |
| MSERR_IO | 4 | 表示发生IO错误。 | | MSERR_IO | 4 | 表示发生IO错误。<br/>**系统能力：** SystemCapability.Multimedia.Media.Core |
| MSERR_TIMEOUT | 5 | 表示操作超时。 | | MSERR_TIMEOUT | 5 | 表示操作超时。<br/>**系统能力：** SystemCapability.Multimedia.Media.Core |
| MSERR_UNKNOWN | 6 | 表示未知错误。 | | MSERR_UNKNOWN | 6 | 表示未知错误。<br/>**系统能力：** SystemCapability.Multimedia.Media.Core |
| MSERR_SERVICE_DIED | 7 | 表示服务端失效。 | | MSERR_SERVICE_DIED | 7 | 表示服务端失效。<br/>**系统能力：** SystemCapability.Multimedia.Media.Core |
| MSERR_INVALID_STATE | 8 | 表示在当前状态下，不允许执行此操作。 | | MSERR_INVALID_STATE | 8 | 表示在当前状态下，不允许执行此操作。<br/>**系统能力：** SystemCapability.Multimedia.Media.Core |
| MSERR_UNSUPPORTED | 9 | 表示在当前版本下，不支持此操作。 | | MSERR_UNSUPPORTED | 9 | 表示在当前版本下，不支持此操作。<br/>**系统能力：** SystemCapability.Multimedia.Media.Core |
## MediaType<sup>8+</sup> ## MediaType<sup>8+</sup>
媒体类型枚举 媒体类型枚举
| 名称 | 值 | 说明 | | 名称 | 值 | 说明 |
| ------------------- | ---- | ------------------ | | -------------- | ---- | ------------------------------------------------------------ |
| MEDIA_TYPE_AUD | 0 | 表示音频。 | | MEDIA_TYPE_AUD | 0 | 表示音频。<br/>**系统能力：** SystemCapability.Multimedia.Media.Core |
| MEDIA_TYPE_VID | 1 | 表示视频。 | | MEDIA_TYPE_VID | 1 | 表示视频。<br/>**系统能力：** SystemCapability.Multimedia.Media.Core |
| MEDIA_TYPE_SUBTITLE | 2 | 表示字幕：开发中。 |
## CodecMimeType<sup>8+</sup> ## CodecMimeType<sup>8+</sup>
Codec MIME类型枚举 Codec MIME类型枚举
| 名称 | 值 | 说明 | | 名称 | 值 | 说明 |
| ------------ | ----------------- | ------------------------ | | ------------ | ----------------- | ------------------------------------------------------------ |
| VIDEO_MPEG4 | ”video/mp4v-es“ | 表示视频/mpeg4类型。 | | VIDEO_MPEG4 | ”video/mp4v-es“ | 表示视频/mpeg4类型。<br/>**系统能力：** SystemCapability.Multimedia.Media.Core |
| AUDIO_MPEG | "audio/mpeg" | 表示音频/mpeg类型。 | | AUDIO_AAC | "audio/mp4a-latm" | 表示音频/mp4a-latm类型。<br/>**系统能力：** SystemCapability.Multimedia.Media.Core |
| AUDIO_AAC | "audio/mp4a-latm" | 表示音频/mp4a-latm类型。 | | AUDIO_VORBIS | "audio/vorbis" | 表示音频/vorbis类型。<br/>**系统能力：** SystemCapability.Multimedia.Media.Core |
| AUDIO_VORBIS | "audio/vorbis" | 表示音频/vorbis类型。 | | AUDIO_FLAC | "audio/flac" | 表示音频/flac类型。<br/>**系统能力：** SystemCapability.Multimedia.Media.Core |
| AUDIO_FLAC | "audio/flac" | 表示音频/flac类型。 |
## MediaDescriptionKey<sup>8+</sup> ## MediaDescriptionKey<sup>8+</sup>
...@@ -224,31 +222,31 @@ Codec MIME类型枚举 ...@@ -224,31 +222,31 @@ Codec MIME类型枚举
| 名称 | 值 | 说明 | | 名称 | 值 | 说明 |
| ------------------------ | --------------- | ------------------------------------------------------------ | | ------------------------ | --------------- | ------------------------------------------------------------ |
| MD_KEY_TRACK_INDEX | "track_index" | 表示轨道序号，其对应键值类型为number。 | | MD_KEY_TRACK_INDEX | "track_index" | 表示轨道序号，其对应键值类型为number。<br/>**系统能力：** SystemCapability.Multimedia.Media.Core |
| MD_KEY_TRACK_TYPE | "track_type" | 表示轨道类型，其对应键值类型为number，参考[MediaType](#mediatype8)。 | | MD_KEY_TRACK_TYPE | "track_type" | 表示轨道类型，其对应键值类型为number，参考[MediaType](#mediatype8)。<br/>**系统能力：** SystemCapability.Multimedia.Media.Core |
| MD_KEY_CODEC_MIME | "codec_mime" | 表示codec_mime类型，其对应键值类型为string。 | | MD_KEY_CODEC_MIME | "codec_mime" | 表示codec_mime类型，其对应键值类型为string。<br/>**系统能力：** SystemCapability.Multimedia.Media.Core |
| MD_KEY_DURATION | "duration" | 表示媒体时长，其对应键值类型为number，单位为ms。 | | MD_KEY_DURATION | "duration" | 表示媒体时长，其对应键值类型为number，单位为ms。<br/>**系统能力：** SystemCapability.Multimedia.Media.Core |
| MD_KEY_BITRATE | "bitrate" | 表示比特率，其对应键值类型为number，单位为bps。 | | MD_KEY_BITRATE | "bitrate" | 表示比特率，其对应键值类型为number，单位为bps。<br/>**系统能力：** SystemCapability.Multimedia.Media.Core |
| MD_KEY_WIDTH | "width" | 表示视频宽度，其对应键值类型为number，单位为像素。 | | MD_KEY_WIDTH | "width" | 表示视频宽度，其对应键值类型为number，单位为像素。<br/>**系统能力：** SystemCapability.Multimedia.Media.Core |
| MD_KEY_HEIGHT | "height" | 表示视频高度，其对应键值类型为number，单位为像素。 | | MD_KEY_HEIGHT | "height" | 表示视频高度，其对应键值类型为number，单位为像素。<br/>**系统能力：** SystemCapability.Multimedia.Media.Core |
| MD_KEY_FRAME_RATE | "frame_rate" | 表示视频帧率，其对应键值类型为number，单位为100fps。 | | MD_KEY_FRAME_RATE | "frame_rate" | 表示视频帧率，其对应键值类型为number，单位为100fps。<br/>**系统能力：** SystemCapability.Multimedia.Media.Core |
| MD_KEY_AUD_CHANNEL_COUNT | "channel_count" | 表示声道数，其对应键值类型为number。 | | MD_KEY_AUD_CHANNEL_COUNT | "channel_count" | 表示声道数，其对应键值类型为number。<br/>**系统能力：** SystemCapability.Multimedia.Media.Core |
| MD_KEY_AUD_SAMPLE_RATE | "sample_rate" | 表示采样率，其对应键值类型为number，单位为HZ。 | | MD_KEY_AUD_SAMPLE_RATE | "sample_rate" | 表示采样率，其对应键值类型为number，单位为HZ。<br/>**系统能力：** SystemCapability.Multimedia.Media.Core |
## BufferingInfoType<sup>8+</sup> ## BufferingInfoType<sup>8+</sup>
缓存事件类型枚举 缓存事件类型枚举
| 名称 | 值 | 说明 | | 名称 | 值 | 说明 |
| ----------------- | ---- | -------------------------- | | ----------------- | ---- | ------------------------------------------------------------ |
| BUFFERING_START | 1 | 表示开始缓存。 | | BUFFERING_START | 1 | 表示开始缓存。<br/>**系统能力：** SystemCapability.Multimedia.Media.Core |
| BUFFERING_END | 2 | 表示结束缓存。 | | BUFFERING_END | 2 | 表示结束缓存。<br/>**系统能力：** SystemCapability.Multimedia.Media.Core |
| BUFFERING_PERCENT | 3 | 表示缓存百分比。 | | BUFFERING_PERCENT | 3 | 表示缓存百分比。<br/>**系统能力：** SystemCapability.Multimedia.Media.Core |
| CACHED_DURATION | 4 | 表示缓存时长，单位为毫秒。 | | CACHED_DURATION | 4 | 表示缓存时长，单位为毫秒。<br/>**系统能力：** SystemCapability.Multimedia.Media.Core |
## AudioPlayer ## AudioPlayer
音频播放管理类，用于管理和播放音频媒体。在调用AudioPlayer的方法前，需要先通过[createAudioPlayer()](#media.createaudioplayer)或[createAudioPlayerAsync()](#media.createaudioplayerasync8)构建一个[AudioPlayer](#audioplayer)实例。 音频播放管理类，用于管理和播放音频媒体。在调用AudioPlayer的方法前，需要先通过[createAudioPlayer()](#media.createaudioplayer)构建一个[AudioPlayer](#audioplayer)实例。
音频播放demo可参考：[音频播放开发指导](../../media/audio-playback.md) 音频播放demo可参考：[音频播放开发指导](../../media/audio-playback.md)
...@@ -256,11 +254,11 @@ Codec MIME类型枚举 ...@@ -256,11 +254,11 @@ Codec MIME类型枚举
| 名称 | 类型 | 可读 | 可写 | 说明 | | 名称 | 类型 | 可读 | 可写 | 说明 |
| ----------- | ------------------------- | ---- | ---- | ------------------------------------------------------------ | | ----------- | ------------------------- | ---- | ---- | ------------------------------------------------------------ |
| src | string | 是 | 是 | 音频媒体URI，支持当前主流的音频格式(mp4、aac、mp3、ogg)。<br>**支持路径示例**：<br>1、fd类型播放：fd://xxx<br>![zh-cn_image_0000001164217678](figures/zh-cn_image_url.png)<br>2、http网络播放路径：开发中<br>3、hls网络播放路径：开发中<br>**注意事项**：<br>媒体素材需至少赋予读权限后，才可正常播放 | | src | string | 是 | 是 | 音频媒体URI，支持当前主流的音频格式(mp4、aac、mp3、ogg)。<br>**支持路径示例**：<br>1、fd类型播放：fd://xxx<br>![zh-cn_image_0000001164217678](figures/zh-cn_image_url.png)<br>2、http网络播放路径：开发中<br>3、hls网络播放路径：开发中<br>**注意事项**：<br>媒体素材需至少赋予读权限后，才可正常播放。<br/>**系统能力：** SystemCapability.Multimedia.Media.AudioPlayer |
| loop | boolean | 是 | 是 | 音频循环播放属性，设置为'true'表示循环播放。 | | loop | boolean | 是 | 是 | 音频循环播放属性，设置为'true'表示循环播放。<br/>**系统能力：** SystemCapability.Multimedia.Media.AudioPlayer |
| currentTime | number | 是 | 否 | 音频的当前播放位置。 | | currentTime | number | 是 | 否 | 音频的当前播放位置。<br/>**系统能力：** SystemCapability.Multimedia.Media.AudioPlayer |
| duration | number | 是 | 否 | 音频时长。 | | duration | number | 是 | 否 | 音频时长。<br/>**系统能力：** SystemCapability.Multimedia.Media.AudioPlayer |
| state | [AudioState](#audiostate) | 是 | 否 | 音频播放的状态。 | | state | [AudioState](#audiostate) | 是 | 否 | 音频播放的状态。<br/>**系统能力：** SystemCapability.Multimedia.Media.AudioPlayer |
### play<a name=audioplayer_play></a> ### play<a name=audioplayer_play></a>
...@@ -268,6 +266,8 @@ play(): void ...@@ -268,6 +266,8 @@ play(): void
开始播放音频资源，需在[dataLoad](#on('play' | 'pause' | 'stop' | 'reset' | 'dataload' | 'finish' | 'volumechange'))事件成功触发后，才能调用play方法。 开始播放音频资源，需在[dataLoad](#on('play' | 'pause' | 'stop' | 'reset' | 'dataload' | 'finish' | 'volumechange'))事件成功触发后，才能调用play方法。
**系统能力：** SystemCapability.Multimedia.Media.AudioPlayer
**示例：** **示例：**
```js ```js
...@@ -283,6 +283,8 @@ pause(): void ...@@ -283,6 +283,8 @@ pause(): void
暂停播放音频资源。 暂停播放音频资源。
**系统能力：** SystemCapability.Multimedia.Media.AudioPlayer
**示例：** **示例：**
```js ```js
...@@ -298,6 +300,8 @@ stop(): void ...@@ -298,6 +300,8 @@ stop(): void
停止播放音频资源。 停止播放音频资源。
**系统能力：** SystemCapability.Multimedia.Media.AudioPlayer
**示例：** **示例：**
```js ```js
...@@ -313,6 +317,8 @@ reset(): void ...@@ -313,6 +317,8 @@ reset(): void
切换播放音频资源。 切换播放音频资源。
**系统能力：** SystemCapability.Multimedia.Media.AudioPlayer
**示例：** **示例：**
```js ```js
...@@ -328,6 +334,8 @@ seek(timeMs: number): void ...@@ -328,6 +334,8 @@ seek(timeMs: number): void
跳转到指定播放位置。 跳转到指定播放位置。
**系统能力：** SystemCapability.Multimedia.Media.AudioPlayer
**参数：** **参数：**
| 参数名 | 类型 | 必填 | 说明 | | 参数名 | 类型 | 必填 | 说明 |
...@@ -353,6 +361,8 @@ setVolume(vol: number): void ...@@ -353,6 +361,8 @@ setVolume(vol: number): void
设置音量。 设置音量。
**系统能力：** SystemCapability.Multimedia.Media.AudioPlayer
**参数：** **参数：**
| 参数名 | 类型 | 必填 | 说明 | | 参数名 | 类型 | 必填 | 说明 |
...@@ -374,6 +384,8 @@ release(): void ...@@ -374,6 +384,8 @@ release(): void
释放音频资源。 释放音频资源。
**系统能力：** SystemCapability.Multimedia.Media.AudioPlayer
**示例：** **示例：**
```js ```js
...@@ -387,6 +399,8 @@ getTrackDescription(callback: AsyncCallback<Array<[MediaDescription](#mediadescr ...@@ -387,6 +399,8 @@ getTrackDescription(callback: AsyncCallback<Array<[MediaDescription](#mediadescr
通过回调方式获取音频轨道信息。 通过回调方式获取音频轨道信息。
**系统能力：** SystemCapability.Multimedia.Media.AudioPlayer
**参数：** **参数：**
| 参数名 | 类型 | 必填 | 说明 | | 参数名 | 类型 | 必填 | 说明 |
...@@ -421,6 +435,8 @@ getTrackDescription(): Promise<Array<[MediaDescription](#mediadescription8)>> ...@@ -421,6 +435,8 @@ getTrackDescription(): Promise<Array<[MediaDescription](#mediadescription8)>>
通过Promise方式获取音频轨道信息。 通过Promise方式获取音频轨道信息。
**系统能力：** SystemCapability.Multimedia.Media.AudioPlayer
**返回值：** **返回值：**
| 类型 | 说明 | | 类型 | 说明 |
...@@ -462,6 +478,8 @@ on(type: 'bufferingUpdate', callback: (infoType: [BufferingInfoType](#bufferingi ...@@ -462,6 +478,8 @@ on(type: 'bufferingUpdate', callback: (infoType: [BufferingInfoType](#bufferingi
开始订阅音频缓存更新事件。 开始订阅音频缓存更新事件。
**系统能力：** SystemCapability.Multimedia.Media.AudioPlayer
**参数：** **参数：**
| 参数名 | 类型 | 必填 | 说明 | | 参数名 | 类型 | 必填 | 说明 |
...@@ -484,6 +502,8 @@ on(type: 'play' | 'pause' | 'stop' | 'reset' | 'dataLoad' | 'finish' | 'volumeCh ...@@ -484,6 +502,8 @@ on(type: 'play' | 'pause' | 'stop' | 'reset' | 'dataLoad' | 'finish' | 'volumeCh
开始订阅音频播放事件。 开始订阅音频播放事件。
**系统能力：** SystemCapability.Multimedia.Media.AudioPlayer
**参数：** **参数：**
| 参数名 | 类型 | 必填 | 说明 | | 参数名 | 类型 | 必填 | 说明 |
...@@ -554,6 +574,8 @@ on(type: 'timeUpdate', callback: Callback\<number>): void ...@@ -554,6 +574,8 @@ on(type: 'timeUpdate', callback: Callback\<number>): void
开始订阅音频播放[seek()](#seek)时间更新事件。 开始订阅音频播放[seek()](#seek)时间更新事件。
**系统能力：** SystemCapability.Multimedia.Media.AudioPlayer
**参数：** **参数：**
| 参数名 | 类型 | 必填 | 说明 | | 参数名 | 类型 | 必填 | 说明 |
...@@ -580,6 +602,8 @@ on(type: 'error', callback: ErrorCallback): void ...@@ -580,6 +602,8 @@ on(type: 'error', callback: ErrorCallback): void
开始订阅音频播放错误事件。 开始订阅音频播放错误事件。
**系统能力：** SystemCapability.Multimedia.Media.AudioPlayer
**参数：** **参数：**
| 参数名 | 类型 | 必填 | 说明 | | 参数名 | 类型 | 必填 | 说明 |
...@@ -602,13 +626,13 @@ audioPlayer.setVolume(3); //设置volume为无效值，触发'error'事件 ...@@ -602,13 +626,13 @@ audioPlayer.setVolume(3); //设置volume为无效值，触发'error'事件
音频播放的状态机。可通过state属性获取当前状态。 音频播放的状态机。可通过state属性获取当前状态。
| 名称 | 类型 | 描述 | | 名称 | 类型 | 描述 |
| ------------------ | ------ | -------------- | | ------------------ | ------ | ------------------------------------------------------------ |
| idle | string | 音频播放空闲。 | | idle | string | 音频播放空闲。<br/>**系统能力：** SystemCapability.Multimedia.Media.AudioPlayer |
| playing | string | 音频正在播放。 | | playing | string | 音频正在播放。<br/>**系统能力：** SystemCapability.Multimedia.Media.AudioPlayer |
| paused | string | 音频暂停播放。 | | paused | string | 音频暂停播放。<br/>**系统能力：** SystemCapability.Multimedia.Media.AudioPlayer |
| stopped | string | 音频播放停止。 | | stopped | string | 音频播放停止。<br/>**系统能力：** SystemCapability.Multimedia.Media.AudioPlayer |
| error<sup>8+</sup> | string | 错误状态。 | | error<sup>8+</sup> | string | 错误状态。<br/>**系统能力：** SystemCapability.Multimedia.Media.AudioPlayer |
## VideoPlayer<sup>8+</sup> ## VideoPlayer<sup>8+</sup>
...@@ -620,13 +644,13 @@ audioPlayer.setVolume(3); //设置volume为无效值，触发'error'事件 ...@@ -620,13 +644,13 @@ audioPlayer.setVolume(3); //设置volume为无效值，触发'error'事件
| 名称 | 类型 | 可读 | 可写 | 说明 | | 名称 | 类型 | 可读 | 可写 | 说明 |
| ----------- | ---------------------------------- | ---- | ---- | ------------------------------------------------------------ | | ----------- | ---------------------------------- | ---- | ---- | ------------------------------------------------------------ |
| url | string | 是 | 是 | 视频媒体URL，支持当前主流的视频格式(mp4、mpeg-ts、webm、mkv)。<br>**支持路径示例**：<br>1. fd类型播放：fd://xxx<br>![zh-cn_image_0000001164217678](figures/zh-cn_image_url.png)<br>**注意事项**：<br>媒体素材需至少赋予读权限后，才可正常播放 | | url | string | 是 | 是 | 视频媒体URL，支持当前主流的视频格式(mp4、mpeg-ts、webm、mkv)。<br>**支持路径示例**：<br>1. fd类型播放：fd://xxx<br>![zh-cn_image_0000001164217678](figures/zh-cn_image_url.png)<br>**注意事项**：<br>媒体素材需至少赋予读权限后，才可正常播放。<br/>**系统能力：** SystemCapability.Multimedia.Media.VideoPlayer |
| loop | boolean | 是 | 是 | 视频循环播放属性，设置为'true'表示循环播放。 | | loop | boolean | 是 | 是 | 视频循环播放属性，设置为'true'表示循环播放。<br/>**系统能力：** SystemCapability.Multimedia.Media.VideoPlayer |
| currentTime | number | 是 | 否 | 视频的当前播放位置。 | | currentTime | number | 是 | 否 | 视频的当前播放位置。<br/>**系统能力：** SystemCapability.Multimedia.Media.VideoPlayer |
| duration | number | 是 | 否 | 视频时长，返回-1表示直播模式 | | duration | number | 是 | 否 | 视频时长，返回-1表示直播模式。<br/>**系统能力：** SystemCapability.Multimedia.Media.VideoPlayer |
| state | [VideoPlayState](#videoplaystate8) | 是 | 否 | 视频播放的状态。 | | state | [VideoPlayState](#videoplaystate8) | 是 | 否 | 视频播放的状态。<br/>**系统能力：** SystemCapability.Multimedia.Media.VideoPlayer |
| width | number | 是 | 否 | 视频宽。 | | width | number | 是 | 否 | 视频宽。<br/>**系统能力：** SystemCapability.Multimedia.Media.VideoPlayer |
| height | number | 是 | 否 | 视频高。 | | height | number | 是 | 否 | 视频高。<br/>**系统能力：** SystemCapability.Multimedia.Media.VideoPlayer |
### setDisplaySurface<sup>8+</sup> ### setDisplaySurface<sup>8+</sup>
...@@ -634,6 +658,8 @@ setDisplaySurface(surfaceId: string, callback: AsyncCallback\<void>): void ...@@ -634,6 +658,8 @@ setDisplaySurface(surfaceId: string, callback: AsyncCallback\<void>): void
通过回调方式设置SurfaceId。 通过回调方式设置SurfaceId。
**系统能力：** SystemCapability.Multimedia.Media.VideoPlayer
**参数：** **参数：**
| 参数名 | 类型 | 必填 | 说明 | | 参数名 | 类型 | 必填 | 说明 |
...@@ -659,6 +685,8 @@ setDisplaySurface(surfaceId: string): Promise\<void> ...@@ -659,6 +685,8 @@ setDisplaySurface(surfaceId: string): Promise\<void>
通过Promise方式设置SurfaceId。 通过Promise方式设置SurfaceId。
**系统能力：** SystemCapability.Multimedia.Media.VideoPlayer
**参数：** **参数：**
| 参数名 | 类型 | 必填 | 说明 | | 参数名 | 类型 | 必填 | 说明 |
...@@ -691,6 +719,8 @@ prepare(callback: AsyncCallback\<void>): void ...@@ -691,6 +719,8 @@ prepare(callback: AsyncCallback\<void>): void
通过回调方式准备播放视频。 通过回调方式准备播放视频。
**系统能力：** SystemCapability.Multimedia.Media.VideoPlayer
**参数：** **参数：**
| 参数名 | 类型 | 必填 | 说明 | | 参数名 | 类型 | 必填 | 说明 |
...@@ -715,6 +745,8 @@ prepare(): Promise\<void> ...@@ -715,6 +745,8 @@ prepare(): Promise\<void>
通过Promise方式准备播放视频。 通过Promise方式准备播放视频。
**系统能力：** SystemCapability.Multimedia.Media.VideoPlayer
**返回值：** **返回值：**
| 类型 | 说明 | | 类型 | 说明 |
...@@ -741,6 +773,8 @@ play(callback: AsyncCallback\<void>): void; ...@@ -741,6 +773,8 @@ play(callback: AsyncCallback\<void>): void;
通过回调方式开始播放视频。 通过回调方式开始播放视频。
**系统能力：** SystemCapability.Multimedia.Media.VideoPlayer
**参数：** **参数：**
| 参数名 | 类型 | 必填 | 说明 | | 参数名 | 类型 | 必填 | 说明 |
...@@ -765,6 +799,8 @@ play(): Promise\<void>; ...@@ -765,6 +799,8 @@ play(): Promise\<void>;
通过Promise方式开始播放视频。 通过Promise方式开始播放视频。
**系统能力：** SystemCapability.Multimedia.Media.VideoPlayer
**返回值：** **返回值：**
| 类型 | 说明 | | 类型 | 说明 |
...@@ -791,6 +827,8 @@ pause(callback: AsyncCallback\<void>): void ...@@ -791,6 +827,8 @@ pause(callback: AsyncCallback\<void>): void
通过回调方式暂停播放视频。 通过回调方式暂停播放视频。
**系统能力：** SystemCapability.Multimedia.Media.VideoPlayer
**参数：** **参数：**
| 参数名 | 类型 | 必填 | 说明 | | 参数名 | 类型 | 必填 | 说明 |
...@@ -815,6 +853,8 @@ pause(): Promise\<void> ...@@ -815,6 +853,8 @@ pause(): Promise\<void>
通过Promise方式暂停播放视频。 通过Promise方式暂停播放视频。
**系统能力：** SystemCapability.Multimedia.Media.VideoPlayer
**返回值：** **返回值：**
| 类型 | 说明 | | 类型 | 说明 |
...@@ -841,6 +881,8 @@ stop(callback: AsyncCallback\<void>): void ...@@ -841,6 +881,8 @@ stop(callback: AsyncCallback\<void>): void
通过回调方式停止播放视频。 通过回调方式停止播放视频。
**系统能力：** SystemCapability.Multimedia.Media.VideoPlayer
**参数：** **参数：**
| 参数名 | 类型 | 必填 | 说明 | | 参数名 | 类型 | 必填 | 说明 |
...@@ -865,6 +907,8 @@ stop(): Promise\<void> ...@@ -865,6 +907,8 @@ stop(): Promise\<void>
通过Promise方式停止播放视频。 通过Promise方式停止播放视频。
**系统能力：** SystemCapability.Multimedia.Media.VideoPlayer
**返回值：** **返回值：**
| 类型 | 说明 | | 类型 | 说明 |
...@@ -891,6 +935,8 @@ reset(callback: AsyncCallback\<void>): void ...@@ -891,6 +935,8 @@ reset(callback: AsyncCallback\<void>): void
通过回调方式切换播放视频。 通过回调方式切换播放视频。
**系统能力：** SystemCapability.Multimedia.Media.VideoPlayer
**参数：** **参数：**
| 参数名 | 类型 | 必填 | 说明 | | 参数名 | 类型 | 必填 | 说明 |
...@@ -915,6 +961,8 @@ reset(): Promise\<void> ...@@ -915,6 +961,8 @@ reset(): Promise\<void>
通过Promise方式切换播放视频。 通过Promise方式切换播放视频。
**系统能力：** SystemCapability.Multimedia.Media.VideoPlayer
**返回值：** **返回值：**
| 类型 | 说明 | | 类型 | 说明 |
...@@ -941,6 +989,8 @@ seek(timeMs: number, callback: AsyncCallback\<number>): void ...@@ -941,6 +989,8 @@ seek(timeMs: number, callback: AsyncCallback\<number>): void
通过回调方式跳转到指定播放位置，默认跳转到指定时间点的下一个关键帧。 通过回调方式跳转到指定播放位置，默认跳转到指定时间点的下一个关键帧。
**系统能力：** SystemCapability.Multimedia.Media.VideoPlayer
**参数：** **参数：**
| 参数名 | 类型 | 必填 | 说明 | | 参数名 | 类型 | 必填 | 说明 |
...@@ -966,6 +1016,8 @@ seek(timeMs: number, mode:SeekMode, callback: AsyncCallback\<number>): void ...@@ -966,6 +1016,8 @@ seek(timeMs: number, mode:SeekMode, callback: AsyncCallback\<number>): void
通过回调方式跳转到指定播放位置。 通过回调方式跳转到指定播放位置。
**系统能力：** SystemCapability.Multimedia.Media.VideoPlayer
**参数：** **参数：**
| 参数名 | 类型 | 必填 | 说明 | | 参数名 | 类型 | 必填 | 说明 |
...@@ -992,6 +1044,8 @@ seek(timeMs: number, mode?:SeekMode): Promise\<number> ...@@ -992,6 +1044,8 @@ seek(timeMs: number, mode?:SeekMode): Promise\<number>
通过Promise方式跳转到指定播放位置，如果没有设置mode则跳转到指定时间点的下一个关键帧。 通过Promise方式跳转到指定播放位置，如果没有设置mode则跳转到指定时间点的下一个关键帧。
**系统能力：** SystemCapability.Multimedia.Media.VideoPlayer
**参数：** **参数：**
| 参数名 | 类型 | 必填 | 说明 | | 参数名 | 类型 | 必填 | 说明 |
...@@ -1029,6 +1083,8 @@ setVolume(vol: number, callback: AsyncCallback\<void>): void ...@@ -1029,6 +1083,8 @@ setVolume(vol: number, callback: AsyncCallback\<void>): void
通过回调方式设置音量。 通过回调方式设置音量。
**系统能力：** SystemCapability.Multimedia.Media.VideoPlayer
**参数：** **参数：**
| 参数名 | 类型 | 必填 | 说明 | | 参数名 | 类型 | 必填 | 说明 |
...@@ -1054,6 +1110,8 @@ setVolume(vol: number): Promise\<void> ...@@ -1054,6 +1110,8 @@ setVolume(vol: number): Promise\<void>
通过Promise方式设置音量。 通过Promise方式设置音量。
**系统能力：** SystemCapability.Multimedia.Media.VideoPlayer
**参数：** **参数：**
| 参数名 | 类型 | 必填 | 说明 | | 参数名 | 类型 | 必填 | 说明 |
...@@ -1086,6 +1144,8 @@ release(callback: AsyncCallback\<void>): void ...@@ -1086,6 +1144,8 @@ release(callback: AsyncCallback\<void>): void
通过回调方式释放视频资源。 通过回调方式释放视频资源。
**系统能力：** SystemCapability.Multimedia.Media.VideoPlayer
**参数：** **参数：**
| 参数名 | 类型 | 必填 | 说明 | | 参数名 | 类型 | 必填 | 说明 |
...@@ -1110,6 +1170,8 @@ release(): Promise\<void> ...@@ -1110,6 +1170,8 @@ release(): Promise\<void>
通过Promise方式释放视频资源。 通过Promise方式释放视频资源。
**系统能力：** SystemCapability.Multimedia.Media.VideoPlayer
**返回值：** **返回值：**
| 类型 | 说明 | | 类型 | 说明 |
...@@ -1136,6 +1198,8 @@ getTrackDescription(callback: AsyncCallback<Array<[MediaDescription](#mediadescr ...@@ -1136,6 +1198,8 @@ getTrackDescription(callback: AsyncCallback<Array<[MediaDescription](#mediadescr
通过回调方式获取视频轨道信息。 通过回调方式获取视频轨道信息。
**系统能力：** SystemCapability.Multimedia.Media.VideoPlayer
**参数：** **参数：**
| 参数名 | 类型 | 必填 | 说明 | | 参数名 | 类型 | 必填 | 说明 |
...@@ -1170,6 +1234,8 @@ getTrackDescription(): Promise<Array<[MediaDescription](#mediadescription8>>)>> ...@@ -1170,6 +1234,8 @@ getTrackDescription(): Promise<Array<[MediaDescription](#mediadescription8>>)>>
通过Promise方式获取视频轨道信息。 通过Promise方式获取视频轨道信息。
**系统能力：** SystemCapability.Multimedia.Media.VideoPlayer
**返回值：** **返回值：**
| 类型 | 说明 | | 类型 | 说明 |
...@@ -1212,6 +1278,8 @@ setSpeed(speed:number, callback: AsyncCallback\<number>): void ...@@ -1212,6 +1278,8 @@ setSpeed(speed:number, callback: AsyncCallback\<number>): void
通过回调方式设置播放速度。 通过回调方式设置播放速度。
**系统能力：** SystemCapability.Multimedia.Media.VideoPlayer
**参数：** **参数：**
| 参数名 | 类型 | 必填 | 说明 | | 参数名 | 类型 | 必填 | 说明 |
...@@ -1237,6 +1305,8 @@ setSpeed(speed:number): Promise\<number> ...@@ -1237,6 +1305,8 @@ setSpeed(speed:number): Promise\<number>
通过Promise方式设置播放速度。 通过Promise方式设置播放速度。
**系统能力：** SystemCapability.Multimedia.Media.VideoPlayer
**参数：** **参数：**
| 参数名 | 类型 | 必填 | 说明 | | 参数名 | 类型 | 必填 | 说明 |
...@@ -1263,6 +1333,8 @@ on(type: 'playbackCompleted', callback: Callback\<void>): void ...@@ -1263,6 +1333,8 @@ on(type: 'playbackCompleted', callback: Callback\<void>): void
开始监听视频播放完成事件。 开始监听视频播放完成事件。
**系统能力：** SystemCapability.Multimedia.Media.VideoPlayer
**参数：** **参数：**
| 参数名 | 类型 | 必填 | 说明 | | 参数名 | 类型 | 必填 | 说明 |
...@@ -1284,6 +1356,8 @@ on(type: 'bufferingUpdate', callback: (infoType: BufferingInfoType, value: numbe ...@@ -1284,6 +1356,8 @@ on(type: 'bufferingUpdate', callback: (infoType: BufferingInfoType, value: numbe
开始监听视频缓存更新事件。 开始监听视频缓存更新事件。
**系统能力：** SystemCapability.Multimedia.Media.VideoPlayer
**参数：** **参数：**
| 参数名 | 类型 | 必填 | 说明 | | 参数名 | 类型 | 必填 | 说明 |
...@@ -1306,6 +1380,8 @@ on(type: 'startRenderFrame', callback: Callback\<void>): void ...@@ -1306,6 +1380,8 @@ on(type: 'startRenderFrame', callback: Callback\<void>): void
开始监听视频播放首帧送显上报事件。 开始监听视频播放首帧送显上报事件。
**系统能力：** SystemCapability.Multimedia.Media.VideoPlayer
**参数：** **参数：**
| 参数名 | 类型 | 必填 | 说明 | | 参数名 | 类型 | 必填 | 说明 |
...@@ -1327,6 +1403,8 @@ on(type: 'videoSizeChanged', callback: (width: number, height: number) => void): ...@@ -1327,6 +1403,8 @@ on(type: 'videoSizeChanged', callback: (width: number, height: number) => void):
开始监听视频播放宽高变化事件。 开始监听视频播放宽高变化事件。
**系统能力：** SystemCapability.Multimedia.Media.VideoPlayer
**参数：** **参数：**
| 参数名 | 类型 | 必填 | 说明 | | 参数名 | 类型 | 必填 | 说明 |
...@@ -1349,6 +1427,8 @@ on(type: 'error', callback: ErrorCallback): void ...@@ -1349,6 +1427,8 @@ on(type: 'error', callback: ErrorCallback): void
开始监听视频播放错误事件。 开始监听视频播放错误事件。
**系统能力：** SystemCapability.Multimedia.Media.VideoPlayer
**参数：** **参数：**
| 参数名 | 类型 | 必填 | 说明 | | 参数名 | 类型 | 必填 | 说明 |
...@@ -1371,14 +1451,14 @@ videoPlayer.setVolume(3); //设置volume为无效值，触发'error'事件 ...@@ -1371,14 +1451,14 @@ videoPlayer.setVolume(3); //设置volume为无效值，触发'error'事件
视频播放的状态机，可通过state属性获取当前状态。 视频播放的状态机，可通过state属性获取当前状态。
| 名称 | 类型 | 描述 | | 名称 | 类型 | 描述 |
| -------- | ------ | -------------- | | -------- | ------ | ------------------------------------------------------------ |
| idle | string | 视频播放空闲。 | | idle | string | 视频播放空闲。<br/>**系统能力：** SystemCapability.Multimedia.Media.VideoPlayer |
| prepared | string | 视频播放准备。 | | prepared | string | 视频播放准备。<br/>**系统能力：** SystemCapability.Multimedia.Media.VideoPlayer |
| playing | string | 视频正在播放。 | | playing | string | 视频正在播放。<br/>**系统能力：** SystemCapability.Multimedia.Media.VideoPlayer |
| paused | string | 视频暂停播放。 | | paused | string | 视频暂停播放。<br/>**系统能力：** SystemCapability.Multimedia.Media.VideoPlayer |
| stopped | string | 视频播放停止。 | | stopped | string | 视频播放停止。<br/>**系统能力：** SystemCapability.Multimedia.Media.VideoPlayer |
| error | string | 错误状态。 | | error | string | 错误状态。<br/>**系统能力：** SystemCapability.Multimedia.Media.VideoPlayer |
## SeekMode<sup>8+</sup> ## SeekMode<sup>8+</sup>
...@@ -1386,22 +1466,22 @@ videoPlayer.setVolume(3); //设置volume为无效值，触发'error'事件 ...@@ -1386,22 +1466,22 @@ videoPlayer.setVolume(3); //设置volume为无效值，触发'error'事件
| 名称 | 值 | 描述 | | 名称 | 值 | 描述 |
| ----------------- | ---- | ------------------------------------------------------------ | | ----------------- | ---- | ------------------------------------------------------------ |
| SEEK_NEXT_SYNC | 0 | 表示跳转到指定时间点的下一个关键帧，建议向后快进的时候用这个枚举值 | | SEEK_NEXT_SYNC | 0 | 表示跳转到指定时间点的下一个关键帧，建议向后快进的时候用这个枚举值。<br/>**系统能力：** SystemCapability.Multimedia.Media.VideoPlayer |
| SEEK_PREV_SYNC | 1 | 表示跳转到指定时间点的上一个关键帧，建议向前快进的时候用这个枚举值 | | SEEK_PREV_SYNC | 1 | 表示跳转到指定时间点的上一个关键帧，建议向前快进的时候用这个枚举值。<br/>**系统能力：** SystemCapability.Multimedia.Media.VideoPlayer |
| SEEK_CLOSEST_SYNC | 2 | 表示跳转到指定时间点最近的关键帧。 | | SEEK_CLOSEST_SYNC | 2 | 表示跳转到指定时间点最近的关键帧。<br/>**系统能力：** SystemCapability.Multimedia.Media.VideoPlayer |
| SEEK_CLOSEST | 3 | 表示精确跳转到指定时间点。 | | SEEK_CLOSEST | 3 | 表示精确跳转到指定时间点。<br/>**系统能力：** SystemCapability.Multimedia.Media.VideoPlayer |
## PlaybackSpeed<sup>8+</sup> ## PlaybackSpeed<sup>8+</sup>
视频播放的倍速枚举，可通过setSpeed方法作为参数传递下去。 视频播放的倍速枚举，可通过setSpeed方法作为参数传递下去。
| 名称 | 值 | 描述 | | 名称 | 值 | 描述 |
| -------------------- | ---- | ------------------------------ | | -------------------- | ---- | ------------------------------------------------------------ |
| SPEED_FORWARD_0_75_X | 0 | 表示视频播放正常播速的0.75倍。 | | SPEED_FORWARD_0_75_X | 0 | 表示视频播放正常播速的0.75倍。<br/>**系统能力：** SystemCapability.Multimedia.Media.VideoPlayer |
| SPEED_FORWARD_1_00_X | 1 | 表示视频播放正常播速。 | | SPEED_FORWARD_1_00_X | 1 | 表示视频播放正常播速。<br/>**系统能力：** SystemCapability.Multimedia.Media.VideoPlayer |
| SPEED_FORWARD_1_25_X | 2 | 表示视频播放正常播速的1.25倍。 | | SPEED_FORWARD_1_25_X | 2 | 表示视频播放正常播速的1.25倍。<br/>**系统能力：** SystemCapability.Multimedia.Media.VideoPlayer |
| SPEED_FORWARD_1_75_X | 3 | 表示视频播放正常播速的1.75倍。 | | SPEED_FORWARD_1_75_X | 3 | 表示视频播放正常播速的1.75倍。<br/>**系统能力：** SystemCapability.Multimedia.Media.VideoPlayer |
| SPEED_FORWARD_2_00_X | 4 | 表示视频播放正常播速的2.00倍。 | | SPEED_FORWARD_2_00_X | 4 | 表示视频播放正常播速的2.00倍。<br/>**系统能力：** SystemCapability.Multimedia.Media.VideoPlayer |
## MediaDescription<sup>8+</sup> ## MediaDescription<sup>8+</sup>
...@@ -1411,8 +1491,8 @@ videoPlayer.setVolume(3); //设置volume为无效值，触发'error'事件 ...@@ -1411,8 +1491,8 @@ videoPlayer.setVolume(3); //设置volume为无效值，触发'error'事件
| 名称 | 类型 | 说明 | | 名称 | 类型 | 说明 |
| ----- | ------ | ------------------------------------------------------------ | | ----- | ------ | ------------------------------------------------------------ |
| key | string | 通过key值获取对应的value。key值具体可见[MediaDescriptionKey](#mediadescriptionkey8)。 | | key | string | 通过key值获取对应的value。key值具体可见[MediaDescriptionKey](#mediadescriptionkey8)。<br/>**系统能力：** SystemCapability.Multimedia.Media.Core |
| value | any | 对应key值得value。其类型可为任意类型，具体key对应value的类型可参考[MediaDescriptionKey](#mediadescriptionkey8)的描述信息。 | | value | any | 对应key值得value。其类型可为任意类型，具体key对应value的类型可参考[MediaDescriptionKey](#mediadescriptionkey8)的描述信息。<br/>**系统能力：** SystemCapability.Multimedia.Media.Core |
**示例：** **示例：**
...@@ -1446,6 +1526,10 @@ prepare(config: AudioRecorderConfig): void ...@@ -1446,6 +1526,10 @@ prepare(config: AudioRecorderConfig): void
录音准备。 录音准备。
**需要权限：** ohos.permission.MICROPHONE
**系统能力：** SystemCapability.Multimedia.Media.AudioRecorder
**参数：** **参数：**
| 参数名 | 类型 | 必填 | 说明 | | 参数名 | 类型 | 必填 | 说明 |
...@@ -1477,6 +1561,8 @@ start(): void ...@@ -1477,6 +1561,8 @@ start(): void
开始录制，需在[prepare](#audiorecorder_on)事件成功触发后，才能调用start方法。 开始录制，需在[prepare](#audiorecorder_on)事件成功触发后，才能调用start方法。
**系统能力：** SystemCapability.Multimedia.Media.AudioRecorder
**示例：** **示例：**
```js ```js
...@@ -1492,6 +1578,8 @@ pause():void ...@@ -1492,6 +1578,8 @@ pause():void
暂停录制，需要在[start](#audiorecorder_on)事件成功触发后，才能调用pause方法。 暂停录制，需要在[start](#audiorecorder_on)事件成功触发后，才能调用pause方法。
**系统能力：** SystemCapability.Multimedia.Media.AudioRecorder
**示例：** **示例：**
```js ```js
...@@ -1507,6 +1595,8 @@ resume():void ...@@ -1507,6 +1595,8 @@ resume():void
暂停录制，需要在[pause](#audiorecorder_on)事件成功触发后，才能调用resume方法。 暂停录制，需要在[pause](#audiorecorder_on)事件成功触发后，才能调用resume方法。
**系统能力：** SystemCapability.Multimedia.Media.AudioRecorder
**示例：** **示例：**
```js ```js
...@@ -1522,6 +1612,8 @@ stop(): void ...@@ -1522,6 +1612,8 @@ stop(): void
停止录音。 停止录音。
**系统能力：** SystemCapability.Multimedia.Media.AudioRecorder
**示例：** **示例：**
```js ```js
...@@ -1537,6 +1629,8 @@ release(): void ...@@ -1537,6 +1629,8 @@ release(): void
释放录音资源。 释放录音资源。
**系统能力：** SystemCapability.Multimedia.Media.AudioRecorder
**示例：** **示例：**
```js ```js
...@@ -1555,6 +1649,8 @@ reset(): void ...@@ -1555,6 +1649,8 @@ reset(): void
进行重置录音之前，需要先调用[stop()](#audiorecorder_stop)停止录音。重置录音之后，需要调用[prepare()](#audiorecorder_prepare)设置录音参数项，才能再次进行录音。 进行重置录音之前，需要先调用[stop()](#audiorecorder_stop)停止录音。重置录音之后，需要调用[prepare()](#audiorecorder_prepare)设置录音参数项，才能再次进行录音。
**系统能力：** SystemCapability.Multimedia.Media.AudioRecorder
**示例：** **示例：**
```js ```js
...@@ -1570,6 +1666,8 @@ on(type: 'prepare' | 'start' | 'pause' | 'resume' | 'stop' | 'release' | 'reset' ...@@ -1570,6 +1666,8 @@ on(type: 'prepare' | 'start' | 'pause' | 'resume' | 'stop' | 'release' | 'reset'
开始订阅音频录制事件。 开始订阅音频录制事件。
**系统能力：** SystemCapability.Multimedia.Media.AudioRecorder
**参数：** **参数：**
| 参数名 | 类型 | 必填 | 说明 | | 参数名 | 类型 | 必填 | 说明 |
...@@ -1626,6 +1724,8 @@ on(type: 'error', callback: ErrorCallback): void ...@@ -1626,6 +1724,8 @@ on(type: 'error', callback: ErrorCallback): void
开始订阅音频录制错误事件。 开始订阅音频录制错误事件。
**系统能力：** SystemCapability.Multimedia.Media.AudioRecorder
**参数：** **参数：**
| 参数名 | 类型 | 必填 | 说明 | | 参数名 | 类型 | 必填 | 说明 |
...@@ -1650,13 +1750,13 @@ audioRecorder.prepare(); // prepare不设置参数，触发'error' ...@@ -1650,13 +1750,13 @@ audioRecorder.prepare(); // prepare不设置参数，触发'error'
| 名称 | 参数类型 | 必填 | 说明 | | 名称 | 参数类型 | 必填 | 说明 |
| --------------------- | --------------------------------------- | ---- | ------------------------------------------------------------ | | --------------------- | --------------------------------------- | ---- | ------------------------------------------------------------ |
| audioEncoder | [AudioEncoder](#audioencoder) | 否 | 音频编码格式，默认设置为AAC_LC。 | | audioEncoder | [AudioEncoder](#audioencoder) | 否 | 音频编码格式，默认设置为AAC_LC。<br/>**系统能力：** SystemCapability.Multimedia.Media.AudioRecorder |
| audioEncodeBitRate | number | 否 | 音频编码比特率，默认值为48000。 | | audioEncodeBitRate | number | 否 | 音频编码比特率，默认值为48000。<br/>**系统能力：** SystemCapability.Multimedia.Media.AudioRecorder |
| audioSampleRate | number | 否 | 音频采集采样率，默认值为48000。 | | audioSampleRate | number | 否 | 音频采集采样率，默认值为48000。<br/>**系统能力：** SystemCapability.Multimedia.Media.AudioRecorder |
| numberOfChannels | number | 否 | 音频采集声道数，默认值为2。 | | numberOfChannels | number | 否 | 音频采集声道数，默认值为2。<br/>**系统能力：** SystemCapability.Multimedia.Media.AudioRecorder |
| format | [AudioOutputFormat](#audiooutputformat) | 否 | 音量输出封装格式，默认设置为MPEG_4。 | | format | [AudioOutputFormat](#audiooutputformat) | 否 | 音量输出封装格式，默认设置为MPEG_4。<br/>**系统能力：** SystemCapability.Multimedia.Media.AudioRecorder |
| location<sup>8+</sup> | [Location](#location8) | 否 | 音频采集的地理位置。 | | location<sup>8+</sup> | [Location](#location8) | 否 | 音频采集的地理位置。<br/>**系统能力：** SystemCapability.Multimedia.Media.AudioRecorder |
| uri | string | 是 | 视频输出URI：fd://xx&nbsp;(fd&nbsp;number)<br/>![zh-cn_image_0000001164217678](figures/zh-cn_image_url.png) <br/>文件需要由调用者创建，并赋予适当的权限。 | | uri | string | 是 | 视频输出URI：fd://xx&nbsp;(fd&nbsp;number)<br/>![zh-cn_image_0000001164217678](figures/zh-cn_image_url.png) <br/>文件需要由调用者创建，并赋予适当的权限。<br/>**系统能力：** SystemCapability.Multimedia.Media.AudioRecorder |
## AudioEncoder ## AudioEncoder
...@@ -1665,11 +1765,11 @@ audioRecorder.prepare(); // prepare不设置参数，触发'error' ...@@ -1665,11 +1765,11 @@ audioRecorder.prepare(); // prepare不设置参数，触发'error'
| 名称 | 默认值 | 说明 | | 名称 | 默认值 | 说明 |
| ------- | ------ | ------------------------------------------------------------ | | ------- | ------ | ------------------------------------------------------------ |
| DEFAULT | 0 | Default audio encoding format is AMR_NB。本接口在OpenHarmony 3.1 Release版本仅为接口定义，暂不支持使用。接口将在OpenHarmony 3.1 MR版本中提供使用支持。<br/>**系统能力：**SystemCapability.Multimedia.Media.AudioRecorder | | DEFAULT | 0 | Default audio encoding format is AMR_NB。本接口在OpenHarmony 3.1 Release版本仅为接口定义，暂不支持使用。接口将在OpenHarmony 3.1 MR版本中提供使用支持。<br/>**系统能力：** SystemCapability.Multimedia.Media.AudioRecorder |
| AMR_NB | 1 | AMR-NB(Adaptive Multi Rate-Narrow Band Speech Codec) 编码格式。本接口在OpenHarmony 3.1 Release版本仅为接口定义，暂不支持使用。接口将在OpenHarmony 3.1 MR版本中提供使用支持。<br/>**系统能力：**SystemCapability.Multimedia.Media.AudioRecorder | | AMR_NB | 1 | AMR-NB(Adaptive Multi Rate-Narrow Band Speech Codec) 编码格式。本接口在OpenHarmony 3.1 Release版本仅为接口定义，暂不支持使用。接口将在OpenHarmony 3.1 MR版本中提供使用支持。<br/>**系统能力：** SystemCapability.Multimedia.Media.AudioRecorder |
| AMR_WB | 2 | AMR-WB(Adaptive Multi Rate-Wide Band Speech Codec) 编码格式。本接口在OpenHarmony 3.1 Release版本仅为接口定义，暂不支持使用。接口将在OpenHarmony 3.1 MR版本中提供使用支持。<br/>**系统能力：**SystemCapability.Multimedia.Media.AudioRecorder | | AMR_WB | 2 | AMR-WB(Adaptive Multi Rate-Wide Band Speech Codec) 编码格式。本接口在OpenHarmony 3.1 Release版本仅为接口定义，暂不支持使用。接口将在OpenHarmony 3.1 MR版本中提供使用支持。<br/>**系统能力：** SystemCapability.Multimedia.Media.AudioRecorder |
| AAC_LC | 3 | AAC-LC（Advanced&nbsp;Audio&nbsp;Coding&nbsp;Low&nbsp;Complexity）编码格式。<br/>**系统能力：**SystemCapability.Multimedia.Media.AudioRecorder | | AAC_LC | 3 | AAC-LC（Advanced&nbsp;Audio&nbsp;Coding&nbsp;Low&nbsp;Complexity）编码格式。<br/>**系统能力：** SystemCapability.Multimedia.Media.AudioRecorder |
| HE_AAC | 4 | HE_AAC（High-Efficiency Advanced&nbsp;Audio&nbsp;Coding）编码格式。本接口在OpenHarmony 3.1 Release版本仅为接口定义，暂不支持使用。接口将在OpenHarmony 3.1 MR版本中提供使用支持。<br/>**系统能力：**SystemCapability.Multimedia.Media.AudioRecorder | | HE_AAC | 4 | HE_AAC（High-Efficiency Advanced&nbsp;Audio&nbsp;Coding）编码格式。本接口在OpenHarmony 3.1 Release版本仅为接口定义，暂不支持使用。接口将在OpenHarmony 3.1 MR版本中提供使用支持。<br/>**系统能力：** SystemCapability.Multimedia.Media.AudioRecorder |
## AudioOutputFormat ## AudioOutputFormat
...@@ -1678,11 +1778,11 @@ audioRecorder.prepare(); // prepare不设置参数，触发'error' ...@@ -1678,11 +1778,11 @@ audioRecorder.prepare(); // prepare不设置参数，触发'error'
| 名称 | 默认值 | 说明 | | 名称 | 默认值 | 说明 |
| -------- | ------ | ------------------------------------------------------------ | | -------- | ------ | ------------------------------------------------------------ |
| DEFAULT | 0 | 默认封装格式为MPEG-4。本接口在OpenHarmony 3.1 Release版本仅为接口定义，暂不支持使用。接口将在OpenHarmony 3.1 MR版本中提供使用支持。<br/>**系统能力：**SystemCapability.Multimedia.Media.AudioRecorder | | DEFAULT | 0 | 默认封装格式为MPEG-4。本接口在OpenHarmony 3.1 Release版本仅为接口定义，暂不支持使用。接口将在OpenHarmony 3.1 MR版本中提供使用支持。<br/>**系统能力：** SystemCapability.Multimedia.Media.AudioRecorder |
| MPEG_4 | 2 | 封装为MPEG-4格式。<br/>**系统能力：**SystemCapability.Multimedia.Media.AudioRecorder | | MPEG_4 | 2 | 封装为MPEG-4格式。<br/>**系统能力：** SystemCapability.Multimedia.Media.AudioRecorder |
| AMR_NB | 3 | 封装为AMR_NB格式。本接口在OpenHarmony 3.1 Release版本仅为接口定义，暂不支持使用。接口将在OpenHarmony 3.1 MR版本中提供使用支持。<br/>**系统能力：**SystemCapability.Multimedia.Media.AudioRecorder | | AMR_NB | 3 | 封装为AMR_NB格式。本接口在OpenHarmony 3.1 Release版本仅为接口定义，暂不支持使用。接口将在OpenHarmony 3.1 MR版本中提供使用支持。<br/>**系统能力：** SystemCapability.Multimedia.Media.AudioRecorder |
| AMR_WB | 4 | 封装为AMR_WB格式。本接口在OpenHarmony 3.1 Release版本仅为接口定义，暂不支持使用。接口将在OpenHarmony 3.1 MR版本中提供使用支持。<br/>**系统能力：**SystemCapability.Multimedia.Media.AudioRecorder | | AMR_WB | 4 | 封装为AMR_WB格式。本接口在OpenHarmony 3.1 Release版本仅为接口定义，暂不支持使用。接口将在OpenHarmony 3.1 MR版本中提供使用支持。<br/>**系统能力：** SystemCapability.Multimedia.Media.AudioRecorder |
| AAC_ADTS | 6 | 封装为ADTS（Audio&nbsp;Data&nbsp;Transport&nbsp;Stream）格式，是AAC音频的传输流格式。<br/>**系统能力：**SystemCapability.Multimedia.Media.AudioRecorder | | AAC_ADTS | 6 | 封装为ADTS（Audio&nbsp;Data&nbsp;Transport&nbsp;Stream）格式，是AAC音频的传输流格式。<br/>**系统能力：** SystemCapability.Multimedia.Media.AudioRecorder |
## VideoRecorder<sup>8+</sup> ## VideoRecorder<sup>8+</sup>
...@@ -1702,6 +1802,10 @@ prepare(config: VideoRecorderConfig, callback: AsyncCallback\<void>): void; ...@@ -1702,6 +1802,10 @@ prepare(config: VideoRecorderConfig, callback: AsyncCallback\<void>): void;
异步方式进行视频录制的参数设置。通过注册回调函数获取返回值。 异步方式进行视频录制的参数设置。通过注册回调函数获取返回值。
**需要权限：** ohos.permission.MICROPHONE ohos.permission.CAMERA
**系统能力：** SystemCapability.Multimedia.Media.VideoRecorder
**参数：** **参数：**
| 参数名 | 类型 | 必填 | 说明 | | 参数名 | 类型 | 必填 | 说明 |
...@@ -1766,6 +1870,10 @@ prepare(config: VideoRecorderConfig): Promise\<void>; ...@@ -1766,6 +1870,10 @@ prepare(config: VideoRecorderConfig): Promise\<void>;
异步方式进行视频录制的参数设置。通过Promise获取返回值。 异步方式进行视频录制的参数设置。通过Promise获取返回值。
**需要权限：** ohos.permission.MICROPHONE ohos.permission.CAMERA
**系统能力：** SystemCapability.Multimedia.Media.VideoRecorder
**参数：** **参数：**
| 参数名 | 类型 | 必填 | 说明 | | 参数名 | 类型 | 必填 | 说明 |
...@@ -1837,6 +1945,8 @@ getInputSurface(callback: AsyncCallback\<string>): void; ...@@ -1837,6 +1945,8 @@ getInputSurface(callback: AsyncCallback\<string>): void;
只能在[prepare()](#videorecorder_prepare1)接口调用后调用。 只能在[prepare()](#videorecorder_prepare1)接口调用后调用。
**系统能力：** SystemCapability.Multimedia.Media.VideoRecorder
**参数：** **参数：**
| 参数名 | 类型 | 必填 | 说明 | | 参数名 | 类型 | 必填 | 说明 |
...@@ -1868,6 +1978,8 @@ getInputSurface(): Promise\<string>; ...@@ -1868,6 +1978,8 @@ getInputSurface(): Promise\<string>;
只能在[prepare()](#videorecorder_prepare1)接口调用后调用。 只能在[prepare()](#videorecorder_prepare1)接口调用后调用。
**系统能力：** SystemCapability.Multimedia.Media.VideoRecorder
**返回值：** **返回值：**
| 类型 | 说明 | | 类型 | 说明 |
...@@ -1897,6 +2009,8 @@ start(callback: AsyncCallback\<void>): void; ...@@ -1897,6 +2009,8 @@ start(callback: AsyncCallback\<void>): void;
在[prepare()](#videorecorder_prepare1)和[getInputSurface()](#getinputsurface)后调用，需要依赖数据源先给surface传递数据。 在[prepare()](#videorecorder_prepare1)和[getInputSurface()](#getinputsurface)后调用，需要依赖数据源先给surface传递数据。
**系统能力：** SystemCapability.Multimedia.Media.VideoRecorder
**参数：** **参数：**
| 参数名 | 类型 | 必填 | 说明 | | 参数名 | 类型 | 必填 | 说明 |
...@@ -1924,6 +2038,8 @@ start(): Promise\<void>; ...@@ -1924,6 +2038,8 @@ start(): Promise\<void>;
在[prepare()](#videorecorder_prepare1)和[getInputSurface()](#getinputsurface)后调用，需要依赖数据源先给surface传递数据。 在[prepare()](#videorecorder_prepare1)和[getInputSurface()](#getinputsurface)后调用，需要依赖数据源先给surface传递数据。
**系统能力：** SystemCapability.Multimedia.Media.VideoRecorder
**返回值：** **返回值：**
| 类型 | 说明 | | 类型 | 说明 |
...@@ -1951,6 +2067,8 @@ pause(callback: AsyncCallback\<void>): void; ...@@ -1951,6 +2067,8 @@ pause(callback: AsyncCallback\<void>): void;
在[start()](#videorecorder_start1)后调用。可以通过调用[resume()](#videorecorder_resume1)接口来恢复录制。 在[start()](#videorecorder_start1)后调用。可以通过调用[resume()](#videorecorder_resume1)接口来恢复录制。
**系统能力：** SystemCapability.Multimedia.Media.VideoRecorder
**参数：** **参数：**
| 参数名 | 类型 | 必填 | 说明 | | 参数名 | 类型 | 必填 | 说明 |
...@@ -1978,6 +2096,8 @@ pause(): Promise\<void>; ...@@ -1978,6 +2096,8 @@ pause(): Promise\<void>;
在[start()](#videorecorder_start1)后调用。可以通过调用[resume()](#videorecorder_resume1)接口来恢复录制。 在[start()](#videorecorder_start1)后调用。可以通过调用[resume()](#videorecorder_resume1)接口来恢复录制。
**系统能力：** SystemCapability.Multimedia.Media.VideoRecorder
**返回值：** **返回值：**
| 类型 | 说明 | | 类型 | 说明 |
...@@ -2003,6 +2123,8 @@ resume(callback: AsyncCallback\<void>): void; ...@@ -2003,6 +2123,8 @@ resume(callback: AsyncCallback\<void>): void;
异步方式恢复视频录制。通过注册回调函数获取返回值。 异步方式恢复视频录制。通过注册回调函数获取返回值。
**系统能力：** SystemCapability.Multimedia.Media.VideoRecorder
**参数：** **参数：**
| 参数名 | 类型 | 必填 | 说明 | | 参数名 | 类型 | 必填 | 说明 |
...@@ -2028,6 +2150,8 @@ resume(): Promise\<void>; ...@@ -2028,6 +2150,8 @@ resume(): Promise\<void>;
异步方式恢复视频录制。通过Promise获取返回值。 异步方式恢复视频录制。通过Promise获取返回值。
**系统能力：** SystemCapability.Multimedia.Media.VideoRecorder
**返回值：** **返回值：**
| 类型 | 说明 | | 类型 | 说明 |
...@@ -2055,6 +2179,8 @@ stop(callback: AsyncCallback\<void>): void; ...@@ -2055,6 +2179,8 @@ stop(callback: AsyncCallback\<void>): void;
需要重新调用[prepare()](#videorecorder_prepare1)和[getInputSurface()](#getinputsurface)接口才能重新录制。 需要重新调用[prepare()](#videorecorder_prepare1)和[getInputSurface()](#getinputsurface)接口才能重新录制。
**系统能力：** SystemCapability.Multimedia.Media.VideoRecorder
**参数：** **参数：**
| 参数名 | 类型 | 必填 | 说明 | | 参数名 | 类型 | 必填 | 说明 |
...@@ -2082,6 +2208,8 @@ stop(): Promise\<void>; ...@@ -2082,6 +2208,8 @@ stop(): Promise\<void>;
需要重新调用[prepare()](#videorecorder_prepare1)和[getInputSurface()](#getinputsurface)接口才能重新录制。 需要重新调用[prepare()](#videorecorder_prepare1)和[getInputSurface()](#getinputsurface)接口才能重新录制。
**系统能力：** SystemCapability.Multimedia.Media.VideoRecorder
**返回值：** **返回值：**
| 类型 | 说明 | | 类型 | 说明 |
...@@ -2107,6 +2235,8 @@ release(callback: AsyncCallback\<void>): void; ...@@ -2107,6 +2235,8 @@ release(callback: AsyncCallback\<void>): void;
异步方式释放视频录制资源。通过注册回调函数获取返回值。 异步方式释放视频录制资源。通过注册回调函数获取返回值。
**系统能力：** SystemCapability.Multimedia.Media.VideoRecorder
**参数：** **参数：**
| 参数名 | 类型 | 必填 | 说明 | | 参数名 | 类型 | 必填 | 说明 |
...@@ -2132,6 +2262,8 @@ release(): Promise\<void>; ...@@ -2132,6 +2262,8 @@ release(): Promise\<void>;
异步方式释放视频录制资源。通过Promise获取返回值。 异步方式释放视频录制资源。通过Promise获取返回值。
**系统能力：** SystemCapability.Multimedia.Media.VideoRecorder
**返回值：** **返回值：**
| 类型 | 说明 | | 类型 | 说明 |
...@@ -2159,6 +2291,8 @@ reset(callback: AsyncCallback\<void>): void; ...@@ -2159,6 +2291,8 @@ reset(callback: AsyncCallback\<void>): void;
需要重新调用[prepare()](#videorecorder_prepare1)和[getInputSurface()](#getinputsurface)接口才能重新录制。 需要重新调用[prepare()](#videorecorder_prepare1)和[getInputSurface()](#getinputsurface)接口才能重新录制。
**系统能力：** SystemCapability.Multimedia.Media.VideoRecorder
**参数：** **参数：**
| 参数名 | 类型 | 必填 | 说明 | | 参数名 | 类型 | 必填 | 说明 |
...@@ -2186,6 +2320,8 @@ reset(): Promise\<void>; ...@@ -2186,6 +2320,8 @@ reset(): Promise\<void>;
需要重新调用[prepare()](#videorecorder_prepare1)和[getInputSurface()](#getinputsurface)接口才能重新录制。 需要重新调用[prepare()](#videorecorder_prepare1)和[getInputSurface()](#getinputsurface)接口才能重新录制。
**系统能力：** SystemCapability.Multimedia.Media.VideoRecorder
**返回值：** **返回值：**
| 类型 | 说明 | | 类型 | 说明 |
...@@ -2211,6 +2347,8 @@ on(type: 'error', callback: ErrorCallback): void ...@@ -2211,6 +2347,8 @@ on(type: 'error', callback: ErrorCallback): void
开始订阅视频录制错误事件。 开始订阅视频录制错误事件。
**系统能力：** SystemCapability.Multimedia.Media.VideoRecorder
**参数：** **参数：**
| 参数名 | 类型 | 必填 | 说明 | | 参数名 | 类型 | 必填 | 说明 |
...@@ -2233,14 +2371,14 @@ videoRecorder.on('error', (error) => { // 设置'error'事件回调 ...@@ -2233,14 +2371,14 @@ videoRecorder.on('error', (error) => { // 设置'error'事件回调
视频录制的状态机。可通过state属性获取当前状态。 视频录制的状态机。可通过state属性获取当前状态。
| 名称 | 类型 | 描述 | | 名称 | 类型 | 描述 |
| -------- | ------ | ---------------------- | | -------- | ------ | ------------------------------------------------------------ |
| idle | string | 视频录制空闲。 | | idle | string | 视频录制空闲。<br/>**系统能力：** SystemCapability.Multimedia.Media.VideoRecorder |
| prepared | string | 视频录制参数设置完成。 | | prepared | string | 视频录制参数设置完成。<br/>**系统能力：** SystemCapability.Multimedia.Media.VideoRecorder |
| playing | string | 视频正在录制。 | | playing | string | 视频正在录制。<br/>**系统能力：** SystemCapability.Multimedia.Media.VideoRecorder |
| paused | string | 视频暂停录制。 | | paused | string | 视频暂停录制。<br/>**系统能力：** SystemCapability.Multimedia.Media.VideoRecorder |
| stopped | string | 视频录制停止。 | | stopped | string | 视频录制停止。<br/>**系统能力：** SystemCapability.Multimedia.Media.VideoRecorder |
| error | string | 错误状态。 | | error | string | 错误状态。<br/>**系统能力：** SystemCapability.Multimedia.Media.VideoRecorder |
## VideoRecorderConfig<sup>8+</sup> ## VideoRecorderConfig<sup>8+</sup>
...@@ -2248,60 +2386,60 @@ videoRecorder.on('error', (error) => { // 设置'error'事件回调 ...@@ -2248,60 +2386,60 @@ videoRecorder.on('error', (error) => { // 设置'error'事件回调
| 名称 | 参数类型 | 必填 | 说明 | | 名称 | 参数类型 | 必填 | 说明 |
| --------------- | ---------------------------------------------------------- | ---- | ------------------------------------------------------------ | | --------------- | ---------------------------------------------------------- | ---- | ------------------------------------------------------------ |
| audioSourceType | [AudioSourceType](#audiosourcetype<sup>8+</sup>) | 是 | 视频录制的音频源类型。 | | audioSourceType | [AudioSourceType](#audiosourcetype<sup>8+</sup>) | 是 | 视频录制的音频源类型。<br/>**系统能力：** SystemCapability.Multimedia.Media.VideoRecorder |
| videoSourceType | [VideoSourceType](#videosourcetype<sup>8+</sup>) | 是 | 视频录制的视频源类型。 | | videoSourceType | [VideoSourceType](#videosourcetype<sup>8+</sup>) | 是 | 视频录制的视频源类型。<br/>**系统能力：** SystemCapability.Multimedia.Media.VideoRecorder |
| profile | [VideoRecorderProfile](#videorecorderprofile<sup>8+</sup>) | 是 | 视频录制的profile。 | | profile | [VideoRecorderProfile](#videorecorderprofile<sup>8+</sup>) | 是 | 视频录制的profile。<br/>**系统能力：** SystemCapability.Multimedia.Media.VideoRecorder |
| orientationHint | number | 否 | 录制视频的旋转角度。 | | orientationHint | number | 否 | 录制视频的旋转角度。<br/>**系统能力：** SystemCapability.Multimedia.Media.VideoRecorder |
| location | [Location](#location8) | 否 | 录制视频的地理位置。 | | location | [Location](#location8) | 否 | 录制视频的地理位置。<br/>**系统能力：** SystemCapability.Multimedia.Media.VideoRecorder |
| url | string | 是 | 视频输出URL：fd://xx&nbsp;(fd&nbsp;number)<br/>![zh-cn_image_0000001164217678](figures/zh-cn_image_url.png) <br/>文件需要由调用者创建，并赋予适当的权限。 | | url | string | 是 | 视频输出URL：fd://xx&nbsp;(fd&nbsp;number)<br/>![zh-cn_image_0000001164217678](figures/zh-cn_image_url.png) <br/>文件需要由调用者创建，并赋予适当的权限。<br/>**系统能力：** SystemCapability.Multimedia.Media.VideoRecorder |
## AudioSourceType<sup>8+</sup> ## AudioSourceType<sup>8+</sup>
表示视频录制中音频源类型的枚举。 表示视频录制中音频源类型的枚举。
| 名称 | 值 | 说明 | | 名称 | 值 | 说明 |
| -------------------------- | ---- | ---------------------- | | ------------------------- | ---- | ------------------------------------------------------------ |
| AUDIO_SOURCE_TYPE_DEFAULT0 | 0 | 默认的音频输入源类型。 | | AUDIO_SOURCE_TYPE_DEFAULT | 0 | 默认的音频输入源类型。<br/>**系统能力：** SystemCapability.Multimedia.Media.VideoRecorder |
| AUDIO_SOURCE_TYPE_MIC | 1 | 表示MIC的音频输入源。 | | AUDIO_SOURCE_TYPE_MIC | 1 | 表示MIC的音频输入源。<br/>**系统能力：** SystemCapability.Multimedia.Media.VideoRecorder |
## VideoSourceType<sup>8+</sup> ## VideoSourceType<sup>8+</sup>
表示视频录制中视频源类型的枚举。 表示视频录制中视频源类型的枚举。
| 名称 | 值 | 说明 | | 名称 | 值 | 说明 |
| ----------------------------- | ---- | ------------------------------- | | ----------------------------- | ---- | ------------------------------------------------------------ |
| VIDEO_SOURCE_TYPE_SURFACE_YUV | 0 | 输入surface中携带的是raw data。 | | VIDEO_SOURCE_TYPE_SURFACE_YUV | 0 | 输入surface中携带的是raw data。<br/>**系统能力：** SystemCapability.Multimedia.Media.VideoRecorder |
| VIDEO_SOURCE_TYPE_SURFACE_ES | 1 | 输入surface中携带的是ES data。 | | VIDEO_SOURCE_TYPE_SURFACE_ES | 1 | 输入surface中携带的是ES data。<br/>**系统能力：** SystemCapability.Multimedia.Media.VideoRecorder |
## VideoRecorderProfile<sup>8+</sup> ## VideoRecorderProfile<sup>8+</sup>
视频录制的配置文件。 视频录制的配置文件。
| 名称 | 参数类型 | 必填 | 说明 | | 名称 | 参数类型 | 必填 | 说明 |
| ---------------- | -------------------------------------------- | ---- | ---------------- | | ---------------- | -------------------------------------------- | ---- | ------------------------------------------------------------ |
| audioBitrate | number | 是 | 音频编码比特率。 | | audioBitrate | number | 是 | 音频编码比特率。<br/>**系统能力：** SystemCapability.Multimedia.Media.VideoRecorder |
| audioChannels | number | 是 | 音频采集声道数。 | | audioChannels | number | 是 | 音频采集声道数。<br/>**系统能力：** SystemCapability.Multimedia.Media.VideoRecorder |
| audioCodec | [CodecMimeType](#CodecMimeType8) | 是 | 音频编码格式。 | | audioCodec | [CodecMimeType](#CodecMimeType8) | 是 | 音频编码格式。<br/>**系统能力：** SystemCapability.Multimedia.Media.VideoRecorder |
| audioSampleRate | number | 是 | 音频采样率。 | | audioSampleRate | number | 是 | 音频采样率。<br/>**系统能力：** SystemCapability.Multimedia.Media.VideoRecorder |
| fileFormat | [ContainerFormatType](#containerformattype8) | 是 | 文件的容器格式。 | | fileFormat | [ContainerFormatType](#containerformattype8) | 是 | 文件的容器格式。<br/>**系统能力：** SystemCapability.Multimedia.Media.VideoRecorder |
| videoCodec | [CodecMimeType](#CodecMimeType8) | 是 | 视频编码格式。 | | videoCodec | [CodecMimeType](#CodecMimeType8) | 是 | 视频编码格式。<br/>**系统能力：** SystemCapability.Multimedia.Media.VideoRecorder |
| videoFrameWidth | number | 是 | 录制视频帧的宽。 | | videoFrameWidth | number | 是 | 录制视频帧的宽。<br/>**系统能力：** SystemCapability.Multimedia.Media.VideoRecorder |
| videoFrameHeight | number | 是 | 录制视频帧的高。 | | videoFrameHeight | number | 是 | 录制视频帧的高。<br/>**系统能力：** SystemCapability.Multimedia.Media.VideoRecorder |
## ContainerFormatType<sup>8+</sup> ## ContainerFormatType<sup>8+</sup>
表示容器格式类型的枚举，缩写为CFT。 表示容器格式类型的枚举，缩写为CFT。
| 名称 | 值 | 说明 | | 名称 | 值 | 说明 |
| ----------- | ----- | --------------------- | | ----------- | ----- | ------------------------------------------------------------ |
| CFT_MPEG_4 | "mp4" | 视频的容器格式，MP4。 | | CFT_MPEG_4 | "mp4" | 视频的容器格式，MP4。<br/>**系统能力：** SystemCapability.Multimedia.Media.VideoRecorder |
| CFT_MPEG_4A | "m4a" | 音频的容器格式，M4A。 | | CFT_MPEG_4A | "m4a" | 音频的容器格式，M4A。<br/>**系统能力：** SystemCapability.Multimedia.Media.VideoRecorder |
## Location<sup>8+</sup> ## Location<sup>8+</sup>
视频录制的地理位置。 视频录制的地理位置。
| 名称 | 参数类型 | 必填 | 说明 | | 名称 | 参数类型 | 必填 | 说明 |
| --------- | -------- | ---- | ---------------- | | --------- | -------- | ---- | ------------------------------------------------------------ |
| latitude | number | 是 | 地理位置的纬度。 | | latitude | number | 是 | 地理位置的纬度。<br/>**系统能力：** SystemCapability.Multimedia.Media.Core |
| longitude | number | 是 | 地理位置的经度。 | | longitude | number | 是 | 地理位置的经度。<br/>**系统能力：** SystemCapability.Multimedia.Media.Core |
\ No newline at end of file \ No newline at end of file
Markdown is supported
0% 或 .
You are about to add 0 people to the discussion. Proceed with caution.
先完成此消息的编辑！
想要评论请 注册 或