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 정책
개인 정보 보호 정책
데이터 처리 및 보안 계약

COS에 녹화 저장

PDF
포커스 모드
폰트 크기
마지막 업데이트 시간: 2025-11-12 15:39:28
CSS를 사용하면 라이브 스트림을 녹화하고 녹화 파일을 VOD 또는 COS에 저장할 수 있습니다. 본문은 COS(Cloud Object Storage)에 녹화하는 방법을 보여줍니다.

주의 사항

1. COS에 녹화하려면 먼저 COS를 활성화해야 합니다. 연체료 결제로 인한 서비스 중단을 방지하기 위해 사전에 스토리지 패키지를 구입하는 것이 좋습니다. 자세한 내용은 COS > 시작하기를 참고하십시오.
2. 녹화 기능을 활성화한 후 COS 서비스가 정상 상태인지 확인하십시오. COS가 활성화되지 않았거나 연체로 인해 일시 중지된 경우 실시간 녹화에 실패합니다. 녹화 파일이 생성되지 않으며, 요금도 발생하지 않습니다.
3. 녹화 파일은 녹화 종료 후 약 5분 후에 사용 가능합니다. 예를 들어 라이브 방송 녹화를 12:00에 시작해서 12:30에 멈추면 12:35 경에 12:00 - 12:30에 해당하는 녹화된 영상을 받을 수 있습니다.
4. 녹화 템플릿을 생성한 후 푸시 도메인에 바인딩해야 합니다. 자세한 사용법은 녹화 구성을 참고하십시오. 템플릿은 바인딩 후 5 - 10분 후에 적용됩니다.
5. 혼합 스트림 녹화는 중국 본토 내부의 스트림과 외부 스트림의 혼합을 지원하지 않습니다. 그렇게 하면 오류가 발생하고 녹음 파일이 재생되지 않습니다.
6. CSS는 COS에 녹화 파일을 저장하기 위한 권한이 필요합니다. COS에 녹화 기능을 사용하기 전에 필요한 권한을 부여했는지 확인하십시오. 권한이 부족하여 COS에 녹화가 실패하면 비디오를 복구할 수 없습니다. 권한을 부여하는 방법은 COS에 녹화 파일을 저장하도록 CSS 권한 부여를 참고하십시오.
7. 녹화 시작 시 녹화 템플릿을 지정하지 않으면 녹화 파일이 VOD로 저장됩니다.

전제 조건

CSS를 활성화하고 푸시 도메인을 추가했습니다.
COS를 활성화했습니다.

녹화 템플릿 생성

1. CSS 콘솔에 로그인하여 기능 구성>라이브 방송 녹화 페이지로 이동합니다.
2. COS에 저장을 선택합니다.
3. 템플릿 생성을 클릭하여 다음 설정을 완료합니다.
구성 항목
설명
템플릿 이름
라이브 방송 녹화 템플릿 이름을 자체 정의할 수 있습니다(중국어, 영어, 숫자, _, -만 지원).
템플릿 설명
라이브 방송 녹화 템플릿 소개 설명을 자체 정의할 수 있습니다(중국어, 영어, 숫자, _, -만 지원).
콘텐츠 녹화
원본 스트림 녹화
이 옵션을 선택하면 트랜스코딩, 워터마크 추가, 스트림 믹싱 전에 비디오가 녹화됩니다. 이 옵션을 선택하면 WebRTC 스트림의 오디오를 녹음할 수 없습니다.
워터마크를 포함한 녹화
이 설정을 선택하면 워터마크 템플릿에 구성된 워터마크가 추가된 후 라이브 스트림이 녹화됩니다.
지정 트랜스코딩 스트림 녹화
지정된 트랜스코딩 템플릿에 따라 트랜스코딩된 비디오를 녹화합니다. 기존 트랜스코딩 템플릿을 선택하거나 템플릿 이름을 클릭하여 구성을 수정할 수 있습니다. 구성된 템플릿이 삭제되면 워터마크와 함께 녹화됩니다.
녹화 형식
비디오는 HLS, FLV, MP4 및 AAC(오디오 전용) 형식으로 출력할 수 있습니다.
주의사항:
WebRTC 푸시 스트림 녹화 원본 스트림은 오디오가 손실되므로 다른 녹화 콘텐츠를 선택하는 것이 좋습니다.
녹화 및 트랜스 코딩 스트림 기능은 현재 타임 시프트 시나리오의 사용을 지원하지 않습니다. 녹화 템플릿이 타임 시프트 설정과 연결된 경우 원래 스트림에 따라 녹화가 수행됩니다.
지정된 트랜스 코딩 스트림 녹화에서 오디오 전용 트랜스코딩 템플릿을 선택하면 녹화 형식에서 오디오 형식만 선택할 수 있습니다.
트랜스코딩 스트림을 녹화하려면 먼저 트랜스코딩 작업을 시작해야 하며, 별도의 트랜스코딩 비용이 발생합니다. 동일한 트랜스코딩 템플릿으로 재생하는 경우, 중복 과금되지 않습니다.
4. 녹화 내용을 선택하고 원하는 녹화 형식을 확인하면 관련 형식 설정 인터페이스가 나타납니다. 하나 이상의 녹화 형식을 선택하고 동시에 설정할 수 있습니다. 다음 설정을 수행하십시오.
구성 항목
설명
파일당 최대 녹화 시간(분)
HLS 형식의 녹화 파일 길이에는 제한이 없습니다. 라이브 스트림이 중단되고 재개 제한 시간이 경과하면 녹화를 계속할 수 있도록 새로운 녹화 파일이 생성됩니다.
FLV 형식의 녹화 파일 최대 길이 값 범위는 1 - 720분입니다.
MP4 또는 AAC 형식의 최대 녹화 파일 길이 값 범위는 1 - 120분입니다.
녹화 재개 시간 초과(초)
HLS 형식만 푸시 중단 후 녹화 재개를 지원하며 재개를 위한 제한 시간 값 범위는 1s - 1800s입니다.
저장 기간(일)
영구 저장
을 선택하여 녹화 파일을 영구적으로 저장하거나
기간 지정
을 선택하여 저장 기간(최대 1500일)을 지정할 수 있습니다. 기간을 0으로 설정하면 녹화 파일이 영구 저장됩니다.
저장 경로
COS 에서 생성한 Bucket을 선택합니다. 이 Bucket에 대한 CSS 액세스 권한을 부여했는지 확인하십시오.
Region은 선택한 COS Bucket의 리전 정보를 보여줍니다. 수정할 수 없습니다.
백업 저장 경로
재해 복구 저장 경로를 활성화할 수 있으며, 네트워크 지터로 인해 녹화 파일을 기본 저장 경로에 저장하지 못한 경우 백업 경로를 사용합니다. 기본 경로가 복구되면 백업 경로에 저장된 녹화 파일이 자동으로 기본 경로에 업로드됩니다. 백업 및 기본 경로는 서로 다른 region에 있어야 합니다.
폴더
기본 저장 폴더는 {RecordSource}/{Domain}/{AppName}/{StreamID}/{RecordId}/{StartYear}-{StartMonth}-{StartDay}-{StartHour}-{StartMinute}-{StartSecond}입니다.
{RecordSource}는 콘텐츠 유형을 나타냅니다. 원본 스트림이 기록된 경우 이것이 origin입니다. 트랜스코딩된 스트림이 기록된 경우 이것이 트랜스코딩 템플릿 id입니다.
{StartYear}: 시작 시간-년
{StartMonth}: 시작 시간-월
{StartDay}: 시작 시간-일
{StartMinute}: 시작 시간-분
{StartSecond}: 시작 시간-초
{Domain}: 푸시 도메인
{AppName}: 푸시 경로
{StreamID}: 스트림
ID{RecordId}: CreateRecordTask API에서 반환되는 녹화 작업 id로 녹화 규칙 or 녹화 작업을 구분
「/」는 폴더 수준, 「-」는 일반 문자
5. 저장을 클릭합니다.
설명:
스트림은 기록되는 동안 업로드되므로 파일 이름에 종료 시간을 나타내는 필드가 포함되지 않습니다.

