HarmonyOS API：@ohos.multimedia.media (媒体服务)

joytrian

发布于 2023-4-4 16:00

9247浏览

0收藏

版本：v3.1 Beta

@ohos.multimedia.media (媒体服务)

VideoPlayer⁸⁺

视频播放管理类，用于管理和播放视频媒体。在调用VideoPlayer的方法前，需要先通过createVideoPlayer()构建一个VideoPlayer实例。

视频播放demo可参考：视频播放开发指导

属性

系统能力： SystemCapability.Multimedia.Media.VideoPlayer

名称	类型	可读	可写	说明
url⁸⁺	string	是	是	视频媒体URL，支持当前主流的视频格式(mp4、mpeg-ts、webm、mkv)。支持路径示例： 1. fd类型播放：fd://xx 2. http网络播放: http://xx 3. https网络播放: https://xx 4. hls网络播放路径：http://xx或者https://xx
fdSrc⁹⁺	AVFileDescriptor	是	是	视频媒体文件描述，使用场景：应用中的视频资源被连续存储在同一个文件中。使用示例：假设一个连续存储的音乐文件: 视频1(地址偏移:0，字节长度:100) 视频2(地址偏移:101，字节长度:50) 视频3(地址偏移:151，字节长度:150) 1. 播放视频1：AVFileDescriptor { fd = 资源句柄; offset = 0; length = 100; } 2. 播放视频2：AVFileDescriptor { fd = 资源句柄; offset = 101; length = 50; } 3. 播放视频3：AVFileDescriptor { fd = 资源句柄; offset = 151; length = 150; } 假设是一个独立的视频文件: 请使用src=fd://xx
loop⁸⁺	boolean	是	是	视频循环播放属性，设置为'true'表示循环播放。
currentTime⁸⁺	number	是	否	视频的当前播放位置，单位为毫秒（ms）。
duration⁸⁺	number	是	否	视频时长，单位为毫秒（ms），返回-1表示直播模式。
state⁸⁺	VideoPlayState	是	否	视频播放的状态。
width⁸⁺	number	是	否	视频宽，单位为像素（px）。
height⁸⁺	number	是	否	视频高，单位为像素（px）。

setDisplaySurface⁸⁺

setDisplaySurface(SurfaceId: string, callback: AsyncCallback<void>): void

通过回调方式设置SurfaceId。

*注意：SetDisplaySurface需要在设置url和Prepare之间，无音频的视频流必须设置Surface否则Prepare失败。

系统能力： SystemCapability.Multimedia.Media.VideoPlayer

参数：

参数名	类型	必填	说明
SurfaceId	string	是	SurfaceId
callback	AsyncCallback<void>	是	设置SurfaceId的回调方法。

示例：

let SurfaceId = null;
videoPlayer.setDisplaySurface(SurfaceId, (err) => {
    if (err == null) {
        console.info('setDisplaySurface success!');
    } else {
        console.info('setDisplaySurface fail!');
    }
});1.
2.
3.
4.
5.
6.
7.
8.

setDisplaySurface⁸⁺

setDisplaySurface(SurfaceId: string): Promise<void>

通过Promise方式设置SurfaceId。

*注意：SetDisplaySurface需要在设置url和Prepare之间，无音频的视频流必须设置Surface否则Prepare失败。

系统能力： SystemCapability.Multimedia.Media.VideoPlayer

参数：

参数名	类型	必填	说明
SurfaceId	string	是	SurfaceId

返回值：

类型	说明
Promise<void>	设置SurfaceId的Promise返回值。

示例：

let SurfaceId = null;
videoPlayer.setDisplaySurface(SurfaceId).then(() => {
    console.info('setDisplaySurface success');
}).catch((error) => {
   console.info(`video catchCallback, error:${error}`);
});1.
2.
3.
4.
5.
6.

prepare⁸⁺

prepare(callback: AsyncCallback<void>): void

通过回调方式准备播放视频。

系统能力： SystemCapability.Multimedia.Media.VideoPlayer

参数：

参数名	类型	必填	说明
callback	AsyncCallback<void>	是	准备播放视频的回调方法。

示例：

videoPlayer.prepare((err) => {
    if (err == null) {
        console.info('prepare success!');
    } else {
        console.info('prepare fail!');
    }
});1.
2.
3.
4.
5.
6.
7.

prepare⁸⁺

prepare(): Promise<void>

通过Promise方式准备播放视频。

系统能力： SystemCapability.Multimedia.Media.VideoPlayer

返回值：

类型	说明
Promise<void>	准备播放视频的Promise返回值。

示例：

