媒体服务

导入模块

import media from '@ohos.multimedia.media';

media.createAVPlayer9+

createAVPlayer(callback: AsyncCallback<AVPlayer>): void

异步方式创建音视频播放实例，通过注册回调函数获取返回值。

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

参数：

错误码：

以下错误码的详细介绍请参见媒体错误码

示例：

let avPlayer;

media.createAVPlayer((error, video) => {
  if (video != null) {
    avPlayer = video;
    console.info('createAVPlayer success');
  } else {
    console.error(`createAVPlayer fail, error message:${error.message}`);
  }
});

media.createAVPlayer9+

createAVPlayer(): Promise<AVPlayer>

异步方式创建音视频播放实例，通过Promise获取返回值。

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

返回值：

错误码：

以下错误码的详细介绍请参见媒体错误码

示例：

let avPlayer;

media.createAVPlayer().then((video) => {
  if (video != null) {
    avPlayer = video;
    console.info('createAVPlayer success');
  } else {
    console.error('createAVPlayer fail');
  }
}).catch((error) => {
  console.error(`AVPlayer catchCallback, error message:${error.message}`);
});

media.createAVRecorder9+

createAVRecorder(callback: AsyncCallback<AVRecorder>): void

异步方式创建音视频录制实例。通过注册回调函数获取返回值。

一台设备只允许创建一个录制实例。

注意，使用相机进行视频录制时，需要与相机模块配合，当前相机模块仅对系统应用开放。

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

参数：

错误码：

以下错误码的详细介绍请参见媒体错误码

示例：

let avRecorder;

media.createAVRecorder((error, recorder) => {
  if (recorder != null) {
    avRecorder = recorder;
    console.info('createAVRecorder success');
  } else {
    console.error(`createAVRecorder fail, error message:${error.message}`);
  }
});

media.createAVRecorder9+

createAVRecorder(): Promise<AVRecorder>

异步方式创建音视频录制实例。通过Promise获取返回值。

一台设备只允许创建一个录制实例。

注意，使用相机进行视频录制时，需要与相机模块配合，当前相机模块仅对系统应用开放。

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

返回值：

错误码：

以下错误码的详细介绍请参见媒体错误码

示例：

let avRecorder;

media.createAVRecorder().then((recorder) => {
  if (recorder != null) {
    avRecorder = recorder;
    console.info('createAVRecorder success');
  } else {
    console.error('createAVRecorder fail');
  }
}).catch((error) => {
  console.error(`createAVRecorder catchCallback, error message:${error.message}`);
});

AVErrorCode9+

媒体错误码类型枚举

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

MediaType8+

媒体类型枚举。

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

CodecMimeType8+

Codec MIME类型枚举。

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

MediaDescriptionKey8+

媒体信息描述枚举。

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

BufferingInfoType8+

缓存事件类型枚举。

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

StateChangeReason9+

表示播放或录制实例状态机切换原因的枚举，伴随state一起上报。

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

AVPlayer9+

播放管理类，用于管理和播放媒体资源。在调用AVPlayer的方法前，需要先通过createAVPlayer()构建一个AVPlayer实例。

Audio/Video播放demo可参考：音频播放开发指导、视频播放开发指导。

属性

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

说明：

将资源句柄（fd）传递给媒体播放器之后，请不要通过该资源句柄做其他读写操作，包括但不限于将同一个资源句柄传递给多个媒体播放器。同一时间通过同一个资源句柄读写文件时存在竞争关系，将导致播放异常。

on('stateChange')9+

on(type: 'stateChange', callback: (state: AVPlayerState, reason: StateChangeReason) => void): void

监听播放状态机AVPlayerState切换的事件。

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

参数：

示例：

avPlayer.on('stateChange', async (state, reason) => {
  switch (state) {
    case 'idle':
      console.info('state idle called')
      break;
    case 'initialized':
      console.info('initialized prepared called')
      break;
    case 'prepared':
      console.info('state prepared called')
      break;
    case 'playing':
      console.info('state playing called')
      break;
    case 'paused':
      console.info('state paused called')
      break;
    case 'completed':
      console.info('state completed called')
      break;
    case 'stopped':
      console.info('state stopped called')
      break;
    case 'released':
      console.info('state released called')
      break;
    case 'error':
      console.info('state error called')
      break;
    default:
      console.info('unkown state :' + state)
      break;
  }
})

off('stateChange')9+

