全部產品
Search
文件中心

ApsaraVideo Live:設定頻道模式和使用者角色

更新時間:Sep 30, 2025

阿里雲ARTC Web SDK提供設定頻道模式和使用者角色功能,用於建立不同的互動體驗。本文為您介紹設定頻道模式和使用者角色相關功能的範例程式碼。

頻道模式

針對不同的應用情境進行效能最佳化,阿里雲ARTC Web SDK提供了兩個頻道模式選項,請根據您的業務情境進行選擇。

重要

您需要在加入頻道前調用setChannelProfile介面進行設定,進入頻道後設定無效。

// 前提:需要先建立引擎執行個體
// 調用介面設定
aliRtcEngine.setChannelProfile('communication');

選項

含義

說明

是否為預設值

communication

通訊模式

該模式下所有使用者均需要互動交流,適合線上多人會議、線上通話等情境。

interactive_live

即時音視頻模式

該模式下使用者分為主播和觀眾兩種角色,主播支援發布和訂閱音視頻流,但觀眾僅支援訂閱音視頻流,適合大方會、即時音視頻等情境。

使用者角色

當選擇使用interactive_live(即時音視頻模式)後,您需要調用setClientRole介面為您的使用者指派不同的使用者角色,阿里雲ARTC Web SDK提供了兩個使用者角色選項,請根據您的實際情況進行選擇。

重要

通訊模式下設定使用者角色無效。

// 前提:需要設定頻道為即時音視頻模式,通訊模式設定使用者角色無效。

// 您可以在任何時刻重新設定角色,如觀眾需要上麥與主播通話時,可以重新設定為 interactive
aliRtcEngine.setClientRole('interactive');

// 當通話結束後,設定為 live
aliRtcEngine.setClientRole('live');

選項

含義

說明

是否為預設值

interactive

主播角色

主播角色支援發布和訂閱音視頻流。

live

觀眾角色

觀眾角色僅支援訂閱音視頻流。