-

场景介绍

视频录制的主要工作是选择视频/音频来源后,录制并生成视频/音频文件。

接口说明

接口名 功能描述
Recorder() 创建 Recorder 实例。
setSource(Source source) 设置音视频源。
setAudioProperty(AudioProperty property) 设置音频属性。
setVideoProperty(VideoProperty property) 设置视频属性。
setStorageProperty(StorageProperty property) 设置音视频存储属性。
prepare() 准备录制资源。
start() 开始录制。
stop() 停止录制。
pause() 暂停录制。
resume() 恢复录制。
reset() 重置录制。
setRecorderLocation(float latitude, float longitude) 设置视频的经纬度。
setOutputFormat(int outputFormat) 设置输出文件格式。
getVideoSurface() 获取视频窗口。
setRecorderProfile(RecorderProfile profile) 设置媒体录制配置信息。
registerRecorderListener(IRecorderListener listener) 注册媒体录制回调。
release() 释放媒体录制资源。

开发步骤

  1. 调用 Recorder() 方法,创建 Recorder 实例。

  1. 调用 setOutputFormat(int outputFormat) 方法,设置录制文件存储格式。

  1. 构造数据源对象,并调用 Recorder 实例的 setSource(Source source) 方法,设置媒体源,代码示例如下:

   Recorder recorder = new Recorder();
   FileDescriptor fd = in.getFD();
   Source source = new Source(fd);
   source.setRecorderAudioSource(Recorder.AudioSource.DEFAULT);
   recorder.setSource(source);

  1. (可选)构造音频属性 AudioProperty 对象(不设置音频则是只录视频),并调用 Recorder 实例的 setAudioProperty(AudioProperty property) 方法,设置录制的音频属性,代码示例如下:

   final int AUDIO_NUM_CHANNELS_STEREO = 2;
   final int AUDIO_SAMPLE_RATE_HZ = 8000;
   AudioProperty audioProperty = new AudioProperty.Builder()
                       .setRecorderNumChannels(AUDIO_NUM_CHANNELS_STEREO)
                       .setRecorderSamplingRate(AUDIO_SAMPLE_RATE_HZ)
                       .setRecorderAudioEncoder(Recorder.AudioEncoder.DEFAULT)
                       .build();
   recorder.setAudioProperty(audioProperty);

  1. 构造存储属性 StorageProperty 对象,并调用 Recorder 实例的 setStorageProperty(StorageProperty property) 方法,设置录制的存储属性,代码示例如下:

   String path = "/path/audiotestRecord.mp4";
   StorageProperty storageProperty = new StorageProperty.Builder()
                       .setRecorderPath(path)
                       .setRecorderMaxDurationMs(-1) 
                       .setRecorderMaxFileSizeBytes(-1)
                       .build();
   recorder.setStorageProperty(storageProperty);

  1. (可选)构造视频属性 VideoProperty 对象,并调用 Recorder 实例的 setVideoProperty(VideoProperty property) 方法,设置录制的视频属性,代码示例如下:

   VideoProperty videoProperty = new VideoProperty.Builder()
                       .setRecorderVideoEncoder(Recorder.VideoEncoder.DEFAULT)
                       .setRecorderWidth(1080)
                       .setRecorderDegrees(0)
                       .setRecorderHeight(800)
                       .setRecorderBitRate(10000000)
                       .setRecorderRate(30)
                       .build();
   recorder.setVideoProperty(videoProperty);

  1. 调用 prepare(),准备录制。

  1. (可选)构造录制回调,首先构造对象 IRecorderListener,IRecorderListener 需要实现 onError(int what, int extra),实现录制过程收到错误信息时做相应的操作。下面的代码例子中录制异常时,打印了相关的日志信息,代码示例如下:

   IRecorderListener listener = new RecorderErrorAndInfoListener() {
       @Override
       public void onError(int what, int extra) {
           HiLog.error("EncodeWriteFileListener onError what:%{public}d, extra:%{public}d", what, extra);
       }
   }

  1. 调用 start() 方法,开始录制。

  1. (可选)调用 pause() 方法和 resume() 方法,可以实现暂停和恢复录制。

  1. 调用 stop() 方法停止录制。

  1. 录制结束后,调用 release() 释放资源。