Push Error Event Notifications

Last updated: 2024-09-09 17:34:21

Push error callbacks notify you of the details of push errors. You need to configure a callback address in the CSS console, and CSS will send push error callbacks to the server you configured.
This document describes the fields in a callback notification sent by CSS after a push error occurs.
Must-Knows
This guide assumes that you understand how to configure callbacks and receive callback notifications from CSS. For details, see How to Receive Event Notification.
Push Error Callback Parameters
Event type
Event Type
Parameter Value
Push errors
event_type = 321
Common callback parameters
Parameter
Type
Description
appid
int
The user’s App ID.
stream_id
string
The stream ID.
data_time
int
The callback time (ms).
report_interval
int
The reporting interval (ms) when a push error occurs.
abnormal_event
json
The push error details.
abnormal_event parameters
Parameter
Type
Description
type
int
The error type.
count
int
The number of times the error occurred between two reports (within the reporting interval).
detail
json
desc: The error description.
occur_time: The time when the error occurred.
type_desc_cn
string
The error description in Chinese.
type_desc_en
string
The error description in English.
Error types
Type
Description
1
The video timestamp moved backwards.
2
The audio timestamp moved backwards.
3
The video timestamp increased notably (by more than 1000 milliseconds).
4
The audio timestamp increased notably (by more than 1000 milliseconds).
5
Chunk size too big (bigger than 8,192).
6
Two consecutive video frames arrived late (by more than 3000 milliseconds).
7
Two consecutive audio frames arrived late (by more than 1000 milliseconds).
8
The video codec changed.
9
The audio codec changed.
10
No codec header before a video frame arrived.
11
No codec header before an audio frame arrived.
Note:
Currently, you cannot configure callbacks for a specific type of push error. A push error callback includes the information of all push errors that occurred during the reporting interval. If no push errors occur, no callbacks will be sent.
A push error callback only collects data for push errors in the current reporting cycle. The system will not handle the errors.
Sample callback
{
    "abnormal_event":[
        {
            "count":2,
            "detail":[
                {
                    "desc":"video frame arrive interval too long, interval=3046(msec)",
                    "occur_time":1670588070569
                },
                {
                    "desc":"video frame arrive interval too long, interval=2953(msec)",
                    "occur_time":1670588073522
                }
            ],
            "type":6,
            "type_desc_cn":" ",
            "type_desc_en":"video frame arrive interval bigger than 1000(ms)"
        },
        {
            "count":2,
            "detail":[
                {
                    "desc":"audio frame arrive interval too long, interval=3009(msec)",
                    "occur_time":1670588070532
                },
                {
                    "desc":"audio frame arrive interval too long, interval=2917(msec)",
                    "occur_time":1670588073486
                }
            ],
            "type":7,
            "type_desc_cn":" ",
            "type_desc_en":"audio frame arrive interval bigger than 1000(ms)"
        }
    ],
    "appid":0,
    "data_time":1670588074971,
    "domain":"xxxx.xxxxx.xxxx.xxxx",
    "event_type":321,
    "interface":"general_callback",
    "path":"xxxx",
    "report_interval":5000,
    "sequence":"000000000000000000",
    "stream_id":"xxxxxx",
    "stream_param":"txSecret=f5828cd4a8a09109304b060172fb3960&txTime=665982e4",
    "timeout":5000
}

tencent cloud

Recent Pages

Push Error Event Notifications

Must-Knows

Push Error Callback Parameters

Event type

Common callback parameters

`abnormal_event` parameters

Sample callback

Was this page helpful?

Was this page helpful?

Parameter	Type	Description
appid	int	The user’s App ID.
stream_id	string	The stream ID.
data_time	int	The callback time (ms).
report_interval	int	The reporting interval (ms) when a push error occurs.
abnormal_event	json	The push error details.

Type	Description
1	The video timestamp moved backwards.
2	The audio timestamp moved backwards.
3	The video timestamp increased notably (by more than 1000 milliseconds).
4	The audio timestamp increased notably (by more than 1000 milliseconds).
5	Chunk size too big (bigger than 8,192).
6	Two consecutive video frames arrived late (by more than 3000 milliseconds).
7	Two consecutive audio frames arrived late (by more than 1000 milliseconds).
8	The video codec changed.
9	The audio codec changed.
10	No codec header before a video frame arrived.
11	No codec header before an audio frame arrived.

tencent cloud

Sign Up

Log in

Recent Pages

Push Error Event Notifications

Must-Knows

Push Error Callback Parameters

Event type

Common callback parameters

abnormal_event parameters

Sample callback

Was this page helpful?

Was this page helpful?

`abnormal_event` parameters