off(type: 'stateChange'): void

取消监听播放状态机AVPlayerState切换的事件。

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

参数：

示例：

avPlayer.off('stateChange')

on('error')9+

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

监听AVPlayer的错误事件，该事件仅用于错误提示，不需要用户停止播控动作。如果此时AVPlayerState也切至error状态，用户需要通过reset()或者release()退出播放操作。

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

参数：

AVPlayer回调的错误分类可以分为以下几种：

示例：

avPlayer.on('error', (error) => {
  console.error('error happened,and error message is :' + error.message)
  console.error('error happened,and error code is :' + error.code)
})

off('error')9+

off(type: 'error'): void

取消监听播放的错误事件。

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

参数：

示例：

avPlayer.off('error')

prepare9+

prepare(callback: AsyncCallback<void>): void

通过回调方式准备播放视频，需在stateChange事件成功触发至initialized状态后，才能调用。

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

参数：

错误码：

以下错误码的详细介绍请参见媒体错误码。

示例：

avPlayer.prepare((err) => {
  if (err == null) {
    console.info('prepare success');
  } else {
    console.error('prepare filed,error message is :' + err.message)
  }
})

prepare9+

prepare(): Promise<void>

通过Promise方式准备播放视频，需在stateChange事件成功触发至initialized状态后，才能调用。

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

返回值：

错误码：

以下错误码的详细介绍请参见媒体错误码。

示例：

avPlayer.prepare().then(() => {
  console.info('prepare success');
}, (err) => {
  console.error('prepare filed,error message is :' + err.message)
})

play9+

play(callback: AsyncCallback<void>): void

通过回调方式开始播放音视频资源，只能在prepared/paused/complete状态调用。

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

参数：

错误码：

以下错误码的详细介绍请参见媒体错误码。

示例：

avPlayer.play((err) => {
  if (err == null) {
    console.info('play success');
  } else {
    console.error('play filed,error message is :' + err.message)
  }
})

play9+

play(): Promise<void>

通过Promise方式开始播放音视频资源，只能在prepared/paused/complete状态调用。

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

返回值：

错误码：

以下错误码的详细介绍请参见媒体错误码

示例：

avPlayer.play().then(() => {
  console.info('play success');
}, (err) => {
  console.error('play filed,error message is :' + err.message)
})

pause9+

pause(callback: AsyncCallback<void>): void

通过回调方式暂停播放音视频资源，只能在playing状态调用。

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

参数：

错误码：

以下错误码的详细介绍请参见媒体错误码

示例：

avPlayer.pause((err) => {
  if (err == null) {
    console.info('pause success');
  } else {
    console.error('pause filed,error message is :' + err.message)
  }
})

pause9+

pause(): Promise<void>

通过Promise方式暂停播放音视频资源，只能在playing状态调用。

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

返回值：

错误码：

以下错误码的详细介绍请参见媒体错误码

示例：

avPlayer.pause().then(() => {
  console.info('pause success');
}, (err) => {
  console.error('pause filed,error message is :' + err.message)
})

stop9+

stop(callback: AsyncCallback<void>): void

通过回调方式停止播放音视频资源，只能在prepared/playing/paused/complete状态调用。

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

参数：

错误码：

以下错误码的详细介绍请参见媒体错误码

示例：

avPlayer.stop((err) => {
  if (err == null) {
    console.info('stop success');
  } else {
    console.error('stop filed,error message is :' + err.message)
  }
})

stop9+

stop(): Promise<void>

通过Promise方式停止播放音视频资源，只能在prepared/playing/paused/complete状态调用。

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

返回值：

错误码：

以下错误码的详细介绍请参见媒体错误码

示例：

avPlayer.stop().then(() => {
  console.info('stop success');
}, (err) => {
  console.error('stop filed,error message is :' + err.message)
})

reset9+

reset(callback: AsyncCallback<void>): void

通过回调方式重置播放，只能在initialized/prepared/playing/paused/complete/stopped/error状态调用。

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

参数：

错误码：

以下错误码的详细介绍请参见媒体错误码

示例：

avPlayer.reset((err) => {
  if (err == null) {
    console.info('reset success');
  } else {
    console.error('reset filed,error message is :' + err.message)
  }
})

reset9+

reset(): Promise<void>

通过Promise方式通过Promise方式重置播放，只能在initialized/prepared/playing/paused/complete/stopped/error状态调用。

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

返回值：

错误码：

