tencent cloud

Feedback

Address Generator

Last updated: 2024-01-23 16:29:08
    The CSS console provides an address generator which you can use to quickly generate push/playback URLs. The main parts of a live streaming URL include a domain name (domain), an application name (AppName), a stream name (StreamName) and an authentication key (Key).
    
    After URLs are generated, you can select and copy the one you need or copy it by clicking the copy icon. You can also get the URL by scanning the QR code.

    Support and Limits

    If you need to generate multiple live streaming URLs, we recommend that you splice them as instructed in Splicing Live Streaming URLs.
    CSS provides a test domain name xxxx.livepush.myqcloud.com. You can use it to test push, but we do not recommend using it for business purposes.
    When playing a transcoded stream, the StreamName in the playback address should be suffixed with "_TranscodingTemplateName" to work. It is recommended not to include "_" in the StreamName. If the string after "_" is the same as the transcoding template name, the part after "_" will be recognized as the transcoding template name, which may cause the stream pulling to fail.
    You can get a URL generated by scanning the QR code with TCToolkit .
    The recent records of the address generator are stored in the local cache of a browser. Clearing the cache will also remove these records..

    Prerequisites

    You have logged in to the CSS console, and have added a push/playback domain name.

    Parameter Description

    Parameter
    Description
    URL Type
    You can choose from the following three address types for configuration:
    Push Address
    Playback Address
    Push and playback URLs
    Select Domain Name
    You can choose:
    Push Domain Name
    Playback Domain Name
    Select both Push Domain Name and Playback Domain Name
    AppName
    The application name, which is used to identify a streaming file path. Default value: `live`.Only letters, digits, and symbols are allowed.
    StreamName
    A custom stream name is a unique identifier for each live stream. It only supports English letters, numbers, and symbols. The length of the StreamName is limited to 255 characters.
    Type
    Default encryption type: MD5, alternative option: SHA256
    Expiration Time
    The actual expiration time of a playback URL is the specified time plus the validity period of the authentication key.
    The expiration time of a push URL is the specified time.
    Transcoding Template
    This option is only used when selecting the address type as Playback Address and choosing the domain name as Playback Domain Name.
    If you choose a Transcoding Template, the generated playback address will be for the transcoded live stream. If you need to play the original live stream, there is no need to select a transcoding template to generate the address.
    If you choose an Adaptive Bitrate Template, the generated playback address will be for the adaptive bitrate live stream. If you need to play the original live stream, there is no need to select a transcoding template to generate the address.

    Generating Push URLs

    Directions

    1. Log in to the CSS console and select Address Generator on the left sidebar.
    2. Select the address type as Push Address.
    3. Select the push domain name that you have added to Domain Management.
    4. Enter an AppName. It is live by default.
    5. Enter a StreamName, such as liveteststream.
    6. Select your Encryption Type.
    7. Select the expiration time of the URL, such as 2023-08-20 18:04:47.
    8. Click Generate Address.
    
    
    

    Push URL format

    CSS supports RTMP, WebRTC, SRT and RTMP over SRT for push. As a result, the push URLs generated will start with rtmp://, webrtc://, srt:// or rtmp://.
    
    
    
    

    Generating Playback URLs

    Directions

    1. Log in to the CSS console and select Address Generator on the left sidebar.
    2. Select the address type as Playback Address and choose the playback domain name that you have added to Domain Management.
    3. Enter an AppName. It is live by default.
    4. Enter a StreamName, such as liveteststream.
    5. Select your Encryption Type.
    6. Select the URL expiration time, such as 2023-08-20 19:13:09.
    7. Select an existing transcoding template (optional).
    8. Click Generate Address.
    
    
    

    Playback URL format

    If a transcoding template is used, the generated playback address will be for the transcoded live stream. The playback supports RTMP, FLV, HLS, and WebRTC protocols. You can generate playback addresses with prefixes such as rtmp://, http://, and webrtc:// using the address generator. Compared to the original live stream, you need to append "_TranscodingTemplateName" after the StreamName.
    Caution
    UDP playback URLs are for LEB. To learn about the billing of LEB, see Pricing Overview.
    
    
    

    Generate Push and Playback Address Group

    Directions

    1. Log in to the CSS console and select Address Generator on the left sidebar.
    2. Select the address type as Push and playback URLs.
    3. Select the Push Domain Name and Playback Domain Name that you have added to Domain Management.
    4. Enter an AppName. It is live by default.
    5. Enter a StreamName, such as liveteststream.
    6. Select your Encryption Type.
    7. Select the URL expiration time, such as 2023-08-20 20:11:49.
    8. Select an existing transcoding template (optional).
    9. Click Generate Address.
    
    
    

    Push and Playback Address Group Explanation

    Push Address
    Playback Address
    CSS supports RTMP, WebRTC, SRT and RTMP over SRT for push. As a result, the push URLs generated will start with rtmp://, webrtc://, srt:// or rtmp://.
    
    
    IIf a transcoding template is used, the generated playback address will be for the transcoded live stream. The playback supports RTMP, FLV, HLS, and WebRTC protocols. You can generate playback addresses with prefixes such as rtmp://, http://, and webrtc:// using the address generator. Compared to the original live stream, you need to append "_TranscodingTemplateName" after the StreamName.
    
    

    Adaptive bitrate URL format

    If you use an Adaptive Bitrate Template, the generated playback address will be for adaptive bitrate playback.
    This playback address supports HLS and WebRTC protocols. You can generate playback addresses with prefixes such as http:// and webrtc:// using the address generator.
    For adaptive bitrate pull addresses using the HLS protocol, the processing method is the same as that for regular transcoded addresses.
    For adaptive bitrate pull addresses using the WebRTC protocol, there is no need to append the transcoding template name after the StreamName. Instead, you need to append "&tabr_bitrates=AdaptiveBitrateSubTemplateNameList&tabr_start_bitrate=StartingPlaybackBitrateSubTemplateName&tabr_control=auto" after the original live stream URL. The adaptive bitrate sub-template names in the list should be arranged in descending order of bitrate, separated by commas..
    
    
    

    Custom Concatenation Explanation

    1. Log in to the CSS console and select Address Generator on the left sidebar.Click Splice manually to enter theCustom Concatenation Management page.
    
    
    
    2. In the pop-up Address Resolution Sample window, the examples are as follows:
    Stream Push
    Original stream playback
    Transcoded stream playback
    Adaptive bitrate playback
    Playback
    
    
    
    
    
    
    
    
    
    
    
    
    
    
    

    Recent Record Explanation

    Based on your business needs, you can view or delete the records of recently generated addresses. These records include push addresses, playback addresses, address groups, and other information.

    View Records

    1. Log in to the CSS console and select Address Generator on the left sidebar.Click History to enter the Recent Record Management page.
    
    
    
    2. Select the live address record information you want to view and click View.
    
    
    

    Delete Live Address Record

    If you need to delete a live address record, first select the address type you want to delete, and then click Delete on the right side of the page. Next, you will be redirected to the delete confirmation window; click Confirm again to delete the corresponding live address record.
    
    
    
    Caution:
    The URLs are automatically saved to the browser cache and will be deleted when you clear the cache
    
    
    
    
    Contact Us

    Contact our sales team or business advisors to help your business.

    Technical Support

    Open a ticket if you're looking for further assistance. Our Ticket is 7x24 avaliable.

    7x24 Phone Support