已知問題:工作室、布萊特灣播放器和 API

已識別的已知問題包括:

一室公寓

使用 Chrome 的翻譯功能會破壞一些工作室功能
使用 Chrome 的翻譯功能翻譯 Studio 模塊將導致某些功能中斷。

媒體模組

使用 IE 11 捕獲圖像
當視頻寬高比為 1:1 或 4:3 時,使用 IE 11 捕獲圖像將不起作用。
包含雙位元組字元的來源檔案名稱
在媒體模組中重新轉碼後,包含雙位元組字元的來源檔案名稱會亂碼。
媒體分享

分享大量影片時,Brightcove 建議一次分享最多兩頁的影片。一次分享大量影片可能會導致逾時錯誤。

不支援在已經包含字幕的共享視訊中新增字幕。

剪裁即時串流所建立的視訊媒體共用將失敗。

排程視訊
由於播放 API 和目錄快取視訊最多 10-15 分鐘,因此要求排定視訊在接下來的幾分鐘 (最多 20 分鐘) 可能無法取得可播放的視訊,直到快取重新整理為止。

玩家模組

預先載入設定
由於 Internet Explorer 中的錯誤,使用 IE 時可能會忽略預先載入設定。
跨網域存取資料來源設定
如果已針對網域限制的 Brightcove 播放程式啟用這個網際網路資源管理器原則設定,播放程式將不會載入 IE 11 中。這似乎是 IE 中的一個錯誤,並且沒有已知的解決方法。如果您希望受網域限制的玩家在 IE 11 中工作,請關閉此設定。

即時視訊

不活動時仍發布的重複事件顯示播放的最後 3 段
如果 SEP 重複事件仍在頁面上發布並且客戶端當前未進行流式處理,結果是最後 3 個片段(約 18 秒)被緩存並將播放。

解決方法

防止這種情況的一種方法是通過添加包含如下代碼的插件 在播放器中實現實時自定義錯誤消息

// Listen for a change on the durationmyPlayer.on("durationchange", ()=>{
// Save the duration to a local variable
var duration = myPlayer.duration();

// Check if the duration is a finite number (VOD)
// or if it's infinite (Live).
// If it's a VOD it would mean that the recurrent stream is over
// and the custom image would be displayed.
var isLive = !Number.isFinite(myPlayer.duration())