以下错误码的详细介绍请参见媒体错误码

示例：

avPlayer.reset().then(() => {
  console.info('reset success');
}, (err) => {
  console.error('reset filed,error message is :' + err.message)
})

release9+

release(callback: AsyncCallback<void>): void

通过回调方式销毁播放资源，除released状态，都可以调用。

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

参数：

错误码：

以下错误码的详细介绍请参见媒体错误码

示例：

avPlayer.release((err) => {
  if (err == null) {
    console.info('reset success');
  } else {
    console.error('release filed,error message is :' + err.message)
  }
})

release9+

release(): Promise<void>

通过Promise方式通过Promise方式销毁播放，除released状态，都可以调用。

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

返回值：

错误码：

以下错误码的详细介绍请参见媒体错误码

示例：

avPlayer.release().then(() => {
  console.info('release success');
}, (err) => {
  console.error('release filed,error message is :' + err.message)
})

getTrackDescription9+

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

通过回调方式获取音视频轨道信息，可以在prepared/playing/paused状态调用。

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

参数：

错误码：

以下错误码的详细介绍请参见媒体错误码

示例：

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

avPlayer.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}`);
  }
});

getTrackDescription9+

getTrackDescription(): Promise<Array<MediaDescription>>

通过Promise方式获取音视频轨道信息，可以在prepared/playing/paused状态调用。

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

返回值：

错误码：

以下错误码的详细介绍请参见媒体错误码

示例：

let arrayDescription;

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

avPlayer.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]);
}

seek9+

seek(timeMs: number, mode?:SeekMode): void

跳转到指定播放位置，只能在prepared/playing/paused/complete状态调用，可以通过seekDone事件确认是否生效。

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

参数：

示例：

let seekTime = 1000
avPlayer.seek(seekTime, media.SeekMode.SEEK_PREV_SYNC)

on('seekDone')9+

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

监听seek生效的事件。

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

参数：

示例：

avPlayer.on('seekDone', (seekDoneTime:number) => {
  console.info('seekDone success,and seek time is:' + seekDoneTime)
})

off('seekDone')9+

off(type: 'seekDone'): void

取消监听seek生效的事件。

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

参数：

示例：

avPlayer.off('seekDone')

setSpeed9+

setSpeed(speed: PlaybackSpeed): void

设置倍速模式，只能在prepared/playing/paused/complete状态调用，可以通过speedDone事件确认是否生效。

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

参数：

示例：

avPlayer.setSpeed(media.PlaybackSpeed.SPEED_FORWARD_2_00_X)

on('speedDone')9+

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

监听setSpeed生效的事件

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

参数：

示例：

avPlayer.on('speedDone', (speed:number) => {
  console.info('speedDone success,and speed value is:' + speed)
})

off('speedDone')9+

off(type: 'speedDone'): void

取消监听setSpeed生效的事件。

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

参数：

示例：

avPlayer.off('speedDone')

setBitrate9+

setBitrate(bitrate: number): void

选择要播放的指定比特率，仅对HLS协议网络流有效，只能在prepared/playing/paused/complete状态调用，可以通过bitrateDone事件确认是否生效。

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

参数：

示例：

let bitrate = 96000
avPlayer.setBitrate(bitrate)

on('bitrateDone')9+

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

监听setBitrate生效的事件。

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

参数：

示例：

avPlayer.on('bitrateDone', (bitrate:number) => {
  console.info('bitrateDone success,and bitrate value is:' + bitrate)
})

off('bitrateDone')9+

off(type: 'bitrateDone'): void

取消监听setBitrate生效的事件。

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

参数：

示例：

avPlayer.off('bitrateDone')

on('availableBitrates')9+

on(type: 'availableBitrates', callback: (bitrates: Array<number>) => void): void

监听HLS协议流可用的比特率列表，只会在切换prepared状态后上报。

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

参数：

示例：

avPlayer.on('availableBitrates', (bitrates: Array<number>) => {
  console.info('availableBitrates success,and availableBitrates length is:' + bitrates.length)
})

off('availableBitrates')9+

off(type: 'availableBitrates'): void

取消监听HLS协议流可用的比特率列表。

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

参数：

示例：

avPlayer.off('availableBitrates')

setVolume9+

setVolume(volume: number): void

设置媒体播放音量，只能在prepared/playing/paused/complete状态调用，可以通过volumeChange事件确认是否生效。

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

参数：

示例：

let volume = 1.0
avPlayer.setVolume(volume)

on('volumeChange')9+

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

监听setVolume生效的事件。

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

参数：

示例：

avPlayer.on('volumeChange', (vol:number) => {
  console.info('volumeChange success,and new volume is :' + vol)
})

off('volumeChange')9+

off(type: 'volumeChange'): void

取消监听setVolume生效的事件。

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

参数：

示例：

avPlayer.off('volumeChange')

on('endOfStream')9+

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

监听资源播放至结尾的事件；如果用户设置loop=1，播放会跳转至开头重播；如果用户没有设置loop，会通过stateChange上报completed状态。

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

参数：

示例：

avPlayer.on('endOfStream', () => {
  console.info('endOfStream success')
})

off('endOfStream')9+

off(type: 'endOfStream'): void

取消监听资源播放至结尾的事件。

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

参数：

示例：

avPlayer.off('endOfStream')

on('timeUpdate')9+

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

监听资源播放当前时间，单位为毫秒（ms），用于刷新进度条当前位置，默认间隔1s时间上报，因用户操作(seek)产生的时间变化会立刻上报。

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

参数：

示例：

avPlayer.on('timeUpdate', (time:number) => {
  console.info('timeUpdate success,and new time is :' + time)
})

off('timeUpdate')9+

off(type: 'timeUpdate'): void

取消监听资源播放当前时间。

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

参数：

示例：

avPlayer.off('timeUpdate')

on('durationUpdate')9+

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

监听资源播放资源的时长，单位为毫秒（ms），用于刷新进度条长度，默认只在prepared上报一次，同时允许一些特殊码流刷新多次时长。

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

参数：

示例：

avPlayer.on('durationUpdate', (duration) => {
  console.info('durationUpdate success,new duration is :' + duration)
})

off('durationUpdate')9+

off(type: 'durationUpdate'): void

取消监听资源播放资源的时长。

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

参数：

示例：

avPlayer.off('durationUpdate')

on('bufferingUpdate')9+

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

订阅音视频缓存更新事件，仅网络播放支持该订阅事件。

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

参数：

示例：

avPlayer.on('bufferingUpdate', (infoType: media.BufferingInfoType, value: number) => {
  console.info('bufferingUpdate success,and infoType value is:' + infoType + ', value is :' + value)
})

off('bufferingUpdate')9+

off(type: 'bufferingUpdate'): void

取消监听音视频缓存更新事件。

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

参数：

示例：

avPlayer.off('bufferingUpdate')

on('startRenderFrame')9+

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

订阅视频播放开始首帧渲染的更新事件，仅视频播放支持该订阅事件，该事件仅代表播放服务将第一帧画面送显示模块，实际效果依赖显示服务渲染性能。

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

参数：

示例：

avPlayer.on('startRenderFrame', () => {
  console.info('startRenderFrame success')
})

off('startRenderFrame')9+

off(type: 'startRenderFrame'): void

取消监听视频播放开始首帧渲染的更新事件。

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

参数：

示例：

avPlayer.off('startRenderFrame')

on('videoSizeChange')9+

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

监听视频播放宽高变化事件，仅视频播放支持该订阅事件，默认只在prepread状态上报一次，但HLS协议码流会在切换分辨率时上报；

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

参数：

示例：

avPlayer.on('videoSizeChange', (width: number, height: number) => {
  console.info('videoSizeChange success,and width is:' + width + ', height is :' + height)
})

off('videoSizeChange')9+

off(type: 'videoSizeChange'): void

取消监听视频播放宽高变化事件。

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

参数：

示例：

avPlayer.off('videoSizeChange')

on('audioInterrupt')9+

on(type: 'audioInterrupt', callback: (info: audio.InterruptEvent) => void): void

监听音频焦点变化事件，多个音视频资源同时播放时，会根据音频焦点模型audio.InterruptMode触发此事件。

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

参数：

示例：

import audio from '@ohos.multimedia.audio';

avPlayer.on('audioInterrupt', (info: audio.InterruptEvent) => {
  console.info('audioInterrupt success,and InterruptEvent info is:' + info)
})

off('audioInterrupt')9+

off(type: 'audioInterrupt'): void

取消监听音频焦点变化事件。

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

参数：

示例：

avPlayer.off('audioInterrupt')

AVPlayerState9+

AVPlayer的状态机，可通过state属性主动获取当前状态，也可通过监听stateChange事件上报当前状态，状态机之间的切换规则，可参考使用AVPlayer开发音频播放功能。

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

AVFileDescriptor9+

音视频文件资源描述，一种特殊资源的播放方式，使用场景：应用中的音频资源被连续存储在同一个文件中，需要根据偏移量和长度进行播放。

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

SeekMode8+

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

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

PlaybackSpeed8+

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

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

VideoScaleType9+

枚举，视频缩放模式。

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

MediaDescription8+

通过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}`);
  }
});

