# 服务器音视频录制

# 简介

在音视频通话过程中,您可以开启音视频录制功能,菊风会将录制后的视频上传到开发者指定的七牛云存储。按照文档步骤实现服务器音视频录制功能。 您如果要使用阿里云存储,您可以通过发送邮件与我们取得联系:marketing@juphoon.com.cn。

# 前提条件

集成服务器音视频录制功能前,请确保您已经集成了基础的多方音视频通话功能。

WARNING

SDK 不支持模拟器运行,请使用真机。

# 功能说明

平台 功能描述
合流录制 支持将房间内所有用户的音视频合流录制
录制内容可选 房间内同时录制输出音频和视频两种文件
视频截图 支持房间内所有用户的音视频的截图
自定义布局 支持房间视频画面自定义布局

# 适用场景

应用行业 场景说明
社交直播 直播中录制精彩瞬间;直播后回放精彩内容
金融双录 业务办理过程中同步录音录像,符合业务监管要求
远程医疗 远程问诊过程中在线录制,完成线上问诊的同时能够有效避免医患纠纷
在线教育 同步进行课程录制,课后学生可回顾,家长可回放检查课程质量

# 集成步骤

# 设置录制参数

音视频录制的文件将由服务器上传到七牛云上,您需要设置录制参数以指定文件存储地址。

# 七牛云存储

通过下述步骤指定七牛云存储地址:

  1. 获取 七牛云 (opens new window) 存储信息:bucketNamesecretKeyaccessKey
  2. 调用 buildQiniuRecordParam (opens new window) 函数创建录制参数字符串。
  3. 将上述字符串赋值给 recordString (opens new window) 属性。
  4. 调用 join (opens new window) 加入频道。

示例:七牛云存储

// 设置七牛云存储
JCMediaChannel.JoinParam joinParam = new JCMediaChannel.JoinParam();
joinParam.record = new JCMediaChannel.RecordParam();
joinParam.record.recordString = JCMediaChannel.RecordParam.buildQiniuRecordParam(true, bucketName, secretKey, accessKey, "自定义文件名");
// 加入频道
mediaChannel.join("channelId",joinParam);

TIP

如果进行音频录制,需要将 buildQiniuRecordParam/buildAliossRecordParam 中的第一个参数 video 设置为 false。

# 获取录制状态

设置完录制参数后,开发者需要根据目前的录制状态来决定是否启音视频录制。调用 getRecordState (opens new window) 以获取当前的录制状态。

录制状态说明:

属性 说明
RECORD_STATE_NONE (opens new window) 无法进行视频录制。用户不在频道中或者加入频道时没有设置视频录制参数
RECORD_STATE_READY (opens new window) 可以开启视频录制。用户在加入频道时设置了录制参数,并且没有在录制视频
RECORD_STATE_RUNNING (opens new window) 视频录制中。用户在加入频道时设置了录制参数,并且正在视频录制中

# 开启/关闭音视频录制

调用 enableRecord (opens new window) 开启或关闭音视频录制。传入 true 表示开启音视频录制,false 表示关闭音视频录制。

示例:根据录制状态选择开启或关闭音视频录制

开启录制

public onMediaChannelPropertyChange(JCMediaChannel.PropChangeParam propChangeParam) {
// 根据音视频录制状态判断是否开启音视频录制
if (mediaChannel.getRecordState() == JCMediaChannel.RECORD_STATE_NONE) {
  // 无法进行音视频录制
} else if (mediaChannel.getRecordState() == JCMediaChannel.RECORD_STATE_READY) {
  // 可以开启音视频录制
  mediaChannel.enableRecord(true, null);
  }
}

关闭录制

if (mediaChannel.getRecordState() == JCMediaChannel.RECORD_STATE_RUNNING) {
  // 音视频录制中,可以关闭音视频录制
  mediaChannel.enableRecord(false, null);
}

TIP

在会议录制的过程中如果关闭了录制,后再次开启的时候需要重新设置录制文件的名称,否者录制的文件会被覆盖掉,方法如下。

JCMediaChannel.RecordParam recordParam = new JCMediaChannel.RecordParam();
  //七牛云
recordParam.recordString = JCMediaChannel.RecordParam.buildQiniuRecordParam(true, bucketName, secretKey, accessKey, "新自定义文件名");
  //开启录制
JCManager.getInstance().mediaChannel.enableRecord(true, recordParam);
最后更新时间: 2023/11/20 16:13:38