videoPlayer.prepare().then(() => {
    console.info('prepare success');
}).catch((error) => {
   console.info(`video catchCallback, error:${error}`);
});1.
2.
3.
4.
5.

play⁸⁺

play(callback: AsyncCallback<void>): void;

通过回调方式开始播放视频。

系统能力： SystemCapability.Multimedia.Media.VideoPlayer

参数：

参数名	类型	必填	说明
callback	AsyncCallback<void>	是	开始播放视频的回调方法。

示例：

videoPlayer.play((err) => {
    if (err == null) {
        console.info('play success!');
    } else {
        console.info('play fail!');
    }
});1.
2.
3.
4.
5.
6.
7.

play⁸⁺

play(): Promise<void>;

通过Promise方式开始播放视频。

系统能力： SystemCapability.Multimedia.Media.VideoPlayer

返回值：

类型	说明
Promise<void>	开始播放视频的Promise返回值。

示例：

videoPlayer.play().then(() => {
    console.info('play success');
}).catch((error) => {
   console.info(`video catchCallback, error:${error}`);
});1.
2.
3.
4.
5.

pause⁸⁺

pause(callback: AsyncCallback<void>): void

通过回调方式暂停播放视频。

系统能力： SystemCapability.Multimedia.Media.VideoPlayer

参数：

参数名	类型	必填	说明
callback	AsyncCallback<void>	是	暂停播放视频的回调方法。

示例：

videoPlayer.pause((err) => {
    if (err == null) {
        console.info('pause success!');
    } else {
        console.info('pause fail!');
    }
});1.
2.
3.
4.
5.
6.
7.

pause⁸⁺

pause(): Promise<void>

通过Promise方式暂停播放视频。

系统能力： SystemCapability.Multimedia.Media.VideoPlayer

返回值：

类型	说明
Promise<void>	暂停播放视频的Promise返回值。

示例：

videoPlayer.pause().then(() => {
    console.info('pause success');
}).catch((error) => {
   console.info(`video catchCallback, error:${error}`);
});1.
2.
3.
4.
5.

stop⁸⁺

stop(callback: AsyncCallback<void>): void

通过回调方式停止播放视频。

系统能力： SystemCapability.Multimedia.Media.VideoPlayer

参数：

参数名	类型	必填	说明
callback	AsyncCallback<void>	是	停止播放视频的回调方法。

示例：

videoPlayer.stop((err) => {
    if (err == null) {
        console.info('stop success!');
    } else {
        console.info('stop fail!');
    }
});1.
2.
3.
4.
5.
6.
7.

stop⁸⁺

stop(): Promise<void>

通过Promise方式停止播放视频。

系统能力： SystemCapability.Multimedia.Media.VideoPlayer

返回值：

类型	说明
Promise<void>	停止播放视频的Promise返回值。

示例：

videoPlayer.stop().then(() => {
    console.info('stop success');
}).catch((error) => {
   console.info(`video catchCallback, error:${error}`);
});1.
2.
3.
4.
5.

reset⁸⁺

reset(callback: AsyncCallback<void>): void

通过回调方式重置播放视频。

系统能力： SystemCapability.Multimedia.Media.VideoPlayer

参数：

参数名	类型	必填	说明
callback	AsyncCallback<void>	是	切换播放视频的回调方法。

示例：

videoPlayer.reset((err) => {
    if (err == null) {
        console.info('reset success!');
    } else {
        console.info('reset fail!');
    }
});1.
2.
3.
4.
5.
6.
7.

reset⁸⁺

reset(): Promise<void>

通过Promise方式重置播放视频。

系统能力： SystemCapability.Multimedia.Media.VideoPlayer

返回值：

类型	说明
Promise<void>	切换播放视频的Promise返回值。

示例：

videoPlayer.reset().then(() => {
    console.info('reset success');
}).catch((error) => {
   console.info(`video catchCallback, error:${error}`);
});1.
2.
3.
4.
5.

seek⁸⁺

seek(timeMs: number, callback: AsyncCallback<number>): void

通过回调方式跳转到指定播放位置，默认跳转到指定时间点的下一个关键帧。

系统能力： SystemCapability.Multimedia.Media.VideoPlayer

参数：

参数名	类型	必填	说明
timeMs	number	是	指定的跳转时间节点，单位毫秒（ms），取值范围为[0, duration]。
callback	AsyncCallback<number>	是	跳转到指定播放位置的回调方法。

示例：

let seekTime = 5000;
videoPlayer.seek(seekTime, (err, result) => {
    if (err == null) {
        console.info('seek success!');
    } else {
        console.info('seek fail!');
    }
});1.
2.
3.
4.
5.
6.
7.
8.

