Options
All
  • Public
  • Public/Protected
  • All
Menu

Class RCRTCRoom

普通音视频房间

Hierarchy

Index

Methods

Properties

Accessors

Constructors

Methods

on

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

  • 添加事件监听器

    Parameters

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

    Returns void

once

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

  • Parameters

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

    Returns void

off

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

  • 移除事件监听器

    Parameters

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

    Returns void

emit

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

  • 事件派发

    Parameters

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

    Returns void

removeAll

  • removeAll(eventType: string): void

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

    Parameters

    • eventType: string

    Returns void

clear

  • clear(): void

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

    Returns void

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

getRoomId

  • getRoomId(): string

  • 获取房间 Id

    Returns string

getCrtUserId

  • getCrtUserId(): string

getRemoteUserIds

  • getRemoteUserIds(): string[]

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

    Returns string[]

getRemoteTracks

getRemoteTracksByUserId

getSessionId

  • getSessionId(): string

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

    Returns string

sendMessage

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

  • 向房间内发消息

    Parameters

    • name: string

      消息名称

    • content: any

      消息内容

    Returns Promise<{ code: RCRTCCode }>

setRoomAttribute

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

  • 设置房间属性

    Parameters

    • key: string

      属性名

    • value: string

      属性值

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

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

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

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

    Returns Promise<{ code: RCRTCCode }>

deleteRoomAttributes

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

  • 删除房间属性

    Parameters

    • keys: string[]

      待删除的属性名数组

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

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

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

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

    Returns Promise<{ code: RCRTCCode }>

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 }>

isDestroyed

  • isDestroyed(): boolean

  • 查询房间是否已销毁

    Returns boolean

publish

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

    Parameters

    Returns Promise<IPubSuccessRes>

unpublish

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

    Parameters

    Returns Promise<IPubSuccessRes>

subscribe

unsubscribe

updateSubList

getLocalTrack

getLocalTracks

getRemoteTrack

registerRoomEventListener

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

    Parameters

    Returns void

registerReportListener

onAudioLevelChange

  • 音量上报

    Parameters

    • handler: null | IAudioLevelChangeHandler

      音量事件监听函数

    • Optional _: number

      参数已废弃，SDK 默认以每秒一次进行回调上报时间间隔

    Returns void

getClientSessionId

  • getClientSessionId(): string

changeMediaDevice

startASR

  • 开启房间内的语音识别服务

    description

    语音识别功能依赖房间内的音频流，开启后且房间内有音频流，会通过 onReceiveStartASR 通知业务层，代表真正开启成功

    Returns Promise<{ code: RCRTCCode }>

stopASR

  • 关闭房间内的语音识别服务

    Returns Promise<{ code: RCRTCCode }>

asrIsAvailable

  • asrIsAvailable(): boolean

setEnableASR

  • setEnableASR(enable: boolean): Promise<{ code: RCRTCCode }>

  • 设置是否接收房间内语音识别的内容

    description

    Parameters

    • enable: boolean

      为 ture 时，sdk 会获取语音识别资源并解析，通过房间监听事件 onReceiveASRContent 事件，抛出语音识别内容

    Returns Promise<{ code: RCRTCCode }>

startRealtimeTranslation

  • startRealtimeTranslation(destLangCode: string): Promise<{ code: RCRTCCode }>

  • 开启语音实时翻译

    description

    执行时机：需在房间监听事件 onReceiveStartASR 中执行。

    description

    执行条件：设置接收房间内语音识别资源

    Parameters

    • destLangCode: string

      翻译的目标语言

    Returns Promise<{ code: RCRTCCode }>

stopRealtimeTranslation

  • stopRealtimeTranslation(): Promise<{ code: RCRTCCode }>

startSummarization

  • startSummarization(): Promise<{ code: RCRTCCode; taskId?: string }>

  • 开始智能总结

    description

    执行时机：需在房间监听事件 onReceiveStartASR 中执行。

    discussion
    1. 智能总结任务依赖语音识别服务
    2. 开始智能总结任务为房间级别接口，房间内开始智能总结任务，房间内其他人通过 IRoomEventListener 的 onReceiveStartSummarization 收到通知，拿到 taskId
    3. 智能总结任务开始后，房间内的语音识别内容会被用于智能总结生成文本内容
    4. 智能总结任务开始后，可通过 stopSummarization 接口关闭

    Returns Promise<{ code: RCRTCCode; taskId?: string }>

    taskId 智能总结任务 Id

stopSummarization

  • stopSummarization(): Promise<{ code: RCRTCCode }>

  • 关闭智能总结

    discussion
    1. 关闭智能总结任务为房间级别接口，房间内关闭智能总结任务，房间内其他人通过 IRoomEventListener 的 onReceiveStopSummarization 收到通知

    Returns Promise<{ code: RCRTCCode }>

getSummarizationStatusData

Properties

Readonly _roomId

_roomId: string

Accessors

subscribedTracks

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

    Returns ISubscribeAttr[]

Constructors

constructor

  • new RCRTCRoom(context: RTCContext, runtime: IRuntime, roomId: string, service: default, initOptions: IRCRTCInitOptions, roomType?: RTCMode, encrypt?: boolean): RCRTCRoom

  • 类的构造函数。

    Parameters

    • context: RTCContext

      RTC上下文

    • runtime: IRuntime

      运行时

    • roomId: string

      房间号

    • service: default

      RCMediaService

    • initOptions: IRCRTCInitOptions

      IRCRTCInitOptions

    • roomType: RTCMode = RTCMode.RTC

      RTCMode = RTCMode.RTC,

    • encrypt: boolean = false

    Returns RCRTCRoom