제품 개요
하위 제품 소개
기본 개념
제품 기능
응용 시나리오
제품 장점
사용 제한
스트림 푸시 중단 이벤트 알림
스트림 푸시 및 중단 콜백은 라이브 방송 푸시 성공이나 중단을 포함한 라이브 방송 푸시 스트림 상태 정보 푸시에 사용됩니다. 사용자는 콜백 템플릿에서 스트림 푸시 콜백과 스트림 중단 콜백 메시지를 수신할 서버 주소를 설정하고, 해당 템플릿을 푸시 도메인과 연결해야 합니다. 해당 푸시 스트림 주소를 생성하고 라이브 방송 스트림을 시작하면, 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 백엔드인지 확인할 수 있습니다. |
콜백 메시지 매개변수
필드 이름 | 유형 | 설명 |
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}
피드백