Web SDK 使用限制如下所示，為保證最佳體驗(yàn)，建議用戶更新至各瀏覽器最新版本。

注意當(dāng)前視頻僅支持H.264編碼，VP8編碼暫無法支持，由此會(huì)影響到SDK對(duì)一些平臺(tái)或系統(tǒng)、瀏覽器版本的支持已在下方注明。

一、桌面端

瀏覽器兼容性

已知問題和限制

• 在 Windows 設(shè)備上使用 deviceId 為default或communications的麥克風(fēng)時(shí)，如果插入新的麥克風(fēng)再拔出，原麥克風(fēng)的采集可能中斷，建議避免使用default或communications的麥克風(fēng)。Chrome issue

• 部分Windows設(shè)備Chrome 111+版本屏幕分享會(huì)有鼠標(biāo)重影、閃爍問題，暫時(shí)無法解決，需要等待Chrome修復(fù)。Chrome issue

• Mac 設(shè)備中，Mersive Solstic 軟件的虛擬攝像頭驅(qū)動(dòng)會(huì)導(dǎo)致 Chrome 無法獲取攝像頭列表，導(dǎo)致無法采集攝像頭，建議用戶刪除該虛擬攝像頭驅(qū)動(dòng)。Chrome issue

• macOS上Chrome84版本有概率出現(xiàn)幀率突然下降導(dǎo)致圖像卡頓，建議瀏覽器升級(jí)至最新版本。Chrome issue & Chrome issue

• Firefox 只支持視頻幀率為 30 fps，不能調(diào)整為其他幀率。

• Firefox會(huì)動(dòng)態(tài)安裝H.264編解碼器，在成功前無法進(jìn)行音視頻通信，可以通過getSupportedCodec檢測(cè)，若不包含H.264，可引導(dǎo)用戶在Firefox打開地址about:addons，到 插件 中檢查 OpenH264 是否安裝成功，就緒后再進(jìn)行通話。Firefox issue

• Firefox不支持CVO（Coordination of video orientation），訂閱的移動(dòng)端的視頻可能方向不正確。Firefox issue

• Safari 不支持修改揚(yáng)聲器。

• Safari 11只支持 480p 及以上的分辨率。

• Safari 14.0.1 和 14.2 音頻可能斷斷續(xù)續(xù)或有雜音，建議升級(jí)系統(tǒng)版本。Webkit issue

• Chrome 81+、Safari 和 Firefox需要在獲得媒體設(shè)備權(quán)限后才能獲取設(shè)備，因此會(huì)影響獲取設(shè)備相關(guān)方法。

二、移動(dòng)端

瀏覽器兼容性

已知問題和限制

• 由于H.264版權(quán)限制，SDK不支持華為設(shè)備部分版本的Chrome瀏覽器和以Chrome WebView為內(nèi)核的瀏覽器。

• Android System Webview M79 以下的版本，無法使用 H264 解碼，導(dǎo)致SDK無法支持，建議引導(dǎo)用戶升級(jí)至M79+。Chromium issue

• 部分Android 12 的設(shè)備，其使用Chrome 瀏覽器或 Chromium 內(nèi)核瀏覽器 97 或以下版本時(shí)可能會(huì)花屏，這是因?yàn)镃hromium WebRTC 模塊視頻編碼回退，建議升級(jí)Chrome版本。Chromium issue

• Android設(shè)備上創(chuàng)建兩個(gè)攝像頭視頻軌道出現(xiàn)報(bào)錯(cuò), 可以先調(diào)用 close 或 setEnable(false) 釋放已有的視頻軌道。

• 部分小米及OnePlus機(jī)型在佩戴藍(lán)牙耳機(jī)進(jìn)行通話時(shí)可能無法聽到遠(yuǎn)端用戶的聲音，原因可能是Chromium在切換藍(lán)牙設(shè)備協(xié)議時(shí)產(chǎn)生異常,建議增加藍(lán)牙耳機(jī)可能出現(xiàn)無聲的提示。

• Android設(shè)備上在音頻采集發(fā)送時(shí)，若中途佩戴起藍(lán)牙耳機(jī)，遠(yuǎn)端用戶音頻可能會(huì)仍通過揚(yáng)聲器播放。Chromium issue

