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

已識別的已知問題包括：

• 一室公寓
  • 媒體模組
  • 玩家模組
  • 即時視訊
  • 分析模組
  • 聽眾模組
  • 社交模組
  • 上傳模組/動態擷取
• 布萊特灣玩家
• 布萊特灣播放器外掛程式
• 布萊特灣直播
• Brightcove 觀眾洞察

• 分析 API
• CMS 應用程式
• 動態擷取 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-ended和ads-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>標記使用width和height屬性，來自最後一個玩家的玩家 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 處於維護模式，這是一個外觀問題，因此將無法修復。

• 廣告與飛輪插件
• 廣告與 IMA3 插件
• 顯示錯誤訊息外掛程式
• 品質選擇外掛程式

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 錯誤。