阿裡雲 RTC SDK 為您提供螢幕分享使用的接口方法,通過本文檔您可以了解實作的具體調用流程。
前提條件
您需要調用 isSupport 接口根據傳回參數 supportScreenShare 來檢測是否支援螢幕分享。
環境要求
Web SDK 螢幕共享功能的環境要求請參見
。
推流端
- 設定參數。
/**
* 設定視訊/螢幕流參數
* @param {Number} width 寬度
* @param {Number} height 高度
* @param {Number} frameRate 幀率
* @param {Number} type 類型 1:攝像頭流 2:共享流
*/
aliWebrtc.setVideoProfile({
width,
height,
frameRate
},type);
- 啟動螢幕分享。
// 配置螢幕共享推流
aliWebrtc.configLocalScreenPublish = true;
// 啟動推流
aliWebrtc.publish().then(()=>{
//推流成功
}).catch((err) => {
//推流失敗
})
- 共享螢幕聲音。說明共享螢幕聲音支援 Windows 端 Chrome 75 及以上版本或 Edge 80 及以上版本,Mac 端僅支援分享标簽頁聲音。
-
- 勾選分享音頻。
産品百科 | RTC Web SDK 如何調用螢幕分享接口 - 推音頻流。分享的音頻會和麥克風混流,需要同時推音頻流,此時訂閱端隻需訂閱音頻流就可以聽到對方麥克風和螢幕分享音頻。
- 勾選分享音頻。
- 停止螢幕分享。
// 配置螢幕共享停止
aliWebrtc.configLocalScreenPublish = false;
// 啟動停推
aliWebrtc.publish().then(()=>{
//推流成功
}).catch((err) => {
//推流失敗
})
- 錯誤碼提示。
aliWebrtc.on("onError",(error)=>{
//10010 螢幕共享未知錯誤
//10011 螢幕共享在選擇頁面取消選擇 螢幕共享被禁止
//10012 螢幕共享在網頁底部懸浮窗單擊停止共享 螢幕共享已取消
console.log(error.errorCode);
})
訂閱端
訂閱端使用者可通過手動方式訂閱推流端螢幕共享流,并設定對應 video 顯示,詳情請參見
AliRtcEngine 接口「視訊雲技術」你最值得關注的音視訊技術公衆号,每周推送來自阿裡雲一線的實踐技術文章,在這裡與音視訊領域一流工程師交流切磋。