바인딩 도메인 이름

1. CSS 콘솔에 로그인하고 왼쪽 사이드바에서 기능 구성 > 라이브 방송 녹화를 선택한 후 COS에 저장을 클릭합니다.
기존 템플릿에 도메인 바인딩: 왼쪽 상단의 도메인 이름 바인딩을 클릭합니다.
신규 녹화 템플릿 생성 완료 후 도메인 연결: 녹화 템플릿 생성 완료 후 안내 창의 도메인 바인딩을 클릭합니다.
2. 도메인 바인딩 창에서 바인딩할 녹화 템플릿푸시 도메인을 선택하고 확인을 클릭하면 바인딩이 완료됩니다.
설명:
추가를 클릭하여 현재 템플릿에 여러 개의 푸시 도메인을 추가할 수 있습니다.

도메인 이름 바인딩 해제

1. CSS 콘솔에 로그인하고 왼쪽 사이드바에서 기능 구성 > 라이브 방송 녹화를 선택한 후 COS에 저장을 클릭합니다.
2. 도메인 이름으로 바인딩된 녹화 템플릿을 선택하고 대상 도메인 이름을 찾은 다음 바인딩 해제를 클릭합니다.
3. 현재 연결된 도메인의 바인딩 해제 여부를 확인하고 확인을 클릭하면 바인딩 해제가 완료됩니다.
설명:
녹화 템플릿 바인딩을 해제해도 현재 라이브 방송 중인 스트리밍에는 영향을 주지 않습니다.
바인딩 해제 적용이 필요한 경우, 해제 후 스트리밍을 중단하고 다시 푸시 스트리밍 라이브 방송을 시작하면 새로운 라이브 방송부터는 녹화 파일이 생성되지 않습니다.

템플릿 수정

1. 기능 구성 > 라이브 방송 녹화로 이동하여 COS에 저장을 선택합니다.
2. 대상 녹화 템플릿을 선택하고 오른쪽 편집을 클릭하여 템플릿 정보를 수정합니다.
3. 저장을 클릭합니다.

템플릿 삭제

1. CSS 콘솔에 로그인하고 왼쪽 사이드바에서 기능 구성 > 라이브 방송 녹화를 선택한 후 COS에 저장을 클릭합니다.
2. 생성된 녹화 템플릿을 선택하고 오른쪽 상단의 삭제 버튼을 클릭합니다.
3. 현재 녹화 템플릿의 삭제 여부를 확인하고 확인을 클릭하면 삭제가 완료됩니다.
주의사항:
템플릿이 이미 연결되어 있는 경우, 먼저 바인딩 해제를 진행한 후 삭제할 수 있습니다.
콘솔의 템플릿 관리에서는 현재 도메인 차원에서 연결 인터페이스 생성 규칙을 취소할 수 없습니다. 녹화 관리 인터페이스를 통해 지정한 스트림과 연결하고 있는 경우, DeleteLiveRecordRule을 참고하여 연결을 해제해야 합니다.

관련 작업

도메인 관리 페이지에서 도메인과 녹화 템플릿을 바인딩 해제바인딩할 수도 있습니다. 자세한 내용은 녹화 구성을 참고하십시오.

도움말 및 지원

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

피드백