지원 지원 문의 | 시스템 상태 시스템 상태
페이지 내용

    De 구현livery 규칙

    이 주제에서는 Brightcove의 De를 구현하는 방법을 배웁니다.live미디어가 어떻게 생성되는지 사용자 정의 할 수있는 규칙live비즈니스 목표를 달성하기 위해 빨간색.

    WeGO 소개

    게시자는 종종 기술 및 비즈니스 이유로 미디어 매니페스트의 콘텐츠 특성을 수정해야합니다. 이러한 요구를 충족하기 위해 Brightcove는 Dynamic De에서 반환 된 매니페스트의 콘텐츠를 수정하는 규칙을 적용 할 수있는 프레임 워크를 만들었습니다.live너.

    Delive규칙은 조건과 조치로 구성됩니다.

    • 상태 -특정 작업을 트리거하는 "If"조건
    • 행위 -매니페스트 수정 방법을 정의하는 "Then"매개 변수

    De에 대한 자세한 내용은live규칙은 다음을 참조하십시오.

    계정 설정

    가격에 대해 알아보고 계정에이 기능을 사용하려면 계정 관리자에게 문의하세요.

    규칙 적용

    다음 순서도는live규칙이 적용됩니다.

    Delive적용된 규칙
    Delive적용된 규칙

    상태

    첫 번째 단계에서 지원되는 "if"조건은 다음과 같습니다.

    • 명시 적 요청 -구성 ID는 생성 한 작업의 ID입니다. 이 ID를 사용하여 Playback API 런타임에. 이 ID는 기본 서비스가 결정을 내릴 수 있도록하는 구성 값에 매핑됩니다. Playback API 적절한 응답 데이터를 반환합니다.

    • 장치 그룹 -사용자 에이전트 구문 분석에 의해 감지 된 장치 유형. 현재 지원되는 그룹은 다음과 같습니다.
      • 기계적 인조 인간
      • 애플 티비
      • Chromecast를
      • ipad
      • 아이폰
      • 데스크탑 크롬
      • 데스크탑 파이어 폭스
      • 데스크탑 사파리
      • fetchtv
      • ios- 기타
      • roku-7 / 8
      • 스마트 폰 일반
      • 태블릿 안드로이드
      • 태블릿에 빛나다
      • 알 수없는
       
    • 지리학 -요청 장치의 물리적 위치 :
      • 대륙
      • 국가

    행위

    첫 번째 단계에서 지원되는 작업 또는 "then"매개 변수는 다음과 같습니다.

    • Media Delivery CDN -주어진 Dynamic De 내에서 사용하도록 구성된 CDN에서livery 계정, 데 사용할 CDNlive미디어 세그먼트의 ry.

    • 변환 특성 -기본 미디어 변환의 특성을 기반으로 필터링합니다. 여기에는 다음이 포함됩니다.
      • 최소 비디오 비트 전송률
      • 최대 비디오 비트 레이트
      • 최소 비디오 해상도
      • 최대 비디오 해상도
      • 최대 오디오 변환 수
      • 최대 비디오 변환 수
      • 첫 번째 동영상 전송률
      • 불연속

    범위

    작업은 두 가지 수준에서 적용 할 수 있습니다.

    • 내계정 -특정 고객 계정에 대한 모든 요청에 ​​적용되는 작업
    • 특정 요청 -특정 요청에 대해 호출되는 작업

    작업은 위에 나열된 순서대로 적용됩니다. 이후 작업은 이전 작업보다 우선합니다.

    규칙 정의

    드 사용livery Rules API를 사용하여live너.

    Delivery 규칙 API

    그리고, Delivery 규칙 API 미디어를 제어하기위한 조건과 작업을 정의 할 수 있습니다.live너.

    그리고, 응답 드에서livery Rules API에는 conditions 정렬. 이 배열을 사용하면 여러 if / then 각각의 조건 then 하나 이상을 가리킴 액션 ID.

    추가하거나 삭제할 방법이 없더라도 conditions,이 작업은 conditions 정렬.

    기본 URL

    API의 기본 URL은 다음과 같습니다.

    https://delivery-rules.api.brightcove.com

    계정 경로

    모든 경우에있어 요청은 특정 Video Cloud 계정. 따라서 항상 계정이라는 용어 다음에 계정 ID를 기본 URL에 추가합니다.

    https://delivery-rules.api.brightcove.com/accounts/{accountID}

    권한 부여

    요청에 대한 액세스 토큰이 필요하며 Authorization 헤더에 있어야합니다. :

    Authorization: Bearer {access_token}

    액세스 토큰은 Brightcove OAuth 서비스에서 얻어야하는 임시 OAuth2 액세스 토큰입니다. 클라이언트 자격 증명을 얻고이를 사용하여 액세스 토큰을 검색하는 방법에 대한 자세한 내용은 Brightcove OAuth 개요.

    권한

    Playback Rights API에 대한 요청은 클라이언트 신임장 다음 권한이 있습니다.

    • video-cloud/delivery-rules/read
    • video-cloud/delivery-rules/all

    규칙 관리

    드livery Rules API는 다음 요청을 지원합니다. API에 대한 자세한 내용은 Delivery 규칙 API 참조.

    드 가져 오기livery 규칙

    다음 GET 요청을 사용하여 최신 버전의 De를 가져옵니다.live계정에 대한 규칙.

    GET /accounts/{accountID}
    API 응답

    다음은 응답 본문입니다. Delive규칙에는 일련의 조건과 일련의 작업이 포함됩니다.

    {
      "conditions": [
        {
          "name": "MyCondition1",
          "if": {
            "device_group": [
              "ipad"
            ],
            "request_country": [
              "string"
            ],
            "request_continent": [
              "AF"
            ]
          },
          "then": [
            "MyAction1"
          ]
        }
      ],
      "actions": [
        {
          "id": "MyAction1",
          "properties": {
            "min_video_bitrate": 0,
            "max_video_bitrate": 0,
            "first_video_bitrate": 0,
            "min_video_resolution": "string",
            "max_video_resolution": "string",
            "max_video_renditions": 0,
            "max_audio_renditions": 0,
            "preferred_cdn_provider": "string",
            "preferred_cdn_domain": "string",
          "video_codecs": [
            "string"
          ],
          "audio_codecs": [
            "string"
          ]
        }
        }
      ]
    }

    조건 얻기

    다음 GET 요청을 사용하여 계정에 대한 조건을 가져옵니다.

    GET /accounts/{accountID}/conditions
    API 응답

    다음은 응답 본문입니다.

    [
      {
        "name": "MyCondition1",
        "if": {
          "device_group": [
            "ipad"
          ],
          "request_country": [
            "string"
          ],
          "request_continent": [
            "AF"
          ]
        },
        "then": [
          "MyAction1"
        ]
      }
    ]

    업데이트 조건

    다음 PUT 요청을 사용하여 계정 조건을 업데이트하십시오.

    PUT /accounts/{accountID}/conditions
      Content-Type: application/json
      Authorization: Bearer {access_token}
      Body: {conditions object}
    

    조건 요청 본문

    다음은 조건에 대한 요청 본문입니다. 이것은 조건 개체의 배열입니다.

    [
      {
        "name": "MyCondition1",
        "if": {
          "device_group": [
            "ipad"
          ],
          "request_country": [
            "string"
          ],
          "request_continent": [
            "AF"
          ]
        },
        "then": [
          "MyAction1"
        ]
      }
    ]

    조건에 대한 필드 세부 정보는 다음과 같습니다.

    분야 거래증명방식 제품 설명
    name 조건에 대한 고유 식별자
    device_group 사용자 에이전트 구문 분석에 의해 감지 된 장치 유형 배열
    request_country 두 글자 국가 코드의 배열
    request_continent 두 글자의 대륙 코드 배열
    then 관련 작업의 고유 식별자

    액션 만들기

    다음 POST 요청을 사용하여 계정에 대한 작업을 만듭니다.

    POST /accounts/{accountID}/actions
      Content-Type: application/json
      Authorization: Bearer {access_token}
      Body: {actions object}
    

    작업 요청 본문

    다음은 작업 요청 본문입니다.

    {
        "properties": {
          "min_video_bitrate": 0,
          "max_video_bitrate": 0,
          "first_video_bitrate": 0,
          "min_video_resolution": "string",
          "max_video_resolution": "string",
          "max_video_renditions": 0,
          "max_audio_renditions": 0,
          "preferred_cdn_provider": "string",
          "preferred_cdn_domain": "string",
          "video_codecs": [
            "string"
          ],
          "audio_codecs": [
            "string"
          ]
      }
    }

    작업에 대한 API 응답

    다음은 작업 요청 본문입니다.

    {
        "id": "MyAction1",
        "properties": {
          "min_video_bitrate": 0,
          "max_video_bitrate": 0,
          "first_video_bitrate": 0,
          "min_video_resolution": "string",
          "max_video_resolution": "string",
          "max_video_renditions": 0,
          "max_audio_renditions": 0,
          "preferred_cdn_provider": "string",
          "preferred_cdn_domain": "string",
          "video_codecs": [
           "string"
          ],
          "audio_codecs": [
           "string"
          ]
      }
    }

    작업에 대한 필드 세부 정보는 다음과 같습니다.

    분야 거래증명방식 제품 설명
    id 작업에 대해 시스템이 생성 한 고유 식별자입니다. 이것이 actionID 업데이트 및 삭제 방법에 사용됩니다.
    properties 목적 특정 작업에 대해 정의 된 속성의 개체
    min_video_bitrate,
    max_video_bitrate
    정수 허용되는 최소 또는 최대 비디오 비트 전송률 (kbps) 설정
    first_video_bitrate 정수 첫 번째 동영상의 비트 전송률 (kbps) 설정
    min_video_resolution,
    max_video_resolution
    허용되는 최소 또는 최대 비디오 해상도 (WxH) 설정
    max_video_renditions 정수 최대 비디오 변환 수 설정
    max_audio_renditions 정수 최대 오디오 변환 수 설정
    preferred_cdn_provider 선호하는 CDN 공급자 설정
    preferred_cdn_domain 선호하는 CDN 도메인 설정
    video_codecs 비디오 코덱 배열
    audio_codecs 오디오 코덱 배열

    액션 얻기

    다음 GET 요청을 사용하여 계정에 대한 작업을 가져옵니다.

    GET /accounts/{accountID}/actions
    API 응답

    을 참조 작업에 대한 API 응답.

    액션 얻기

    다음 GET 요청을 사용하여 계정에 대한 특정 작업을 가져옵니다.

    GET /accounts/{accountID}/actions/{actionID}
    API 응답

    을 참조 작업에 대한 API 응답.

    액션 업데이트

    다음 PUT 요청을 사용하여 계정에 대한 작업을 업데이트합니다.

    PUT /accounts/{accountID}/actions/{actionID}
      Content-Type: application/json
      Authorization: Bearer {access_token}
      Body: {actions object}
    
    API 요청

    을 참조 조치 요청 본문.

    API 응답

    을 참조 작업에 대한 API 응답.

    액션 삭제

    다음 DELETE 요청을 사용하여 계정에 대한 작업을 제거합니다.

    DELETE /accounts/{accountID}/actions/{actionID}

    제한 사항

    De를 사용할 때 몇 가지 알려진 제한 사항이 있습니다.livery 규칙 :

    • 미디어 콘텐츠 -드live규칙은 Smooth 또는 pMP4 비디오에서는 작동하지 않습니다.
    • 미디어 콘텐츠 -드livery 규칙은 live 동영상.
    • 오디오 만 -드liveSSAI (Server-Side Ads)가 활성화 된 규칙에는 비디오 및 오디오 콘텐츠가 모두 필요합니다. 이것은 SSAI 제한 사항입니다.

    19 년 2021 월 XNUMX 일에 마지막으로 업데이트 된 페이지