This topic describes how to use the URL generator.

Prerequisites

  • A streaming domain is added. For more information about how to add a streaming domain, see Add a domain name.
  • An ingest domain is added and bound to the streaming domain. This is required when you need to obtain the ingest URL. For more information about how to add an ingest domain and bind it to a streaming domain, see Add a domain name and Bind an ingest domain to a streaming domain.
    Note If you need only to upload third-party streaming URLs to the live center of ApsaraVideo Live for CDN acceleration, the ingest domain is not required.

  • A transcoding template is configured. This is required when you need to obtain the streaming URL for transcoded streams. For more information about how to configure a transcoding template, see Transcoding management.

Background information

  • The URL generator can be used to generate ingest URLs and streaming URLs. You can generate a streaming URL for original quality streams or transcoded streams. You must configure a transcoding template before you generate a streaming URL.
  • You can use the URL generator to generate a streaming URL for ApsaraVideo Player SDK or third-party software, such as Video Lan Client (VLC), to play streams. A streaming URL for transcoded streams can meet the requirements of various clients and network environments.
  • You can use the URL generator to generate an ingest URL for Push SDK or third-party software, such as Open Broadcaster Software (OBS), to ingest streams.

Procedure

  1. Log on to the ApsaraVideo Live console.
  2. In the left-side navigation pane, choose Tools > URL Generator.
  3. Set the parameters described in the following table.
    URL generator
    Parameter Description
    Streaming Domain Select a streaming domain from the Streaming Domain drop-down list.
    Authentication Type By default, Type A is used and the validity period is 30 minutes.
    Note For more information about how to change the validity period, see Configure URL signing.
    Ingest Domain
    • If an associated ingest domain exists, the ingest domain is automatically selected. If no associated ingest domain exists, you need to bind an ingest domain to the specified streaming domain.
    • If you need only to upload third-party streaming URLs to the live center of ApsaraVideo Live for CDN acceleration, leave this parameter empty.
    Application Name Enter the name of an application in the Application Name field.
    Note The name of an application can be up to 256 characters in length and can contain digits, letters, hyphens (-), underscores (_), and equal signs (=).
    Stream Name Enter the name of the stream in the Stream Name field.
    Note The name of the stream can be up to 256 characters in length and can contain digits, letters, hyphens (-), underscores (_), and equal signs (=).
    Transcoding Template Select the transcoding template that you have configured. If you do not specify this parameter, the default value is Original Quality.Transcoding Template
    Generate URLs Click Generate URLs to generate an ingest URL and a streaming URL.
    Note
    • ApsaraVideo Live determines whether a stream is unique based on the stream name instead of the application name. If you have specified a unique application name, you must also specify a unique stream name to ensure that the stream is unique.
    • If an ingest domain is bound to the specified streaming domain, an ingest URL is generated.
    • If you do not select a transcoding template, a streaming URL for the original stream is generated. If you select a transcoding template, a streaming URL for the transcoded stream is generated.