Live Stream Callback

Last updated: 2022-01-13 10:36:38

    CSS supports callbacks. To use this feature, you need to create a callback template in the console, configure an address to receive callbacks for an event, and then bind the template with your push domain name. If the event configured in the template triggers a callback during live streaming, Tencent Cloud will send a request to your server, which is responsible for responding to the request. After successful verification, the server will obtain a JSON packet of the callback through the address configured for the event.
    This document describes how to create, modify and delete a callback template in the console.

    You can create a callback template in the following ways:

    Notes

    Creating Callback Template

    1. Log in to the CSS console.
    2. Select Event Center > Live Stream Callback in the left sidebar.
    3. Click Create Callback Template, fill in the information, select the types of callbacks you want to receive, enter the callback URLs, and click Save.
      Configuration ItemDescription
      Template Name Name of the callback template, which can contain up to 30 letters, digits, underscores (_), and hyphens (-).
      Template Description Description of the callback template, which can contain up to 100 letters, digits, underscores (_), and hyphens (-).
      Callback Key Custom callback key.
      It can contain up to 32 letters, digits, underscores (_), and hyphens (-). For details, see Event Message Notification Common Parameters.
      Push Callback Enter an address starting with `http`, `https`, etc. to receive push callbacks.
      Interruption Callback Enter an address starting with `http`, `https`, etc. to receive stream interruption callbacks.
      Recording Callback Enter an address starting with `http`, `https`, etc. to receive recording callbacks.
      Screencapture Callback Enter an address starting with `http`, `https`, etc. to receive screencapture callbacks.
      Porn Detection Callback Enter an address starting with `http`, `https`, etc. to receive porn detection callbacks.

    Modifying Callback Template

    1. Select Event Center > Live Stream Callback.
    2. Select the target callback template and click Edit to modify its information.
    3. After modification, click Save.

    Deleting Callback Template

    If a template is bound to a domain name, you need to unbind it before you can delete it. For detailed directions, see Unbinding Callback Template.

    1. Select Event Center > Live Stream Callback.
    2. Find the target callback template, and click Delete.
    3. In the pop-up, click Confirm.