AVRecorder9+

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

音视频录制demo可参考：使用AVRecorder开发音频录制功能

注意，使用相机进行视频录制时，需要与相机模块配合，当前相机模块仅对系统应用开放。

属性

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

prepare9+

prepare(config: AVRecorderConfig, callback: AsyncCallback<void>): void

异步方式进行音视频录制的参数设置。通过注册回调函数获取返回值。

需要权限： ohos.permission.MICROPHONE

不涉及音频录制时，可以不需要获取ohos.permission.MICROPHONE权限。

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

参数：

错误码：

以下错误码的详细介绍请参见媒体错误码。

示例：

// 配置参数以实际硬件设备支持的范围为准
let AVRecorderProfile = {
  audioBitrate : 48000,
  audioChannels : 2,
  audioCodec : media.CodecMimeType.AUDIO_AAC,
  audioSampleRate : 48000,
  fileFormat : media.ContainerFormatType.CFT_MPEG_4,
  videoBitrate : 2000000,
  videoCodec : media.CodecMimeType.VIDEO_AVC,
  videoFrameWidth : 640,
  videoFrameHeight : 480,
  videoFrameRate : 30
}
let AVRecorderConfig = {
  audioSourceType : media.AudioSourceType.AUDIO_SOURCE_TYPE_MIC,
  videoSourceType : media.VideoSourceType.VIDEO_SOURCE_TYPE_SURFACE_YUV,
  profile : AVRecorderProfile,
  url : 'fd://', // 文件需先由调用者创建，赋予读写权限，将文件fd传给此参数，eg.fd://45
  rotation : 0, // 合理值0、90、180、270，非合理值prepare接口将报错
  location : { latitude : 30, longitude : 130 }
}