seek⁸⁺

seek(timeMs: number, mode:SeekMode, callback: AsyncCallback<number>): void

通过回调方式跳转到指定播放位置。

系统能力： SystemCapability.Multimedia.Media.VideoPlayer

参数：

参数名	类型	必填	说明
timeMs	number	是	指定的跳转时间节点，单位毫秒（ms），取值范围为[0, duration]。
mode	SeekMode	是	跳转模式。
callback	AsyncCallback<number>	是	跳转到指定播放位置的回调方法。

示例：

import media from '@ohos.multimedia.media'
let seekTime = 5000;
videoPlayer.seek(seekTime, media.SeekMode.SEEK_NEXT_SYNC, (err, result) => {
    if (err == null) {
        console.info('seek success!');
    } else {
        console.info('seek fail!');
    }
});1.
2.
3.
4.
5.
6.
7.
8.
9.

seek⁸⁺

seek(timeMs: number, mode?:SeekMode): Promise<number>

通过Promise方式跳转到指定播放位置，如果没有设置mode则跳转到指定时间点的下一个关键帧。

系统能力： SystemCapability.Multimedia.Media.VideoPlayer

参数：

参数名	类型	必填	说明
timeMs	number	是	指定的跳转时间节点，单位毫秒（ms），取值范围为[0, duration]。
mode	SeekMode	否	跳转模式。

返回值：

类型	说明
Promise<number>	跳转到指定播放位置的Promise返回值，单位ms。

示例：

import media from '@ohos.multimedia.media'
let seekTime = 5000;
videoPlayer.seek(seekTime).then((seekDoneTime) => { // seekDoneTime表示seek完成后的时间点
    console.info('seek success');
}).catch((error) => {
   console.info(`video catchCallback, error:${error}`);
});

videoPlayer.seek(seekTime, media.SeekMode.SEEK_NEXT_SYNC).then((seekDoneTime) => {
    console.info('seek success');
}).catch((error) => {
   console.info(`video catchCallback, error:${error}`);
});1.
2.
3.
4.
5.
6.
7.
8.
9.
10.
11.
12.
13.

setVolume⁸⁺

setVolume(vol: number, callback: AsyncCallback<void>): void

通过回调方式设置音量。

系统能力： SystemCapability.Multimedia.Media.VideoPlayer

参数：

参数名	类型	必填	说明
vol	number	是	指定的相对音量大小，取值范围为[0.00-1.00]，1表示最大音量，即100%。
callback	AsyncCallback<void>	是	设置音量的回调方法。

示例：

let vol = 0.5;
videoPlayer.setVolume(vol, (err, result) => {
    if (err == null) {
        console.info('setVolume success!');
    } else {
        console.info('setVolume fail!');
    }
});1.
2.
3.
4.
5.
6.
7.
8.

setVolume⁸⁺

setVolume(vol: number): Promise<void>

通过Promise方式设置音量。

系统能力： SystemCapability.Multimedia.Media.VideoPlayer

参数：

参数名	类型	必填	说明
vol	number	是	指定的相对音量大小，取值范围为[0.00-1.00]，1表示最大音量，即100%。

返回值：

类型	说明
Promise<void>	设置音量的Promise返回值。

示例：

let vol = 0.5;
videoPlayer.setVolume(vol).then(() => {
    console.info('setVolume success');
}).catch((error) => {
   console.info(`video catchCallback, error:${error}`);
});1.
2.
3.
4.
5.
6.

release⁸⁺

release(callback: AsyncCallback<void>): void

通过回调方式释放视频资源。

系统能力： SystemCapability.Multimedia.Media.VideoPlayer

参数：

参数名	类型	必填	说明
callback	AsyncCallback<void>	是	释放视频资源的回调方法。

示例：

videoPlayer.release((err) => {
    if (err == null) {
        console.info('release success!');
    } else {
        console.info('release fail!');
    }
});1.
2.
3.
4.
5.
6.
7.

release⁸⁺

release(): Promise<void>

通过Promise方式释放视频资源。

系统能力： SystemCapability.Multimedia.Media.VideoPlayer

返回值：

类型	说明
Promise<void>	释放视频资源的Promise返回值。

示例：

videoPlayer.release().then(() => {
    console.info('release success');
}).catch((error) => {
   console.info(`video catchCallback, error:${error}`);
});1.
2.
3.
4.
5.

getTrackDescription⁸⁺

getTrackDescription(callback: AsyncCallback<Array<MediaDescription>>): void

通过回调方式获取视频轨道信息。

系统能力： SystemCapability.Multimedia.Media.VideoPlayer

参数：

