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

    獲取帳戶的所有配置文件

    此示例向您展示瞭如何檢索帳戶的所有“摘要配置文件”,以及如何過濾掉一些您可能不想顯示的項目。

    簡介

    獲取帳戶的所有提取配置文件非常簡單-這只是對API的簡單調用。 不太直接的是您對它們的處理方式。 如果要在某種應用程序中向用戶顯示配置文件以供用戶在攝取視頻時進行選擇,則需要了解和處理一些潛在問題。 這些問題圍繞著Brightcove正在從 舊版攝取系統 新的 動態投放。 您可以在下面閱讀有關動態投放系統優勢的所有信息 此概述; 這裡重要的是舊帳戶的含義。

    • 對於2017年XNUMX月之前創建的帳戶,該帳戶最初是為 舊版攝取系統
    • 如果該帳戶 沒有 尚未轉換為動態交付,仍為該帳戶設置了動態交付配置文件,並且 Ingest Profiles API 將退還他們。 如果用戶在使用時嘗試使用這些配置文件 Dynamic Ingest API,將返回錯誤。
    • 如果該帳戶 已被轉換為動態交付,但是未禁用舊版提取,仍將返回舊版提取配置文件; 這些通常不應使用,並且 不能 用於對已轉換為動態投放的視頻進行操作。
    • 如果您獲取了舊的攝取配置文件,除了當前的配置文件,您還將獲取許多 過時的 由於某些客戶仍在使用它們而保留在系統中的配置文件。 這些應該 決不 使用。
    • 傳統配置文件還可能包括多達3個用於實時流式傳輸的配置文件,通常不應將其用於提取VOD內容。
    • 最後,對於僅配置為動態投放的帳戶,可能會返回兩種動態投放配置文件:
      • “靜態”配置文件-具有固定格式的普通類型
      • 使用的“動態”配置文件 上下文感知編碼(CAE) 自動確定要在配置文件中設置的約束範圍內創建的最佳演繹集。

    該示例的目的是向您展示如何檢索帳戶概要文件並過濾不同類型以及在帳戶中創建的自定義概要文件的結果。

    獲取憑證

    要使用 Ingest Profiles API 您將需要適當的憑據。

    在大多數情況下,獲取憑據的最簡單方法是通過Studio Admin API身份驗證部分(需要您帳戶的管理員權限)。 看到 管理API身份驗證憑據 有關詳細信息。 在大多數情況下,您可能只想獲取所有權限 Ingest Profiles API 操作:

    Ingest Profiles API 權限
    Ingest Profiles API 權限

    如果您所需的權限在Studio中不可用,或者您希望直接從 OAuth API,請使用您的選擇 獲取客戶憑證 下面列出的文件。 無論選擇哪個選項,都需要詢問正確的操作權限。 以下內容可與cURL或Postman一起使用,以獲取對 Ingest Profiles API:

    "operations": [
      "video-cloud/ingest-profiles/profile/read",
      "video-cloud/ingest-profiles/profile/write",
      "video-cloud/ingest-profiles/account/read",
      "video-cloud/ingest-profiles/account/write"
    ]

    該應用程序

    源代碼

    在此找到與此樣本相關的所有代碼 GitHub存儲庫.

    示例應用

    見筆 Ingest Profiles API 示例:獲取帳戶的所有配置文件 通過Brightcove學習服務(@ rcrooks1969)上 CodePen.

    使用CodePen

    以下是有效使用上述CodePen的一些技巧:

    • 切換 player 通過點擊 結果 按鈕。
    • 點擊 HTML / CSS / JS 按鈕顯示一種代碼類型。
    • 點擊 在CodePen上編輯 在右上角將此CodePen分支到您自己的帳戶中。
    • 在此找到與此樣本相關的所有代碼 GitHub存儲庫.

    代理代碼

    為了在此頁面上構建自己的示例應用程序版本,您必須創建並託管自己的代理。 (Brightcove Learning Services使用的代理僅接受來自Brightcove域的請求。)一個示例代理與我們使用的代理非常相似,但是沒有可以阻止來自非Brightcove域的請求的檢查。 這個GitHub倉庫。 您還將在此處找到使用它的基本說明,以及有關在Proxy中構建應用的更詳盡的指南。 使用REST API.


    頁面最後更新於24年2020月XNUMX日