TRTC开启查找文件

小亮 2022-09-19 14:12 61414

查找录制文件

在开启录制功能以后,TRTC 系统中录制下来的文件就能在腾讯云点播服务中找到。您可以直接在云点播控制台手动查找,也可以由您的后台服务器使用 REST API 进行定时筛选:

方式一:在点播控制台手动查找

  1. 登录云点播控制台,在左侧导航栏选择【媒资管理】。
  2. 单击列表上方的【前缀搜索】,选择【前缀搜索】,在搜索框输入关键词,例如1400000123_1001_rexchang_main ,单击TRTC开启查找文件,将展示视频名称前缀相匹配的视频文件。
  3. 您可以根据创建时间筛选所需的目标文件。

方式二:通过点播 REST API 查找

腾讯云点播系统提供了一系列 REST API 来管理其上的音视频文件,您可以通过 搜索媒体信息 这个 REST API 来查询您在点播系统上的文件。您可以通过请求参数表中的 Text  参数进行模糊匹配,也可以根据 StreamId  参数进行精准查找。
REST 请求示例:

https://vod.tencentcloudapi.com/?Action=SearchMedia
&StreamId=stream1001
&Sort.Field=CreateTime
&Sort.Order=Desc
&<公共请求参数>

接收录制文件

除了 查找录制文件,您还可以通过配置回调地址,让腾讯云主动把新录制文件的消息推送给您的服务器。
房间里的最后一路音视频流退出后,腾讯云会结束录制并将文件转存到云点播平台,该过程大约默认需要30秒至2分钟(若您设置了续录时间为300秒,则等待时间将在默认基础上叠加300秒)。转存完成后,腾讯云会通过您在 设置录制回调 中设置的回调地址(HTTP/HTTPS)向您的服务器发送通知。

腾讯云会将录制和录制相关的事件都通过您设置的回调地址推送给您的服务器,回调消息示例如下图所示:

TRTC开启查找文件

您可以通过下表中的字段来确定当前回调是对应的哪一次通话(或直播):

序号 字段名 说明
1 event_type 消息类型,当 event_type 为100时,表示该回调消息为录制文件生成的消息。
2 stream_id 即直播 CDN 的 streamId,您可以在进房时通过设置 TRTCParams 中的streamId 字段指定(推荐),也可以在调用 TRTCCloud 的 startPublishing 接口时通过参数 streamId 来指定。
3 stream_param.userid 用户名的 Base64 编码。
4 stream_param.userdefinerecordid 自定义字段,您可以通过设置 TRTCParams 中的userDefineRecordId 字段指定。
5 video_url 录制文件的观看地址,可以用于点播回放

说明:

更多回调字段说明,请参见 云直播-录制事件通知

删除录制文件

腾讯云点播系统提供了一系列 REST API 来管理其上的音视频文件,您可以通过 删除媒体 API 删除某个指定的文件。
REST 请求示例:

[](javascript: void 0;)

https://vod.tencentcloudapi.com/?Action=DeleteMedia
&FileId=52858907988664150587
&<公共请求参数>

回放录制文件

在线教育等场景中,通常需要在直播结束后多次回放录制文件,以便充分利用教学资源。

选择文件格式(HLS)

设置录制格式 中选择文件格式为 HLS。
HLS 支持最长三十分钟的断点续录,可以做到“一场直播(或一堂课)只产生一个回放链接”,且 HLS 文件支持绝大多数浏览器在线播放,非常适合视频回放场景。

获取点播地址(video_url)

接收录制文件 时,可以获取回调消息中 video_url 字段,该字段为当前录制文件在腾讯云的点播地址。