tencent cloud

Feedback

Last updated: 2022-05-17 11:26:25

    Tencent Cloud CSS console provides the relay feature. If you cannot use your live streaming source to push or you want to use on-demand videos for live streaming, you can use the relay feature to quickly pull contents from an existing live streaming source or videos and then push them to the destination URL, with no need for live push.

    Prerequisites

    • You have activated CSS and logged in to the CSS console.
    • You have added a push domain name in the console.

    Limits

    • You can create up to 20 relay tasks.
    • The relay feature is charged based on the duration of relay tasks. For details, see Relay.
    • Relay only pulls and pushes contents. Please ensure that the contents have been authorized and comply with the laws and regulations for distribution. If the contents infringe relevant rights or violate regulations, CSS will suspend related features and reserve the right to take legal action.

    Creating a Task

    1. Go to CSS Toolkit > Relay, and click Create Task.
    2. Enter the basic information of the task:
      Configuration ItemDescription
      Task Description Provide a description of the task.
      Execution Time The default execution time is from the current time to 24 hours later. You can select a time range not longer than 7 days, and the start time cannot be later than 1 year from the current time.
      Suppose the current time is 2021-3-24 11:50:01.
      • You can select a time range between 2021-3-24 11:50:01 and 2022-3-30 11:50:01.
      • The end time cannot be later than 2022-3-30 11:50:01.
      Event Callback Notification Enter a callback URL for receiving relay task event notifications.
    3. Provide the content source information.
      • Region: Random (Chinese mainland), North China region (Beijing), East China (Shanghai), South China (Guangzhou), Southeast Asia (Singapore), Southeast Asia (Bangkok), Northeast Asia (Seoul), South Asia (Mumbai), Hong Kong
      • If you select Random (Chinese mainland), the system will assign a region that is nearby.
    4. For Content Type, you can select Live streaming or Custom video path.
      • Live streaming:
        • Enter a live streaming URL (only one is allowed).
        • If you select Enable backup, when the system fails to pull content from the primary source, it will automatically switch to the backup source. After the primary recovers, you need to manually switch back. Backup sources support only loop of a single video.
      • Custom video path:
        • You can enter multiple (max 30) source URLs.
        • Select Repeat to repeat the playback indefinitely or Specified to specify the number of times (1-100) to play the content.
          Note:

          • The system will stop the relay task either when the playback count reaches the specified value or when the task reaches its end time.
          • After modifying a task:
        • If you change only the playback count, after the new value is applied, the count will start from 2.
        • If you change both the source URL and playback count, after the new configuration takes effect (whether immediately or after the current playback ends), the count will start from 1.
        • If you change the destination URL, the playback count will be reset.
    5. Enter a destination URL for receiving the content.
      1. Click Address Generator to enter the URL generation page.
      2. Select an existing push domain name, enter the Appname, StreamName, and expiration time, and click Confirm to generate a push URL, which will be auto-filled as Destination Address.
        Note:

        Make sure the URL expiration time is later than the task end time. If you change the destination after the task starts, it will stop and restart.

    6. Click Save.

    Managing Tasks

    Viewing task details

    In the task list, find your task, and click its description/ID to view task details in the pop-up window.

    Note:

    You can click the buttons at the bottom of the pop-up window to edit the task, switch inputs, restart the task, or disable the task.

    Viewing task status

    In the task list, find your task, and click its description/ID to view its execution status in the pop-up window.

    Task StatusField ValueDescription
    Not started Inactive The task has not started yet.
    Valid Active The task has started and is executed as expected.
    Inactive The task has started but is not executed as expected.
    Disabled Inactive The task is disabled.
    Expired Inactive The task has expired.

    Modifying a task

    1. In the task list, find the task you want to modify, and click Edit.
    2. Modify the task information, and then click Save.
    • You cannot change the region or content type.
    • When modifying the task end time, make sure that the destination URL is valid until the task ends. Modifying the destination URL will cause the task to stop and restart.
    1. In the pop-up window, check the information before and after the change:
      • Suppose you modified the start time, end time, and playback count of a task. You would see the following information in the pop-up window:
      • If the source URLs for Custom video path are changed, you need to select whether to apply the change After the current video ends (default) or Now. After the changes take effect, relay will restart from the first source URL.
      • If Destination Address is changed, the system will remind you that after you click Confirm, the current relay task will stop and restart.
    2. After checking, click Confirm.

    Copying a task

    1. In the task list, find the relay task you want to copy, and click Copy. You will be directed to the task creation page.
    2. The information of the copied task will be auto-filled. You can modify it as needed.
    3. Click Save to create a new relay task.

    Restarting a task

    Restarting a task will not change its status. An ongoing task will be restarted from the beginning. Perform the following to restart a task:

    1. In the task list, find the relay task you want to restart, and click Restart.
    2. In the pop-up window, click Restart.

    Disabling a task

    If you disable a task, the task will stop. You can click Enable to start it again. Perform the following to disable a task:

    1. In the task list, find the relay task you want to disable, and click Disable.
    2. In the pop-up window, click Disable.

    Enabling a task

    If you enable a task, the task will start from the beginning. Perform the following to enable a task:

    1. In the task list, find the relay task you want to enable, and click Enable.
    2. In the pop-up window, click OK.

    Deleting a task

    Deleted tasks cannot be recovered. Perform the following to delete a task:

    1. In the task list, find the relay task you want to delete, and click Delete.
    2. In the pop-up window, click Delete.

    Batch operations

    You can delete, disable, and enable up to 10 relay tasks at a time.

    1. In the task list, select the relay tasks you want to delete, disable, or enable.

    2. Click Batch Operation, and select Delete, Disable, or Enable.

    3. In the pop-up window, confirm the information and click Delete, Disable, or Enable.

      Auto-Deleting Expired Tasks

    A task expires after its end time. If you have too many relay tasks, you may fail to create new ones. To avoid this, you can enable auto-delete for the system to delete expired tasks automatically at the specified time. Deleted tasks cannot be recovered.

    1. Go to CSS Toolkit > Relay, and click Set in the Expired area.
    2. Click to enable auto-delete.
    3. Specify a period (1-24 hours) to retain expired tasks before they are deleted.
    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