支持 聯繫支持 | 系統狀況 系統狀態
頁面內容

    實施Delive規則

    在本主題中,您將學習如何實現Brightcove的Delivery規則,可讓您自定義媒體的顯示方式live紅色以滿足您的業務目標。

    概述

    出版商出於技術和商業原因,經常需要修改其媒體清單的內容特徵。 為了滿足這些需求,Brightcove創建了一個框架,可以在其中應用規則,以修改從Dynamic Dem返回的清單內容。live瑞

    Delive規則由條件和動作組成。

    • 條件 -觸發特定動作的“如果”條件
    • 動態 -定義清單修改方式的“然後”參數

    有關De的更多詳細信息livery規則,請參閱以下內容:

    帳戶設定

    請與您的客戶經理聯繫,以了解有關定價的信息並為您的帳戶啟用此功能。

    適用規則

    以下流程圖顯示了live應用ry規則。

    Delive適用的規則
    Delive適用的規則

    條件

    第一階段支持的“ if”條件包括:

    • 明確要求 -配置ID是您創建的操作的ID。 您將使用此ID傳遞給 Playback API 在運行時。 該ID映射到配置值,這些配置值允許基礎服務做出由 Playback API 返回適當的響應數據。

    • 設備組 -用戶代理解析檢測到的設備類型。 當前支持的組包括:
      • 機器人
      • AppleTV的
      • 的Chromecast
      • ipad公司
      • iPhone
      • 桌面鉻
      • 桌面Firefox
      • 桌面瀏覽器
      • 抓取電視
      • ios-other
      • roku-7 / 8
      • 智能手機通用
      • 平板電腦
      • 平板電腦
      • 未知
       
    • 地理 -請求設備的物理位置:
      • 大陸
      • 國家

    動態

    第一階段支持的操作或“ then”參數包括:

    • 媒體部liveCDN -從配置用於給定動態De的CDNlivery帳戶,用於de的CDNlive媒體細分

    • 渲染特徵 -根據基礎媒體再現的特徵進行過濾。 這些包括:
      • 最低視頻比特率
      • 最大視頻比特率
      • 最低視頻分辨率
      • 最大視頻分辨率
      • 音頻再現的最大數量
      • 視頻再現的最大數量
      • 第一個視頻比特率
      • 間斷性

    範圍

    可以在兩個級別上應用操作:

    • 帳戶 -適用於對特定客戶帳戶的所有請求的操作
    • 具體要求 -針對特定請求調用的操作

    將按照上面列出的順序執行操作。 以後的動作將覆蓋以前的動作。

    定義規則

    使用德livery Rules API自定義媒體live瑞

    Delivery規則API

    Delivery規則API 允許您定義條件和操作來控制您的媒體live瑞

    響應 從德livery Rules API包含一個 conditions 數組。 該數組允許您創建多個 if / then 每個條件 then 指向一個或多個 動作編號.

    即使沒有添加或刪除的方法 conditions,您可以通過更新 conditions 數組。

    基本網址

    API的基本URL為:

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

    帳戶路徑

    在所有情況下,都將針對特定 Video Cloud 帳戶。 因此,您將始終在基本URL中添加術語“帳戶”和“帳戶ID”:

    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 Rules API參考.

    得到德live規則

    使用以下GET請求獲取De的最新版本livery帳戶規則。

    GET /accounts/{accountID}
    API響應

    這是響應正文。 請注意,livery規則包含一組條件和一組操作。

    {
      "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規則:

    • 媒體內容 -的livery規則不適用於Smooth或pMP4視頻。
    • 媒體內容 -的livery規則不適用於 live 視頻。
    • 僅音頻 -的live啟用服務器端廣告(SSAI)的ry規則需要視頻和音頻內容。 這是SSAI的限制。

    頁面最後更新於19年2021月XNUMX日