if(!isLive && duration !== 0){myPlayer.pause();myModal.open();
布萊特灣玩家計算已完成現場活動的視頻觀看次數
Brightcove 播放程式會在每次載入遠端資產時都會計入 ideo_view,即使它是一個已完成的即時活動,且其中包含空白或不再可擷取的 HLS 播放清單也是如此。因應措施:停用、取消排程或刪除視訊。

觀眾洞察

服務器端廣告插入 (SSAI) - 前置廣告

問題

在使用前段廣告尋求播放至影片開頭時,會觸發ads-ad-endedads-pod-ended事件。

因應措施

一個可能的解決方法是使用

player.currentTime(0.1)

而不是這個

player.currentTime(0)
 

分析

總帶寬報告僅適用於舊的提取視頻
“總帶寬”數據字段當前不適用於動態傳遞,因此自定義報告的此選項將不可用。
由於廣告封鎖程式,分析資料可能無法正確
分析資料 (同時透過 UI 和 API 取得) 可能因為廣告封鎖程式 (例如 UBlock) 封鎖在用戶端電腦上提交分析資料,所以可能會造成不正確的影響。
針對某些視訊顯示 0 位元組的自訂報告
使用動態傳遞內嵌設定檔擷取的視訊會在自訂報告中顯示 0 bytes_Fetes。
使用多個篩選器的自訂報告
使用多個過濾器時,將使用 AND 操作。例如,如果您添加兩個過濾器,視頻標籤玩家 , 只有帶有指定標籤的視頻在指定的播放器中查看將被返回。
使用依視訊標籤篩選功能的自訂報表
建立自訂報表時,使用「依視訊標籤篩選」功能會有限制。它只會在資料庫中使用該特定標籤考慮多達 2,000 部影片。如果具有特定標籤的影片數量大於此,我們建議您取得未篩選的報表,其中包含標籤,並使用試算表軟體在本機執行篩選。
「其他/第三方」出現在績效報告
在 Video Cloud 播放器 (例如遠端資產) 中播放非您的 Video Cloud 媒體櫃的視訊時,系統會顯示其他/第三方,而不會顯示相關聯的視訊 ID。
已更新的影片名稱未反映在分析中
Analytics 學習影片標題的唯一時間,就是播放器將影片標題傳送至 Analytics (分析) 作為播放信標的一部分。如果影片標題有所變更,在播放影片之前,分析資料將不會有新的影片標題。這可能會導致更新視訊名稱的情況,如果沒有錄製播放,則舊的視訊名稱會反映在 Analytics (分析) 報表中。2013 年 3 月之前時段的資料經常遭受此問題影響,而且會顯示只有數字的中繼資料。例如,影片標題可能會顯示為 1230123012。這是因為這個時期的資料是在舊的分析系統中擷取的。
視頻名稱和播放器名稱顯示???????在分析用戶界面
對於十月 2013,元數據(視頻名稱和播放器名稱)可能看起來像一堆?????秒。此問題會影響其中繼資料具有雙位元組字元且在 2013 年 10 月具有視訊檢視次數的發行者這個問題與我們擷取要在 Analytics UI 中顯示的中繼資料的方式有關。從 2013 年 11 月開始,Analytics 系統具有額外的保護措施,以防止隨事件指標一起傳送的中繼資料遭到損毀。
報告時區
報告時區是用來計算報告資料的日期界限。變更報告時區設定只會影響未來的資料,而且不會追溯套用變更。如果更改此設置,則在查看應用更改的日期範圍時,數據中可能會出現平坦點或峰值。對該設置的更新可能不會立即生效,並且分析數據可能會繼續引用舊設置,直到系統處理更改為止。
參與資料以每日粒度儲存
參與資料會使用 UTC 時間以每日粒度儲存,有時可能會在參與報告的「受眾 x%」表格中包含 2 整天的資料。
網際網路總管支援
分析模組需要網際網路總管 11 或更新版本。
裝置製造商的「其他」結果數目很多
在某些情況下,您可能會看到裝置製造商的大量「其他」結果時,資料收集器無法辨識使用分析資料user_agent傳送給它時。我們已經確定了這個最常見的原因是由 Instagram 創建的自定義 user_agent 字符串,但可能還有其他人。

觀眾

觀眾活動顯示觀看百分比:0 和監看時間:0
有時候,互動事件會在沒有播放視訊的情況下觸發,或在視訊傳送第一個信標之前觸發。這可能會導致記錄具有互動性但沒有視訊活動的檢視事件 (觀看 0%,觀看 0 秒)。
網際網路總管支援
受眾領先表單需要網際網路總管 11 或更新版本。

社交

Ghostery 瀏覽器外掛程式可能會干擾社交模組

Ghostery 瀏覽器外掛程式可能會干擾 Social 模組,使其無法正確載入。

因應措施:將工作室添加到 Ghostery 的白名單。

上傳模組/動態擷取

如果裝置上的時鐘與實際時間不相符,透過上傳模組上傳失敗
上傳已授權一段時間。如果您的時鐘時間與實際時間不同超過 15 分鐘,您會在上傳時收到錯誤訊息。
透過動態擷取重新轉檔會更新視訊啟用日期
當您使用動態擷取來重新轉換視訊時,視訊的啟用日期會更新為目前的日期。如果您使用依啟用日期排序的智慧型播放清單,這會影響播放清單中影片的順序。
檔案名稱
視訊檔案名稱 (包括副檔名) 不得超過 120 個單位元組 (60 個雙位元組) 字元。如果這樣做,視訊將會成功攝入,但您將無法在稍後重新轉碼。

布萊特灣玩家

查看 Brightcove 玩家發行說明,查看最近的發行版本是否已修正過去的已知問題。

Safari 15 新增播放速度按鈕
Brightcove 不會覆蓋用戶首選項,除此之外,Apple 聲明 This property cannot be set for HTML5 audio/video elements on iOS
使用以數字開頭的元素 ID 會導致 CSS 和 JavaScript(document.querySelector)出現問題
如果元素 ID 以數字開頭,則以元素 ID 或 JavaScript 為基礎的 CSS 規則嘗試使用文檔querySelector()querySelectorAll()方法獲取對元素的引用將失敗。有一個痛苦的 解決方法 ,但更好的解決方案是避免這樣做。
在全屏模式下,Player 的控制欄不會在 Windows 10 觸控 PC 上消失
沒有已知的解決方法。
id設定為的圖元default
眾所周知,如果頁面id="default"上有一個元素,Brightcove 播放器表現不佳。博客文章 DOM:元素 ID 是全局變量解釋了為什麼這是一個問題。這個問題的一個常見症狀是MEDIA_ERR_UNKNOWN錯誤。
廣告在Safari和/或iOS上被屏蔽
Apple對Safari和iOS的跨域策略所做的更改可能會導致廣告無法播放。

解決方法

我們通過添加其他CORs標頭解決了SSAI的此問題。如果您使用的是客戶端廣告,這將無法解決問題,因為必須從服務器或託管服務發送CORs標頭。我們添加的標題是:

access-control-allow-headers: Server,Range,Content-Length,Content-Range
          access-control-allow-headers: X-Requested-With,Origin,Range,Accept-Encoding,Referer
          access-control-allow-methods: GET,HEAD,OPTIONS
          access-control-allow-origin: *
主控台警告

Brightcove Player 可能會生成警告出現在瀏覽器的控制台中。與錯誤消息相反,警告是無害的,並且不會影響播放。此處會顯示警告的範例:

主控台警告
沒有海報或縮圖影像的影片
沒有縮圖/海報影像的影片可能會在載入播放器時出現錯誤。這會影響行動 SDK 播放程式的方式,可能會造成玩家當機。
每當播放暫停時,網際網路總管會將其播放速率重設為 1.0。
這在 Safari 14(大蘇爾版本)中不再是一個問題。
僅限音訊內容的 IE11 影像未顯示
當只播放 IE11 中的音頻內容時,視頻靜態圖像將不會顯示,只能看到黑屏。圖像可以用下面的代碼保留:
  .vjs-has-started .vjs-poster {
  display: block;
  }
  
自動進階播放清單
對於 Safari,如果播放清單可見,且播放程式的預先載入設定設定為none,則下一部影片的自動播放將會無訊息失敗。
Apple 用戶設置阻止 Brightcove 播放器自動顯示字幕
iOS 的自動字幕可以通過在系統偏好設置 > 輔助功能 > 字幕 >然後選擇更喜歡隱藏式字幕和 SDH複選框。
關聯式功能表
在靠近播放器右邊或底部邊緣的視訊上按一下滑鼠右鍵時,播放程式快顯功能表會顯示在螢幕外。
在頁面上使用具有相同的 player_id 的不同大小的多個玩家

如果多個播放器在一個頁面上有相同的id並且在裡面指定不同的尺寸<video>標記使用widthheight屬性,來自最後一個玩家的玩家 CSS 將應用於所有玩家。

因應措施

  • 如果您希望他們有不同的尺寸或風格/李,請使用不同玩家 ID 的玩家 >
  • 為使用 CSS 提供播放器大小調整的播放器定義一個類,並將類添加到不同播放器的視頻標籤
FastClick.js 會導致不正確的事件處理
使用 FastClick.js 會導致我們自訂控制列內的不正確事件處理。這可能會導致無法在行動裝置上使用我們的控制列。
視頻在瀏覽器和火狐上顯示灰色

使用 Chrome 和 Firefox 時,藍洞播放器中的影片可能會以灰色顯示。這可能是因為硬體加速和/或 NVIDIA 驅動程式設定所致。

因應措施:開啟 NVIDIA 控制台。在「視訊」下選取「調整視訊色彩設定」在 [ 如何進行色彩調整 ] 下方,選取 [使用 NVIDIA 設定]。在 [ 進階] 下,確定 [ 動態範圍]為 [ 完整] (0-255)而非限制 (16-235)應取消核取動態對比度增強功能。谷歌瀏覽器幫助論壇上已報告此問題

使用模擬器

無論您是使用 Chrome 裝置模式或其他模擬器來測試視訊播放,請注意,模擬器無法準確地呈現實際裝置的執行方式。雖然您可以在開發期間使用模擬器進行初始測試,但最好使用真實設備以獲得準確的結果。

使用 Chrome 裝置模式測試播放時,您可能會看到以下訊息:「在設備模式下使用 Chrome 只是在 Chrome 中呈現該設備的視口和用戶代理字符串,這不是實際設備的執行方式的準確表示。」

使用data-setup
您不應該data-setup 與布萊奇灣玩家一起使用。您可能會在 API 文件data-setup 中看到使用,但這是因為該文件是直接從 Video.js 播放程式原始程式碼產生的,而且您可以將該屬性與純 Video.js 的video 標籤搭配使用。屬性將配置信息發送給玩家,但 Brightcove Player 使用不同的方法來執行此任務,這使得data-setup 不可靠。
通訊協定感知來源選擇與 DASH
使用 DASH 內容時,無法使用通訊協定感知來源選取項目。它僅適用於 HLS 和 MP4 內容
在 Safari 中使用 iframe 播放器實現時引發控制台錯誤
在 Safari 中使用 Brightcove 播放器的 iframe 實現時,您將在控制台中看到以下錯誤消息:阻止來源為“https://players.brightcove.net”的框架訪問來源為“#DOMAIN NAME#”的框架。通訊協定、網域和連接埠必須相符。報告的錯誤不會影響播放。
Safari 的字幕選單中會顯示「未知」。
這是一個薩法里/蘋果限制。較新版本的布萊特灣播放器使用 Safari 內置的原生字幕功能,這是標準行為。這是由蘋果公司記錄: https://developer.apple.com/library/ios/qa/qa1801/_index.html
在非 Flash 環境中進行全螢幕

在為播放器禁用 Flash 或基於 Flash 的 HLS 的環境中,播放器使用style 的屬性video 標記,全屏查看在某些瀏覽器中可能無法正常工作。

解決方法:刪除style 屬性來自video 標記,而是在頁面樣式表中創建一個規則,如下所示:

  .video-js{
  width:640px;
  height:360px;
  }
  
  
社交分享
在桌上型電腦上,在廣告期間看不到社交分享按鈕。
HTTPS

在大多數的桌面瀏覽器上,當資訊清單和視訊區段都透過 HTTPS 連線提供時,Brightcove 播放程式只會在 HTTPS 網站上播放 HLS。這是由於最近幾個瀏覽器的更改,這些瀏覽器更嚴重限制了非 SSL 內容。這會影響桌面電腦上的 Chrome、Firefox 和網際網路資源管理器的使用者。它不會影響 Safari 使用者或行動瀏覽器,也不會影響 MP4 轉譯的播放。

我們正在處理視訊雲端管理資產的這項限制;如果您管理自己的 CDN 和轉碼 (遠端資產),則必須將 CDN 設定為支援 HTTPS 傳遞資訊清單和視訊內容。

全螢幕顯示

在支援全螢幕 API 的較新瀏覽器中,必須套用頁面內 CSS 規則,以確保播放程式在切換至全螢幕時縮放為 100%。否則,播放程式會在全螢幕顯示中以原始大小顯示。有關詳細信息,請參閱全屏顯示話題在調整播放器大小文檔。

對於 IE10 和更早版本,沒有全屏 API 支持,將打開一個新窗口,但玩家不會調整大小以填充窗口。這是因為尚未套用任何樣式來調整播放器大小。由於視窗無法捲動,因此您只能看到網站的某個部分,而且根本沒有播放程式。

多個視頻發布在一個頁面上與 HapyAK 章節

當有 HapyAk 章節的單一頁面上發佈多個視訊時,可能會顯示錯誤的章節。

解決方法

使用這個腳本:https://github.com/brightcove/gallery-in-page-snippets/blob/master/snippets/hapyakFix.js .但是,閃存播放(IE11/Win7)無法避免此問題,因此需要在 IE11/Win7 的情況下實現 HTML5 後備。

阿卡邁高清和 HDS
布萊特灣播放器不支援透過 Akamai HD 或 HDS 傳送方式進行視訊傳送。
錯誤:d.off 不是一個功能

在播放器中切換不同格式 (例如 MP4 和 HLS) 時,可能會發生此錯誤,由已知錯誤引起的。在錯誤修正之前,您可以簡單地重試造成問題的程式碼。下列程式碼是修正應用程式中錯誤的範例:

  try {
  myPlayer.catalog.load(video);
  } catch (e) {
  myPlayer.catalog.load(video);
  }
  myPlayer.play();
  
  
HLS 影片持續時間
這是可能的,在控制欄中顯示的持續時間可能會從初始顯示變化。一旦所有的 HLS 段被加載,持續時間可能會更新。
必要
如果您使用 RequireJS,則可能必須使用該bc() 方法來實例化播放器。使用該方法的需求將由如何/何時加載玩家資產來決定。有關更多信息,請參閱要求 JS 和 Brightcove 播放器文檔。
引用網址與描述網址
referrer_url 值在 iOS 和安卓設備之間可能具有不同的值。因此,建議改用該description_url 值。這個值在所有平台和裝置上都是一致的。
在 Safari 上的循環屬性
循環屬性在 Safari 瀏覽器上無法正常工作。您可以使用 Brightcove 玩家示例中詳細的解決方案:建立「視訊迴圈」文件。
野生動物園的字幕
由於 Safari 使用本機功能來設置字幕樣式,因此字幕設置菜單選項在CC Safari 瀏覽器(iOS 和 macOS)上的菜單。
使用名為全局的 HTML 元素 ID
您不應將進階 (頁內嵌) 播放程式實作程式碼嵌套在父<div> 標籤中,並id 指派該值global 。這會導致布萊特灣播放器的問題。
玩家版本 5 圖標問題
Brightcove 播放器第 5 版在章節和字幕上使用相同的圖示。由於版本 5 處於維護模式,這是一個外觀問題,因此可以解決問題很懷疑。

布萊特灣播放器外掛程式

你將被鏈接到特定的插件文檔,所以看到一個插件的已知問題。由於版本 5 處於維護模式,這是一個外觀問題,因此將無法修復。

Android

  • Brightcove 播放器進度控制和音量滑桿無法通過 Android 上的 TalkBack 的原生手勢調整。這是由於平台的限制。相反地,使用者必須直接與元素互動。在 Android 上,用兩根手指點兩下,使用者可以將進度或音量調整至兩隻手指點兩下的位置。
  • 在設備上,HLS 視頻的進度條可能不同步,因為 HLS 在 Android 上不能很好地工作。視頻的總持續時間也可能會錯誤地顯示為 0:01。
  • 存在多個可訪問性問題本國的適用於所有 Android 版本的手機和平板電腦上的瀏覽器。Talkback 不會為任何播放器控制項提供音訊和震動回饋。(此問題適用於 Android 設備上的附加內容 Chrome 瀏覽器,僅適用於本機瀏覽器。
  • 在裝置上,錯誤訊息的輕觸事件不會冒泡到父視訊元素。這表示一旦出現錯誤訊息,就無法關閉。
  • 在 Android 設備上,當導航控制欄中的播放器菜單(如字幕或品質選擇)時,長按菜單中的項目後,菜單可能會「卡住」在打開狀態。這是因為 Chrome 添加了:hover 偽類。在玩家的其他地方長按一下,通常會關閉選單。

瞭解如何建立使用適用於安卓系統的 Brightcove 播放器開發套件的安卓應用程式

iOS

  • 「亮灣播放器」進度控制和音量滑桿無法透過 iOS 上的「旁白」的原生手勢調整。這是由於平台的限制。相反地,使用者必須直接與元素互動。在 iOS 上,使用者必須輕觸兩下以選取進度列或音量滑桿,然後按兩下並按住即可讓使用者調整時間或音量。
  • iOS 上的野生動物園從未預加載。如需詳細資訊,請參閱 Safari HTML5 音訊和視訊指南
  • 切換至其他應用程式時,iOS 中會發生播放器錯誤。當 Brightcove 播放器中的視頻在 Safari/Chrome 的 iOS 設備上播放時,播放器將在切換到另一個應用程序後出錯,然後在一分鐘或更長時間後切換回 Safari/Chrome。

蘋果手機

  • 在 iPhone 上,社交分享將無法運作。由於 iOS 手機切換為原生全螢幕,因此您無法從 iPhone 分享影片。
  • 在 iPhone 上,錯誤訊息的輕觸事件不會冒泡到父視訊元素。這表示一旦出現錯誤訊息,就無法關閉。

瞭解如何建立使用 iOS 版 Brightcove 播放器 SDK 的 iOS 應用程式

視窗 8

  • 不支援隨附廣告。
  • 在 Windows 8 平板電腦上,尋找不適用於標準的 HTML/MP4 播放。它適用於 HLS 技術。
  • 在 Windows 8 平板電腦上,廣告工作,但同伴會導致瀏覽器崩潰。
  • 在 Windows 8 平板電腦上,HLS,快閃記憶體,即時和嵌入類型都支援。
  • 在 Windows 8 手機上播放 MP4,但不支援快閃記憶體或 HLS。
  • 在 Windows 8 手機上,無論嵌入類型是 iframe 還是內聯,一旦您點擊播放,播放將始終以全屏顯示。這表示重疊在播放開始後不會顯示。
  • 無法啟用註解。

Chrome

  • 音訊位元率低的轉譯時發生問題

    由於 Chrome 瀏覽器實現上的 MSE 上存在錯誤,這裡記錄了:

    https://bugs.chromium.org/p/chromium/issues/detail?id=534301

    如果正在嘗試轉譯的音頻配置文件與 AAC-LC 不同,在 BC 播放器的第 5 版或更高版本的瀏覽器上播放將失敗(顯示 MEDIA_ERR_DECODE)。

    為了避免在新內嵌的內容上發生這種情況,客戶必須確保他們

    • 使用音訊位元率等於或大於 48kbps
    • 在其 DI 配置文件中包括以下設置:"max_aac_profile": "aac-lc"

    為了避免在現有內容上發生這種情況,選項包括:

    • 按照上述建議重新轉碼
  • Html5 視訊的要求可能會保持擱置狀態,而且視訊永遠不會載入。見谷歌的文檔在這個問題上。

Firefox

  • 安卓版火狐瀏覽器:沒有官方支持,但如果可能的話會嘗試解決錯誤。
  • 據報導火狐版本 42 可能有布萊特灣播放器的播放問題。這個問題似乎與 Firefox 使用硬件加速設置的設置有關。勾選此選項 (啟用) 時,視訊播放程式只會播放音訊,只會顯示靜態影像。這個問題的解決方法是禁用此選項,如下所示:選項-> 進階-> 一般-> (取消勾選) 在可用時使用硬體加速
  • 如果您的視頻內容的第一幀的開始演示時間戳(pts)大於 0,則火狐播放器可能會在 Firefox 上超時。目前建議的解決方案是重新編碼您的內容。請注意,重新編碼並不意味著重新轉換。原始主版將需要重新上傳。如果這樣無法解決問題,請聯絡客戶支援以取得進一步協助。

Internet Explorer

  • 設定為自動顯示在視訊上的字幕 (檢查媒體模組中註解的「預設」設定) 無法與 IE11 搭配使用
  • 在視窗 8 和視窗 10 上播放邊緣和 IE11 時,音訊高於 48 kHz 的影片將會失敗。這是微軟的限制。看這份微軟文件更多細節。
  • IMA3 閃存廣告在 IE 瀏覽器上效果更好。谷歌 IMA3 不支持 IE 瀏覽器上的 Flash 和 HTML 廣告,但在我們的測試中,我們發現 Flash SDK 目前更加強大。

Safari

  • 沒有已知問題

IM3

  • 使用 Google IMA3 可略過廣告時,「略過廣告」按鈕沒有分頁索引,因此無法使用鍵盤導覽至這些按鈕。因此,誰依賴於鍵盤導航的觀眾將無法跳過廣告。

Brightcove Live

  • 當設定h264_profile baseline 或未新增至工作要求時,會在使用火狐 v57 的視窗 10 上造成問題。h264_profile
  • 到達直播結束時,播放器可能會顯示PLAYER_ERR_TIMEOUT 錯誤。