서문
CMS 및 재생 API 모두 비디오 클라우드 비디오 데이터에 대한 액세스를 제공합니다. 이 항목의 목적은 이러한 항목 간의 차이점과 이를 사용하는 모범 사례를 이해하는 데 도움이 되는 것입니다.
CMS와 재생 API의 차이점
CMS 및 재생 API는 동일한 기본 비디오 데이터에 액세스합니다. 그러나 특정 상황에서 어떤 것을 사용하는지 결정해야하는 몇 가지 주요 차이점이 있습니다.
일반적으로 Video Cloud를 CMS 시스템과 통합하는 등의 백엔드 사용을 위한 것입니다. CMS API Playback API는 플레이어 또는 비디오 포털의 비디오 및 플레이리스트 데이터를 가져오는 프런트엔드에서 사용하기 위한 것입니다 (예: Brightcove Player catalog및playlist API는 Playback API를 사용합니다).
아래 표에는 두 API 간의 몇 가지 주요 차이점이 나와 있습니다.
| 아이템 | CMS API | 재생 API |
|---|---|---|
| 작업의 종류 | 만들기, 읽기, 업데이트, 삭제 | 읽기 전용 - 재생 API를 사용하여 데이터를 수정할 수 없습니다. |
| 운영 범위 | 비디오 데이터의 모든 측면 관리 | 특정 동영상 또는 재생목록 가져오기 또는 동영상 검색 |
| 인증 | 임시액세스 토큰 | 영구정책 키 |
| 데이터의 최신 성 | 캐싱 없음, 항상 최신 | 최대 20분 동안 캐시됨 |
| 응답 속도 | 느리게 | 더 빠름 (캐싱 때문에) |
| 접속하다 | 서버 측 전용 (COR 사용 안 함) | 서버 또는 클라이언트 측 (COR 사용) |
| 데이터 | 비디오 및 재생 목록 요청에는 비디오 소스 URL이 포함되지 않습니다. 이를 가져오려면 두 번째 요청이 필요합니다. | 비디오 및 재생 목록 요청에는 비디오 소스 URL이 포함됩니다. |
미디어 URL 사용
변환, 이미지 및 기타 자산에 대한 URL은 고정되어 있지 않다는 점을 이해하는 것이 중요합니다. 브라이트코브는 미디어 자산의 스토리지를 수시로 재구성하며, 이 경우 특정 자산에 대한 URL이 변경됩니다. 페이지 또는 앱에서 이러한 자산에 대한 하드 코딩된 URL을 사용하는 경우 링크가 어느 시점에서 중단됩니다.
또한 모든 URL에는 콘텐츠 보안상의 이유로TTL토큰이 포함되어 있습니다. 즉, URL은 기본적으로 6시간 후에 만료됩니다. 토큰의 수명은 최대 365일까지 연장할 수 있습니다. 수명이 더 긴 토큰을 원한다면 브라이트코브지원팀에 문의하십시오 . 단, 는 해당 자산이 CDN에 캐시되는 최대 시간을TTL반영하지만 토큰이 만료되기 전에 URL이 변경되지 않는다는 보장은 없습니다.
VOD 콘텐츠의 경우 매니페스트 URL에 더 짧은 TTL을 지정할 수 있습니다. 자세한 내용은 Short Manifest TTL 문서를 참조하십시오.
미디어 링크가 깨지는 것을 방지하는 가장 좋은 방법은 CMS API또는 Playback API를 사용하여 런타임에 Video Cloud에서 해당 링크를 검색하는것입니다.
URL 캐싱
런타임 API 요청이 옵션이 아닌 경우, 하루에 한 번 이상 새로 고침되는 로컬 데이터 캐시에서 URL을 가져오거나TTL토큰에 설정된 Time-to-Live 범위 내에서 둘 중 더 짧은 날짜를 기준으로 URL을 가져오는 것이 좋습니다.
정적 URL
브라이트코브는 비디오 클라우드 라이브러리의 에셋에 대한 비디오 매니페스트 파일에 정적 URL을 제공합니다. 이를 통해 CMS에서 콘텐츠를 관리하고 사용자 지정 보안 스키마를 사용하여 콘텐츠를 제공할 수 있습니다.
이는 매니페스트 URL이 필요하기 전에 Playback API 호출을 허용하지 않는 기존 아키텍처를 사용하는 고객에게 중요합니다. 플레이어는이 기능을 사용할 수도 있으므로 한 번의 통화를 제거하여 재생 시작 시간을 줄일 수 있습니다.
자세한 내용은 정적 URL 전달 문서를 참조하십시오.
짧은 매니페스트 TTL
재생 워크플로에서 Brightcove Player는 재생 API(또는 Edge 인증 API)를 호출하여 인증을 위한 정책 키(또는 JWT)를 제공하여 재생을 시작하기 위해 사용 가능한 매니페스트를 검색합니다.
이러한 API를 확장하고 가용성을 높일 수 있도록 캐싱 계층이 도입되었습니다. 이 계층은 Signed Manifest URL API 및 Playback API의 응답을 저장합니다. 서명된 매니페스트가 캐시되기 때문에 TTL은 캐시의 시간과 플레이어가 사용할 버퍼에 대해 유효할 만큼 충분히 길어야 합니다.
짧은 매니페스트 TTL을 통해 시청자는 방해 없이 계속 재생할 수 있습니다. 또한 모든 Dynamic Delivery 기능은 짧은 매니페스트 TTL과 함께 작동합니다.
참조 ID 충돌
이 섹션은CMS API에만 적용됩니다.
참조 ID의 고유성을 보장하기 위해 는 할당된 비디오에서 작업을 수행한 후 최대 3분 동안 ID를CMS API잠급니다. 이렇게 하면 실패한 요청을 너무 빨리 다시 시도하거나 이전에 할당된 비디오를 삭제한 후 참조 ID를 너무 빨리 다시 사용하려고 할 때 409 오류가 반환될 수 있습니다. 참조오류 메시지 참조상세 사항은.