1# 音视频录制开发指导 2 3 4## 使用场景 5 6音视频录制的主要功能是录制音视频，并根据设置的编码格式、采样率、码率等参数封装输出文件。 7 8 9## 接口说明 10 11音视频录制API接口如下，具体的API详见接口文档。 12 13 **表1** 音视频录制API接口 14 15| 类名 | 接口名 | 功能 | 16| -------- | -------- | -------- | 17| Recorder | int32_t SetVideoSource(VideoSourceType source, int32_t &sourceId) | 设置录制视频源 | 18| Recorder | int32_t SetVideoEncoder(int32_t sourceId, VideoCodecFormat encoder) | 设置录制的视频编码器类型 | 19| Recorder | int32_t SetVideoSize(int32_t sourceId, int32_t width, int32_t height) | 设置录制的视频宽和高 | 20| Recorder | int32_t SetVideoFrameRate(int32_t sourceId, int32_t frameRate) | 设置要录制的视频帧率 | 21| Recorder | int32_t SetVideoEncodingBitRate(int32_t sourceId, int32_t rate) | 设置录制视频编码的码率 | 22| Recorder | int32_t SetCaptureRate(int32_t sourceId, double fps) | 设置视频帧的捕获帧率 | 23| Recorder | std::shared_ptr<OHOS::Surface> GetSurface(int32_t sourceId); | 获取对应输入源的surface | 24| Recorder | int32_t SetAudioSource(AudioSourceType source, int32_t &sourceId) | 设置录制音频源 | 25| Recorder | int32_t SetAudioEncoder(int32_t sourceId, AudioCodecFormat encoder) | 设置录制的音频编码器类型 | 26| Recorder | int32_t SetAudioSampleRate(int32_t sourceId, int32_t rate) | 设置录制的音频采样率 | 27| Recorder | int32_t SetAudioChannels(int32_t sourceId, int32_t num) | 设置要录制的音频通道数 | 28| Recorder | int32_t SetAudioEncodingBitRate(int32_t sourceId, int32_t bitRate) | 设置录制音频编码的码率 | 29| Recorder | int32_t SetMaxDuration(int32_t duration) | 设置录制文件的最大时长 | 30| Recorder | int32_t SetOutputFormat(OutputFormatType format) | 设置输出文件格式 | 31| Recorder | int32_t SetOutputPath(const string &path); | 设置输出文件保存路径 | 32| Recorder | int32_t SetOutputFile(int32_t fd) | 设置输出文件的fd | 33| Recorder | int32_t SetNextOutputFile(int32_t fd); | 设置下一个输出文件的fd | 34| Recorder | int32_t SetMaxFileSize(int64_t size) | 设置录制会话的最大文件大小 | 35| Recorder | int32_t SetRecorderCallback(const std::shared_ptr<RecorderCallback> &callback) | 注册录制侦听器回调 | 36| Recorder | int32_t Prepare() | 准备录制 | 37| Recorder | int32_t Start() | 开始录制 | 38| Recorder | int32_t Pause() | 暂停录制 | 39| Recorder | int32_t Resume() | 恢复录制 | 40| Recorder | int32_t Stop(bool block) | 停止录制 | 41| Recorder | int32_t Reset(); | 重置录制 | 42| Recorder | int32_t Release() | 释放录制资源 | 43| Recorder | int32_t SetFileSplitDuration(FileSplitType type, int64_t timestamp, uint32_t duration) | 设置切分录像 | 44| Recorder | int32_t SetParameter(int32_t sourceId, const Format &format) | 设置录制的扩展参数 | 45 46 47## 约束与限制 48 49无。 50 51 52## 开发步骤 53 541. 创建Recorder实例。 55 56 ``` 57 Recorder *recorder = new Recorder(); 58 ``` 59 602. 设置Recorder参数，包括设置音视频源信息，音视频编码格式，采样率，码率，视频宽高等信息。 61 62 ``` 63 int32_t sampleRate = 48000; 64 int32_t channelCount = 1; 65 AudioCodecFormat audioFormat = AAC_LC; 66 AudioSourceType inputSource = AUDIO_MIC; 67 int32_t audioEncodingBitRate = sampleRate; 68 VideoSourceType source = VIDEO_SOURCE_SURFACE_ES; 69 int32_t frameRate = 30; 70 double fps = 30; 71 int32_t rate = 4096; 72 int32_t sourceId = 0; 73 int32_t audioSourceId = 0; 74 int32_t width = 1920; 75 int32_t height = 1080; 76 VideoCodecFormat encoder = H264; 77 recorder->SetVideoSource(source, sourceId ); // 设置视频源，获得sourceId 78 recorder->SetVideoEncoder(sourceId, encoder); // 设置视频编码格式 79 recorder->SetVideoSize(sourceId, width, height); // 设置视频宽高 80 recorder->SetVideoFrameRate(sourceId, frameRate); // 设置视频帧率 81 recorder->SetVideoEncodingBitRate(sourceId, rate); // 设置视频编码码率 82 recorder->SetCaptureRate(sourceId, fps); // 设置视频帧的捕获帧率 83 recorder->SetAudioSource(inputSource, audioSourceId); // 设置音频源，获得audioSourceId 84 recorder->SetAudioEncoder(audioSourceId, audioFormat); // 设置音频编码格式 85 recorder->SetAudioSampleRate(audioSourceId, sampleRate); // 设置音频采样率 86 recorder->SetAudioChannels(audioSourceId, channelCount); // 设置音频通道数 87 recorder->SetAudioEncodingBitRate(audioSourceId, audioEncodingBitRate); // 设置音频编码码率 88 ``` 89 903. 准备录制，Recorder进行录制前的准备工作。 91 92 ``` 93 recorder->Prepare(); // 准备录制 94 ``` 95 964. 开始录制，Recorder会根据设置的音频源和视频源进行录制。 97 98 ``` 99 recorder->Start(); // 开始录制 100 ``` 101 1025. 结束录制，释放资源。 103 104 ``` 105 recorder->Stop(); // 停止录制 106 recorder->Release(); // 释放录制资源 107 ``` 108