tuikit-atomicx-vue3 3.4.1 → 3.5.0-beta.7

package/src/hooks/useAudioControl.ts

@@ -12,12 +12,12 @@ const createAudioPlayEvent = (audioId: string) => new CustomEvent(AUDIO_PLAY_EVE
   detail: { audioId },
 });
 
-interface IUseAudioControlProps {
+interface UseAudioControlProps {
   url: string;
   audioId?: string;
 }
 
-interface IUseAudioControlReturn {
+interface UseAudioControlReturn {
   isPlaying: ReturnType<typeof ref<boolean>>;
   progress: ReturnType<typeof ref<number>>;
   duration: ReturnType<typeof ref<number | undefined>>;
@@ -36,7 +36,7 @@ interface IUseAudioControlReturn {
  * @param props Configuration parameters
  * @returns Audio control related states and methods
  */
-export function useAudioControl(props: IUseAudioControlProps): IUseAudioControlReturn {
+export function useAudioControl(props: UseAudioControlProps): UseAudioControlReturn {
   const { url } = props;
 
   // Generate a unique ID if audioId is not provided
@@ -147,7 +147,20 @@ export function useAudioControl(props: IUseAudioControlProps): IUseAudioControlR
       if (!audioInstance) {
         return;
       }
-      duration.value = audioInstance.duration;
+      if (audioInstance.duration === Infinity) {
+        // Jump to a large time
+        audioInstance.currentTime = 1e101;
+        audioInstance.ontimeupdate = () => {
+          if (!audioInstance) {
+            return;
+          }
+          duration.value = audioInstance.duration;
+          audioInstance.ontimeupdate = null;
+          audioInstance.currentTime = 0;
+        };
+      } else {
+        duration.value = audioInstance.duration;
+      }
       isLoading.value = false;
     };
 

package/src/hooks/useRoomEngine.ts

@@ -15,7 +15,7 @@ TUIRoomEngine.once('ready', () => {
       },
     })
   );
-  roomEngine.instance = new TUIRoomEngine();
+  roomEngine.instance = new TUIRoomEngine({ isSharedInstance: true });
   deviceManager.instance = roomEngine.instance?.getMediaDeviceManager();
 });
 

package/src/index.ts

@@ -1,4 +1,5 @@
 import { useLoginState } from './states/LoginState';
+import { useUIKitModalState } from './states/UIKitModalState';
 
 export * from './chat';
 export * from './rtc';
@@ -6,7 +7,9 @@ export * from './i18n';
 export * from './types';
 export * from './components/Avatar';
 export * from './components/UserPicker';
+export * from './components/UIKitModal';
 
 export {
   useLoginState,
+  useUIKitModalState,
 };

package/src/report/MetricsKey.ts

@@ -0,0 +1,16 @@
+export enum MetricsKey {
+  T_METRICS_STATE_API_CREATE_LIVE_COUNT = 180000, // 统计开播的次数
+  T_METRICS_STATE_API_CREATE_LIVE_MOBILE_COUNT = 180001, // 统计移动端 Web 开播的次数
+  T_METRICS_STATE_API_JOIN_LIVE_COUNT = 180002, // 统计观看的次数
+  T_METRICS_STATE_API_JOIN_LIVE_MOBILE_COUNT = 180003, // 统计移动端 Web 观看的次数
+  T_METRICS_STATE_API_LOGIN_COUNT = 180010, // 统计登录次数
+  T_METRICS_STATE_API_LOGIN_MOBILE_COUNT = 180011, // 统计移动端 Web 登录次数
+  T_METRICS_STATE_API_LIVE_MONITOR_CLOSE_ROOM_COUNT = 180020, // 计监播页解散房间的次数
+  T_METRICS_STATE_API_LIVE_MONITOR_START_PLAY_COUNT = 180021, // 统计监播页开始拉流的次数
+  T_METRICS_STATE_API_VIDEO_MIXER_ADD_MEDIA_CAMERA_COUNT = 180030, // 统计混流时添加摄像头的次数
+  T_METRICS_STATE_API_VIDEO_MIXER_ADD_MEDIA_SCREEN_COUNT = 180031, // 统计混流时添加屏幕分享的次数
+  T_METRICS_STATE_API_BARRAGE_SEND_TEXT_MSG_COUNT = 180040, // 统计发送弹幕消息的次数
+  T_METRICS_STATE_API_AUDIENCE_FETCH_LIST_COUNT = 180050, // 统计获取观众列表的次数
+  T_METRICS_STATE_API_CO_GUEST_REQUEST_CONNECTION_COUNT = 180060, // 统计观众连麦请求的次数
+  T_METRICS_STATE_API_CO_HOST_REQUEST_CONNECTION_COUNT = 180070, // 统计主播连线请求的次数
+}

package/src/report/dataReport.ts

@@ -0,0 +1,55 @@
+import TUIRoomEngine from '@tencentcloud/tuiroom-engine-js';
+import { MetricsKey } from './MetricsKey';
+
+const KEY_METRICS_API = 'KeyMetricsStats';
+
+type Task = () => void;
+
+export class DataReport {
+  private taskQueue: Task[] = [];
+  private isReady = false;
+
+  constructor() {
+    this.bindEvent();
+  }
+
+  public reportCount(key: MetricsKey) {
+    const task = this.createReportCountTask(key);
+    if (!this.isReady) {
+      this.taskQueue.push(task);
+    } else {
+      task();
+    }
+  }
+
+  private bindEvent() {
+    TUIRoomEngine.once('ready', () => {
+      this.isReady = true;
+      this.executePendingTasks();
+    });
+  }
+
+  private executePendingTasks() {
+    this.taskQueue.forEach(task => {
+      try {
+        task();
+      } catch (error) {
+        console.error('Task execution failed:', error);
+      }
+    });
+    this.taskQueue = [];
+  }
+
+  private createReportCountTask(key: MetricsKey): Task {
+    return () => {
+      TUIRoomEngine.callExperimentalAPI(
+        JSON.stringify({
+          api: KEY_METRICS_API,
+          params: { key },
+        })
+      );
+    };
+  }
+}
+
+export const dataReport = new DataReport();

package/src/report/index.ts

@@ -0,0 +1,7 @@
+import { dataReport } from "./dataReport";
+import { MetricsKey } from "./MetricsKey";
+
+export {
+  dataReport,
+  MetricsKey,
+}

package/src/rtc/index.ts

@@ -7,28 +7,28 @@ import { CameraButton as CameraButtonComponent } from '../components/CameraButto
 import { CoGuestPanel as CoGuestPanelComponent } from '../components/CoGuestPanel';
 import { CoHostPanel as CoHostPanelComponent } from '../components/CoHostPanel';
 import { LiveAudienceList as LiveAudienceListComponent } from '../components/LiveAudienceList';
-import { LiveCoreView as LiveCoreViewComponent } from '../components/LiveCoreView';
 import { LiveList as LiveListComponent } from '../components/LiveList';
 import { LiveMonitorView as LiveMonitorViewComponent } from '../components/LiveMonitorView';
 import { LiveScenePanel as LiveScenePanelComponent } from '../components/LiveScenePanel';
+import { LiveCoreView, LiveView } from '../components/LiveView';
 import { MicButton as MicButtonComponent } from '../components/MicButton';
 import { StreamMixer as StreamMixerComponent } from '../components/StreamMixer';
 import { StreamView as StreamViewComponent } from '../components/StreamView';
 import { VideoSetting as VideoSettingComponent } from '../components/VideoSetting';
 import { VideoSettingPanel as VideoSettingPanelComponent } from '../components/VideoSettingPanel';
-import { useBarrageListState as BarrageListState } from '../states/BarrageListState';
+import { useRoomEngine as RoomEngine } from '../hooks/useRoomEngine';
+import { useBarrageState } from '../states/BarrageState';
+import { useBattleState } from '../states/BattleState';
 import { useCoGuestState as CoGuestState } from '../states/CoGuestState';
 import { useCoHostState as CoHostState } from '../states/CoHostState';
 import { useDeviceState as DeviceState } from '../states/DeviceState';
 import { useLiveAudienceState as LiveAudienceState } from '../states/LiveAudienceState';
+import { useLiveListState } from '../states/LiveListState';
 import { useLiveMonitorState as LiveMonitorState } from '../states/LiveMonitorState';
 import { useLiveSeatState as LiveSeatState } from '../states/LiveSeatState';
-import { useLiveState as LiveState } from '../states/LiveState';
 import { useRoomState as RoomState } from '../states/RoomState';
 import { useUserState as UserState } from '../states/UserState';
 import { useVideoMixerState as VideoMixerState } from '../states/VideoMixerState';
-import { useBattleState  } from '../states/BattleState';
-import { useRoomEngine as RoomEngine } from '../hooks/useRoomEngine';
 
 import RTCLoginServer from './server';
 
@@ -36,7 +36,6 @@ RTCLoginServer.getInstance().init();
 
 const BarrageList = BarrageListComponent;
 const BarrageInput = BarrageInputComponent;
-const LiveCoreView = LiveCoreViewComponent;
 const StreamMixer = StreamMixerComponent;
 const LiveScenePanel = LiveScenePanelComponent;
 const LiveAudienceList = LiveAudienceListComponent;
@@ -52,10 +51,8 @@ const StreamView = StreamViewComponent;
 const AudioSetting = AudioSettingComponent;
 const VideoSetting = VideoSettingComponent;
 
-const useBarrageListState = BarrageListState;
 const useLiveMonitorState = LiveMonitorState;
 const useLiveSeatState = LiveSeatState;
-const useLiveState = LiveState;
 const useUserState = UserState;
 const useCoGuestState = CoGuestState;
 const useCoHostState = CoHostState;
@@ -70,6 +67,7 @@ export {
   BarrageList,
   BarrageInput,
   LiveCoreView,
+  LiveView,
   StreamMixer,
   LiveScenePanel,
   LiveAudienceList,
@@ -87,7 +85,7 @@ export {
 
   // States
   useRoomEngine,
-  useLiveState,
+  useLiveListState,
   useRoomState,
   useUserState,
   useDeviceState,
@@ -97,6 +95,6 @@ export {
   useCoHostState,
   useLiveAudienceState,
   useLiveMonitorState,
-  useBarrageListState,
   useBattleState,
+  useBarrageState,
 };

package/src/rtc/server.ts

@@ -3,7 +3,9 @@ import { ref } from 'vue';
 import TUIChatEngine from '@tencentcloud/chat-uikit-engine';
 import TUICore, { TUILogin, TUIConstants } from '@tencentcloud/tui-core';
 import TUIRoomEngine from '@tencentcloud/tuiroom-engine-js';
+import { dataReport, MetricsKey } from '../report';
 import { useLoginState } from '../states/LoginState';
+import { isMobile } from '../utils';
 
 export default class RTCLoginServer {
   private static instance: RTCLoginServer;
@@ -69,6 +71,8 @@ export default class RTCLoginServer {
 
     try {
       this.isEngineLoggingIn = true;
+      const metricsKey = !isMobile ? MetricsKey.T_METRICS_STATE_API_LOGIN_COUNT : MetricsKey.T_METRICS_STATE_API_LOGIN_MOBILE_COUNT;
+      dataReport.reportCount(metricsKey);
       await TUIChatEngine.login({
         chat,
         SDKAppID,

package/src/types/audience.ts

@@ -1,4 +1,4 @@
-import { TUIRole } from '@tencentcloud/tuiroom-engine-js';
+import type { TUIRole } from '@tencentcloud/tuiroom-engine-js';
 
 export interface AudienceInfo {
   userId: string;
@@ -9,3 +9,29 @@ export interface AudienceInfo {
   isMessageDisabled: boolean;
   joinedTimestamp?: number;
 }
+
+export interface LiveUserInfo {
+  userId: string;
+  userName: string;
+  avatarUrl: string;
+}
+
+export enum LiveAudienceEvent {
+  onAudienceJoined = 'onAudienceJoined',
+  onAudienceLeft = 'onAudienceLeft',
+}
+
+type AudienceJoinedEventInfo = {
+  audience: LiveUserInfo;
+};
+
+type AudienceLeftEventInfo = {
+  audience: LiveUserInfo;
+};
+
+export interface LiveAudienceEventInfo {
+  [LiveAudienceEvent.onAudienceJoined]: AudienceJoinedEventInfo;
+  [LiveAudienceEvent.onAudienceLeft]: AudienceLeftEventInfo;
+}
+
+export type LiveAudienceEventCallback = <T extends LiveAudienceEvent = LiveAudienceEvent>(eventInfo: LiveAudienceEventInfo[T]) => void;

package/src/types/battle.ts

@@ -1,12 +1,95 @@
-export type BattleConfig =  {
+import type { SeatUserInfo } from './seat';
+
+export interface BattleConfig {
   duration: number;
   needResponse: boolean;
   extensionInfo: string;
 }
 
-export type BattleInfo = {
+export interface BattleInfo {
   battleId: string;
   config: BattleConfig;
-  startTime: number,
+  startTime: number;
   endTime: number;
-}
+}
+
+export enum BattleEndedReason {
+  timeOver = 0,
+  allMemberExit = 1,
+}
+
+export enum BattleEvent {
+  onBattleStarted,
+  onBattleEnded,
+  onUserJoinBattle,
+  onUserExitBattle,
+  onBattleRequestReceived,
+  onBattleRequestCancelled,
+  onBattleRequestTimeout,
+  onBattleRequestAccept,
+  onBattleRequestReject,
+}
+interface BattleStartedEventInfo {
+  battleInfo: BattleInfo;
+  inviter: SeatUserInfo;
+  invitees: SeatUserInfo[];
+}
+
+interface BattleEndedEventInfo {
+  battleInfo: BattleInfo;
+  reason: BattleEndedReason;
+}
+
+interface UserJoinBattleEventInfo {
+  battleId: string;
+  battleUser: SeatUserInfo;
+}
+
+interface UserExitBattleEventInfo {
+  battleId: string;
+  battleUser: SeatUserInfo;
+}
+
+interface BattleRequestReceivedEventInfo {
+  battleId: string;
+  inviter: SeatUserInfo;
+  invitee: SeatUserInfo;
+}
+
+interface BattleRequestCancelledEventInfo {
+  battleId: string;
+  inviter: SeatUserInfo;
+  invitee: SeatUserInfo;
+}
+
+interface BattleRequestTimeoutEventInfo {
+  battleId: string;
+  inviter: SeatUserInfo;
+  invitee: SeatUserInfo;
+}
+
+interface BattleRequestAcceptEventInfo {
+  battleId: string;
+  inviter: SeatUserInfo;
+  invitee: SeatUserInfo;
+}
+
+interface BattleRequestRejectEventInfo {
+  battleId: string;
+  inviter: SeatUserInfo;
+  invitee: SeatUserInfo;
+}
+
+export type BattleEventInfoMap = {
+  [BattleEvent.onBattleStarted]: BattleStartedEventInfo;
+  [BattleEvent.onBattleEnded]: BattleEndedEventInfo;
+  [BattleEvent.onUserJoinBattle]: UserJoinBattleEventInfo;
+  [BattleEvent.onUserExitBattle]: UserExitBattleEventInfo;
+  [BattleEvent.onBattleRequestReceived]: BattleRequestReceivedEventInfo;
+  [BattleEvent.onBattleRequestCancelled]: BattleRequestCancelledEventInfo;
+  [BattleEvent.onBattleRequestTimeout]: BattleRequestTimeoutEventInfo;
+  [BattleEvent.onBattleRequestAccept]: BattleRequestAcceptEventInfo;
+  [BattleEvent.onBattleRequestReject]: BattleRequestRejectEventInfo;
+};
+
+export type BattleEventCallback = <T extends BattleEvent = BattleEvent>(eventInfo: BattleEventInfoMap[T]) => void;

package/src/types/coGuest.ts

@@ -1,3 +1,21 @@
+import type { LiveUserInfo } from './audience';
+
+export enum HostEvent {
+  onGuestApplicationReceived = 'onGuestApplicationReceived',
+  onGuestApplicationCancelled = 'onGuestApplicationCancelled',
+  onGuestApplicationProcessedByOtherHost = 'onGuestApplicationProcessedByOtherHost',
+  onHostInvitationResponded = 'onHostInvitationResponded',
+  onHostInvitationNoResponse = 'onHostInvitationNoResponse',
+}
+
+export enum GuestEvent {
+  onHostInvitationReceived = 'onHostInvitationReceived',
+  onHostInvitationCancelled = 'onHostInvitationCancelled',
+  onGuestApplicationResponded = 'onGuestApplicationResponded',
+  onGuestApplicationNoResponse = 'onGuestApplicationNoResponse',
+  onKickedOffSeat = 'onKickedOffSeat',
+}
+
 export type CoGuestRequestInfo = {
   timestamp: number;
   requestId: string;
@@ -7,9 +25,73 @@ export type CoGuestRequestInfo = {
   avatarUrl: string;
 };
 
-export enum CoGuestStatus {
-  Connected = 'Connected',
-  Disconnected = 'Disconnected', //  不在连线中
-  AdminInviting = 'AdminInviting', // 主持人/管理员邀请连线中
-  UserApplying = 'UserApplying', // 普通成员申请连线中
+export enum NoResponseReason {
+  timeout = 0,
+  alreadySeated = 1,
+}
+
+interface GuestApplicationReceivedEventInfo {
+  guestUser: LiveUserInfo;
+}
+
+interface GuestApplicationCancelledEventInfo {
+  guestUser: LiveUserInfo;
+}
+
+interface GuestApplicationProcessedByOtherHostEventInfo {
+  guestUser: LiveUserInfo;
+  hostUser: LiveUserInfo;
+}
+
+interface HostInvitationRespondedEventInfo {
+  isAccept: boolean;
+  guestUser: LiveUserInfo;
+}
+
+interface HostInvitationNoResponseEventInfo {
+  guestUser: LiveUserInfo;
+  reason: NoResponseReason;
 }
+
+interface HostInvitationReceivedEventInfo {
+  hostUser: LiveUserInfo;
+}
+interface HostInvitationCancelledEventInfo {
+  hostUser: LiveUserInfo;
+}
+interface GuestApplicationRespondedEventInfo {
+  isAccept: boolean;
+  hostUser: LiveUserInfo;
+}
+interface GuestApplicationNoResponseEventInfo {
+  reason: NoResponseReason;
+}
+
+interface KickedOffSeatEventInfo {
+  seatIndex: number;
+  hostUser: LiveUserInfo;
+}
+
+type HostEventInfoMap = {
+  [HostEvent.onGuestApplicationReceived]: GuestApplicationReceivedEventInfo;
+  [HostEvent.onGuestApplicationCancelled]: GuestApplicationCancelledEventInfo;
+  [HostEvent.onGuestApplicationProcessedByOtherHost]: GuestApplicationProcessedByOtherHostEventInfo;
+  [HostEvent.onHostInvitationResponded]: HostInvitationRespondedEventInfo;
+  [HostEvent.onHostInvitationNoResponse]: HostInvitationNoResponseEventInfo;
+};
+
+type GuestEventInfoMap = {
+  [GuestEvent.onHostInvitationReceived]: HostInvitationReceivedEventInfo;
+  [GuestEvent.onHostInvitationCancelled]: HostInvitationCancelledEventInfo;
+  [GuestEvent.onGuestApplicationResponded]: GuestApplicationRespondedEventInfo;
+  [GuestEvent.onGuestApplicationNoResponse]: GuestApplicationNoResponseEventInfo;
+  [GuestEvent.onKickedOffSeat]: KickedOffSeatEventInfo;
+};
+
+export type CoGuestEventInfoMap = HostEventInfoMap & GuestEventInfoMap;
+
+type CoGuestEventCallbackBase<T extends HostEvent | GuestEvent> = (
+  eventInfo: CoGuestEventInfoMap[T]
+) => void;
+
+export type CoGuestEventCallback = CoGuestEventCallbackBase<HostEvent | GuestEvent>;

package/src/types/device.ts

@@ -1,15 +1,21 @@
 export enum DeviceError {
-  NoError = 'NoError',
-  NoDeviceDetected = 'NoDeviceDetected',
-  NoSystemPermission = 'NoSystemPermission',
-  NotSupportCapture = 'NotSupportCapture',
-  OccupiedError = 'OccupiedError',
-  UnknownError = 'UnknownError',
+  NoError = 0,
+  NoDeviceDetected = 1,
+  NoSystemPermission = 2,
+  NotSupportCapture = 3,
+  OccupiedError = 4,
+  UnknownError = 5,
 }
 
-export enum AudioOutput {
-  Speaker = 'speaker',
-  Earpiece = 'earpiece',
+export enum AudioRoute {
+  Speakerphone = 0,
+  Earpiece = 1,
+}
+
+export enum MirrorType {
+  Auto = 0,
+  Enable = 1,
+  Disable = 2,
 }
 
 export enum DeviceType {
@@ -18,6 +24,13 @@ export enum DeviceType {
   ScreenShare =  'ScreenShare',
 }
 
+export enum VideoQuality {
+  Quality360P = 1,
+  Quality540P = 2,
+  Quality720P = 3,
+  Quality1080P = 4,
+}
+
 export enum DevicePermission {
   PublishAudio = 'PublishAudio',
   PublishVideo = 'PublishVideo',
@@ -46,13 +59,25 @@ export interface AudioSettingProps {
 }
 
 export enum DeviceStatus {
-  On = "On",            // 媒体状态打开
-  Off = "Off",          // 媒体状态关闭
-  AdminInviting = "AdminInviting",   // 关闭状态且正在被主持人/管理员被邀请中
-  UserApplying = "UserApplying", // 关闭状态且用户正在申请打开中
+  Off = 0,
+  On = 1,
 }
 
-export enum DeviceStatusReason {
-  ChangedBySelf = 0,
-  ChangedByAdmin = 1,
+export enum NetworkQuality {
+  Unknown = 0,
+  Excellent = 1,
+  Good = 2,
+  Poor = 3,
+  Bad = 4,
+  VeryBad = 5,
+  Down = 6,
 }
+
+export interface NetworkInfo {
+  userId: string;
+  quality: NetworkQuality;
+  upLoss: number;
+  downLoss: number;
+  delay: number;
+}
+

package/src/types/index.ts

@@ -1,5 +1,5 @@
 // common
-export * from './login';
+export type * from './login';
 // chat
 export * from './message';
 export * from './search';
@@ -15,7 +15,7 @@ export * from './types';
 export * from './live';
 export * from './stream';
 export * from './room';
-export * from './videoMixer';
+export type * from './videoMixer';
 export * from './audience';
 export * from './seat';
 export * from './monitor';

package/src/types/live.ts

@@ -33,14 +33,6 @@ export enum LiveOrientation {
   Portrait = 'portrait',
 }
 
-export enum LiveStatus {
-  IDLE = 'IDLE', // 未进入直播间的状态
-  NotStarted = 'NotStarted', // 进入直播间，直播未开始
-  Live = 'Live', // 进入直播间，直播中
-  Paused = 'Paused', // 进入直播间，直播暂停中，优先级低
-  Ended = 'Ended', // 进入直播间，直播已结束
-}
-
 export interface LayoutItem {
   locationX: number; // 以画面左上角为原点的 x 坐标
   locationY: number; // 以画面左上角为原点的 y 坐标
@@ -75,20 +67,20 @@ export interface LayoutInfo {
 export interface CreateLiveParams {
   liveId: string;
   liveName: string;
-  notice: string;
-  isMessageDisableForAllUser: boolean;
-  isGiftEnabled: boolean;
-  isLikeEnabled: boolean;
-  isPublicVisible: boolean;
-  isSeatEnabled: boolean;
-  keepOwnerOnSeat: boolean;
-  seatLayoutTemplateId: number;
-  maxSeatCount: number;
-  seatMode: TUISeatMode;
-  coverUrl: string;
-  backgroundUrl: string;
-  categoryList: Array<number>;
-  activityStatus: number;
+  notice?: string;
+  isMessageDisableForAllUser?: boolean;
+  isGiftEnabled?: boolean;
+  isLikeEnabled?: boolean;
+  isPublicVisible?: boolean;
+  isSeatEnabled?: boolean;
+  keepOwnerOnSeat?: boolean;
+  seatLayoutTemplateId?: number;
+  maxSeatCount?: number;
+  seatMode?: TUISeatMode;
+  coverUrl?: string;
+  backgroundUrl?: string;
+  categoryList?: Array<number>;
+  activityStatus?: number;
 }
 
 export interface JoinLiveParams {
@@ -104,3 +96,30 @@ export interface UpdateLiveInfoParams {
   isPublicVisible?: boolean;
   layoutTemplate?: number;
 }
+
+export enum LiveListEvent {
+  onLiveEnded = 'onLiveEnded',
+  onKickedOutOfLive = 'onKickedOutOfLive',
+}
+
+export enum LiveEndedReason {
+  endedByHost = 1,
+  endedByServer = 2,
+}
+
+export enum LiveKickedOutReason {
+  byAdmin = 0,
+  byLoggedOnOtherDevice = 1,
+  byServer = 2,
+  forNetworkDisconnected = 3,
+  forJoinRoomStatusInvalidDuringOffline = 4,
+  forCountOfJoinedRoomsExceedLimit = 5,
+}
+
+export interface LiveListEventInfo {
+  liveId: string;
+  reason: LiveEndedReason | LiveKickedOutReason;
+  message: string;
+}
+
+export type LiveListEventCallback = (eventInfo: LiveListEventInfo) => void;