使用 BC（）和獲取播放器（）方法

簡介

使用Brightcove Player進行開發時的基本要求是獲得對播放器的引用。在Brightcove Player 6.x的整個生命週期中，執行此操作的最佳做法已發生變化。這是您應遵循的最佳實踐（有關每個項目符號的詳細信息，請參閱本文檔的後面）：

• 在使用特定版本的播放器時獲取播放器參考<video>標籤，請執行以下一項操作：
  • v6.16.0 +使用videojs.getPlayer()方法。
  • v6.16.0之前的版本使用videojs()方法。
• 使用時進階（網頁內嵌入）播放器的實現，最佳實踐是：
  • v6.11.0 +使用<video-js>標籤。
  • v6.11.0之前的版本使用<video>標籤。
• 如果您要在頁面上手動實例化播放器，請使用bc()方法，它將生成對播放器的引用。

getPlayer()與videojs()

如果您已經使用Brightcove Player進行了一段時間的開發，幾乎可以肯定地看到了類似於以下代碼的代碼，這些代碼用於獲取對Player的引用並將其存儲在myPlayer變量：

  videojs('myPlayerID').ready(function(){
    var myPlayer = this;
  });

如果您正在使用v6.16.0 +這是API的更簡潔用法，也是推薦的最佳做法player.getPlayer()代替，如下所示：

  videojs.getPlayer('myPlayerID').ready(function() {
    var myPlayer = this;
  });
  

video-js標籤與video標籤

對於Brightcove Player v6.11.0 +這是使用的最佳做法<video-js>過度<video>。原因如下：

• 使用<video-js>將防止您可以通過使用<video>元件。在Chrome 67+版本中就是一個例子。Chrome會暫時顯示損壞的視頻圖標，直到<video>標籤將轉換為Brightcove Player。圖示會顯示如下：

  

• 在某些情況下，例如使用非視頻雲媒體時，<video-js>將使玩家對初始化過程有更多的控制權。這樣可以防止可能與瀏覽器相關的任何自動瀏覽器行為<video>元件。

bc()方法細節

的bc()方法用於在您選擇的時間實例化播放器。的延遲玩家實例化該文檔討論了用例和實現。的Brightcove Player示例：垂直音量控制顯示了bc()要將音量控制的方向更改為垂直的方法，該方法必須在實例化播放器之前發生。

該方法的語法為：

  bc(id,options)

其中：

• id：
  • 描述：視頻元素或視頻元素ID
  • 數據類型：字符串|元素
  • 必填：true
• options：
  • 描述：提供設置的選項對象
  • 數據類型：物件
  • 必填：false
• 該方法返回Brightcove Player實例

例如，您可能具有以下內容video-js標籤，然後使用JavaScript配置播放器：

  <video-js id="myPlayerID"
     data-embed="default"
     data-application-id=""
     controls=""
     width="640" height="360"></video-js>
  <script src="https://players.brightcove.net/1752604059001/default_default/index.min.js"></script>
  
  <script type="text/javascript">
    // +++ Define the player options +++
    var options = {
      controlBar: {
        volumePanel: {
          inline: false,
          vertical: true
        }
      }
    };
  
    // +++ Add the player attributes +++
    var myPlayerEl = document.getElementById("myPlayerID");
    myPlayerEl.setAttribute('data-account', 1752604059001);
    myPlayerEl.setAttribute('data-player', 'default');
    myPlayerEl.setAttribute('data-video-id', 5557662144001);
  
    // +++ Create the player +++
    bc(myPlayerEl, options);
  </script>

常規播放器配置選項（在播放器配置指南），以下可與bc()方法：