云端录制
更新时间: 2024/05/27 14:49:44
为满足用户在会议过程录制和备案等需求,NERoom 提供云端录制功能,支持会议过程的录制。
通过云端录制功能,您可以将会议视频的内容录制并储存下来,以便后续提供给更多人观看回放或存档。
前提条件
-
已开通 NERoom 房间组件、IM 套餐包、聊天室和音视频通话 2.0。
-
建议开启消息抄送服务,接收云端录制事件的相关回调。
实现步骤
-
调用如下接口添加云端录制状态的监听。
fun addRoomListener(listener: NERoomListener) fun onRoomCloudRecordStateChanged(state: NERoomCloudRecordState, operateBy: NERoomMember?)
名称 类型 描述 state NERoomCloudRecordState 云端录制状态,RecordingStart 表示云端录制中;RecordingStop 表示未在云端录制。 operateBy NERoomMember 修改云端录制状态的操作者 示例代码如下:
currentRoomContext.addRoomListener( new NERoomListenerAdapter() { override fun onRoomCloudRecordStateChanged( state: NERoomCloudRecordState, operateBy: NERoomMember? ) { var isCloudRecording = state == NERoomCloudRecordState.RECORDING_START Log.d(TAG,"" + isCloudRecording + operateBy.toString()); } )
-
在初始化之后,加入房间前,通过
NERoomRtcController.setParameters
设置开启云端录制功能。客户端的录制参数用于指定本端参与的录制模式。可设置的录制参数如下:
参数 说明 KEY_SERVER_RECORD_AUDIO 是否开启云端音频录制。默认为 false,即关闭音频录制 示例代码如下:
// KEY_SERVER_RECORD_AUDIO const NERtcParameterKey<bool> // 是否开启云端音频录制。默认为 false,即关闭音频录制 currentRoomContext?.rtcController.setParameters("KEY_SERVER_RECORD_AUDIO", true)
-
调用
joinRoom
接口加入房间。示例代码如下:
NERoomService roomService = NERoomKit.getInstance().getService(NERoomService.class); String roomUuid="123"; String userName="userName"; String role="host";//从模板获取角色名称,比如PK直播的场景中的角色名为:host,invited_host,audience String password = "password"; //设置为null,表示没有密码 Map<String,String> initialProperties = new HashMap<String,String>(); initialProperties.put("custom-property-key0", "custom-property-value0"); initialProperties.put("custom-property-key1", "custom-property-value1"); roomService.joinRoom(new NEJoinRoomParams(roomUuid, userName, role, password, initialProperties), new NEJoinRoomOptions(), new NECallback2<NERoomContext>() { @Override public void onSuccess(@Nullable NERoomContext neRoomContext) { super.onSuccess(neRoomContext); Log.d(TAG,"success"); } @Override public void onError(int code, @Nullable String message) { super.onError(code, message); Log.d(TAG,"error"); } });
-
参与者调用
startCloudRecord
方法开始录制。触发
onRoomCloudRecordStateChanged
回调。事件中包含state
(云端录制状态)和operateBy
(状态变更操作者信息)。示例代码如下:
/// 参考joinRoom示例代码,调用joinRoom后获取NERoomContext neRoomContext对象 /// 调用startCloudRecord,成功触发onSuccess回调,失败则触发onError回调 neRoomContext.startCloudRecord(new NECallback2<Unit>() { @Override public void onSuccess(@Nullable Unit data) { super.onSuccess(data); } @Override public void onError(int code, @Nullable String message) { super.onError(code, message); } });
-
参与者调用
stopCloudRecord
方法停止录制。所有录制的参与者均关闭音频和视频开关或退出房间时自动关闭录制。
示例代码如下:
/// 调用stopCloudRecord,同上 neRoomContext.stopCloudRecord(new NECallback2<Unit>() { @Override public void onSuccess(@Nullable Unit data) { super.onSuccess(data); } @Override public void onError(int code, @Nullable String message) { super.onError(code, message); } });
-
参与者可以可以调用
getRoomCloudRecordList
方法获取指定房间中的录制文件列表。获取的单个视频文件信息,包括:视频 ID、视频名称、各个视频格式的播放地址、各个视频格式的下载地址、各个视频格式的视频大小、视频截图地址、视频所属分类 ID 和名称、视频播放时长和视频转码完成时间。
示例代码如下:
NERoomService roomService = NERoomKit.getInstance().getService(NERoomService.class); /// 这里roomArchiveId为房间归档id,可以从joinRoomResult.room.roomArchiveId获取,或从业务服务器接口获取 roomService.getRoomCloudRecordList(roomArchiveId, new NECallback2<List<NERoomRecord>>() { @Override public void onSuccess(@Nullable List<NERoomRecord> data) { super.onSuccess(data); } @Override public void onError(int code, @Nullable String message) { super.onError(code, message); } });
此文档是否对你有帮助?