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:20
CSS 서비스는 라이브 방송 혼합 스트림 기능을 제공하며, 설정한 혼합 스트림 레이아웃 동기화에 따라 각 입력 원본 혼합 스트림을 새로운 스트리밍으로 만들어 라이브 방송 인터랙션 효과를 구현합니다. 또한 CSS 라이브 방송 혼합 스트림 기능은 API 3.0 인터페이스와도 연결할 수 있습니다. 자세한 내용은 라이브 방송 혼합 스트림 인터페이스를 참고하십시오. 본 문서에서는 각 시나리오에서 라이브 방송 혼합 스트림을 구현하는 방법에 대해 예시와 함께 설명합니다.

주의 사항

클라우드 혼합 스트림 기능을 사용하면 표준 트랜스 코딩 요금이 추가로 발생합니다. 자세한 과금 설명은 트랜스 코딩 요금을 참고하십시오.
혼합 스트림 자르기 기능을 사용하는 경우 해당 매개변수는 원본 스트리밍 매개변수보다 클 수 없습니다.

기능 지원

동시에 최대 16개의 혼합 스트림을 지원합니다.
5가지 입력 원본 유형(멀티미디어, 순수 오디오, 순수 비디오, 이미지, 캔버스)의 혼합 입력을 지원합니다.
혼합 스트림을 새로운 스트림으로 통합할 수 있습니다.
자르기, 워터마크 기능을 제공합니다.
템플릿 설정을 제공합니다.
혼합 스트림 녹화를 지원합니다.
자동 혼합 스트림을 지원합니다.
실시간 혼합 스트림 종류 및 위치 전환을 제공합니다.
혼합 스트림 실행과 취소가 무결성으로 매끄럽게 진행됩니다.

자주 사용하는 레이아웃 템플릿

자주 사용하는 템플릿으로는 10, 30, 40, 310, 390, 410, 510, 610이 있습니다. 해당 8가지의 템플릿 사용 시 입력 스트림에 위치 및 길이 매개변수를 입력할 필요 없이 원본 화면과 동일한 비율로 축소/확대되며, 템플릿 ID만 전달하면 됩니다.
가장 자주 사용하는 레이아웃 템플릿 효과 이미지:
템플릿10
템플릿30






템플릿40
템플릿310






템플릿390
템플릿410






템플릿510
템플릿610







혼합 스트림 생성

매개변수 설명

자세한 내용은 라이브 방송 혼합 스트림을 참고하십시오.

시나리오1: 혼합 스트림-템플릿 20 사용 신청

사전 설정된 템플릿을 이용한 혼합 스트림

입력 예시

https://live.tencentcloudapi.com/?Action=CreateCommonMixStream
&MixStreamSessionId=test_room
&MixStreamTemplateId=20
&OutputParams.OutputStreamName=test_stream1
&InputStreamList.0.InputStreamName=test_stream1
&InputStreamList.0.LayoutParams.ImageLayer=1
&InputStreamList.1.InputStreamName=test_stream2
&InputStreamList.1.LayoutParams.ImageLayer=2
&<공통 요청 매개변수>

출력 예시

{
  "Response": {
    "RequestId": "e8fa8015-0892-40d5-95c4-12a4bc06ed31"
  }
}

호스트 마이크 연결 혼합 스트림 효과


img



시나리오2: 혼합 스트림-템플릿 390 사용 신청

사전 설정된 템플릿을 이용한 혼합 스트림

입력 예시

https://live.tencentcloudapi.com/?Action=CreateCommonMixStream
&MixStreamSessionId=test_room
&MixStreamTemplateId=390
&OutputParams.OutputStreamName=test_stream2
&InputStreamList.0.InputStreamName=test_stream1
&InputStreamList.0.LayoutParams.ImageLayer=1
&InputStreamList.0.LayoutParams.InputType=3
&InputStreamList.0.LayoutParams.ImageWidth=1920  (캔버스 너비)
&InputStreamList.0.LayoutParams.ImageHeight=1080 （캔버스 높이）
&InputStreamList.0.LayoutParams.Color=0x000000
&InputStreamList.1.InputStreamName=test_stream2
&InputStreamList.1.LayoutParams.ImageLayer=2
&InputStreamList.2.InputStreamName=test_stream3
&InputStreamList.2.LayoutParams.ImageLayer=3
&<공통 요청 매개변수>

