Recording

1. Log on to the Intelligent Media Services console.

2. In the top-left corner, select the appropriate region.

3. In the left-side navigation pane, choose Real-time Media Processing> Template Management.

4. On the Recording tab, create a recording template.

   Parameter			Description
   Template name			Enter a name for the recording template.
   Storage rule	M3U8	Recording file name	The name of the M3U8 file. The naming convention is record/{JobId}/{EscapedStartTime}_{EscapedEndTime}.
   		TS slice name	The name of the TS slice. The naming convention is record/{JobId}/{UnixTimeStamp}_{Sequence}.
   		Single TS duration	The duration of a single slice, in seconds. The value must be an integer from 5 to 30.
   		Recording cycle	The recording cycle, in minutes. The value must be an integer from 15 to 360. If the live stream duration exceeds the specified recording cycle, a new file is generated.
   	FLV	Recording file name	The name of the FLV file. The naming convention is record/{JobId}/{EscapedStartTime}_{EscapedEndTime}.
   		Recording cycle	The recording cycle, in minutes. The value must be an integer from 15 to 360. If the live stream duration exceeds the specified recording cycle, a new file is generated.
   	MP4	Recording file name	The name of the MP4 file. The naming convention is record/{JobId}/{EscapedStartTime}_{EscapedEndTime}.
   		Recording cycle	The recording cycle, in minutes. The value must be an integer from 15 to 360. If the live stream duration exceeds the specified recording cycle, a new file is generated.

Call the CreateLiveRecordTemplate operation and set the Format parameter as needed to create a custom template.

1. Log on to the Intelligent Media Services console.

2. In the top-left corner, select the appropriate region.

3. In the left-side navigation pane, choose Real-time Media Processing> Task Management.

4. On the Recording tab, create a recording job.

   Parameter	Description
   Job name	Enter a name for the recording job.
   Storage location	Select a storage location for the recorded files. You can store them in Alibaba Cloud OSS or VOD. If no storage location is available, you must configure one. For more information, see Configure storage locations.
   Select template	Select a recording template.
   Live stream	Enter a valid live stream URL. Only the RTMP protocol is supported.
   Callback URL	Enter a callback URL. This URL is valid only for the current job. If you leave this parameter empty, the system uses the URL specified in your callback settings.

Call the SubmitLiveRecordJob operation to submit a real-time media recording job.

Query recording job details by receiving callbacks for Live Recording File Generation and Live Recording Status events. For more information, see Callback event overview.

Call the GetLiveRecordJob operation to query the details of a real-time media recording job.

1. Log on to the Intelligent Media Services console.

2. In the top-left corner, select the appropriate region.

3. In the left-side navigation pane, choose Real-time Media Processing> File Management.

4. On the Recording tab, find the recording job and click View Recorded Files in the Actions column to view the recorded files from the live stream.

Call the ListLiveRecordFiles operation to view the recorded files of a live stream. Call the DeleteLiveRecordFiles operation to delete recorded files.

To also delete recorded files stored in OSS, you must first grant the required permissions to Intelligent Media Services.

1. Log on to the RAM console.

2. Create a custom permission policy.

   1. In the left navigation bar, select Permissions > Policy.

   2. Click Create Policy.

   3. On the JSON tab, create the following policy.

      {
          "Version": "1",
          "Statement": [
              {
                  "Action": "oss:DeleteObject",
                  "Resource": "*",
                  "Effect": "Allow"
              }
          ]
      }

      Note

      Resource specifies the OSS storage path of the real-time recording files. The asterisk (*) indicates all files.

   4. Enter a policy name. We recommend that you name it AliyunICEMediaResourcesAccessRole. Click OK.

3. Find the AliyunICEDefaultRole role and grant permissions to it.

   1. In the left navigation bar, select Identities > Roles.

   2. In the search box, enter AliyunICEDefaultRole to find the role. If the role is not found, you have not yet activated Intelligent Media Services. You must activate the service first. For more information, see Activate Intelligent Media Services.

   3. In the Actions column for AliyunICEDefaultRole, click Add Permissions. For Permission Type, select Custom Policy. For Policy Name, enter the name of the custom policy from Step 2.

4. Click OK to complete the configuration.