ApsaraVideo Live:Live Stream Encapsulation

1. Log on to the ApsaraVideo Live console.

2. In the left-side navigation pane, click Feature Management > Live Stream Encapsulation .

3. Click on the streaming domain name you want to configure, then select Add.

   

   The table below describes the parameters you can configure.

   Parameter	Description
   AppName	The name must be the same as the application name that is specified in the ingest URL. Otherwise, the encapsulation settings do not take effect. The name can be up to 256 characters in length and can contain digits, letters, hyphens (-), and underscores (_). You can also set this parameter to an asterisk (*) to specify any string, including an empty string.
   StreamName	The name must be the same as the stream name that is specified in the ingest URL. Otherwise, the encapsulation settings do not take effect. The name can be up to 256 characters in length and can contain digits, letters, hyphens (-), and underscores (_). You can also set this parameter to an asterisk (*), which indicates any string, including an empty string.
   Protocol Configuration	Select the protocol for encapsulation. Valid values: HLS - CMAF LL-HLS - CMAF LL-HLS - TS DASH - CMAF Note Only DASH is supported HLS & DASH - CMAF Note Both DASH and HLS are supported
   Number of Segments	Specify the number of segments. You can enter an integer from 3 to 5.
   Segment Length	Valid values if you set the Protocol parameter to HLS - CMAF, DASH - CMAF, or HLS & DASH - CMAF: integers from 1 to 10. Unit: seconds. Make sure that the segment length is an integer multiple of the GOP length. The GOP length must be a fixed value. We recommend that you set the GOP length to 5 seconds. Valid values if you set the Protocol parameter to LL-HLS - CMAF or LL-HLS - TS: integers from 1 to 2. Unit: seconds. Make sure that the segment length is an integer multiple of the GOP length. The GOP length must be a fixed value. We recommend that you set the GOP length to 1 second.
   Part Segment Length	This parameter is required only if you set the Protocol parameter to LL-HLS - CMAF or LL-HLS - TS. Valid values: integers from 200 to 1000. Unit: milliseconds. We recommend that you specify a value that is slightly larger than one-third of the segment length.
   Transcoded Stream	Valid values: Source Stream Only and Transcoded Stream Included.

   Note

   • If the time shifting feature is configured for a matched stream, the segment length and format set in the encapsulation settings will apply during time shifting of the stream.

   • If multi-bitrate transcoding is configured for a matched stream, the segment length and format set in the encapsulation settings will apply during multi-bitrate transcoding of the stream.

   • If the playback domain name's region is outside China (Singapore, Germany, Japan, or Indonesia), there may be a significant delay. After completing the configuration, it's recommended to test and verify if the results meet your expectations.

4. After configuring the parameters, click OK.

//Replace <> with actual values
DefaultProfile profile = DefaultProfile.getProfile("<regionId>", "<ALIBABA_CLOUD_ACCESS_KEY_ID>", "<ALIBABA_CLOUD_ACCESS_KEY_SECRET>");
IAcsClient client = new DefaultAcsClient(profile);
AddLivePackageConfigRequest addLivePackageConfigRequest = new AddLivePackageConfigRequest();
addLivePackageConfigRequest.setDomainName("<DomainName>");
//The name can be up to 256 characters in length and can contain digits, letters, hyphens (-), and underscores (_).
//You can also set this parameter to an asterisk (*) to specify any string, including an empty string.
addLivePackageConfigRequest.setAppName("<AppName>");
//The name can be up to 256 characters in length and can contain digits, letters, hyphens (-), and underscores (_).
//You can also set this parameter to an asterisk (*) to specify any string, including an empty string.
addLivePackageConfigRequest.setStreamName("<StreamName>");
//Live stream protocol and encapsulation format.
addLivePackageConfigRequest.setBizProtocol("<Protocol>");
//The number of M3U8 segments. You can enter an integer from 3 to 5.
addLivePackageConfigRequest.setSegmentNum(<3>);
//Segment length. Unit: seconds.
//Valid values if you set the Protocol parameter to LL-HLS: integers from 1 to 2. Unit: seconds. Make sure that the segment length is an integer multiple of the GOP length. The GOP length must be a fixed value. We recommend that you set the GOP length to 1 second.
//Valid values if you set the Protocol parameter to HLS or DASH: integers from 1 to 10. Unit: seconds. Make sure that the segment length is an integer multiple of the GOP length. The GOP length must be a fixed value. We recommend that you set the GOP length to 5 seconds.
addLivePackageConfigRequest.setSegmentDuration(<5>);
//Part segment length. This parameter takes effect only when you set the Protocol parameter to LL-HLS. Valid values: integers from 200 to 1000. Unit: milliseconds. We recommend that you specify a part length that is slightly more than one third of the segment length.
addLivePackageConfigRequest.setPartDuration(<350>);
//Whether to ignore transcoded streams. Default value: true.
addLivePackageConfigRequest.setIgnoreTranscode(<true>);
try {
      AddLivePackageConfigResponse addLivePackageConfigResponse = client.getAcsResponse(addLivePackageConfigRequest);
      System.out.println(new Gson().toJson(addLivePackageConfigResponse));
       // todo something.
 } catch (ServerException e) {
      // TODO Auto-generated catch block
      e.printStackTrace();
 } catch (ClientException e) {
      // TODO Auto-generated catch block
       e.printStackTrace();
 }