IVS Web 播放器 SDK 中的已知問題和解決方法
本文件列出您在使用 Amazon IVS Web 播放器 SDK 時可能遇到的已知問題,並建議潛在的解決方法。
-
在 iOS 行動裝置瀏覽器 (例如 Safari 或 Chrome) 上播放錄製的內容 (也稱為 VOD) 時,向後搜尋將會使播放器靜音。
解決方法:移至其他影片位置後呼叫
player.setMuted(false)
。 -
在 iOS 行動裝置瀏覽器上播放錄製的內容時,直接選擇所需位置時,向後搜尋會間歇性地運作。
解決方法:將拖動條拖曳至所需位置。
-
在 iOS 行動瀏覽器上播放錄製內容時,
player.seekTo()
呼叫無法穩定運作。解決方法:於
loadeddata
事件後為影片 HTML 元素設定currentTime
。例如:videoEl.addEventListener('loadeddata', () => { videoEl.currentTime = 30; // seek 30s from the beginning });
-
在 iOS 行動裝置瀏覽器上播放即時串流或錄製的內容時,字幕可能不會以不同的大小呈現,而且可能會重新呈現多次。
解決方法:無。
-
在 iOS 行動瀏覽器上播放即時串流或錄製內容時,
player.getQualities()
呼叫未傳回可用品質清單。解決方法:無。在 iOS 瀏覽器上,播放器僅支援自動品質模式。
-
啟用本機 HTML5 控制項時,呼叫
setQuality()
會遭到忽略。解決方法:在呼叫
player.setQuality()
之前停用 HTML5 控制項。 -
在 iOS 行動瀏覽器上播放靜音的即時串流時,恢復非使用中的播放器分頁 (例如分頁切換或裝置鎖定/解鎖) 時,可能會出現播放器不穩定 (例如黑色畫面或螢幕凍結、緩衝) 的現象。
解決方法:使用 JavaScript Page Visibility API
偵測頁面可見性變更,然後對播放器採取相應的動作。例如: //if client platform is iOS if (!!navigator.platform && /iPad|iPhone|iPod/.test(navigator.platform)) { document.addEventListener(“visibilitychange”, () => { if (document.visibilityState === “hidden” && player.isMuted()) { player.pause() if (document.visibilityState === “visible” && player.getState() != PlayerState.PLAYING) { player.play() } }) }