Legacy recorded files

In legacy individual recording, the recording service generates separate audio and video files for each user ID. The generated files can include M3U8, TS, and WebM files.

Naming conventionsCopy Anchor Link

Individual recordingCopy Anchor Link

The naming conventions for individual recordings are as follows:

• M3U8 file: <sid>_<cname>__uid_s_<uid>__uid_e_<type>.m3u8
• TS file: <sid>_<cname>__uid_s_<uid>__uid_e_<type>_<utc>.ts
• WebM file: <sid>_<cname>__uid_s_<uid>__uid_e_<type>_<utc>.webm

Where:

• <sid> is the recording ID.
• <cname> is the channel name.
• <uid> is the user ID.
• <type> is the file type (audio or video).
• <utc> is the UTC time when the slice file starts. The time zone is UTC+0, and the timestamp consists of the year, month, day, hour, minute, second, and millisecond. When utc is 20190611073246073, for example, the slice file starts at 07:32
  .073 a.m., June 11, 2019.

For example, in the file name:

sid713476478245_cnameagora__uid_s_123__uid_e_video_20190920125142485.ts

sid713476478245 is the recording ID, cnameagora is the channel name, 123 is the user ID, video is the file type, and the start time of the recording is 12:51

Individual audio non-transcoding recordingCopy Anchor Link

The naming conventions of individual audio non-transcoding recording are as follows:

• M3U8 file: <sid>_<cname>__uid_s_<uid>__uid_e_<type>.m3u8
• TS file: <sid>_<cname>__uid_s_<uid>__uid_e_<type>_<utc>.ts

Where:

• <sid> is the recording ID.
• <cname> is the channel name.
• <uid> is the user ID.
• <type> is the file type (audio).
• <utc> is the UTC time when the slice file starts. The time zone is UTC+0, and the timestamp consists of the year, month, day, hour, minute, second, and millisecond. When utc is 20190611073246073, for example, the slice file starts at 07:32
  .073 a.m., June 11, 2019.

SlicingCopy Anchor Link

This section describes when the recording service slices legacy individual recording files.

Video file slicingCopy Anchor Link

Slicing occurs when any of the following conditions is met:

• When an I frame appears and the slice file reaches 15 seconds.
• The codec changes.
• The width or height of the video changes.
• The video stream is interrupted.
• When you set the browser to use the H.264 codec for encoding, forced slicing occurs when the slice file reaches 5.5 minutes, or the file size is over 50 MB. After forced slicing, the first frame of the new slice file might not be an I frame, in which case the slice file cannot be decoded and played directly. For example, in the communication channel, sometimes only one I frame may appear in several hours. In such case, the first frame of the new slice file is probably not an I frame.

When you set the browser to use the VP8 codec, Agora Cloud Recording does not enforce file slicing.

Audio file slicingCopy Anchor Link

Slicing occurs when the slice file reaches 15 seconds.

Sample M3U8 filesCopy Anchor Link

The following samples show the M3U8 files that legacy individual recording generates for one user ID. For an explanation of the descriptive symbols in these files, see M3U8 file.

Sample M3U8 file for audioCopy Anchor Link

#EXTM3U
#EXT-X-VERSION:3
#EXT-X-MEDIA-SEQUENCE:0
#EXT-X-ALLOW-CACHE:YES
#EXT-X-TARGETDURATION:18
#EXT-X-DISCONTINUITY
#EXT-X-AGORA-TRACK-EVENT:EVENT=START,TRACK_TYPE=AUDIO,TIME=20190920125142289
#EXTINF:15.019000
sid713476478245_cnameagora__uid_s_123__uid_e_audio_20190920125142289.ts
#EXTINF:15.019000
sid713476478245_cnameagora__uid_s_123__uid_e_audio_20190920125157307.ts
#EXTINF:15.019000
sid713476478245_cnameagora__uid_s_123__uid_e_audio_20190920125212326.ts
#EXTINF:15.019000
sid713476478245_cnameagora__uid_s_123__uid_e_audio_20190920125227345.ts
#EXTINF:12.523000
sid713476478245_cnameagora__uid_s_123__uid_e_audio_20190920125242363.ts
#EXT-X-ENDLIST

Sample M3U8 file for videoCopy Anchor Link

#EXTM3U
#EXT-X-VERSION:3
#EXT-X-MEDIA-SEQUENCE:0
#EXT-X-ALLOW-CACHE:YES
#EXT-X-TARGETDURATION:34
#EXT-X-DISCONTINUITY
#EXT-X-AGORA-ROTATE:WIDTH=640,HEIGHT=480,ROTATE=0,TIME=20190920125142485
#EXT-X-AGORA-TRACK-EVENT:EVENT=START,TRACK_TYPE=VIDEO,TIME=20190920125142485
#EXTINF:6.332000
sid713476478245_cnameagora__uid_s_123__uid_e_video_20190920125142485.ts
#EXT-X-AGORA-ROTATE:WIDTH=1280,HEIGHT=720,ROTATE=0,TIME=20190920125149174
#EXT-X-DISCONTINUITY
#EXTINF:17.442000
sid713476478245_cnameagora__uid_s_123__uid_e_video_20190920125149174.ts
#EXT-X-DISCONTINUITY
#EXT-X-AGORA-ROTATE:WIDTH=640,HEIGHT=480,ROTATE=0,TIME=20190920125206616
#EXTINF:33.326000
sid713476478245_cnameagora__uid_s_123__uid_e_video_20190920125206616.ts
#EXT-X-DISCONTINUITY
#EXT-X-AGORA-ROTATE:WIDTH=1280,HEIGHT=720,ROTATE=0,TIME=20190920125239942
#EXTINF:14.815000
sid713476478245_cnameagora__uid_s_123__uid_e_video_20190920125239942.ts
#EXT-X-ENDLIST