avRecorder.prepare(AVRecorderConfig, (err) => {
  if (err == null) {
    console.info('prepare success');
  } else {
    console.error('prepare failed and error is ' + err.message);
  }
})

prepare9+

prepare(config: AVRecorderConfig): Promise<void>

异步方式进行音视频录制的参数设置。通过Promise获取返回值。

需要权限： ohos.permission.MICROPHONE

不涉及音频录制时，可以不需要获ohos.permission.MICROPHONE权限。

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

参数：

返回值：

错误码：

以下错误码的详细介绍请参见媒体错误码。

示例：

// 配置参数以实际硬件设备支持的范围为准
let AVRecorderProfile = {
  audioBitrate : 48000,
  audioChannels : 2,
  audioCodec : media.CodecMimeType.AUDIO_AAC,
  audioSampleRate : 48000,
  fileFormat : media.ContainerFormatType.CFT_MPEG_4,
  videoBitrate : 2000000,
  videoCodec : media.CodecMimeType.VIDEO_AVC,
  videoFrameWidth : 640,
  videoFrameHeight : 480,
  videoFrameRate : 30
}
let AVRecorderConfig = {
  audioSourceType : media.AudioSourceType.AUDIO_SOURCE_TYPE_MIC,
  videoSourceType : media.VideoSourceType.VIDEO_SOURCE_TYPE_SURFACE_YUV,
  profile : AVRecorderProfile,
  url : 'fd://',  // 文件需先由调用者创建，赋予读写权限，将文件fd传给此参数，eg.fd://45
  rotation : 0, // 合理值0、90、180、270，非合理值prepare接口报错
  location : { latitude : 30, longitude : 130 }
}

avRecorder.prepare(AVRecorderConfig).then(() => {
  console.info('prepare success');
}).catch((err) => {
  console.error('prepare failed and catch error is ' + err.message);
});

getInputSurface9+

getInputSurface(callback: AsyncCallback<string>): void

异步方式获得录制需要的surface。此surface提供给调用者，调用者从此surface中获取surfaceBuffer，填入相应的视频数据。

应当注意，填入的视频数据需要携带时间戳（单位ns）和buffersize。时间戳的起始时间请以系统启动时间为基准。

