Live Recording

이 가이드는 Media Acceleration Live Broadcast에서 Recording API를 사용하여 라이브 스트림 녹화를 관리, 자동화 및 제어하는 방법을 설명합니다.

녹화 시스템은 세 가지 계층으로 구성되어 있습니다:

1. 템플릿 — 어떻게 녹화할지 정의: 출력 형식, 저장 위치, 파일 분할 방법, 콜백 설정 등.
2. 규칙 — 언제 녹화할지 정의: 특정 스트림에 템플릿을 바인딩하여 자동으로 녹화를 시작합니다.
3. 실시간 제어 — 온디맨드로 녹화: 활성화된 스트림에 대해 녹화 세션을 수동으로 시작하거나 중지합니다.

템플릿은 기반이 되는 요소입니다. Rule과 Real-Time Control은 모두 templateId로 템플릿을 참조하므로, 다른 API를 사용하기 전에 반드시 하나 이상의 템플릿을 생성해야 합니다.

경고: 모든 녹화 API는 사용자당 5분 내 300건 요청의 속도 제한을 공유합니다. 요청이 제한되지 않도록 통합 시 이에 맞게 계획하십시오.

녹화 템플릿 생성 (템플릿 API)

**녹화 파라미터 템플릿(Recording Parameter Template)**은 녹화가 어떻게 동작해야 하는지 시스템에 알려줍니다: 출력물을 어디에 저장할지, 파일 이름을 어떻게 지정할지, 언제 분할할지, 그리고 콜백 알림을 어디로 전송할지를 지정합니다.

모든 녹화 — 자동으로 시작되었거나 수동으로 시작되었는지에 관계없이 — 에는 반드시 templateId가 필요하므로, 템플릿 생성이 항상 첫 번째 단계입니다.

경고: 현재 하나 이상의 레코딩 규칙에 연결된 템플릿은 삭제할 수 없습니다. 삭제 전 모든 규칙에서 해당 템플릿을 연결 해제해야 합니다.

자동화된 레코딩 규칙 설정하기(Rule API)

템플릿이 준비되면, **레코딩 규칙(Recording Rules)**을 생성하여 녹화를 자동화할 수 있습니다. 규칙은 하나 이상의 라이브 스트림에 templateId를 연결하며 해당 스트림이 라이브 상태로 전환될 때 녹화가 자동으로 시작됩니다.

스트림을 3가지 수준에서 지정할 수 있습니다:

• 전송 Domain — 해당 Domain 하위의 모든 스트림을 기록합니다.
• 어플리케이션 이름 — 특정 어플리케이션 경로 하위의 모든 스트림을 기록합니다.
• 스트림 이름 — 단일 특정 스트림을 기록합니다.

시스템은 가장 긴 일치 원칙에 따라 규칙을 적용합니다. 즉, 특정 스트림 이름을 대상으로 하는 규칙이 더 넓은 Domain 수준의 규칙보다 우선적으로 적용됩니다. 이를 통해 전체에 적용되는 기본값을 설정하면서, 필요할 경우 개별 스트림의 동작을 재정의할 수 있습니다.

경고: 현재 활성화 중이거나 녹화가 진행 중인 규칙은 삭제할 수 없습니다. 규칙을 삭제하기 전에 녹화가 완료되거나 중지될 때까지 기다려야 합니다.

주문형 녹화 트리거(Real-Time Control API)

자동화된 규칙 외의 상황에서 즉시 라이브 스트림을 녹화해야 하는 경우, Real-Time Control API를 사용하여 녹화 세션을 수동으로 시작 및 중지할 수 있습니다.

워크플로우 연결 방식:

1. templateId와 최대 5개의 스트림 전달 URL로 StartRealTimeRecord를 호출합니다.
2. API는 해당 녹화 작업을 고유하게 식별하는 persistentId를 반환합니다.
3. 녹화는 스트림이 자연스럽게 종료되거나 동일한 persistentId로 StopRealTimeRecord를 호출할 때까지 계속 진행됩니다.

전문가 팁: Start API에서 반환된 persistentId를 항상 저장하세요. 스트림이 끝나기 전에 특정 녹화 세션을 중지하는 유일한 방법입니다.