本文帮助您通过全量录制的方式快速接入GME 服务端录制功能。
使用场景
GME 对实时语音流提供服务端录制能力，帮助开发者实现内容留存、内容管理、内容再生产等场景。
全量录制：支持录制应用内全量语音房间按房间维度混流、按用户维度单流。
自定义录制：支持录制用户指定房间按房间维度混流、按用户维度单流。录制后的音频文件将存储在您账号下的 对象存储(COS) 服务中。
注意：
使用 GME 服务端录制功能，录制过程将在 GME 产生录制服务费用。GME 录制服务将从2023年4月1日起正式计费，详细计费信息将提前公示在 GME 购买指南。
录制后的文件将存储在您的腾讯云账号下的对象存储(COS)服务中，将会根据您的存储量、存储时长、访问频次等具体使用方式产生对象存储(COS)账单。详细计费信息请参见 COS 计费说明。
前提条件
已开通实时语音服务：可参见 服务开通指引。
已开通服务端录制服务：目前服务端录制功能针对白名单用户提供，请 提交工单申请 开通白名单。
已接入 GME SDK：包括核心接口和实时语音接口的接入，详情可参见 Native SDK 快速接入、Unity SDK 快速接入、Unreal SDK 快速接入。
服务架构
功能说明
录制范围
开启全量录制，将对所有实时语音房间进行录制。您可以配置仅录制房间混流，或仅录制用户单流，或同时录制单流和混流。
录制机制
机制项 | 描述 |
录制任务启动机制 | 第一个用户进房后触发录制任务启动 |
录制任务终止机制 | 最后一个用户退房后触发录制任务终止 |
录制任务分片机制 | 当单个音频文件时长达到两个小时，将自动进行音频文件分片 当用户关麦，用户单流录制音频将自动分片，用户开麦后启动新的分片 若录制中的任务异常中断，任务自动重连后将启动新的分片 |
录制任务事件通知机制 | 录制任务事件通过回调机制通知到您配置的回调地址。当发生这些事件时，您会收到回调通知：录制开始、录制停止、录制文件上传完成 关于回调信息的详情，请参见 录制回调说明 |
存储位置
录制文件格式
文件格式以
.mp3 格式进行录制。录制文件命名规则
用户单流录制文件：
bizid_roomid_userid/${任务开始时间}_${id}_audio.mp3房间混流录制文件：
bizid_roomid/${taskid}_${任务开始时间}_${id}_audio.mp3参数说明：bizid: GME 应用 ID。可在 GME 控制台 获取
roomid: 语音房间 ID。是您在使用实时语音服务时定义并传入至 GME SDK
userid: 玩家 ID。是您在使用实时语音服务时定义并传入至 GME SDK
taskid: 录制任务 ID，由 GME 录制服务生成。每一个录制任务都具有一个独特的任务 ID
id: 针对一个录制任务的分片的序列号。序列号初始序号为0
接入步骤
1. 在控制台完成录制服务配置
2. 接收录制任务回调（可选）
3. 查看/管理录制文件
步骤1：在控制台完成录制服务配置
1. 开通/关闭录制服务
首次开启录制服务时，GME 将会向您申请服务授权，以便于访问您的对象存储 COS 服务，您需要在弹窗页面需要同意授权后，才能正常开启服务端录制服务。n
2. 录音文件存储配置
1. 进入应用详情页面，在页面中对语音录制服务单击 修改 ，在 录制文件存储桶 单击 绑定 。
2. 在 绑定存储桶弹窗中，您可以绑定一个已有的 COS 存储桶（已有的存储桶需要您在 COS 控制台 先行创建），或新建一个存储桶。n
3. 录制事件回调配置（可选）
如果您希望接收录制服务的事件回调，可以配置回调地址。操作路径：进入应用详情页面，在页面中对语音录制服务单击 修改 ，在 回调地址 单击 修改 ，在弹窗中输入接收回调的 URL 地址。目前仅针对录制任务完成状态推送事件回调消息。n
4. 录制范围配置
录制范围可选自定义录制或全量录制。您此时应选中全量，并在复选框中指定是否录制单流、是否录制混流。完成上述配置后，单击 保存，录制服务即可开启。若您不再需要使用录制服务，请及时在控制台将录制服务开关置为 关闭， 避免产生预期之外的费用。
步骤2：接收录制任务回调（可选）
步骤3：查看/管理录制文件