브라이트코브 비디오 클라우드에서 전송 규칙 만들기
2017년 브라이트코브는 다이내믹 딜리버리를 출시하고 플레이어가 요청하는 시점에 '적시에' 매니페스트와 비디오를 생성하기 시작하여 콘텐츠를 다양한 포맷으로 리패키징하고 최대한 다양한 디바이스를 지원할 수 있게 되었습니다.
그 이후로 고객들로부터 이러한 유연성을 직접 활용하고 콘텐츠가 어떤 CDN을 통해 전송되는지, 어떤 품질의 동영상 렌더링이 제공되어야 하는지, 심지어 동영상 매니페스트 내에서 다양한 품질의 렌더링이 어떤 순서로 표시되어야 하는지 세밀하게 제어하고 싶다는 의견이 점점 더 많아지고 있습니다. 이를 통해 전송 규칙 기능이 만들어졌으며, 현재 일반적으로 API의 일부로 제공됩니다.
이 글에서는 이 API를 사용하여 가장 일반적인 사용 사례 중 하나인 특정 디바이스에 제공되는 동영상의 최대 화질을 제한하는 방법을 살펴보겠습니다.
설정하기
시작하려면 먼저 테스트할 비디오가 필요하며, 비디오 클라우드를 통해 정상적으로 수집했습니다.
해당 플레이어에 전달되는 HLS 매니페스트를 살펴보면 다음과 같은 여러 줄이 포함되어 있으며, 이 경우 480×270, 640×360, 960×540 및 1280×720(아래)과 같이 다양한 해상도의 렌더링 매니페스트를 나타내고 있음을 알 수 있습니다:
#EXT-X-STREAM-INF:PROGRAM-ID=0,BANDWIDTH=2205500,CODECS="mp4a.40.2,avc1.4d001f",RESOLUTION=1280x720,AUDIO="audio-2",CLOSED-CAPTIONS=NONE
https://manifest.prod.boltdns.net/manifest/v1/hls/v4/aes128/5270290572001/aa7059e5-586b-4caa-ae6f-5533f223a569/a557b391-f20e-4727-9185-459411a63029/10s/rendition.m3u8960×540이 가상의 디바이스에 전달하려는 최대 해상도라면 규칙이 적용되면 1280×720 렌더링이 사라지는 것을 볼 수 있습니다.
규칙 만들기
배달 규칙은 조건(규칙이 호출되어야 하는 시기)과 작업(규칙이 콘텐츠에 영향을 미치는 방식)으로 구성됩니다.
최대 동영상 렌더링 품질을 제한하는 규칙이 필요하다는 것을 알고 있으므로 먼저 다음 HTTP 요청으로 액션을 생성해 보겠습니다:
POST /accounts/{accountID}/actions
Content-Type: application/json
Authorization: Bearer {access_token}로 설정된 요청 본문입니다:
{
"properties": {
"max_video_resolution": "960x540"
}
}이렇게 하면 새 액션이 생성되고 다음과 같은 결과가 반환됩니다:
{
"id": "88b13752-3469-4e46-b4aa-49cd4f1685a6",
"properties": {
"max_video_resolution": "960x540"
}
}수동으로 작업 호출
조건부로 액션을 적용하기 전에 수동으로 액션을 호출하고 재생 API 요청에 ID를 파라미터로 추가하여 원하는 대로 작동하는지 확인할 수 있습니다:
https://edge.api.brightcove.com/playback/v1/accounts/5270290572001/videos/6230434222001?config_id=88b13752-3469-4e46-b4aa-49cd4f1685a6이제 이전과 동일한 HLS 매니페스트가 반환되지만 1280×720 렌더링이 제거됩니다!
이러한 방식으로 규칙을 수동으로 호출하는 것은 테스트에 유용할 뿐만 아니라, 브라이트코브 SDK를 활용하여 자체 앱을 구축하는 고객에게 강력한 기술로, 다양한 액션 ID를 전달하기만 하면 기기별, 앱별 또는 사용자별로 서로 다른 규칙을 호출할 수 있습니다.
익명의 사용자에게는 기본 유형의 콘텐츠를 제공하는 액션을 적용하고, 가입한 사용자에게는 더 풍부한(고품질 비디오 및 오디오, HEVC와 같은 최신 코덱, 프리미엄 CDN 제공업체) 콘텐츠를 제공하기 위해 수동 액션을 적용하는 것이 일반적인 사용 방식입니다.
조건부 호출 작업
수동으로 액션을 호출하는 세분화를 원하지 않거나 필요하지 않은 고객을 위해 브라이트코브 매니페스트 생성 서비스가 규칙을 적용해야 하는 상황을 제어할 수 있는 사전 허용된 조건 세트를 제공합니다. 이러한 조건은 모든 요청에 적용되므로 동영상을 시청하는 디바이스 유형에 관계없이 특정 사용자 그룹을 타겟팅할 수 있는 좋은 방법입니다.
제공되는 조건의 전체 세트는 여기에서 API 참조에서 확인할 수 있습니다.
이 튜토리얼에서는 영국의 사용자가 국가 전체의 네트워크 용량 문제로 인해 고해상도 버퍼링에 어려움을 겪고 있으므로 이 문제가 해결될 때까지 고해상도 렌더링을 제거한다고 가정해 보겠습니다.
PUT /accounts/{accountID}/conditions
Content-Type: application/json
Authorization: Bearer {access_token}이 API 호출에는 여러 조건 배열이 필요하지만 지금은 요청에 다음 본문을 포함하여 하나의 조건만 생성하겠습니다:
[
{
"name": "Cut off high-quality renditions for the UK",
"if": {
"request_country": [
"GB"
]
},
"then": [
"88b13752-3469-4e46-b4aa-49cd4f1685a6"
]
}
]이제 영국 내에서 표준 재생 API 요청을 하면(이번에는 config_id 매개 변수가 첨부되지 않음) 고품질 렌더링이 제거된 것을 볼 수 있습니다!
다음 단계는 무엇인가요?
이를 통해 배달 규칙의 강력한 기능과 유연성을 경험해 보셨기를 바랍니다. 지원되는 조건 및 조치의 전체 목록은 여기에서 확인할 수 있으며, 향후 추가했으면 하는 다른 사항이 있으면 고객 지원팀이나 계정 담당자에게 문의하여 알려주세요!
브라이트코브 고객들이 전송 규칙을 어떻게 사용하고 있는지 자세히 알아보려면 세븐 웨스트 미디어가 브라이트코브의 전송 규칙으로 비디오 콘텐츠 전송을 최적화하는 방법을 살펴보세요.
