- Release Notes and Announcements
- Announcements
- Billing Content Adjustment for Cloud Streaming Services Standard Transcoding and Top Speed Codec Transcoding
- Announcement on the Price Adjustment of CSS Audio/Video Enhancement Feature
- Announcement on the Official Billing for CSS Standby Streams Feature
- CSS to Support H.265 8K and AV1 8K Transcoding
- CSS Adds Support for AV1 Codec and Audio/Video Enhancement
- Notice: CSS to Adjust Prices of Basic Services
- CSS to Adjust Pricing of Third-Party Relay
- Delayed Playback to Become Paid Feature
- Announcements
- User Guide
- Product Introduction
- Purchase Guide
- Pricing Overview
- Basic Services
- Value-Added Services
- Live Transcoding (Watermarking, Stream Mixing, subtitles)
- Live Audio and Video Enhancement
- Live Recording
- Time Shifting (New)
- Live Screencapture
- Live Stream Moderation
- Intelligent Porn Detection
- Live Video Caster
- Relay
- Overview of Basic Fees for Value-Added Features
- Delayed Playback
- Standby Streams
- Real-Time Log Shipping
- Prepaid plan
- Purchase Process
- Changing Billing Modes
- Refund Policy
- Viewing Bills
- Renewal
- Processing for Overdue Payments
- Billing FAQs
- Live Video Broadcasting (LVB)
- Live Event Broadcasting (LEB)
- Live Video Caster
- Console Guide
- Console Overview
- Overview
- Domain Management
- Adding Domain Names
- Push Domain Name Management
- Push Configuration
- Recording Configuration
- Time Shifting Configuration
- Screencapture and Porn Detection Configuration
- Watermark Configuration
- Callback Configuration
- Standby Stream Configuration
- Latency Control
- IP Blocklist/Allowlist Configuration
- Delayed Playback
- Moderation Configuration
- Remote Authentication Configuration
- Playback Domain Name Management
- Playback Configuration
- Playback Authentication Configuration
- Referer Configuration
- Template Configuration
- HTTPS Configuration
- Region Configuration
- Origin Server Configuration
- Bandwidth Cap Configuration
- IP Blocklist/Allowlist Configuration
- Blocking Playback by Protocol
- Latency Control
- HTTP Response Header Configuration
- Access control by region Configuration
- Remote Authentication Configuration
- Certificate Management
- Stream Management
- Package Management
- Feature Configuration
- Relay
- Billing Usage Statistics
- Monitoring
- Toolkit
- CAM-Based Access Control
- Feature Guide
- Push and Playback
- Features
- Live Streaming Security
- Global CSS Service
- Callback Notifications
- How to Receive Event Notification
- Stream Pushing Notification
- Recording Event Notification
- Recording Status Event Notification
- Screencapturing Event Notification
- Live Broadcasting Image Audit Event Notification
- Live Streaming Audio Auditing Service Event Notification
- Push Error Event Notifications
- Relay Event Notification
- User Guides for Common Third-Party Tools
- SDK Guide
- API Documentation
- History
- Introduction
- API Category
- Making API Requests
- Live Transcoding APIs
- Delayed Playback Management APIs
- Domain Name Management APIs
- Watermark Management APIs
- Certificate Management APIs
- Live Stream Mix APIs
- Stream Pulling APIs
- Recording Management APIs
- Time Shifting APIs
- Live Callback APIs
- Screencapturing and Porn Detection APIs
- Authentication Management APIs
- Monitoring Data Query APIs
- DescribeAllStreamPlayInfoList
- DescribeGroupProIspPlayInfoList
- DescribeHttpStatusInfoList
- DescribeLiveDomainPlayInfoList
- DescribeLiveStreamPushInfoList
- DescribeLiveTranscodeDetailInfo
- DescribePlayErrorCodeDetailInfoList
- DescribePlayErrorCodeSumInfoList
- DescribeProIspPlaySumInfoList
- DescribeProvinceIspPlayInfoList
- DescribeStreamDayPlayInfoList
- DescribeStreamPlayInfoList
- DescribeStreamPushInfoList
- DescribeTopClientIpSumInfoList
- DescribeVisitTopSumInfoList
- Billing Data Query APIs
- Live Stream Management APIs
- Data Types
- Error Codes
- Ops Guide
- Troubleshooting
- About Pushing
- Playing Method
- Live Streaming Quiz
- FAQs
- SLA
- CSS Policy
- Glossary
- Release Notes and Announcements
- Announcements
- Billing Content Adjustment for Cloud Streaming Services Standard Transcoding and Top Speed Codec Transcoding
- Announcement on the Price Adjustment of CSS Audio/Video Enhancement Feature
- Announcement on the Official Billing for CSS Standby Streams Feature
- CSS to Support H.265 8K and AV1 8K Transcoding
- CSS Adds Support for AV1 Codec and Audio/Video Enhancement
- Notice: CSS to Adjust Prices of Basic Services
- CSS to Adjust Pricing of Third-Party Relay
- Delayed Playback to Become Paid Feature
- Announcements
- User Guide
- Product Introduction
- Purchase Guide
- Pricing Overview
- Basic Services
- Value-Added Services
- Live Transcoding (Watermarking, Stream Mixing, subtitles)
- Live Audio and Video Enhancement
- Live Recording
- Time Shifting (New)
- Live Screencapture
- Live Stream Moderation
- Intelligent Porn Detection
- Live Video Caster
- Relay
- Overview of Basic Fees for Value-Added Features
- Delayed Playback
- Standby Streams
- Real-Time Log Shipping
- Prepaid plan
- Purchase Process
- Changing Billing Modes
- Refund Policy
- Viewing Bills
- Renewal
- Processing for Overdue Payments
- Billing FAQs
- Live Video Broadcasting (LVB)
- Live Event Broadcasting (LEB)
- Live Video Caster
- Console Guide
- Console Overview
- Overview
- Domain Management
- Adding Domain Names
- Push Domain Name Management
- Push Configuration
- Recording Configuration
- Time Shifting Configuration
- Screencapture and Porn Detection Configuration
- Watermark Configuration
- Callback Configuration
- Standby Stream Configuration
- Latency Control
- IP Blocklist/Allowlist Configuration
- Delayed Playback
- Moderation Configuration
- Remote Authentication Configuration
- Playback Domain Name Management
- Playback Configuration
- Playback Authentication Configuration
- Referer Configuration
- Template Configuration
- HTTPS Configuration
- Region Configuration
- Origin Server Configuration
- Bandwidth Cap Configuration
- IP Blocklist/Allowlist Configuration
- Blocking Playback by Protocol
- Latency Control
- HTTP Response Header Configuration
- Access control by region Configuration
- Remote Authentication Configuration
- Certificate Management
- Stream Management
- Package Management
- Feature Configuration
- Relay
- Billing Usage Statistics
- Monitoring
- Toolkit
- CAM-Based Access Control
- Feature Guide
- Push and Playback
- Features
- Live Streaming Security
- Global CSS Service
- Callback Notifications
- How to Receive Event Notification
- Stream Pushing Notification
- Recording Event Notification
- Recording Status Event Notification
- Screencapturing Event Notification
- Live Broadcasting Image Audit Event Notification
- Live Streaming Audio Auditing Service Event Notification
- Push Error Event Notifications
- Relay Event Notification
- User Guides for Common Third-Party Tools
- SDK Guide
- API Documentation
- History
- Introduction
- API Category
- Making API Requests
- Live Transcoding APIs
- Delayed Playback Management APIs
- Domain Name Management APIs
- Watermark Management APIs
- Certificate Management APIs
- Live Stream Mix APIs
- Stream Pulling APIs
- Recording Management APIs
- Time Shifting APIs
- Live Callback APIs
- Screencapturing and Porn Detection APIs
- Authentication Management APIs
- Monitoring Data Query APIs
- DescribeAllStreamPlayInfoList
- DescribeGroupProIspPlayInfoList
- DescribeHttpStatusInfoList
- DescribeLiveDomainPlayInfoList
- DescribeLiveStreamPushInfoList
- DescribeLiveTranscodeDetailInfo
- DescribePlayErrorCodeDetailInfoList
- DescribePlayErrorCodeSumInfoList
- DescribeProIspPlaySumInfoList
- DescribeProvinceIspPlayInfoList
- DescribeStreamDayPlayInfoList
- DescribeStreamPlayInfoList
- DescribeStreamPushInfoList
- DescribeTopClientIpSumInfoList
- DescribeVisitTopSumInfoList
- Billing Data Query APIs
- Live Stream Management APIs
- Data Types
- Error Codes
- Ops Guide
- Troubleshooting
- About Pushing
- Playing Method
- Live Streaming Quiz
- FAQs
- SLA
- CSS Policy
- Glossary
If an event configured in the template triggers a callback during live streaming, Tencent Cloud will send a request to the customer’s server which is responsible for the response. After passing the verification, the server will obtain a JSON packet of the callback.
Currently, the following events can trigger a notification during live streaming: stream push, stream interruption, recording, screencapture and porn detection.
Overall Process
Process Description:
1. The host configures event message notification URLs and features such as recording and screencapture in the console or by calling TencentCloud APIs.
2. The host pushes and stops the stream.
3. When an event occurs, a message will be sent to the customer backend via the event message notification service.
Event Message Notification Protocol
Network protocol
Request: HTTP POST request with a JSON packet. The specific packet content of each type of message is described later.
Response: HTTP status code = 200. The server ignores the specific content of the response packet. For protocol-friendliness, we recommend you add
JSON: {"code":0}`` to the response.Notification reliability
The event notification service has a retry mechanism. For the screencapture event, up to 5 retries will be made at an interval of 2 minutes. For the stream push, stream interruption, recording, and porn detection events, up to 12 retries will be made at an interval of 1 minute.
To prevent frequent retries from placing too much strain on your server and bandwidth, make sure response packets are returned as expected. A retry is triggered in the following cases:
No response packet is returned for a long time (at least 20 seconds).
The HTTP status code in the response is not
200.
How to Configure Event Callbacks
Note
CSS allows you to configure callback URLs separately for events of stream push, stream interruption, recording, screencapture and porn detection.
CSS console
1. Log in to the CSS console and click Feature Configuration > Live Stream Callback to create a callback template. For detailed directions, see Creating a Callback Template.
2. Click Domain Management, find the target push domain name, and click Manage > Template Configuration to bind it with the callback template. For detailed directions, see Callback Configuration.
Server APIs
1. Call the CreateLiveCallbackTemplate API to create a callback template and set the callback parameters.
2. Call the CreateLiveCallbackRule API to set the
DomainName (push domain name) and TemplateId (returned in step 1) parameters. Enter the AppName in the push and playback URLs to enable callback for specific live streams.Callback Parameters
After the template is successfully bound with the domain name, if an event configured in the template is triggered during the live streaming, Tencent Cloud will send a JSON packet containing the callback information to the customer’s server. The callback parameters are detailed as below:
Yes
No
Was this page helpful?