云函数 SCF + TRTC 实现混流录制

一、社交直播

在直播过程中，可以采取混流录制的方法将多流合成、旁路审核，从而降低审核的成本，并且根据国家的要求将混流之后录制文件存储，应对监管要求。

二、金融监管

在线开户，金融双录等场景中，以全局视角录制全部交易过程，并进行存档保留，满足后续服务或者监管要求。

三、其他

客户服务、投诉等场景，可以实时启动录制，录制服务过程与投诉内容，便于优化服务质量，排查投诉合理性，提升投诉处理效率。

四、业务流程

这里说明如何使用 API 网关集成云函数，将实时音视频 TRTC 房间的主播音视频进行混流录制，录制完毕后上传到 COS 存储，提供开箱即用、灵活便捷、可编程的直播录制能力。云函数默认提供 512MB 内存来存储录制文件，如果你需要更大的存储空间，可以选择使用 CFS 挂载能力。工作流程如下：

录制规则如下：

·最多只会录制6路音视频流。

·当房间低于6个人时，会自动混流后续加入的用户。当房间超过6个人时，只会录制最先进房的6个人。

·IsReserve 为 true 时，在用户退出房间后，该用户流仍然在混流任务中，混流任务中将以最后一帧画面和静音补全流。IsReserve 为 false 时，在用户退出房间后，该用户流将从混流任务中删除，如果后续有新用户进入，则以新用户的流加入混流中。

API 网关调用涉及的参数如下：

CosConfig 涉及的参数如下：

注意：说明：

停止录制的触发条件：

·TRTC 房间被销毁。当 TRTC 房间超过300s 没有主播，房间会自动销毁。

·主动调用移除用户接口，将录制观众移出房间。

·使用 RoomId 的用户停止录制，需要调用 移除用户 接口。

·使用 StrRoomId 的用户停止录制时，需要调用 移除用户（字符串房间号）接口。

停止录制后，函数返回数据格式如下：

注意：说明：

注意：如果配置了 Callback，停止结束后，云函数将以 POST 方式将返回数据传递给回调地址。

Files 数组中每一项为 JSON Object，如下：

五、创建云函数

1. 登录 Serverless 控制台，进入函数服务页面。

2. 在函数服务页面上方选择广州地域，并单击新建进入新建函数页面，根据页面相关信息提示进行配置。如下：

·创建方式：选择模板创建。

·模糊搜索：输入“TRTC”进行搜索，选择混流音视频录制。

单击模板中的查看详情，即可在弹出的“模板详情”窗口中查看相关信息，支持下载操作。

3. 单击下一步，根据页面相关信息提示进行配置。如下：

·函数名称：默认填充。

·异步执行：勾选以开启。开启后，函数将以异步执行模式响应事件，事件调用无需阻塞等待处理结果，事件将在被调用后进入异步执行状态。

·状态追踪：勾选以开启。开启后，针对异步执行的事件，将开始记录响应事件的实时状态，并提供事件的统计、查询及终止服务，产生的事件状态数据将为你保留3天。

·执行超时时间：可根据需要自行修改。

·运行角色：默认使用 SCF_ExecuteRole 作为运行角色，并授予 QcloudCOSFullAccess、QcloudCFSFullAccess 访问权限。

4. 配置 API 网关触发器，默认新建 API 服务，不开启集成响应。你也可以选择自定义创建，自定义创建时确保集成响应关闭。如下：


5. 单击完成即可完成函数创建和 API 网关触发器创建。

6. 如需使用 CFS 挂载能力，由于 CFS 只能私有网络访问，因此必须将云函数的 VPC 配置在与 CFS 在同一个私有网络下。如下：


注意：说明：

注意：启用 CFS，需要将环境变量 CFS_PATH 设置为本地目录，例如 /mnt/audio/。

六、创建 TRTC 应用

1. 登录实时音视频控制台，选择左侧导航栏中的开发辅助 > 快速跑通 Demo。

2. 填写 Demo 名称，单击创建完成应用创建。你可以根据自己的客户端选择模板试运行，例如 跑通 Demo(桌面浏览器)。


七、测试函数功能

1. 参考 跑通 Demo (桌面浏览器)，用户 user_00001与 user_00002进入一个 TRTC 房间。

2. 使用 Postman 构造 HTTP 请求。其中 roomId 为已创建 TRTC 应用的房间号，userId 为随机另一个用户 ID（必须唯一）。如下：

{ "SdkAppId": 1400000000, "RoomId": 43474, "UserId": "user_55952145", "Mode":"12", "UserSig": "eJwtzNEKgkAUBNB-2efQ3e3eUqG3tMCKJJEIIxxxxxxxxxxxxxxxhvmweLWzGlUxj0mLs1GXKVf3mgrq*GFUdUR0UQrAYWDyW6Y15cwTwDm4UkxF36iXpkq1joiSc9xxxxxxxxxxxxx-S*CZeOk9sHfnEhCwlUW*fE4oWusw3dULlJ7HoSJ2e6d9fM8Y98fxUAzWA__", "CosConfig": { "Region": "ap-shanghai", "Bucket": "test-123456789", "Path": "/trtc" }, "IsReserve":false, "Callback":"https:xxxxxxxx.com/post/xxx" }

如下：

3. 请求发送后会收到异步函数响应 “Async run task submitted”，此函数的 RequestId 会通过 HTTP 头部信息中的 x-scf-reqid 返回。如下：


4. 在云函数控制台 函数服务页面中，单击上述 创建云函数 步骤中创建的云函数名称，进入“函数详情”页面。

5. 在“函数详情”页面中选择日志查询页签，可以查看到打印出的录制日志信息。如下：


6. 切换至 实时音视频控制台，在“监控仪表盘”页面单击房间 ID，查看所有在房间中的用户，其中一个观众即为录制观众。如下：

7. 如需在录制过程中停止录制，可以调用 移出用户 或者 移出用户（字符串房间号） 将用户移出房间。