添加提示點

簡介

提示點是視頻時間軸上的指定位置。播放視頻時，每次到達提示點時都會自動廣播一個事件-使用播放器API，您可以收聽這些事件並採取所需的任何操作。此外，您可以從播放器中存儲的視頻元數據中讀取所有提示點信息mediainfo對象，它使您能夠在視頻時間軸上標記提示點如果需要，可以某種方式。

提示點有兩種：

• 廣告提示點：用於標記應提出廣告請求的位置（如果視頻和播放器已啟用廣告功能）。
• 代碼提示點：這些提示點用於使用Player API採取某些操作-一些典型用途是顯示某種號召性用語（CTA）或顯示一些與視頻內容有關的圖像或文本，例如作為視頻疊加或播放器周圍的頁面。

範例應用程式

請參閱畫筆 CMS API 範例：添加提示點通過Brightcove學習服務（ @ rcrooks1969） 上密碼筆。

實作概觀

您可以在以下位置添加提示點Studio Media模塊。您還可以使用CMS API添加它們，這是我們在本示例中將使用的方法。

HTTP 方法

提示點可以在您添加時製作視頻或以後更新要求。在此示例中，我們將通過將其添加到現有視頻中影片更新請求，這意味著您將使用PATCH方法。

端點

更新視頻請求的端點是：

          https://cms.api.brightcove.com/v1/accounts/account_id /視頻/  video_id

要求主體

請求主體是一個JSON對象，可以包含許多視頻元數據項。在這裡，我們只看一下cue_points字段，該字段設置為提示點對象的數組，如以下示例所示：

          {
          "cue_points": [
              {
                "name": "Ad Cue Point",
                "type": "AD",
                "time": 2.0,
                "metadata": null,
                "force_stop": false
              },
              {
                "name": "Code Cue Point",
                "type": "CODE",
                "time": 4.0,
                "metadata": "The metadata might be text or the url for an image to display",
                "force_stop": true
              }
            ]
          }

提示點對象字段

下面是提示點對象字段的描述。

注意事項

• ^[1]從技術上講，提示點一直處於活動狀態，直到到達下一個提示點為止-因此，在可以從Brightcove Player中檢索到的提示點數組中，您將看到一個startTime和endTime以及time提示點。