在使用云端录制时,你可能需要自定义录制文件名来方便查找。
你可以自定义录制文件的文件名,且提供可填充变量,但文件名的总长度不得超过 128 个字符,若超出,则超出部分被截断,且最后一位字符变为波浪号~。不同用户的文件名可以相同。
若你文件名设置为空,则文件名为默认值。默认值格式为 Task ID_RoomID_UserID_Type_StartTime_Duration,如:mytask123456789_myroom99991234_user223344_C_20190611073246073_3600.mp4。
若你设置了文件名,且文件名中包含可选填充变量,则文件名会输出可选填充变量的值。可选填充变量如下:
| 可选填充变量 | 描述 |
|---|---|
| TaskId | 云端录制任务 ID。 |
| RoomId | 房间的 ID,是房间的唯一标志 |
| UserId | 用户Id,表示这个流所属的用户。 |
| Type | 流的类型。输出值为 C 和 S。C 表示摄像头流,S 表示屏幕流。 |
| StartTime | 文件开始录制的 UTC 时间,单位为 ms。 |
| Duration | 录制文件时长,单位为 ms,长度固定为 6 个字符,如 000123。 |
如设置参数FileName=[recordfile_T={TaskId}_R={RoomId}_U={UserId_file}_Start={StartTime}_Time={Duration}],则用户1 文件名为recordfile_T=mytask123456789_R=myroom99991234_U=user223344_Start=20190611073246073_Time=3600.mp4,用户 2 的文件名为recordfile_T=mytask123456789_R=myroom99991234_U=user445566_Start=20190611073246073_Time=3600.mp4。
若你设置了文件名,但不包含可选填充变量,则文件名为你设置的字符串值。如你设置文件名参数为FileName=[recordfile_info1_info2_info3],则用户1&用户2文件名均为:recordfile_info1_info2_info3.mp4(用户1和用户2为两个独立录制文件,但文件名称相同)
若你文件名设置为空,则文件名为默认值。默认值格式为 Task ID_RoomID_StartTime_Duration,如:mytask123456789_myroom99991234_user223344_C_20190611073246073_3600.mp4。
若你设置了文件名,且文件名中包含可选填充变量,则文件名会输出可选填充变量的值。可选填充变量如下:
| 可选填充变量 | 描述 |
|---|---|
| TaskId | 云端录制任务 ID。 |
| RoomId | 房间的 ID,是房间的唯一标志 |
| StartTime | 文件开始录制的 UTC 时间,单位为 ms。 |
| Duration | 录制文件时长,单位为 ms,长度固定为 6 个字符,如 000123,若超过6位只会显示前 6 位。 |
如设置参数FileName=[recordfile_T={TaskId}_R={RoomId}],则合流文件名为:recordfile_T=mytask123456789_R=myroom99991234.mp4
若你设置了文件名,但不包含可选填充变量,则文件名为你设置的字符串值。如你设置文件名参数为FileName=[recordfile_info1_info2_info3],则合流文件名为:recordfile_info1_info2_info3.mp4。
中括号{ }指示可选填充变量,当中括号和可选填充变量 以{RoomId} 形式出现时,则为可选变量填充占位符,最后文件名会输出变量的值(不区分大小写);如用户对RoomId、userId等可选变量拼写错误,则视为普通文本。