需在prepare()事件成功触发后，才能调用getInputSurface()方法。

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

参数：

错误码：

以下错误码的详细介绍请参见媒体错误码

示例：

let surfaceID = null; // 该surfaceID用于传递给相机接口创造videoOutput

avRecorder.getInputSurface((err, surfaceId) => {
  if (err == null) {
    console.info('getInputSurface success');
    surfaceID = surfaceId;
  } else {
    console.error('getInputSurface failed and error is ' + err.message);
  }
});

getInputSurface9+

getInputSurface(): Promise<string>

异步方式获得录制需要的surface。此surface提供给调用者，调用者从此surface中获取surfaceBuffer，填入相应的视频数据。

应当注意，填入的视频数据需要携带时间戳（单位ns）和buffersize。时间戳的起始时间请以系统启动时间为基准。

需在prepare()事件成功触发后，才能调用getInputSurface方法。

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

返回值：

错误码：

以下错误码的详细介绍请参见媒体错误码

示例：

let surfaceID = null; // 该surfaceID用于传递给相机接口创造videoOutput

avRecorder.getInputSurface().then((surfaceId) => {
  console.info('getInputSurface success');
  surfaceID = surfaceId;
}).catch((err) => {
  console.error('getInputSurface failed and catch error is ' + err.message);
});

start9+

start(callback: AsyncCallback<void>): void

异步方式开始视频录制。通过注册回调函数获取返回值。

纯音频录制需在prepare()事件成功触发后，才能调用start方法。纯视频录制，音视频录制需在getInputSurface()事件成功触发后，才能调用start方法。

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

参数：

错误码：

以下错误码的详细介绍请参见媒体错误码。

示例：

avRecorder.start((err) => {
  if (err == null) {
    console.info('start AVRecorder success');
  } else {
    console.error('start AVRecorder failed and error is ' + err.message);
  }
});

start9+

start(): Promise<void>

异步方式开始视频录制。通过Promise获取返回值。

纯音频录制需在prepare()事件成功触发后，才能调用start方法。纯视频录制，音视频录制需在getInputSurface()事件成功触发后，才能调用start方法。

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

返回值：

错误码：

以下错误码的详细介绍请参见媒体错误码。

示例：

avRecorder.start().then(() => {
  console.info('start AVRecorder success');
}).catch((err) => {
  console.error('start AVRecorder failed and catch error is ' + err.message);
});

pause9+

pause(callback: AsyncCallback<void>): void

异步方式暂停视频录制。通过注册回调函数获取返回值。

需要start()事件成功触发后，才能调用pause方法，可以通过调用resume()接口来恢复录制。

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

参数：

错误码：

以下错误码的详细介绍请参见媒体错误码。

示例：

avRecorder.pause((err) => {
  if (err == null) {
    console.info('pause AVRecorder success');
  } else {
    console.error('pause AVRecorder failed and error is ' + err.message);
  }
});

pause9+

pause(): Promise<void>

异步方式暂停视频录制。通过Promise获取返回值。

需要start()事件成功触发后，才能调用pause方法，可以通过调用resume()接口来恢复录制。

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

返回值：

错误码：

以下错误码的详细介绍请参见媒体错误码。

示例：

avRecorder.pause().then(() => {
  console.info('pause AVRecorder success');
}).catch((err) => {
  console.error('pause AVRecorder failed and catch error is ' + err.message);
});

resume9+

resume(callback: AsyncCallback<void>): void

异步方式恢复视频录制。通过注册回调函数获取返回值。

需要在pause()事件成功触发后，才能调用resume方法。

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

参数：

错误码：

以下错误码的详细介绍请参见媒体错误码。

示例：

avRecorder.resume((err) => {
  if (err == null) {
    console.info('resume AVRecorder success');
  } else {
    console.error('resume AVRecorder failed and error is ' + err.message);
  }
});

resume9+

resume(): Promise<void>

异步方式恢复视频录制。通过Promise获取返回值。

需要在pause()事件成功触发后，才能调用resume方法。

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

返回值：

错误码：

以下错误码的详细介绍请参见媒体错误码。

示例：

avRecorder.resume().then(() => {
  console.info('resume AVRecorder success');
}).catch((err) => {
  console.error('resume AVRecorder failed and catch error is ' + err.message);
});

stop9+

stop(callback: AsyncCallback<void>): void

