tencent cloud

游戏多媒体引擎

产品动态
产品介绍
产品概述
优势特性
产品功能
应用场景
安全合规认证
新手指引
产品计费
免费额度
购买指南
SDK 下载指引
产品功能体验
基本功能演示
场景化 Demo 体验
控制台指南
用量查看
服务开通
快速入门
快速接入 SDK
快速接入 Sample Project
基础功能开发指南
鉴权密钥
实时语音角色设置
音质选择
进阶功能开发指南
服务端录制
万人范围语音
3D 音效
音效与伴奏
网络音频流转发路由
自定义消息通道
如何应对公司防火墙限制
语言参数参考列表
房间管理功能
客户端 API
Unity SDK
Unreal Engine SDK
Cocos2D SDK
Windows SDK
iOS SDK
Android SDK
macOS SDK
H5SDK
Electron SDK
Flutter SDK
SDK 版本升级指引
错误码
编译工具链文档
服务端 API
History
Introduction
API Category
Usage APIs
Recording APIs
Making API Requests
Voice Chat APIs
Application APIs
Data Types
Error Codes
常见问题
产品功能问题
问题解决指南
计费相关问题
Sample Project 使用问题
一般性问题
鉴权相关问题
实时语音进房失败问题
实时语音无声及音频问题
网络问题
语音转文本问题
工程导出问题
服务协议
服务等级协议
联系我们
词汇表
GME 政策
数据处理和安全协议
隐私协议

全量录制

PDF
聚焦模式
字号
最后更新时间: 2025-08-26 16:10:19
本文帮助您通过全量录制的方式快速接入 GME 服务端录制功能。

使用场景

GME 对实时语音流提供服务端录制能力,帮助开发者实现内容留存、内容管理、内容再生产等场景。全量录制:支持录制应用内全量语音房间按房间维度混流、按用户维度单流;自定义录制:支持录制用户指定房间按房间维度混流、按用户维度单流。录制后的音频文件将存储在您账号下的对象存储(COS)服务中。
本文仅针对全量录制的开发接入方法进行说明。若您需要对应用开启自定义录制,请参见 开发指南-自定义录制
注意:
使用 GME 服务端录制功能,录制过程将在 GME 产生录制服务费用。GME 国际站录制服务将从2023年4月1日起正式计费,详细计费信息将提前公示在 GME 购买指南
录制后的文件将存储在您的腾讯云账号下的对象存储(COS)服务中,将会根据您的存储量、存储时长、访问频次等具体使用方式产生对象存储(COS)账单。详细计费信息请参考COS计费说明

前提条件

已开通实时语音服务:可参见 服务开通指引
已开通服务端录制服务:目前服务端录制功能针对白名单用户提供,请联系我们开通白名单。
已接入GME SDK:包括核心接口和实时语音接口的接入,详情可参见 Native SDK 快速接入Unity SDK 快速接入Unreal SDK 快速接入

服务架构





功能说明

1. 录制范围

开启全量录制,将对所有实时语音房间进行录制。您可以配置仅录制房间混流,或仅录制用户单流,或同时录制单流和混流。

2. 录制机制

录制任务启动机制

第一个用户进房后触发录制任务启动。

录制任务终止机制

最后一个用户退房后触发录制任务终止。

录制任务分片机制

当单个音频文件时长达到两个小时,将自动进行音频文件分片。
当用户关麦,用户单流录制音频将自动分片,用户开麦后启动新的分片。
若录制中的任务异常中断,任务自动重连后将启动新的分片。

录制任务事件通知机制

录制任务事件通过回调机制通知到您配置的回调地址。当发生这些事件时,您会收到回调通知:录制开始录制停止录制文件上传完成。
关于回调信息的详情,请参见 录制回调说明

3. 存储位置

GME 服务端录制,录制完成后的音频文件将存储在您账号下的对象存储(COS)服务中的指定存储桶。存储桶地域由您指定,可选的地域列表请参见 对象存储地域说明

4. 录制文件格式

.mp3

5. 录制文件命名规则

用户单流录制文件: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。

接入步骤

步骤一:在控制台完成录制服务配置

开通/关闭录制服务

登录 GME 控制台,进入服务管理菜单,对希望启用录制服务的应用单击设置,进入应用详情页。在页面中对语音录制服务单击修改



将录制开关置为开启。首次开启录制服务时,GME 将会向您申请服务授权,以便于访问您的对象存储 COS 服务,您需要在弹窗页面需要同意授权后,才能正常开启服务端录制服务。




录音文件存储配置

进入应用详情页面,在页面中对语音录制服务单击修改,在录制文件存储桶单击绑定
绑定存储桶弹窗中,您可以绑定一个已有的 COS 存储桶(已有的存储桶需要您在 COS 控制台 先行创建),或新建一个存储桶。




录制事件回调配置(可选)

如果您希望接收录制服务的事件回调,可以配置回调地址。操作路径:进入应用详情页面,在页面中对语音录制服务单击修改,在回调地址单击修改,在弹窗中输入接收回调的 url 地址。目前仅针对录制任务完成状态推送事件回调消息。




录制范围配置

录制范围可选自定义录制或全量录制。您此时应选中全量,并在复选框中指定是否录制单流、是否录制混流。
完成上述配置后,单击保存,录制服务即可开启。若您不再需要使用录制服务,请及时在控制台将录制服务开关置为关闭, 避免产生预期之外的费用。

步骤二:接收录制任务回调(可选)

如果您在步骤一中配置了回调地址,则需要接收录制任务事件回调。

步骤三:查看/管理录制文件

一个录制任务结束后的数分钟内即可生成完成的音频文件。您需要登录您的 对象存储 COS 控制台 对录制文件进行查看和管理。

帮助和支持

本页内容是否解决了您的问题?

填写满意度调查问卷,共创更好文档体验。

文档反馈