Options
All
  • Public
  • Public/Protected
  • All
Menu

Class RCAbstractRoom Abstract

房间抽象基类

Hierarchy

Index

Constructors

Properties

Accessors

Methods

Constructors

constructor

  • new RCAbstractRoom(_context: RTCContext, _runtime: IRuntime, _roomId: string, _roomMode: RTCMode, _service: default, _initOptions: IRCRTCInitOptions, isUpgrade?: boolean, isMainRoom?: boolean, _useMutilPeerC?: boolean, _clientSessionId?: string, signalRetryTime?: number): RCAbstractRoom

  • RCRTCRoom 类的构造函数。

    Parameters

    • _context: RTCContext

      RTC上下文，

    • _runtime: IRuntime

      运行时

    • _roomId: string

      房间号

    • _roomMode: RTCMode

      RTC模式，

    • _service: default

      RCMediaService

    • _initOptions: IRCRTCInitOptions

      IRCRTCInitOptions

    • Optional isUpgrade: boolean
    • Optional isMainRoom: boolean
    • Optional _useMutilPeerC: boolean
    • _clientSessionId: string = ...

      客户端会话 ID，用于标识客户端。

    • signalRetryTime: number = PUBLISHSIGNALRETRYTIME

      发送信号的时间间隔。

    Returns RCAbstractRoom

Properties

Readonly _roomId

_roomId: string

Accessors

subscribedTracks

  • 获取当前已经订阅的全量资源 returns subscribedTracks ISubscribeAttr[]

    Returns ISubscribeAttr[]

Methods

__destroy

  • __destroy(quitRoom: boolean): Promise<void>

  • 退出并销毁当前房间实例，退出后该房间的所有方法将不可用

    Parameters

    • quitRoom: boolean

    Returns Promise<void>

__getPC

  • __getPC(): default[]

  • 获取 _pc 实例

    Returns default[]

__innerInit

  • __innerInit(mode: RTCMode, joinType?: RTCJoinType, livingType?: RCLivingType, innerUserDatas?: IRTCUserData, outerUserDatas?: IRTCUserData, traceId?: string): Promise<{ code: RCRTCCode | ErrorCode; data?: IJoinRTCRoomData }>

  • Parameters

    • mode: RTCMode
    • Optional joinType: RTCJoinType
    • Optional livingType: RCLivingType
    • Optional innerUserDatas: IRTCUserData
    • Optional outerUserDatas: IRTCUserData
    • Optional traceId: string

    Returns Promise<{ code: RCRTCCode | ErrorCode; data?: IJoinRTCRoomData }>

__onReconnected

  • __onReconnected(livingType?: RCLivingType): Promise<void | { data: undefined | IJoinRTCRoomData }>

  • 断线重连后尝试补发断线过程中的通知信息

    Parameters

    Returns Promise<void | { data: undefined | IJoinRTCRoomData }>

__parseInnerMessage

  • __parseInnerMessage(message: IReceivedMessage, traceId: string): boolean

  • Parameters

    • message: IReceivedMessage
    • traceId: string

    Returns boolean

addSubscribeTask

  • 它将订阅任务添加到队列中。

    Parameters

    Returns void

    一个用代码和失败列表解析为对象的承诺。

addUnsubscribeTask

  • 它将取消订阅任务添加到队列中。

    Parameters

    Returns void

    一个用代码和失败列表解析为对象的承诺。

addUpdateSubscribeListTask

  • 将任务添加到任务队列的函数。

    Parameters

    Returns void

clear

  • clear(): void

  • 无差别清空所有事件监听器

    Returns void

deleteRoomAttributes

  • deleteRoomAttributes(keys: string[], message?: { content: string; name: string }, isInner?: boolean): Promise<{ code: RCRTCCode }>

  • 删除房间属性

    Parameters

    • keys: string[]

      待删除的属性名数组

    • Optional message: { content: string; name: string }

      是否在删除属性的时候携带消息内容，传空则不往房间中发送消息

      • content: string
      • name: string
    • isInner: boolean = false

      RTC 业务内部使用参数，用户忽略

    Returns Promise<{ code: RCRTCCode }>

emit

  • emit(eventType: string, ...attrs: any[]): void

  • 事件派发

    Parameters

    • eventType: string
    • Rest ...attrs: any[]

    Returns void

getClientSessionId

  • getClientSessionId(): string

  • Returns string

getCrtUserId

  • getCrtUserId(): string

  • 获取当前 userId

    Returns string

getLocalTrack

  • 获取已发布的本地资源

    Parameters

    • trackId: string

    Returns null | RCLocalTrack

getLocalTracks

  • 获取所有已发布的资源

    Returns RCLocalTrack[]

getRemoteTrack

  • 根据 trackId 获取房间内的远端资源

    Parameters

    • trackId: string

    Returns null | RCRemoteTrack