参数名	类型	必填	说明
callback	AsyncCallback<Array<MediaDescription>>	是	视频轨道信息MediaDescription数组回调方法。

示例：

function printfDescription(obj) {
    for (let item in obj) {
        let property = obj[item];
        console.info('video key is ' + item);
        console.info('video value is ' + property);
    }
}

videoPlayer.getTrackDescription((error, arrList) => {
    if ((arrList) != null) {
        for (let i = 0; i < arrList.length; i++) {
            printfDescription(arrList[i]);
        }
    } else {
        console.log(`video getTrackDescription fail, error:${error}`);
    }
});1.
2.
3.
4.
5.
6.
7.
8.
9.
10.
11.
12.
13.
14.
15.
16.
17.

getTrackDescription⁸⁺

getTrackDescription(): Promise<Array<MediaDescription>>

通过Promise方式获取视频轨道信息。

系统能力： SystemCapability.Multimedia.Media.VideoPlayer

返回值：

类型	说明
Promise<Array<MediaDescription>>	视频轨道信息MediaDescription数组Promise返回值。

示例：

function printfDescription(obj) {
    for (let item in obj) {
        let property = obj[item];
        console.info('video key is ' + item);
        console.info('video value is ' + property);
    }
}

let arrayDescription;
videoPlayer.getTrackDescription().then((arrList) => {
    if (arrList != null) {
        arrayDescription = arrList;
    } else {
        console.log('video getTrackDescription fail');
    }
}).catch((error) => {
   console.info(`video catchCallback, error:${error}`);
});
for (let i = 0; i < arrayDescription.length; i++) {
    printfDescription(arrayDescription[i]);
}1.
2.
3.
4.
5.
6.
7.
8.
9.
10.
11.
12.
13.
14.
15.
16.
17.
18.
19.
20.
21.

setSpeed⁸⁺

setSpeed(speed:number, callback: AsyncCallback<number>): void

通过回调方式设置播放速度。

系统能力： SystemCapability.Multimedia.Media.VideoPlayer

参数：

参数名	类型	必填	说明
speed	number	是	指定播放视频速度，具体见PlaybackSpeed。
callback	AsyncCallback<number>	是	设置播放速度的回调方法。

示例：

import media from '@ohos.multimedia.media'
let speed = media.PlaybackSpeed.SPEED_FORWARD_2_00_X;

videoPlayer.setSpeed(speed, (err, result) => {
    if (err == null) {
        console.info('setSpeed success!');
    } else {
        console.info('setSpeed fail!');
    }
});1.
2.
3.
4.
5.
6.
7.
8.
9.
10.

setSpeed⁸⁺

setSpeed(speed:number): Promise<number>

通过Promise方式设置播放速度。

系统能力： SystemCapability.Multimedia.Media.VideoPlayer

参数：

参数名	类型	必填	说明
speed	number	是	指定播放视频速度，具体见PlaybackSpeed。

返回值：

类型	说明
Promise<number>	播放速度Promise返回值，具体见PlaybackSpeed。

示例：

import media from '@ohos.multimedia.media'
let speed = media.PlaybackSpeed.SPEED_FORWARD_2_00_X;

videoPlayer.setSpeed(speed).then(() => {
    console.info('setSpeed success');
}).catch((error) => {
   console.info(`video catchCallback, error:${error}`);
});1.
2.
3.
4.
5.
6.
7.
8.

on('playbackCompleted')⁸⁺

on(type: 'playbackCompleted', callback: Callback<void>): void

开始监听视频播放完成事件。

系统能力： SystemCapability.Multimedia.Media.VideoPlayer

参数：

参数名	类型	必填	说明
type	string	是	视频播放完成事件回调类型，支持的事件：'playbackCompleted'。
callback	function	是	视频播放完成事件回调方法。

示例：

videoPlayer.on('playbackCompleted', () => {
    console.info('playbackCompleted success!');
});1.
2.
3.

on('bufferingUpdate')⁸⁺

on(type: 'bufferingUpdate', callback: (infoType: BufferingInfoType, value: number) => void): void

开始监听视频缓存更新事件。仅网络播放支持该订阅事件。

系统能力： SystemCapability.Multimedia.Media.VideoPlayer

参数：

参数名	类型	必填	说明
type	string	是	视频缓存事件回调类型，支持的事件：'bufferingUpdate'。
callback	function	是	视频缓存事件回调方法。 BufferingInfoType为BUFFERING_PERCENT时，value值有效，否则固定为0。

示例：

videoPlayer.on('bufferingUpdate', (infoType, value) => {
    console.log('video bufferingInfo type: ' + infoType);
    console.log('video bufferingInfo value: ' + value);
});1.
2.
3.
4.