출력 예시

{
  "Response": {
    "RequestId": "9d8d5837-2273-4936-8661-781aeab9bc9c"
  }
}

호스트 PK 혼합 스트림 효과


img



시나리오3: 사용자 정의 혼합 스트림 예시

사용자 정의 레이아웃을 사용한 예시로, 위치 매개변수 LocationX와 LocationY는 작은 화면의 왼쪽 상단 꼭지점과 배경 화면 왼쪽 상단 꼭지점의 픽셀 절대 거리입니다.



입력 예시

https://live.tencentcloudapi.com/?Action=CreateCommonMixStream
&MixStreamSessionId=test_room
&OutputParams.OutputStreamName=test_stream2
&InputStreamList.0.InputStreamName=test_stream1
&InputStreamList.0.LayoutParams.ImageLayer=1
&InputStreamList.0.LayoutParams.InputType=3
&InputStreamList.0.LayoutParams.ImageWidth = 1920
&InputStreamList.0.LayoutParams.ImageHeight= 1080
&InputStreamList.0.LayoutParams.Color=0x000000
&InputStreamList.1.InputStreamName=test_stream2
&InputStreamList.1.LayoutParams.ImageLayer=2
&InputStreamList.1.LayoutParams.ImageWidth = 640
&InputStreamList.1.LayoutParams.ImageHeight= 360
&InputStreamList.1.LayoutParams.LocationX= 50
&InputStreamList.1.LayoutParams.LocationY= 720
&InputStreamList.2.InputStreamName=test_stream3
&InputStreamList.2.LayoutParams.ImageLayer=3
&InputStreamList.2.LayoutParams.ImageWidth = 640
&InputStreamList.2.LayoutParams.ImageHeight= 360
&InputStreamList.2.LayoutParams.LocationX= 740
&InputStreamList.2.LayoutParams.LocationY= 720
&<공통 요청 매개변수>

출력 예시

{
  "Response": {
    "RequestId": "8c443359-ba07-4b81-add8-a6ff54f9bf54"
  }
}

사용자 정의 혼합 스트림 효과





혼합 스트림 취소

매개변수 설명

자세한 내용은 범용 혼합 스트림 취소를 참고하십시오.

시나리오 예시

session id에 따른 혼합 스트림 취소

입력 예시

https://live.tencentcloudapi.com/?Action=CancelCommonMixStream
&MixStreamSessionId=test_room

출력 예시

{
  "Response": {
    "RequestId": "3c140219-cfe9-470e-b241-907877d6fb03"
  }
}
주의사항：
혼합 스트림을 신청하고 최소 5초 후에 취소할 수 있습니다.
혼합 스트림을 취소하고 30초 후에 동일한 session id의 혼합 스트림을 신청할 수 있습니다.

에러 코드

