保利威文档中心

幫助中心

模組事件

更新時間:2024-10-10 17:27:10

一、連麥資訊變更

說明: 連麥資訊透過 connectMic.getConnectMicInfo() 取得,當連麥資訊變更時會觸發該事件。

Event 事件: ConnectMicEvents.ConnectMicInfoChange

回呼參數: Object 物件,詳細型別說明如下

屬性名稱 說明 型別
connectMicInfo 連麥資訊 ConnectMicStoreInfo

範例:

watchCore.connectMic.eventEmitter.on(ConnectMicEvents.ConnectMicInfoChange, () => {
  const connectMicInfo = watchCore.connectMic.getConnectMicInfo();
  console.log('连麦信息更新', connectMicInfo);
});

二、講師開啟連麥功能

說明: 講師開啟連麥功能後,觸發該事件,開啟後頁面即可顯示連麥功能。

Event 事件: ConnectMicEvents.OpenConnectMic

回呼參數: Object 物件,詳細型別說明如下

屬性名稱 說明 型別
type 連麥類型 ConnectMicType

範例:

import { ConnectMicType } from '@polyv/live-watch-miniprogram-sdk';
watchCore.connectMic.eventEmitter.on(ConnectMicEvents.OpenConnectMic, (data) => {
  const type = data.type === ConnectMicType.Video ? '视频' : '音频';
  toast.info(`讲师开启了${type}连麦,赶快和主播连麦互动吧~`);
});

三、講師關閉連麥功能

說明: 講師關閉連麥功能後觸發該事件

Event 事件: ConnectMicEvents.CloseConnectMic

回呼參數: Object 物件,詳細型別說明如下

屬性名稱 說明 型別
type 連麥類型 ConnectMicType

範例:

import { ConnectMicType } from '@polyv/live-watch-miniprogram-sdk';
watchCore.connectMic.eventEmitter.on(ConnectMicEvents.CloseConnectMic, (data) => {
  const type = data.type === ConnectMicType.Video ? '视频' : '音频';
  toast.info(`讲师已结束${type}连麦`);
});

四、連麥狀態更新

Event 事件: ConnectMicEvents.ConnectMicStatusChange

回呼參數: Object 物件,詳細型別說明如下

屬性名稱 說明 型別
connectMicStatus 連麥狀態更新 ConnectMicStatus

五、連麥列表修改

說明: 當觀眾上下麥或用戶流加入/退出後,連麥列表改變,透過該事件監聽連麥用戶列表更新。

Event 事件: ConnectMicEvents.ConnectMicDataChange

回呼參數: Object 物件,詳細型別說明如下

屬性名稱 說明 型別
micDatas 連麥列表 ConnectMicItemData[]

範例:

watchCore.connectMic.eventEmitter.on(ConnectMicEvents.ConnectMicDataChange, () => {
  const connectMicList = watchCore.connectMic.getMicDatas();
  console.log('连麦用户列表更新', connectMicList);
});

六、講師掛斷當前連麥者

說明: 當講師掛斷當前連麥用戶,連麥模組將回呼該事件。

Event 事件: ConnectMicEvents.TeacherHangUp

範例:

watchCore.connectMic.eventEmitter.on(ConnectMicEvents.TeacherHangUp, () => {
  toast.info('讲师已挂断你的连麦');
});

七、連麥人數到達上限

說明: 觀眾點擊同意邀請上麥時,可能因連麥人數到達上限而連麥失敗,透過該事件監聽並頁面提示。

Event 事件: ConnectMicEvents.ConnectMicOverLimit

範例:

watchCore.connectMic.eventEmitter.on(ConnectMicEvents.ConnectMicOverLimit, () => {
  toast.error('连麦失败,连麦人数已到达上限');
});

八、當前主講狀態改變

說明: 當講師授予/撤銷當前連麥用戶的主講權限時觸發該事件。

Event 事件: ConnectMicEvents.CurrentSpeakerStatusChanged

回呼參數: Object 物件,詳細型別說明如下

屬性名稱 說明 型別
currentIsSpeaker 當前用戶是否為主講 boolean

範例:

watchCore.connectMic.eventEmitter.on(ConnectMicEvents.CurrentSpeakerStatusChanged, (data) => {
  if (data.currentIsSpeaker) {
    toast.info('讲师已授予您主讲权限');
  } else {
    toast.info('讲师已收回您的主讲权限');
  }
});

九、講師同意連麥申請

說明: 觀眾申請連麥,講師同意連麥申請後觸發該事件。

Event 事件: ConnectMicEvents.AllowConnectMicApply

範例:

watchCore.connectMic.eventEmitter.on(ConnectMicEvents.AllowConnectMicApply, (data) => {
  toast.success('讲师已同意你的连麦申请');
});

十、遠端連麥用戶麥克風開關改變

Event 事件: ConnectMicEvents.RemoteAudioMuteChange

回呼參數: Object 物件,詳細型別說明如下

屬性名稱 說明 型別
isAudioMuted 是否關閉麥克風 boolean

十一、遠端連麥用戶攝影機開關改變

Event 事件: ConnectMicEvents.RemoteVideoMuteChange

回呼參數: Object 物件,詳細型別說明如下

屬性名稱 說明 型別
isVideoMuted 是否關閉攝影機 boolean

十二、本地麥克風開關改變

Event 事件: ConnectMicEvents.LocalAudioMuteChange

回呼參數: Object 物件,詳細型別說明如下

屬性名稱 說明 型別
isAudioMuted 是否關閉麥克風 boolean

十三、本地攝影機開關改變

Event 事件: ConnectMicEvents.LocalVideoMuteChange

回呼參數: Object 物件,詳細型別說明如下

屬性名稱 說明 型別
isVideoMuted 是否關閉攝影機 boolean

十四、離開連麥成功

說明: 本地連麥流離開後觸發該事件,觸發後連麥狀態為 ConnectMicStatus.NotConnect。

Event 事件: ConnectMicEvents.LeaveConnectMicSuccess

範例:

watchCore.connectMic.eventEmitter.on(ConnectMicEvents.LeaveConnectMicSuccess, () => {
  toast.success('你已下麦');
  const connectMicInfo = watchCore.connectMic.getConnectMicInfo();
  console.log('连麦状态', connectMicInfo.conncetMicStatus); // ConnectMicStatus.NotConnect
});
联系客服,在线咨询