tencent cloud

라이브 방송 녹화는 푸시 도메인에 바인딩된 녹화 템플릿에 따라 실시간으로 라이브 방송 스트리밍 화면을 녹화하고, 해당 녹화 파일을 VOD에 저장합니다. 녹화 콜백은 녹화 시작 시간, 종료 시간, 생성된 녹화 파일 ID, 녹화 파일 크기 및 파일 다운로드 주소 등을 포함한 녹화 파일 정보를 푸시하는 데 사용됩니다. 콜백 템플릿에서 녹화 콜백 메시지를 수신할 서버 주소를 설정하고, 해당 템플릿을 푸시 도메인과 연결해야 합니다. 라이브 방송 스트리밍이 녹화 이벤트를 트리거한 후, Tencent Cloud CSS 백그라운드는 녹화 파일 정보를 귀하가 설정한 수신용 서버로 콜백합니다.

본 문서는 녹화 콜백 이벤트 트리거 후, Tencent Cloud CSS가 사용자에게 발송하는 콜백 메시지 알림 필드를 설명합니다.

주의 사항

• Tencent Cloud CSS의 콜백 기능 설정 방법을 이해하신 후 본 문서를 읽으실 것을 권장합니다. 콜백 메시지를 수신하는 방법은 이벤트 알림 수신 방법을 참고 바랍니다.
• 녹화된 비디오 파일은 기본적으로 VOD 콘솔에 저장됩니다. 요금 연체로 인해 VOD 서비스가 정지되는 일이 없도록 사전에 VOD 서비스를 개통해두실 것을 권장합니다.
• API로 CreateRecordTask를 진행하는 경우, 녹화 콜백은 사용자 푸시 스트림 URL의 stream_param 매개변수를 반환하지 않으며 다른 녹화 방식은 반환됩니다.
• HLS 연속 녹화 기능을 설정하면 중간에 스트림이 끊겨도 콜백하지 않으며, 기본적으로 연속 녹화 후 최종 생성된 파일만 콜백합니다.

녹화 이벤트 매개변수 설명

이벤트 유형 매개변수

콜백 공용 매개변수

설명：

key는 **이벤트 센터>라이브 방송 콜백**의 콜백 키로 주로 인증에 사용됩니다. 데이터 정보를 안전하게 보호하기 위해 입력을 권장합니다.

콜백 메시지 매개변수

콜백 메시지 예시

{
    "event_type": 100,

    "appid": 12345678,
    
    "app": "yourapp",
    
    "callback_ext": "{\"video_codec\":\"h264\",\"resolution\":\"640x480\"}",
    
    "appname": "yourappname",
    
    "stream_id":"stream_test",
    
    "channel_id":"stream_test",
    
    "file_id":"1234567890",
    
    "record_file_id": "1234567890",
    
    "file_format":"hls",
    
    "task_id":"UpTbk5RSVhRQ********************0xTSlNTQltlRVRLU1JAWW9EUb",
    
    "start_time":1642089445,
    
    "end_time":1642089598,
    
    "start_time_usec": 316441,
    
    "end_time_usec": 618577,
    
    "duration":154,
    
    "file_size":277941079,
    
    "stream_param":"stream_param=test",
    
    "video_url":"http://12345678.vod2.myqcloud.com/xxxx/yyyy/zzzz.m3u8",
    
    "media_start_time": 135802,
    
    "record_bps": 0,
    
    "sign":"ca3e25e**********09a9ae7281e300d",
    
    "t":1545030873
}