tencent cloud

Cloud Streaming Services

문서Cloud Streaming Services기능 사례콜백 이벤트 정보 알림스트림 푸시 중단 이벤트 알림

스트림 푸시 중단 이벤트 알림

PDF
포커스 모드
폰트 크기
마지막 업데이트 시간: 2025-11-14 15:41:20
스트림 푸시 및 중단 콜백은 라이브 방송 푸시 성공이나 중단을 포함한 라이브 방송 푸시 스트림 상태 정보 푸시에 사용됩니다. 사용자는 콜백 템플릿에서 스트림 푸시 콜백과 스트림 중단 콜백 메시지를 수신할 서버 주소를 설정하고, 해당 템플릿을 푸시 도메인과 연결해야 합니다. 해당 푸시 스트림 주소를 생성하고 라이브 방송 스트림을 시작하면, Tencent Cloud CSS 백그라운드가 푸시 스트림 결과를 사용자가 설정한 수신 서버로 콜백합니다.
본 문서에서는 스트림 푸시 및 중단 이벤트 발생 시 Tencent Cloud CSS가 사용자에게 전송하는 콜백 메시지 알림 필드에 대해 설명합니다.

주의 사항

Tencent Cloud CSS의 콜백 기능 설정 방법과 사용자가 콜백 메시지를 수신하는 방법을 숙지한 뒤 본 문서를 열람할 것을 권장합니다. 자세한 내용은 이벤트 알림 수신 방법을 참고하십시오.

스트림 푸시 및 중단 이벤트 매개변수 설명

이벤트 유형 매개변수

이벤트 유형
필드 값 설명
라이브 방송 푸시 스트림
event_type = 1
라이브 방송 스트림 중단
event_type = 0

콜백 공용 매개변수

필드 이름
유형
설명
t
int64
만료 시간, 이벤트 알림 서명 만료 UNIX 타임스탬프입니다.
Tencent Cloud 메시지 알림의 기본 만료 시간은 10분입니다. 메시지 알림의 t 값으로 지정된 시간이 만료되었을 경우, 해당 알림을 무효라고 판정할 수 있으며, 네트워크 리플레이 공격을 방지할 수 있습니다.
t의 형식은 10진법 UNIX 타임스탬프입니다. 즉, 1970년 01월 01일(UTC/GMT의 자정)부터 경과한 초 단위 수입니다.
sign
string
이벤트 알림 보안 서명은 sign = MD5(key + t)입니다.설명: Tencent Cloud는 암호화된 key와 t의 문자열을 연결하고, MD5 계산을 통해 sign 값을 얻은 후, 이를 알림 메시지에 입력합니다. 사용자의 백엔드 서버는 알림 메시지 수신 후 같은 계산법으로 sign이 정확한지 확인하고, 메시지 출처가 Tencent Cloud 백엔드인지 확인할 수 있습니다.
설명：
key는이벤트 센터>라이브 방송 콜백 의 콜백 키로 주로 인증에 사용됩니다. 데이터 정보를 안전하게 보호하기 위해 입력을 권장합니다.




콜백 메시지 매개변수

필드 이름
유형
설명
appid
int
사용자 APPID
app
string
푸시 도메인
appname
string
푸시 스트림 경로
stream_id
string
라이브 방송 스트림 이름
channel_id
string
동일 라이브 방송 스트림 이름
event_time
int64
이벤트 메시지가 생성하는 UNIX 타임스탬프
sequence
string
메시지 일련번호로, 푸시 스트림 이벤트 1회를 식별합니다. 1회의 푸시 스트림 이벤트는 동일한 일련번호의 스트림 푸시 및 중단 메시지를 생성합니다.
node
string
라이브 방송 액세스 포인트 IP
user_ip
string
사용자 푸시 스트림 IP
stream_param
string
사용자 푸시 스트림 URL의 매개변수
push_duration
string
스트림 중단 이벤트 알림 푸시 시간, 밀리초 단위
errcode
int
스트림 푸시 및 중단 에러 코드
errmsg
string
스트림 푸시 및 중단 에러 설명
set_id
int
중국 국내외 푸시 스트림 여부 판단. 1-6는 중국 국내, 7-200는 중국 국외
width
int
비디오 폭으로, 최초 푸시 스트림 콜백 시작 시 비디오 헤더 정보가 누락되어있으면 0임
height
int
비디오 높이로, 푸시 스트림 콜백 시작 시 비디오 헤더 정보가 누락되어있으면 0임

스트림 중단 원인

중단 원인에 대한 자세한 내용은 스트리밍 중단 기록을 참고하십시오.

콜백 메시지 예시

{
    "app":"test.domain.com",

    "appid":12345678,

    "appname":"live",

    "channel_id":"test_stream",

    "errcode":0,

    "errmsg":"ok",

    "event_time":1545115790,

    "event_type":1,

    "set_id":2,

    "node":"100.121.160.92",

    "sequence":"6674468118806626493",

    "stream_id":"test_stream",

    "stream_param":"stream_param=test",

    "user_ip":"119.29.94.245",

    "width": 0,

    "height": 0,

    "sign":"ca3e25e5dc17a6f9909a9ae7281e300d",

    "t":1545030873
}
이전 주제: 이벤트 알림 수신 방법다음 주제: 녹화 이벤트 알림

도움말 및 지원

문제 해결에 도움이 되었나요?

피드백