Vimeo Live API 사용하기 – 도움말 센터

이 기능을 사용하려면 Vimeo Enterprise 요금제가 필요합니다.

이 도움말은 Vimeo Live API를 사용하여 라이브 이벤트에 대한 세부정보를 검색하는 방법에 대한 정보를 제공합니다. 자세한 내용은 API 참조에서 확인할 수 있습니다.

이 도움말에 포함된 내용:

라이브 이벤트 중에는 기본 개별 클립이 아닌 이벤트 컨테이너를 임베드하여 동일한 임베드 코드가 연결 해제/재연결 시 계속 작동하도록 하는 것이 좋습니다.

API를 사용하여 ID로 이벤트 컨테이너를 검색합니다.

https://api.vimeo.com/live_events/{event_id}

응답이 오면 embed:html에서 임베드 가능한 iframe 코드를 검색합니다.

Is chat enabled? "chat_enabled" true/false

'true'인 경우 'chat_embed_code'에 임베드 가능한 iframe 코드가 포함되어 있습니다.

ID로 응답을 받지 못한 경우에는 ID가 일회성 이벤트와 연결되었을 수 있습니다. '개별 동영상 클립 또는 일회성 이벤트에 대한 세부 정보 검색하기'를 참조하세요.

앱을 위해 알아야 할 이벤트 컨테이너 세부 사항:

'stream privacy'는 프라이버시 수준을 반영합니다.
'embed': 'public', 'whitelist' 또는 'private'. Private은 파트너가 임베드할 수 없습니다.
'stream_password'는 스트림의 비밀번호를 반영합니다.
'badges'에는 플레이어에게 알릴 클립에 대한 정보가 포함되어 있습니다.
- 'live'는 'streaming':true/false 또는 'archived':true/false를 알려줍니다.
- 'vod'는 vod인지 아닌지를 알려줍니다.

자세한 문서는 API 참조에서 확인할 수 있습니다.

이벤트 이후, 플레이어 임베드는 다음 세 가지 중 하나를 표시합니다.

적절한 VOD 클립을 안정적으로 표시하려면 이벤트가 아닌 개별 클립을 임베드해야 합니다. 이벤트 API 응답에서 개별 클립의 ID와 데이터를 확보하세요.

반복 이벤트에는 두 개의 관련 개체가 있습니다. 참조할 개체는 데이터를 검색하는 시기에 따라 다릅니다.

live_clips - (스트림 이후). 이벤트로부터 완료된 모든 동영상 클립의 배열로, 이벤트가 스트리밍된 시점의 동영상 ID 및 에포크 타임스탬프를 포함합니다.
streamable_clip - (스트림 이전/도중). 스트림 이전/도중의 활성 클립입니다. ID와 임베드 코드는 스트리밍이 진행되는 동안의 개별 클립과 VOD 결과물에 상응합니다.

스트림이 중지되면 해당 클립 정보가 live_clips 배열로 이동하고 streamable_clip이 변경되어 스트리밍할 다음 클립에 대한 정보를 포함합니다.

ID로 직접 동영상 클립에 접근할 수 있습니다. 이 방법은 일회성 이벤트 또는 개별 VOD에 대한 세부 정보에 액세스하는 데 사용됩니다. Live가 VOD로 변환될 때 ID 및 임베드는 변경되지 않습니다.

개별 동영상 클립의 세부 정보:

https://api.vimeo.com/videos/{video_id}

자세한 내용은 API 참조를 확인하세요.

관련 문서