• 若用戶加入另一個(gè)有使用Android設(shè)備Chrome119版本且沒佩戴耳機(jī)的用戶的頻道，會(huì)聽到自己的回聲，建議升級(jí)瀏覽器版本。Chromium issue

• 微信瀏覽器不支持自動(dòng)播放，且當(dāng)次用戶通過操作恢復(fù)播放后下一次仍然無法自動(dòng)播放，原因可能是微信瀏覽器對(duì)自動(dòng)播放行為處理的異常，建議在autoplay-failed事件中引導(dǎo)用戶恢復(fù)播放。

• iOS16系統(tǒng)版本的iPhone14機(jī)型音頻采集功能異常，建議使用setMuted代替setEnabled來控制發(fā)送，不要調(diào)用close來關(guān)閉。Webkit issue

• Safari 不支持多個(gè) tab 來采集音視頻，否則前一個(gè) tab 會(huì)停止采集，遠(yuǎn)端流也有可能出現(xiàn)黑屏無聲，建議在切換tab時(shí)停止采集，重新獲焦時(shí)再恢復(fù)。Webkit issue

• iOS13、14無法編碼高于 720p 的視頻，建議設(shè)置視頻的分辨率不超過 720p，或升級(jí)到 iOS 15 及以上版本。

• iOS連續(xù)采集相同類型媒體數(shù)據(jù)會(huì)導(dǎo)致第一次獲取到的狀態(tài)為靜音或黑屏。

• iOS在瀏覽器或應(yīng)用切換到后臺(tái)后，遠(yuǎn)端用戶看到本地用戶的畫面將會(huì)為黑屏，這是蘋果官方限制。蘋果說明

• iOS 14.4 至 15.x 上內(nèi)嵌 WKWebView 的應(yīng)用切換到后臺(tái)時(shí)，音頻流發(fā)送會(huì)中斷。蘋果說明

• Safari 14.2 上音頻或有雜音，建議升級(jí)系統(tǒng)版本。Webkit issue

• iOS15.1.x上的瀏覽器和內(nèi)嵌WKWebView的應(yīng)用在發(fā)送視頻流后頁面崩潰，這是因?yàn)樵撓到y(tǒng)版本上webkit H.264編碼有回退，建議升級(jí)系統(tǒng)版本。Webkit issue

• iOS15.x上的瀏覽器和內(nèi)嵌WKWebView的應(yīng)用被其他應(yīng)用打斷后，可能無法自動(dòng)恢復(fù)播放，建議引導(dǎo)用戶刷新頁面。Webkit issue&Webkit issue

• iOS15.x和16.x播放視頻時(shí)有概率黑屏，建議減少對(duì)video元素及其父元素的css修改。Webkit issue

• iOS15.x使用藍(lán)牙耳機(jī)播放音頻時(shí)有概率失真，建議增加提示使用用戶藍(lán)牙耳機(jī)可能會(huì)出現(xiàn)問題，或升級(jí)系統(tǒng)版本。Webkit issue

• iOS 15.0 至 15.3 上的瀏覽器及內(nèi)嵌 WKWebView 的應(yīng)用聽到遠(yuǎn)端音頻音量低，建議升級(jí)系統(tǒng)版本。Webkit issue

• iOS16.0 特定方向旋轉(zhuǎn)屏幕后，視頻畫面被拉伸，該系統(tǒng)版本W(wǎng)ebKit 的 WebRTC 模塊功能有回退，對(duì) RTP 協(xié)議的圖像方向（Coordination of video orientation, CVO）功能支持異常，建議增加提示信息。

• iOS不支持通過setVolume調(diào)整音量。

• iOS不支持發(fā)送1080P+分辨率的視頻流。

三、關(guān)于 Vue 3 響應(yīng)式及 Proxy

由于Vue 3 基于 Proxy 實(shí)現(xiàn)響應(yīng)式，請(qǐng)開發(fā)者使用 Vue markRaw 將Client，LocalTrack，RemoteTrack 等 SDK 實(shí)例設(shè)置為非響應(yīng)式屬性，若對(duì) SDK 實(shí)例加了 Proxy，可能會(huì)導(dǎo)致 SDK 異常。