tencent cloud

Cloud Streaming Services

신규 사용자 가이드
제품 소개
제품 개요
하위 제품 소개
기본 개념
제품 기능
응용 시나리오
제품 장점
사용 제한
구매 가이드
가격 리스트
기본 서비스
부가 서비스
선불 패키지
구매 프로세스
과금 변경
환불 정책
청구서 조회
연장 안내
연체시 서비스 중지 설명
과금 FAQ
LVB
개요
응용 시나리오
시작하기
SDK 연결 안내
LEB(초저지연 라이브 방송)
개요
LEB와 LVB의 차이점
응용 시나리오
시작하기
SDK 통합
콘솔 가이드
콘솔 소개
개요
Domain Management
스트리밍
리소스 패키지 관리
기능 설정
릴레이
사용량 과금
CAM 액세스 제어
기능 사례
Push and Playback
기능
Live Streaming Security
해외 라이브 방송
콜백 이벤트 정보 알림
자주 사용하는 3rd party 툴 가이드
SDK 사례
0. SDK 통합 가이드
2. 재생
3. 고급 기능
API문서
History
Introduction
API Category
Making API Requests
Live Pad APIs
Live Stream Mix APIs
Time Shifting APIs
Monitoring Data Query APIs
Billing Data Query APIs
Live Transcoding APIs
Delayed Playback Management APIs
Domain Name Management APIs
Watermark Management APIs
Certificate Management APIs
Stream Pulling APIs
Recording Management APIs
Live Callback APIs
Screencapturing and Porn Detection APIs
Authentication Management APIs
Live Stream Management APIs
Data Types
Error Codes
유지보수 가이드
비디오 랙 최적화(V2)
푸시 스트리밍 실패 문제 해결
재생 실패 문제 해결
라이브 방송 딜레이 문제 해결
풀 스트림 비디오 품질 저하 문제 해결
라이브 방송에 COS bucket 권한을 부여하여 화면 캡처 저장
장애 처리
라이브 방송 혼합 스트림 오류: InvalidParameter.OtherError
FAQs
라이브 방송 기본 관련
푸시 및 재생
라이브 방송 과금
라이브 방송 해외 관련
라이브 레코딩
클라우드 혼합 스트리밍 관련
도메인 설정 관련
Apple ATS 적용 관련
SLA
CSS Service Level Agreement
CSS 정책
개인 정보 보호 정책
데이터 처리 및 보안 계약
문서Cloud Streaming Services기능 사례콜백 이벤트 정보 알림화면 캡처 이벤트 알림

화면 캡처 이벤트 알림

PDF
포커스 모드
폰트 크기
마지막 업데이트 시간: 2025-11-14 15:41:21
라이브 방송 화면 캡처는 고정된 시간 간격으로 실시간 라이브 방송 스트리밍 화면을 캡처하여 생성된 이미지를 COS에 저장합니다. 그리고 화면 캡처 콜백은 주로 이미지 생성 시간, 이미지 크기, 경로 및 다운로드 가능한 주소 등 캡처 화면의 이미지 저장 정보를 푸시하는 데 사용됩니다. 콜백 템플릿에서 화면 캡처 콜백 메시지를 수신할 서버 주소를 설정하고, 해당 템플릿을 푸시 도메인과 연결해야 합니다. 라이브 방송 스트리밍에서 화면 캡처 이벤트가 트리거 될 경우, Tencent Cloud LVB 백엔드에서 화면 캡처 정보를 사용자가 설정한 수신용 서버로 콜백합니다.
본 문서에서는 화면 캡처 콜백 이벤트 발생 시 Tencent Cloud CSS가 사용자에게 전송하는 콜백 메시지 알림 필드에 대해 설명합니다.

주의 사항

Tencent Cloud CSS의 콜백 기능 설정 방법을 이해하신 후 본 문서를 읽으실 것을 권장합니다. 콜백 메시지를 수신하는 방법은 이벤트 알림 수신 방법을 참고 바랍니다.
화면 캡처 콜백 이벤트를 트리거한 후 얻은 화면 캡처 정보는 라이브 방송 음란물 감지, 라이브 방송 썸네일 등 다양한 시나리오에 사용할 수 있습니다.

화면 캡처 이벤트 매개변수 설명

이벤트 유형 매개변수

이벤트 유형
필드 값 설명
라이브 방송 화면 캡처
event_type = 200

콜백 공용 매개변수

필드 이름
유형
설명
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는 이벤트 센터 > 라이브 방송 콜백의 콜백 키로 주로 인증에 사용됩니다. 데이터 정보를 안전하게 보호하기 위해 입력을 권장합니다.




콜백 메시지 매개변수

필드 이름
유형
설명
app
string
푸시 도메인
appname
string
푸시 스트림 경로
stream_param
string
사용자 푸시 스트림 URL의 매개변수
stream_id
string
라이브 방송 스트림 이름
channel_id
string
동일 라이브 방송 스트림 이름
create_time
int64
화면 캡처 생성 UNIX 타임스탬프
file_size
int
화면 캡처 파일 크기, 바이트 단위
width
int
화면 캡처 너비, 화소 단위
height
int
화면 캡처 길이, 화소 단위
pic_url
string
화면 캡처 파일 경로 /path/name.jpg
pic_full_url
string
화면 캡처 다운로드 URL

콜백 메시지 예시

{
    "app":"test.app",

    "appname":"live",

    "channel_id":"your_channelid",

    "create_time":1622599925,

    "event_type":200,

    "file_size":30670,

    "height":720,

    "pic_full_url":"http://your.cos.region.myqcloud.com/channelid/channelid-screenshot-10-12-05-1280x720.jpg",

    "pic_url":"/channelid/channelid-screenshot-10-12-05-1280x720.jpg",

    "sign":"ca3e25e5dc17a6f9909a9ae7281e300d",

    "stream_id":"your_streamid",

    "stream_param":"txSecret=ca3e25e5dc17a6f9909a9ae7281e300d&txTime=60B83800",

    "t":1622600525,

    "width":1280
}

이전 주제: 녹화 이벤트 알림다음 주제: 음란물 감지 이벤트 알림

도움말 및 지원

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

피드백