play()
和pause()
方法被調用以根據播放器的位置開始和停止視頻。播放器範例
向內和向外滾動播放器。當播放器完全滾動到視圖中時,視頻或廣告將開始播放。當您將播放器滾動到視線之外時,視頻或廣告將停止播放。在此示例中,有前貼片,五秒鐘可跳過的中片貼和後貼片。
看筆18352滾動播放器查看廣告通過Brightcove學習服務( @ rcrooks1969) 上密碼筆。
原始碼
使用編碼器
以下是一些有效使用上述 CodePen 的提示:
- 按一下Result按鈕來切換播放器的實際顯示。
- 按一下HTML/CSS/JS按鈕以顯示其中一種代碼類型。
- 在本文件後面,應用程序中使用的邏輯,流程和樣式將在播放器 /HTML 配置,應用程序流程和應用程序樣式部分中討論。跟著這些章節中的資訊一起遵循的最佳方式是:
- 點擊 CodePen 中的EDIT ON CODEPEN按鈕,並在一個瀏覽器/瀏覽器選項卡中提供的代碼。
- 在 CodePen 中,調整您要顯示的程式碼。您可以在 CodePen 中變更不同的程式碼區段的寬度。
- 在其他瀏覽器/瀏覽器選項卡中查看播放器 /HTML 配置,應用程序流程和/或應用程序樣式部分。您現在可以遵循程式碼說明,並同時檢視程式碼。
使用的 API /外掛程式資源
API 方法 | 布萊特灣播放器外掛程式 |
---|---|
播放() | IM3 外掛程式 |
暫停() | |
上() |
在此代碼中使用的關鍵 JavaScript 事件是onscroll
。會傳送此事件,並在此程式碼中處理,每次捲動window
元素時。
播放器/HTML 配置
本節詳細說明玩家建立期間所需的任何特殊配置。此外,除了頁面內嵌播放程式實作程式碼之外,還會說明必須新增至頁面的其他 HTML 元素。
播放程式組態
玩家已加入muted
屬性,以避免自動播放問題。如需詳細資訊,請參閱自動播放考量文件。
其他 HTML
HTML <script>
標籤用於導入IMA3插件的jQuery庫和JavaScript。在HTML的head
部分,IMA3的CSS是使用HTML導入的<link>
標籤。
應用程式流程
這個應用程序背後的基本邏輯是:
- 配置IMA3插件。
- 偵聽捲動事件。
- 當處理滾動事件時,檢查播放器是否在視口中。
- 如果播放程式在視埠中,請播放視訊,如果不是,請暫停視訊。
- 跟踪廣告事件,以確定當前是否正在使用常規的Brightcove Player或廣告播放器。
配置IMA3插件
找到標記的代碼:
// ### Configure IMA3 plugin
將IMA3插件配置為使用VMAP配置,該配置將播放前,中和後插播廣告。
監聽窗口元素上的任何滾動事件
找到標記的代碼:
// ### Execute every time page is scrolled ###
這一行代碼調用checkIfVideoInView()
每個方法window.onscroll
事件派發。
處理捲動事件
找到標記的代碼:
// ### Called on scroll, check if in view and the play/pause ###
的checkIfVideoInView()
事件處理函數通常會檢查播放器是否在視口中,然後播放或暫停視頻。至關重要的是,代碼確定正在使用哪個播放器,普通播放器或廣告播放器。布爾值isAdPlaying
根據廣告事件進行切換(在代碼底部的事件處理程序中),然後使用條件(三元)運算符來分配currentPlayer
變量正確的球員。該isScrolledIntoView()
方法用於 if 語句來檢查播放器是否在視口中。當然,該isScrolledIntoView()
方法返回一個布爾值。
檢查播放器是否完全在視口中
找到標記的代碼:
// ### Checks if player is in view ###
該函數返回一個布爾值,使用 jQuery 來確定播放器是否完全在視口中。
追踪正在使用哪個玩家
找到標記的代碼:
// ### Set Boolean value for if ad is playing ###
監視許多廣告事件,並相應地設置布爾值。
應用程式樣式
唯一的 CSS 設置播放器大小。
外掛程式碼
通常,當將 JavaScript 轉換為布萊特灣播放器插件名義更改時,需要更改。一個必要的更改是用定義插件的代碼替換ready()
方法的標準使用。
以下是將與播放器一起使用的 JavaScript 代碼的常用開始:
videojs.getPlayer('myPlayerID').ready(function() {
var myPlayer = this;
...
});
您將變更第一行,以使用標準語法來啟動 Brightcove 播放程式外掛程式:
videojs.registerPlugin('pluginName', function(options) {
var myPlayer = this;
...
});
如前所述,您可以在該文檔的相應GitHub存儲庫中看到該插件的JavaScript代碼:滾動到視圖ads.js。
在播放器上使用外掛程式
一旦您將插件的 CSS 和 JavaScript 文件存儲在可訪問互聯網的位置,您可以使用該插件與播放器。在 Studio 的 PLAYS 模塊中,您可以選擇一個播放器,然後在插件部分將 URL 添加到 CSS 和 JavaScript 文件中,並添加名稱和選項,如果需要選項。