异步方式停止视频录制。通过注册回调函数获取返回值。

需要在start()或pause()事件成功触发后，才能调用stop方法。

纯音频录制时，需要重新调用prepare()接口才能重新录制。纯视频录制，音视频录制时，需要重新调用prepare()和getInputSurface()接口才能重新录制。

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

参数：

错误码：

以下错误码的详细介绍请参见媒体错误码。

示例：

avRecorder.stop((err) => {
  if (err == null) {
    console.info('stop AVRecorder success');
  } else {
    console.error('stop AVRecorder failed and error is ' + err.message);
  }
});

stop9+

stop(): Promise<void>

异步方式停止视频录制。通过Promise获取返回值。

需要在start()或pause()事件成功触发后，才能调用stop方法。

纯音频录制时，需要重新调用prepare()接口才能重新录制。纯视频录制，音视频录制时，需要重新调用prepare()和getInputSurface()接口才能重新录制。

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

返回值：

错误码：

以下错误码的详细介绍请参见媒体错误码。

示例：

avRecorder.stop().then(() => {
  console.info('stop AVRecorder success');
}).catch((err) => {
  console.error('stop AVRecorder failed and catch error is ' + err.message);
});

reset9+

reset(callback: AsyncCallback<void>): void

异步方式重置音视频录制。通过注册回调函数获取返回值。

纯音频录制时，需要重新调用prepare()接口才能重新录制。纯视频录制，音视频录制时，需要重新调用prepare()和getInputSurface()接口才能重新录制。

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

参数：

错误码：

以下错误码的详细介绍请参见媒体错误码。

示例：

avRecorder.reset((err) => {
  if (err == null) {
    console.info('reset AVRecorder success');
  } else {
    console.error('reset AVRecorder failed and error is ' + err.message);
  }
});

reset9+

reset(): Promise<void>

异步方式重置音视频录制。通过Promise获取返回值。

纯音频录制时，需要重新调用prepare()接口才能重新录制。纯视频录制，音视频录制时，需要重新调用prepare()和getInputSurface()接口才能重新录制。

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

返回值：

错误码：

以下错误码的详细介绍请参见媒体错误码。

示例：

avRecorder.reset().then(() => {
  console.info('reset AVRecorder success');
}).catch((err) => {
  console.error('reset AVRecorder failed and catch error is ' + err.message);
});

release9+

release(callback: AsyncCallback<void>): void

异步方式释放音视频录制资源。通过注册回调函数获取返回值。

释放音视频录制资源之后，该AVRecorder实例不能再进行任何操作。

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

参数：

错误码：

以下错误码的详细介绍请参见媒体错误码。

示例：

avRecorder.release((err) => {
  if (err == null) {
    console.info('release AVRecorder success');
  } else {
    console.error('release AVRecorder failed and error is ' + err.message);
  }
});

release9+

release(): Promise<void>

异步方式释放音视频录制资源。通过Promise获取返回值。

释放音视频录制资源之后，该AVRecorder实例不能再进行任何操作。

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

返回值：

错误码：

以下错误码的详细介绍请参见媒体错误码。

示例：

avRecorder.release().then(() => {
  console.info('release AVRecorder success');
}).catch((err) => {
  console.error('release AVRecorder failed and catch error is ' + err.message);
});

on('stateChange')9+

on(type: 'stateChange', callback: (state: AVRecorderState, reason: StateChangeReason) => void): void

订阅录制状态机AVRecorderState切换的事件，当 AVRecorderState状态机发生变化时，会通过订阅的回调方法通知用户。用户只能订阅一个状态机切换事件的回调方法，当用户重复订阅时，以最后一次订阅的回调接口为准。

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

参数：

示例：

avRecorder.on('stateChange', async (state, reason) => {
  console.info('case state has changed, new state is :' + state + ',and new reason is : ' + reason);
});

off('stateChange')9+

off(type: 'stateChange'): void

取消订阅播放状态机AVRecorderState切换的事件。

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

参数：

示例：

avRecorder.off('stateChange');

on('error')9+

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

订阅AVRecorder的错误事件，该事件仅用于错误提示，不需要用户停止播控动作。如果此时AVRecorderState也切至error状态，用户需要通过reset()或者release()退出录制操作。

用户只能订阅一个错误事件的回调方法，当用户重复订阅时，以最后一次订阅的回调接口为准。

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

参数：

错误码：

以下错误码的详细介绍请参见媒体错误码。