Stream Status Callbacks

Stream Status Callbacks 기능을 통해 Media Acceleration Live Broadcast에서 스트림이 시작되거나 종료될 때 실시간 콜백 알림을 받을 수 있습니다. 본 가이드에서는 라이브 푸시 Domain에서 콜백을 활성화하는 방법, 시작/종료 콜백 URL을 설정하는 방법, 각 이벤트와 함께 전달되는 콜백 매개변수를 선택하는 방법을 설명합니다.

애플리케이션에서 모니터링 시스템, 워크플로우 시스템, 비즈니스 백엔드와 같은 외부 서비스와 스트림 라이프사이클 이벤트를 동기화해야 할 때 이 기능을 사용하세요.

시작하기 전에

• Media Acceleration Live Broadcast Domain을 소유한 CDNetworks 콘솔 계정에 접근할 수 있습니다.
• 구성한 Domain은 푸시 Domain이어야 합니다. 스트림 시작 및 종료 콜백은 인제스트(ingest) 이벤트에 연결되어 있기 때문입니다.
• 스트림 시작 및 종료 이벤트를 위한 도달 가능한 콜백 엔드포인트를 준비하셨습니다.
• 스트림 시작 URL과 스트림 종료 URL은 동일한 프로토콜과 Domain을 사용해야 합니다.
• 외부 서비스에서 어떤 콜백 파라미터를 기대하고 있는지 알고 있습니다.

스트림 상태 콜백 구성

도메인 구성 편집기에서 스트림 상태 콜백을 구성합니다.

스크린샷: Stream Status Callbacks 추가 대화상자에서 On이 선택된 모습으로, Method, Stream Start URL, Stream End URL, Callback Parameters가 표시됩니다.

1. Media Delivery > Media Acceleration Live Broadcast > Configuration으로 이동합니다.

2. 도메인 목록에서 구성하려는 푸시 도메인을 찾아 구성 편집을 선택합니다.

3. 설정 편집기에서 Stream Status Callbacks를 선택한 후, Add를 클릭합니다.

   Add 버튼이 보이지 않는 경우, 이미 해당 Domain에 대한 스트림 상태 콜백 설정이 존재할 수 있습니다. 대신 기존 Stream Status Callbacks 행을 확인해 주세요.

4. Stream Status Callbacks에서 On을 선택합니다.

5. 콜백 설정을 구성합니다.

중요: 스트림 시작 URL과 스트림 종료 URL은 동일한 프로토콜과 Domain을 사용해야 합니다. 예를 들어, 두 URL 모두 동일한 https://example.com 호스트로 구성해야 합니다.

6. 콜백 매개변수에서 설정 클릭을 확장하세요. 시작 보고 및 종료 보고에서 스트림 시작 및 종료 콜백에 함께 전송할 매개변수를 선택하세요.
7. 확인을 선택한 후 편집기의 스트림 상태 콜백 행을 검토하세요. 전체 Domain 구성을 검토할 준비가 되면 다음을 선택하세요.

참고 자료

Callback URL 형식

Callback URL에는 다음 형식을 사용하세요:

{protocol}://{host}:{port}/{URI}

예시:

https://test.example.com/api/live/check
http://1.1.1.1:8888/api/live/check

콜백 매개변수

Report Starts와 Report Ends에 대해 콜백 매개변수를 각각 설정할 수 있습니다.

Callback 파라미터는 스트림이 시작되거나 종료될 때 콜백 엔드포인트로 전송되는 이벤트 정보를 정의합니다. 각 이벤트 유형에 대해 기본 파라미터 이름을 그대로 사용하거나, 서비스에서 기대하는 이름으로 변경할 수 있습니다. 콜백 요청에 해당 파라미터를 포함하지 않으려면 파라미터를 비워두세요.