云函数 实时音视频 TRTC

一、在线教育

在一对一或一对多的小班课中，可以针对不同学生多维度进行录制：

·对于单一学生，可以录制学生的单独数据流合成相关数据，实现记录每个学生的精彩瞬间并推送给家长。

·对房间内数据进行定向录制，并生成回放，学生可以观看回放重复进行学习。

·为了方便用户反复观看视频、重复学习，录制的过程可以去除冗余数据。

二、客服中心

·智能客服场景支持单独录制用户的数据流，和识别相关接口进行合成后，可实现办卡及智能开户过程的信息核实。

·支持单独录制客服和用户的声音，自动识别关键字评估服务质量，对智能客服进行迭代训练。

·可以将服务过程的数据进行保存与归档。

三、社交

·仅录制房间需要录制的视频流，用作数据保存，以节省存储和混流的成本。

·录制房间指定的数据，调用审核接口进行审核，可为不同的用户设定不同的审核标准。

·可以将直播片段定向生成片段文件。

四、业务流程

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


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. 创建 TRTC 应用 并进入应用。

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

{ "SdkAppId": 1400000000, "RoomId": 43474, "UserId": "user_55952145", "Mode": "02", "UserSig": "eJwtzNEKgkAUBNB-2efQ3e3eUqG3tMCKJJEIIxxxxxxxxxxxxxxxhvmweLWzGlUxj0mLs1GXKVf3mgrq*GFUdUR0UQrAYWDyW6Y15cwTwDm4UkxF36iXpkq1joiSc9xxxxxxxxxxxxx-S*CZeOk9sHfnEhCwlUW*fE4oWusw3dULlJ7HoSJ2e6d9fM8Y98fxUAzWA__", "CosConfig": { "Region": "ap-shanghai", "Bucket": "test-123456789", "Path": "/trtc" }}

如下：


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

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

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


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


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