on('startRenderFrame')⁸⁺

on(type: 'startRenderFrame', callback: Callback<void>): void

开始监听视频播放首帧送显上报事件。

系统能力： SystemCapability.Multimedia.Media.VideoPlayer

参数：

参数名	类型	必填	说明
type	string	是	视频播放首帧送显上报事件回调类型，支持的事件：'startRenderFrame'。
callback	Callback<void>	是	视频播放首帧送显上报事件回调方法。

示例：

videoPlayer.on('startRenderFrame', () => {
    console.info('startRenderFrame success!');
});1.
2.
3.

on('videoSizeChanged')⁸⁺

on(type: 'videoSizeChanged', callback: (width: number, height: number) => void): void

开始监听视频播放宽高变化事件。

系统能力： SystemCapability.Multimedia.Media.VideoPlayer

参数：

参数名	类型	必填	说明
type	string	是	视频播放宽高变化事件回调类型，支持的事件：'videoSizeChanged'。
callback	function	是	视频播放宽高变化事件回调方法，width表示宽，height表示高。

示例：

videoPlayer.on('videoSizeChanged', (width, height) => {
    console.log('video width is: ' + width);
    console.log('video height is: ' + height);
});1.
2.
3.
4.

on('error')⁸⁺

on(type: 'error', callback: ErrorCallback): void

开始监听视频播放错误事件，当上报error错误事件后，用户需处理error事件，退出播放操作。

系统能力： SystemCapability.Multimedia.Media.VideoPlayer

参数：

参数名	类型	必填	说明
type	string	是	播放错误事件回调类型，支持的事件包括：'error'。 - 'error'：视频播放中发生错误，触发该事件。
callback	ErrorCallback	是	播放错误事件回调方法。

示例：

videoPlayer.on('error', (error) => {      // 设置'error'事件回调
    console.info(`video error called, error: ${error}`);
});
videoPlayer.url = 'fd://error';  //设置错误的播放地址，触发'error'事件1.
2.
3.
4.

VideoPlayState⁸⁺

视频播放的状态机，可通过state属性获取当前状态。

系统能力： SystemCapability.Multimedia.Media.VideoPlayer

名称	类型	说明
idle	string	视频播放空闲。
prepared	string	视频播放准备。
playing	string	视频正在播放。
paused	string	视频暂停播放。
stopped	string	视频播放停止。
error	string	错误状态。

SeekMode⁸⁺

视频播放的Seek模式枚举，可通过seek方法作为参数传递下去。

系统能力： SystemCapability.Multimedia.Media.Core

名称	值	说明
SEEK_NEXT_SYNC	0	表示跳转到指定时间点的下一个关键帧，建议向后快进的时候用这个枚举值。
SEEK_PREV_SYNC	1	表示跳转到指定时间点的上一个关键帧，建议向前快进的时候用这个枚举值。

PlaybackSpeed⁸⁺

视频播放的倍速枚举，可通过setSpeed方法作为参数传递下去。

系统能力： SystemCapability.Multimedia.Media.VideoPlayer

名称	值	说明
SPEED_FORWARD_0_75_X	0	表示视频播放正常播速的0.75倍。
SPEED_FORWARD_1_00_X	1	表示视频播放正常播速。
SPEED_FORWARD_1_25_X	2	表示视频播放正常播速的1.25倍。
SPEED_FORWARD_1_75_X	3	表示视频播放正常播速的1.75倍。
SPEED_FORWARD_2_00_X	4	表示视频播放正常播速的2.00倍。

VideoScaleType⁹⁺

枚举，视频缩放模式。

系统能力： SystemCapability.Multimedia.Media.VideoPlayer

名称	值	说明
VIDEO_SCALE_TYPE_FIT	0	视频拉伸至与窗口等大。

MediaDescription⁸⁺

通过key-value方式获取媒体信息。

系统能力： SystemCapability.Multimedia.Media.Core

示例：

import media from '@ohos.multimedia.media'
function printfItemDescription(obj, key) {
    let property = obj[key];
    console.info('audio key is ' + key); // 通过key值获取对应的value。key值具体可见[MediaDescriptionKey]
    console.info('audio value is ' + property); //对应key值得value。其类型可为任意类型，具体key对应value的类型可参考[MediaDescriptionKey]
}
let audioPlayer = media.createAudioPlayer();
audioPlayer.getTrackDescription((error, arrList) => {
    if (arrList != null) {
        for (let i = 0; i < arrList.length; i++) {
            printfItemDescription(arrList[i], media.MediaDescriptionKey.MD_KEY_TRACK_TYPE);  //打印出每条轨道MD_KEY_TRACK_TYPE的值
        }
    } else {
        console.log(`audio getTrackDescription fail, error:${error}`);
    }
});1.
2.
3.
4.
5.
6.
7.
8.
9.
10.
11.
12.
13.
14.
15.
16.