클라우드 혼합 스트림 API 3.0 인터페이스에서 자주 발생하는 에러 코드 대부분은 이미 API 3.0 에러 코드 스타일에 마이그레이션 되었습니다. 그러나 일부 커버되지 않는 에러 코드가 여전히 존재하며, 해당 에러 코드는 InvalidParameter 에러로 표시되어 Message에 err_code [ $code ],msg [ $message ] 형식으로 제공됩니다. 해당 code의 자세한 원인은 다음과 같습니다.
에러 코드
원인
권장 진단 방법
-1
입력 매개변수 리졸브 오류
요청 본문 body json 포맷이 정확한지 확인합니다.
InputStreamList가 비어 있는지 확인합니다.
-2
입력 매개변수 오류
화면 매개변수의 오버플로우 여부를 확인합니다.
-3
스트림 개수 오류
입력 스트림 개수가 [1, 16] 범위 내에 있는지 확인합니다.
-4
스트림 매개변수 오류
입출력 길이가 (0, 3000) 범위 내에 있는지 확인합니다.
입력 스트림 개수가 (0, 16) 범위 내에 있는지 확인합니다.
입력 스트림에 LayoutParams가 있는지 확인합니다.
InputType 지원 여부를 확인합니다. (적합한 값: 0, 2, 3, 4, 5)
스트림 ID 길이가 (1, 80)을 만족하는지 확인합니다.
-11
이미지 레이어 오류
이미지 레이어 개수 및 입력 스트림 개수가 일치하는지 확인합니다.
이미지 레이어 ID가 중복되었는지 확인합니다.
이미지 레이어 ID가 (0, 16) 범위에 있는지 확인합니다.
-20
입력 매개변수와 인터페이스가 매칭되지 않음
입력 스트림 개수가 템플릿 ID와 매칭되어 있는지 확인합니다.
컬러 매개변수가 정확한지 확인합니다.
-21
혼합 스트림의 입력 스트림 개수 오류
입력 스트림 개수가 2개 이상인지 확인합니다.
-28
배경 길이 획득 실패
캔버스를 설정한 경우, 캔버스 길이를 설정했는지 확인합니다.
배경 스트림이 있는지 확인합니다. (푸시 스트림 후 5초 후에 다시 혼합 스트림을 진행해야 함)
-29
자르기 매개변수 오류
자르기 위치가 스트림 길이를 초과했는지 확인합니다.
-33
워터마크 이미지 ID 오류
입력 이미지 ID가 설정되었는지 확인합니다.
-34
워터마크 이미지 URL 획득 실패
이미지 업로드가 완료되었는지, URL이 생성되었는지 확인합니다.
-111
OutputStreamName 매개변수와 OutputStreamType이 매칭되지 않음
OutputStreamType이 0인 경우, 반드시 OutputStreamName이 InputStreamList에 존재해야 합니다.
OutputStreamType이 1인 경우, OutputStreamName이 InputStreamList에 없어야 합니다.
-300
출력 스트림 ID가 이미 사용됨
해당 출력 스트림이 다른 혼합 스트림의 출력 스트림인지 확인합니다.
-505
입력 스트림을 upload에서 찾을 수 없음
푸시 스트림을 완료하고 5초 후에 혼합 스트림을 진행했는지 확인하고, 재생 가능한지 확인합니다.
-507
스트림 길이 매개변수 조회 실패
캔버스 너비, 높이를 설정했는지 확인합니다.
푸시 스트림이 완료되었는지 확인하고, 푸시 스트림 후 5초 후에 다시 혼합 스트림을 진행하기 바랍니다.
-508
출력 스트림 ID 오류
동일한 MixStreamSessionId에서 서로 다른 출력 스트림 ID를 사용했는지 확인합니다.
-10031
혼합 스트림 트리거 실패
푸시 스트림 후 5초 후에 다시 혼합 스트림을 진행하시기 바랍니다.
-30300-31001-31002
혼합 스트림 취소 시 sessionid 없음
MixStreamSessionId가 있는지 확인합니다.
-31003
출력 스트림 ID와 session의 출력 스트림 ID가 매칭되지 않음
혼합 스트림 취소 시 입력한 출력 스트림 ID를 확인합니다.
-31004
출력 스트림 비트레이트 부적합
출력 스트림 비트레이트가 [1, 50000] 범위에 있는지 확인합니다.
기타
기타 오류입니다. 고객 서비스에 문의하여 기술 지원을 받으십시오.
-

FAQ

혼합 스트림 과정에서 입력 스트림의 자동 크기 조정을 유지하고, 검은 띠를 없애려면 어떻게 해야 하나요?
푸시 스트림 후 혼합 스트림 시 -505 에러 코드가 리턴되는 이유는 무엇인가요?
혼합 스트림 신청 후 혼합 스트림을 취소하지 않을 경우 어떻게 되나요?
혼합 스트림의 보조 호스트 화면이 예상 위치와 다른 이유는 무엇인가요?
설명：
클라우드 혼합 스트림 관련 자세한 문제는 클라우드 혼합 스트림 관련을 참고하십시오.
이전 주제: AV1 인코딩다음 주제: 비디오 콘텐츠 보호

도움말 및 지원

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

피드백