tencent cloud

文档反馈

全量录制

最后更新时间:2024-01-18 14:12:12
    本文帮助您通过全量录制的方式快速接入 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 控制台 对录制文件进行查看和管理。
    联系我们

    联系我们,为您的业务提供专属服务。

    技术支持

    如果你想寻求进一步的帮助,通过工单与我们进行联络。我们提供7x24的工单服务。

    7x24 电话支持