AudioRecorder

音频录制管理类，用于录制音频媒体。在调用AudioRecorder的方法前，需要先通过createAudioRecorder() 构建一个AudioRecorder实例。

音频录制demo可参考：音频录制开发指导

prepare

prepare(config: AudioRecorderConfig): void

录音准备。

需要权限： ohos.permission.MICROPHONE

系统能力： SystemCapability.Multimedia.Media.AudioRecorder

参数：

参数名	类型	必填	说明
config	AudioRecorderConfig	是	配置录音的相关参数，包括音频输出URI、编码格式、采样率、声道数、输出格式等。

示例：

let audioRecorderConfig = {
    audioEncoder : media.AudioEncoder.AAC_LC,
    audioEncodeBitRate : 22050,
    audioSampleRate : 22050,
    numberOfChannels : 2,
    format : media.AudioOutputFormat.AAC_ADTS,
    uri : 'fd://1',       // 文件需先由调用者创建，并给予适当的权限
    location : { latitude : 30, longitude : 130},
}
audioRecorder.on('prepare', () => {    //设置'prepare'事件回调
    console.log('prepare success');
});
audioRecorder.prepare(audioRecorderConfig);1.
2.
3.
4.
5.
6.
7.
8.
9.
10.
11.
12.
13.

start

start(): void

开始录制，需在prepare事件成功触发后，才能调用start方法。

系统能力： SystemCapability.Multimedia.Media.AudioRecorder

示例：

audioRecorder.on('start', () => {    //设置'start'事件回调
    console.log('audio recorder start success');
});
audioRecorder.start();1.
2.
3.
4.

pause

pause():void

暂停录制，需要在start事件成功触发后，才能调用pause方法。

系统能力： SystemCapability.Multimedia.Media.AudioRecorder

示例：

audioRecorder.on('pause', () => {    //设置'pause'事件回调
    console.log('audio recorder pause success');
});
audioRecorder.pause();1.
2.
3.
4.

resume

resume():void

恢复录制，需要在pause事件成功触发后，才能调用resume方法。

系统能力： SystemCapability.Multimedia.Media.AudioRecorder

示例：

audioRecorder.on('resume', () => {    //设置'resume'事件回调
    console.log('audio recorder resume success');
});
audioRecorder.resume();1.
2.
3.
4.

stop

stop(): void

停止录音。

系统能力： SystemCapability.Multimedia.Media.AudioRecorder

示例：

audioRecorder.on('stop', () => {    //设置'stop'事件回调
    console.log('audio recorder stop success');
});
audioRecorder.stop();1.
2.
3.
4.

release

release(): void

释放录音资源。

系统能力： SystemCapability.Multimedia.Media.AudioRecorder

示例：

audioRecorder.on('release', () => {    //设置'release'事件回调
    console.log('audio recorder release success');
});
audioRecorder.release();
audioRecorder = undefined;1.
2.
3.
4.
5.

reset

reset(): void

重置录音。

进行重置录音之前，需要先调用stop()停止录音。重置录音之后，需要调用prepare()设置录音参数项，才能再次进行录音。

系统能力： SystemCapability.Multimedia.Media.AudioRecorder

示例：

audioRecorder.on('reset', () => {    //设置'reset'事件回调
    console.log('audio recorder reset success');
});
audioRecorder.reset();1.
2.
3.
4.

on('prepare' | 'start' | 'pause' | 'resume' | 'stop' | 'release' | 'reset')

开始订阅音频录制事件。

系统能力： SystemCapability.Multimedia.Media.AudioRecorder

参数：

参数名	类型	必填	说明
type	string	是	录制事件回调类型，支持的事件包括：'prepare' \| 'start' \| 'pause' \| ’resume‘ \| 'stop' \| 'release' \| 'reset'。 - 'prepare' ：完成prepare调用，音频录制参数设置完成，触发该事件。 - 'start' ：完成start调用，音频录制开始，触发该事件。 - 'pause': 完成pause调用，音频暂停录制，触发该事件。 - 'resume': 完成resume调用，音频恢复录制，触发该事件。 - 'stop' ：完成stop调用，音频停止录制，触发该事件。 - 'release' ：完成release调用，音频释放录制资源，触发该事件。 - 'reset'：完成reset调用，音频重置为初始状态，触发该事件。
callback	()=>void	是	录制事件回调方法。

示例：