getRemoteTracks

  • 获取所有房间已发布的远端资源列表

    Returns RCRemoteTrack[]

getRemoteTracksByUserId

  • 获取远端用户的资源列表

    Parameters

    • userId: string

    Returns RCRemoteTrack[]

getRemoteUserIds

  • getRemoteUserIds(): string[]

  • 获取远程用户列表，不包含当前用户

    Returns string[]

getRoomAttributes

  • getRoomAttributes(keys?: string[], isInner?: boolean): Promise<{ code: RCRTCCode; data?: KVString }>

  • 获取房间属性

    Parameters

    • keys: string[] = []

      要查询的属性名数组，当数组长度为空时，取所有已设置的 kv 值

    • isInner: boolean = false

      RTC 业务内部使用参数，用户忽略

    Returns Promise<{ code: RCRTCCode; data?: KVString }>

getRoomId

  • getRoomId(): string

  • 获取房间 Id

    Returns string

getSessionId

  • getSessionId(): string

  • 获取房间当前会话 Id，当房间内已无成员时房间会回收，重新加入时 sessionId 将更新

    Returns string

isDestroyed

  • isDestroyed(): boolean

  • 查询房间是否已销毁

    Returns boolean

off

  • off(eventType: string, listener: IEventListener, target?: any): void

  • 移除事件监听器

    Parameters

    • eventType: string
    • listener: IEventListener
    • Optional target: any

    Returns void

on

  • on(eventType: string, listener: IEventListener, target?: any): void

  • 添加事件监听器

    Parameters

    • eventType: string
    • listener: IEventListener
    • Optional target: any

    Returns void

onAudioLevelChange

  • onAudioLevelChange(handler: null | IAudioLevelChangeHandler, gap?: number): void

  • 音量上报

    Parameters

    • handler: null | IAudioLevelChangeHandler

      业务端传入的音量上报事件

    • Optional gap: number

      上报时间间隔

    Returns void

once

  • once(eventType: string, listener: IEventListener, target?: any): void

  • Parameters

    • eventType: string
    • listener: IEventListener
    • Optional target: any

    Returns void

publish

  • 增量发布资源，若发布的资源 tag 及媒体类型重复，后者将覆盖前者进行发布。

    Parameters

    Returns Promise<IPubSuccessRes>

registerReportListener

  • 注册房间数据监控

    description

    该方法暂仅支持 Chrome 浏览器

    Parameters

    Returns void

registerRoomEventListener

  • 注册事件监听器，多次注册会导致后者覆盖前者，可以通过使用 registerRoomEventListener(null) 取消注册

    Parameters

    Returns void

removeAll

  • removeAll(eventType: string): void

  • 清空所有指定类型的事件监听器

    Parameters

    • eventType: string

    Returns void

sendMessage

  • sendMessage(name: string, content: any): Promise<{ code: RCRTCCode }>

  • 向房间内发消息

    Parameters

    • name: string

      消息名称

    • content: any

      消息内容

    Returns Promise<{ code: RCRTCCode }>

setBitrate

  • setBitrate(max: number, min: number, start?: number): void

  • 设置房间上行资源的总码率配置

    deprecated

    use RCLocalTrack.setBitrate instead of setBitrate

    description
    • 自 v5.1.0 版本开始，推荐使用 RCLocalTrack.setBitrate 对不同流分别指定码率。
    • 该方法仅在 SDP plan-b 协议下（Chrome 92 与 Safari 11 之前的版本）有效。

    Parameters

    • max: number

      音视频发送码率上限，不可小于 200 且不可小于 min

    • min: number

      音视频发送码率下限，默认值为 1，且不可小于 1，不可大于 max

    • Optional start: number

      起始码率，默认为码率上限的 70%

    Returns void

setRoomAttribute

  • setRoomAttribute(key: string, value: string, message?: { content: string; name: string }, isInner?: boolean): Promise<{ code: RCRTCCode }>

  • 设置房间属性

    Parameters

    • key: string

      属性名

    • value: string

      属性值

    • Optional message: { content: string; name: string }

      是否在设置属性的时候携带消息内容，传空则不往房间中发送消息

      • content: string
      • name: string
    • isInner: boolean = false

      RTC 业务内部使用参数，用户忽略

    Returns Promise<{ code: RCRTCCode }>

subscribe

unpublish

  • 增量取消资源发布，若相应资源中存在小流资源，则同时取消发布

    Parameters

    Returns Promise<IPubSuccessRes>

unsubscribe

  • 取消订阅资源

    Parameters

    Returns Promise<{ code: RCRTCCode; failedList?: ISubscribeAttr[] }>

updateSubList

  • 强制修改订阅列表，仅订阅数组中的资源，取消订阅其他已订阅资源。 当参数为 [] 时，意味着不再订阅任何资源

    Parameters

    Returns Promise<{ code: RCRTCCode; failedList?: ISubscribeAttr[] }>

Generated using TypeDoc