let audioRecorder = media.createAudioRecorder();                                  // 创建一个音频录制实例
let audioRecorderConfig = {
    audioEncoder : media.AudioEncoder.AAC_LC,
    audioEncodeBitRate : 22050,
    audioSampleRate : 22050,
    numberOfChannels : 2,
    format : media.AudioOutputFormat.AAC_ADTS,
    uri : 'fd://xx',                                                            // 文件需先由调用者创建，并给予适当的权限
    location : { latitude : 30, longitude : 130},
}
audioRecorder.on('error', (error) => {                                             // 设置'error'事件回调
    console.info(`audio error called, error: ${error}`);
});
audioRecorder.on('prepare', () => {                                              // 设置'prepare'事件回调
    console.log('prepare success');
    audioRecorder.start();                                                       // 开始录制，并触发'start'事件回调
});
audioRecorder.on('start', () => {                                                 // 设置'start'事件回调
    console.log('audio recorder start success');
});
audioRecorder.on('pause', () => {                                                 // 设置'pause'事件回调
    console.log('audio recorder pause success');
});
audioRecorder.on('resume', () => {                                                 // 设置'resume'事件回调
    console.log('audio recorder resume success');
});
audioRecorder.on('stop', () => {                                                 // 设置'stop'事件回调
    console.log('audio recorder stop success');
});
audioRecorder.on('release', () => {                                                 // 设置'release'事件回调
    console.log('audio recorder release success');
});
audioRecorder.on('reset', () => {                                                 // 设置'reset'事件回调
    console.log('audio recorder reset success');
});
audioRecorder.prepare(audioRecorderConfig)                                       // 设置录制参数 ，并触发'prepare'事件回调1.
2.
3.
4.
5.
6.
7.
8.
9.
10.
11.
12.
13.
14.
15.
16.
17.
18.
19.
20.
21.
22.
23.
24.
25.
26.
27.
28.
29.
30.
31.
32.
33.
34.
35.
36.

on('error')

on(type: 'error', callback: ErrorCallback): void

开始订阅音频录制错误事件，当上报error错误事件后，用户需处理error事件，退出录制操作。

系统能力： SystemCapability.Multimedia.Media.AudioRecorder

参数：

参数名	类型	必填	说明
type	string	是	录制错误事件回调类型'error'。 - 'error'：音频录制过程中发生错误，触发该事件。
callback	ErrorCallback	是	录制错误事件回调方法。

示例：

let audioRecorderConfig = {
    audioEncoder : media.AudioEncoder.AAC_LC,
    audioEncodeBitRate : 22050,
    audioSampleRate : 22050,
    numberOfChannels : 2,
    format : media.AudioOutputFormat.AAC_ADTS,
    uri : 'fd://xx',                                                     // 文件需先由调用者创建，并给予适当的权限
    location : { latitude : 30, longitude : 130},
}
audioRecorder.on('error', (error) => {                                  // 设置'error'事件回调
    console.info(`audio error called, error: ${error}`); 
});
audioRecorder.prepare(audioRecorderConfig);                            // prepare不设置参数，触发'error'事件1.
2.
3.
4.
5.
6.
7.
8.
9.
10.
11.
12.
13.

AudioRecorderConfig

表示音频的录音配置。

系统能力： SystemCapability.Multimedia.Media.AudioRecorder

名称	类型	必填	说明
audioEncoder^(deprecated)	AudioEncoder	否	音频编码格式，默认设置为AAC_LC。说明：从API Version 8 开始废弃，建议使用audioEncoderMime替代。
audioEncodeBitRate	number	否	音频编码比特率，默认值为48000。
audioSampleRate	number	否	音频采集采样率，默认值为48000。
numberOfChannels	number	否	音频采集声道数，默认值为2。
format^(deprecated)	AudioOutputFormat	否	音频输出封装格式，默认设置为MPEG_4。说明：从API Version 8 开始废弃，建议使用fileFormat替代。
location	Location	否	音频采集的地理位置。
uri	string	是	音频输出URI：fd://xx (fd number) 文件需要由调用者创建，并赋予适当的权限。
audioEncoderMime⁸⁺	CodecMimeType	否	音频编码格式。
fileFormat⁸⁺	ContainerFormatType	否	音频编码格式。

AudioEncoder^(deprecated)

说明

从 API Version 8 开始废弃，建议使用CodecMimeType替代。

表示音频编码格式的枚举。

系统能力： SystemCapability.Multimedia.Media.AudioRecorder

名称	值	说明
DEFAULT	0	默认编码格式。仅做接口定义，暂不支持使用。
AMR_NB	1	AMR-NB(Adaptive Multi Rate-Narrow Band Speech Codec) 编码格式。仅做接口定义，暂不支持使用。
AMR_WB	2	AMR-WB(Adaptive Multi Rate-Wide Band Speech Codec) 编码格式。仅做接口定义，暂不支持使用。
AAC_LC	3	AAC-LC（Advanced Audio Coding Low Complexity）编码格式。
HE_AAC	4	HE_AAC（High-Efficiency Advanced Audio Coding）编码格式。仅做接口定义，暂不支持使用。

AudioOutputFormat^(deprecated)

说明

从 API Version 8 开始废弃，建议使用ContainerFormatType替代。

表示音频封装格式的枚举。

系统能力： SystemCapability.Multimedia.Media.AudioRecorder

名称	值	说明
DEFAULT	0	默认封装格式。仅做接口定义，暂不支持使用。
MPEG_4	2	封装为MPEG-4格式。
AMR_NB	3	封装为AMR_NB格式。仅做接口定义，暂不支持使用。
AMR_WB	4	封装为AMR_WB格式。仅做接口定义，暂不支持使用。
AAC_ADTS	6	封装为ADTS（Audio Data Transport Stream）格式，是AAC音频的传输流格式。

ContainerFormatType⁸⁺

表示容器格式类型的枚举，缩写为CFT。

系统能力： SystemCapability.Multimedia.Media.Core

名称	值	说明
CFT_MPEG_4	'mp4'	视频的容器格式，MP4。
CFT_MPEG_4A	'm4a'	音频的容器格式，M4A。

Location

视频录制的地理位置。

系统能力： SystemCapability.Multimedia.Media.Core

名称	类型	必填	说明
latitude	number	是	地理位置的纬度。
longitude	number	是	地理位置的经度。

文章转载自：https://developer.harmonyos.com/cn/docs/documentation/doc-references-V3/js-apis-media-0000001427902672-V3?catalogVersion=V3#ZH-CN_TOPIC_0000001427902672__audiorecorderconfig

分类

卡片开发

三方库

标签

HarmonyOS API

已于2023-4-4 16:00:21修改

51CTO

51CTO博客

51CTO学堂

HarmonyOS API：@ohos.multimedia.media (媒体服务)

@ohos.multimedia.media (媒体服务)

VideoPlayer8+

属性​

setDisplaySurface8+

setDisplaySurface8+

prepare8+

prepare8+

play8+

play8+

pause8+

pause8+

stop8+

stop8+

reset8+

reset8+

seek8+

seek8+

seek8+

setVolume8+

setVolume8+

release8+

release8+

getTrackDescription8+

getTrackDescription8+

setSpeed8+

setSpeed8+

on('playbackCompleted')8+

on('bufferingUpdate')8+

on('startRenderFrame')8+

on('videoSizeChanged')8+

on('error')8+

VideoPlayState8+

SeekMode8+

PlaybackSpeed8+

VideoScaleType9+

MediaDescription8+

AudioRecorder

prepare​

start​

pause​

resume​

stop​

release​

reset​

on('prepare' | 'start' | 'pause' | 'resume' | 'stop' | 'release' | 'reset')​

on('error')

AudioRecorderConfig

AudioEncoder(deprecated)

AudioOutputFormat(deprecated)

ContainerFormatType8+

Location

目录

订阅鸿蒙技术特刊，精选内容抢先看

VideoPlayer⁸⁺

属性

setDisplaySurface⁸⁺

setDisplaySurface⁸⁺

prepare⁸⁺

prepare⁸⁺

play⁸⁺

play⁸⁺

pause⁸⁺

pause⁸⁺

stop⁸⁺

stop⁸⁺

reset⁸⁺

reset⁸⁺

seek⁸⁺

seek⁸⁺

seek⁸⁺

setVolume⁸⁺

setVolume⁸⁺

release⁸⁺

release⁸⁺

getTrackDescription⁸⁺

getTrackDescription⁸⁺

setSpeed⁸⁺

setSpeed⁸⁺

on('playbackCompleted')⁸⁺

on('bufferingUpdate')⁸⁺

on('startRenderFrame')⁸⁺

on('videoSizeChanged')⁸⁺

on('error')⁸⁺

VideoPlayState⁸⁺

SeekMode⁸⁺

PlaybackSpeed⁸⁺

VideoScaleType⁹⁺

MediaDescription⁸⁺

prepare

start

pause

resume

stop

release

reset

on('prepare' | 'start' | 'pause' | 'resume' | 'stop' | 'release' | 'reset')

AudioEncoder^(deprecated)

AudioOutputFormat^(deprecated)

ContainerFormatType⁸⁺