RCRTCClient | RTCLib

RTC 业务客户端

Hierarchy

RCMediaStreamCapture
- RCRTCClient

Constructors

constructor

new RCRTCClient(_context: RTCContext, _runtime: IRuntime, _options: IRCRTCInitOptions): RCRTCClient

Overrides RCMediaStreamCapture.constructor
- Defined in src/core/RCRTCClient.ts:39
Parameters
- _context: RTCContext
- _runtime: IRuntime
- _options: IRCRTCInitOptions
Returns RCRTCClient

Methods

createCameraVideoTrack

createCameraVideoTrack(tag?: string, options?: ICameraVideoProfile): Promise<{ code: RCRTCCode; track?: RCCameraVideoTrack }>

Inherited from RCMediaStreamCapture.createCameraVideoTrack
- Defined in src/core/RCMediaStreamCapture.ts:147
由摄像头捕获视轨数据

Parameters
- tag: string = 'RongCloudRTC'
- Optional options: ICameraVideoProfile
Returns Promise<{ code: RCRTCCode; track?: RCCameraVideoTrack }>

createLocalAudioTrack

createLocalAudioTrack(tag: string, track: MediaStreamTrack): Promise<{ code: RCRTCCode; track?: RCLocalAudioTrack }>

Inherited from RCMediaStreamCapture.createLocalAudioTrack
- Defined in src/core/RCMediaStreamCapture.ts:441
创建 RCLocalAudioTrack 实例

Parameters
- tag: string
- track: MediaStreamTrack
Returns Promise<{ code: RCRTCCode; track?: RCLocalAudioTrack }>

createLocalFileTracks

createLocalFileTracks(tag: string, file: string | File, options?: ICreateLocalTrackOptions): Promise<{ code: RCRTCCode; tracks: RCLocalFileTrack[] }>

Inherited from RCMediaStreamCapture.createLocalFileTracks
- Defined in src/core/RCMediaStreamCapture.ts:536
根据本地或网络媒体文件资源创建 RCLocalFileTrack 实例

Parameters
- tag: string
  
  资源标识
- file: string | File
  
  网络文件地址，或通过获取到的 File 实例
- Optional options: ICreateLocalTrackOptions
  
  可用于指定 withoutVideo 与 withoutAudio 以剔除视轨与音轨
Returns Promise<{ code: RCRTCCode; tracks: RCLocalFileTrack[] }>

createLocalTracks

createLocalTracks(tag: string, stream: MediaStream, options?: ICreateLocalTrackOptions): Promise<{ code: RCRTCCode; tracks: RCLocalTrack[] }>

Inherited from RCMediaStreamCapture.createLocalTracks
- Defined in src/core/RCMediaStreamCapture.ts:639
根据 MediaStream 实例对象创建 RCLocalTrack 实例

Parameters
- tag: string
  
  轨道标识
- stream: MediaStream
  
  MediaStream 实例
- Optional options: ICreateLocalTrackOptions
  
  可用于指定 withoutVideo 与 withoutAudio 以剔除视轨与音轨
Returns Promise<{ code: RCRTCCode; tracks: RCLocalTrack[] }>

createLocalVideoTrack

createLocalVideoTrack(tag: string, track: MediaStreamTrack): Promise<{ code: RCRTCCode; track?: RCLocalVideoTrack }>

Inherited from RCMediaStreamCapture.createLocalVideoTrack
- Defined in src/core/RCMediaStreamCapture.ts:488
创建 RCLocalVideoTrack 实例

Parameters
- tag: string
  
  视轨数据标识
- track: MediaStreamTrack
  
  MediaStreamTrack 实例
Returns Promise<{ code: RCRTCCode; track?: RCLocalVideoTrack }>

createMicrophoneAndCameraTracks

createMicrophoneAndCameraTracks(tag?: string, options?: { audio?: IMicphoneAudioProfile; video?: ICameraVideoProfile }): Promise<{ code: RCRTCCode; tracks: RCLocalTrack[] }>

Inherited from RCMediaStreamCapture.createMicrophoneAndCameraTracks
- Defined in src/core/RCMediaStreamCapture.ts:206
通过摄像头与麦克风采集音视频轨道数据

Parameters
- tag: string = 'RongCloudRTC'
- Optional options: { audio?: IMicphoneAudioProfile; video?: ICameraVideoProfile }
  - Optional audio?: IMicphoneAudioProfile
  - Optional video?: ICameraVideoProfile
Returns Promise<{ code: RCRTCCode; tracks: RCLocalTrack[] }>

createMicrophoneAudioTrack

createMicrophoneAudioTrack(tag?: string, options?: IMicphoneAudioProfile): Promise<{ code: RCRTCCode; track?: RCMicphoneAudioTrack }>

Inherited from RCMediaStreamCapture.createMicrophoneAudioTrack
- Defined in src/core/RCMediaStreamCapture.ts:90
从麦克风中捕获音轨数据

Parameters
- tag: string = 'RongCloudRTC'
- Optional options: IMicphoneAudioProfile
Returns Promise<{ code: RCRTCCode; track?: RCMicphoneAudioTrack }>

createScreenVideoTrack

createScreenVideoTrack(tag?: string, options?: IScreenVideoProfile): Promise<{ code: RCRTCCode; track?: RCScreenVideoTrack }>

Inherited from RCMediaStreamCapture.createScreenVideoTrack
- Defined in src/core/RCMediaStreamCapture.ts:286
创建屏幕共享视频流，默认分辨率 1280 * 720，帧率 15

description
支持 Electron 平台下通过制定 chromeMediaSourceId 的方式获取屏幕共享视频。参考：https://www.electronjs.org/docs/api/desktop-capturer

Parameters
- tag: string = 'screenshare'
  
  屏幕共享视轨数据标识
- Optional options: IScreenVideoProfile
Returns Promise<{ code: RCRTCCode; track?: RCScreenVideoTrack }>

createScreenWithAudioTracks

createScreenWithAudioTracks(tag?: string, options?: IScreenVideoProfile): Promise<{ code: RCRTCCode; tracks?: (RCScreenVideoTrack | RCScreenAudioTrack)[] }>

Inherited from RCMediaStreamCapture.createScreenWithAudioTracks
- Defined in src/core/RCMediaStreamCapture.ts:301
创建带音频的屏幕共享资源

description
electron 中 mac 系统暂不支持屏幕共享采集声音

Parameters
- tag: string = 'screenshare'
  
  屏幕共享视轨数据标识
- Optional options: IScreenVideoProfile
Returns Promise<{ code: RCRTCCode; tracks?: (RCScreenVideoTrack | RCScreenAudioTrack)[] }>
在可以取到音频的情况下，tracks 中包含音轨和视轨；取不到音视频时 tracks 仅返回视轨

downgradeToAudienceRoom

downgradeToAudienceRoom(room: RCLivingRoom): Promise<{ CDNUris?: IJoinResCDNInfo; MCUTracks?: RCRemoteTrack[]; RTCTracks?: RCRemoteTrack[]; code: RCRTCCode; room?: RCAudienceLivingRoom; userIds?: string[] }>

- Defined in src/core/RCRTCClient.ts:555
降级为观众房间

Parameters
- room: RCLivingRoom
  
  主播房间实例
Returns Promise<{ CDNUris?: IJoinResCDNInfo; MCUTracks?: RCRemoteTrack[]; RTCTracks?: RCRemoteTrack[]; code: RCRTCCode; room?: RCAudienceLivingRoom; userIds?: string[] }>

getAudienceClient

getAudienceClient(useMutilPeerC?: boolean): RCAudienceClient

- Defined in src/core/RCRTCClient.ts:264
获取直播观众客户端

Parameters
- Optional useMutilPeerC: boolean
Returns RCAudienceClient

getCurrentId

getCurrentId(): string

- Defined in src/core/RCRTCClient.ts:120
获取当前用户 Id，若 IM 未连接，这返回 ''

Returns string

getJoinedRoomInfo

getJoinedRoomInfo(): Promise<{ code: RCRTCCode | ErrorCode; data?: IRTCJoinedInfo[] }>

- Defined in src/core/RCRTCClient.ts:635
获取在房间内用户信息

since
version 5.2.1

Returns Promise<{ code: RCRTCCode | ErrorCode; data?: IRTCJoinedInfo[] }>

joinCrossRTCRoom

joinCrossRTCRoom(roomId: string, joinType?: RTCJoinType, outerUserDatas?: IRTCUserData, useMutilPeerC?: boolean, roomType?: RTCMode): Promise<{ code: RCRTCCode; room?: RCRTCRoom; tracks?: RCRemoteTrack[]; userIds?: string[] }>

- Defined in src/core/RCRTCClient.ts:176
加入跨AppKey音视频房间

Parameters
- roomId: string
- Optional joinType: RTCJoinType
  
  多端处理方式
- Optional outerUserDatas: IRTCUserData
  
  业务层设置人员属性
- Optional useMutilPeerC: boolean
  
  是否使用多 peerConnection 发布资源
- roomType: RTCMode = RTCMode.CROSS_MUTI
  
  加入房间的类型默认参数 RTCMode.CROSS_MUTI
Returns Promise<{ code: RCRTCCode; room?: RCRTCRoom; tracks?: RCRemoteTrack[]; userIds?: string[] }>

joinLivingRoom

joinLivingRoom(roomId: string, livingType: RCLivingType, joinType?: RTCJoinType, outerUserDatas?: IRTCUserData, useMutilPeerC?: boolean): Promise<{ CDNEnable?: boolean; code: RCRTCCode; room?: RCLivingRoom; tracks?: RCRemoteTrack[]; userIds?: string[] }>

- Defined in src/core/RCRTCClient.ts:217
主播加入直播房间或观众上麦场景调用，观众上麦之前需先取消已订阅的直播间资源

Parameters
- roomId: string
  
  房间 Id
- livingType: RCLivingType
  
  直播间类型，RCLivingType.AUDIO 为音频直播，RCLivingType.VIDEO 为音视频直播
- Optional joinType: RTCJoinType
  
  多端处理方式，公有云暂不支持该字段
- Optional outerUserDatas: IRTCUserData
  
  业务层设置人员属性
- Optional useMutilPeerC: boolean
Returns Promise<{ CDNEnable?: boolean; code: RCRTCCode; room?: RCLivingRoom; tracks?: RCRemoteTrack[]; userIds?: string[] }>

joinLivingRoomAsAudience

joinLivingRoomAsAudience(roomId: string, livingType: RCLivingType, useMutilPeerC?: boolean): Promise<{ CDNUris?: IJoinResCDNInfo; MCUTracks?: RCRemoteTrack[]; RTCTracks?: RCRemoteTrack[]; code: RCRTCCode; room?: RCAudienceLivingRoom; userIds?: string[] }>

- Defined in src/core/RCRTCClient.ts:363
观众加入直播房间

Parameters
- roomId: string
  
  房间 ID
- livingType: RCLivingType
  
  直播类型（音频直播 or 音视频直播）
- Optional useMutilPeerC: boolean
Returns Promise<{ CDNUris?: IJoinResCDNInfo; MCUTracks?: RCRemoteTrack[]; RTCTracks?: RCRemoteTrack[]; code: RCRTCCode; room?: RCAudienceLivingRoom; userIds?: string[] }>

joinRTCRoom

joinRTCRoom(roomId: string, joinType?: RTCJoinType, outerUserDatas?: IRTCUserData, useMutilPeerC?: boolean, roomType?: RTCMode, signalRetryTime?: number): Promise<{ code: RCRTCCode; room?: RCRTCRoom; tracks?: RCRemoteTrack[]; userIds?: string[] }>

- Defined in src/core/RCRTCClient.ts:135
加入普通音视频房间，返回房间对象、code、userIds、tracks

Parameters
- roomId: string
  
  房间号
- Optional joinType: RTCJoinType
- Optional outerUserDatas: IRTCUserData
- Optional useMutilPeerC: boolean
- roomType: RTCMode = RTCMode.RTC
  
  RTCMode = RTCMode.RTC,
- Optional signalRetryTime: number
  
  连接信令服务器的超时时间。
Returns Promise<{ code: RCRTCCode; room?: RCRTCRoom; tracks?: RCRemoteTrack[]; userIds?: string[] }>

leaveLivingRoomAsAudience

leaveLivingRoomAsAudience(room: RCAudienceLivingRoom): Promise<{ code: RCRTCCode }>

- Defined in src/core/RCRTCClient.ts:453
观众退出并销毁当前房间实例，退出后该房间的所有方法将不可用

Parameters
- room: RCAudienceLivingRoom
Returns Promise<{ code: RCRTCCode }>

leaveRoom

leaveRoom(room: RCAbstractRoom): Promise<{ code: RCRTCCode }>

- Defined in src/core/RCRTCClient.ts:328
退出并销毁当前房间实例，退出后该房间的所有方法将不可用

Parameters
- room: RCAbstractRoom
Returns Promise<{ code: RCRTCCode }>

reportSDKInfo

reportSDKInfo(): void

- Defined in src/core/RCRTCClient.ts:660
Returns void

upgradeToAnchorRoom

upgradeToAnchorRoom(room: RCAudienceLivingRoom): Promise<{ CDNEnable?: boolean; code: RCRTCCode; room?: RCLivingRoom; tracks?: RCRemoteTrack[]; userIds?: string[] }>

- Defined in src/core/RCRTCClient.ts:493
升级为主播房间

Parameters
- room: RCAudienceLivingRoom
  
  观众房间实例
Returns Promise<{ CDNEnable?: boolean; code: RCRTCCode; room?: RCLivingRoom; tracks?: RCRemoteTrack[]; userIds?: string[] }>

Static getTracksWithOptions

getTracksWithOptions(stream: MediaStream, options?: ICreateLocalTrackOptions): (undefined | MediaStreamTrack)[]

Inherited from RCMediaStreamCapture.getTracksWithOptions
- Defined in src/core/RCMediaStreamCapture.ts:691
它接受一个 MediaStream 和一个可选的选项对象并返回一个 MediaStreamTracks 数组

Parameters
- stream: MediaStream
  
  MediaStream - 从中获取曲目的流。
- Optional options: ICreateLocalTrackOptions
Returns (undefined | MediaStreamTrack)[]
一组 MediaStreamTrack 对象。

Hierarchy

Index

Constructors

Methods

Constructors

constructor

Parameters

_context: RTCContext

_runtime: IRuntime

_options: IRCRTCInitOptions

Returns RCRTCClient

Methods

createCameraVideoTrack

Parameters

tag: string = 'RongCloudRTC'

Optional options: ICameraVideoProfile

Returns Promise<{ code: RCRTCCode; track?: RCCameraVideoTrack }>

createLocalAudioTrack

Parameters

tag: string

track: MediaStreamTrack

Returns Promise<{ code: RCRTCCode; track?: RCLocalAudioTrack }>

createLocalFileTracks

Parameters

tag: string

file: string | File

Optional options: ICreateLocalTrackOptions

Returns Promise<{ code: RCRTCCode; tracks: RCLocalFileTrack[] }>

createLocalTracks

Parameters

tag: string

stream: MediaStream

Optional options: ICreateLocalTrackOptions

Returns Promise<{ code: RCRTCCode; tracks: RCLocalTrack[] }>

createLocalVideoTrack

Parameters

tag: string

track: MediaStreamTrack

Returns Promise<{ code: RCRTCCode; track?: RCLocalVideoTrack }>

createMicrophoneAndCameraTracks

Parameters

tag: string = 'RongCloudRTC'

Optional options: { audio?: IMicphoneAudioProfile; video?: ICameraVideoProfile }

Optional audio?: IMicphoneAudioProfile

Optional video?: ICameraVideoProfile

Returns Promise<{ code: RCRTCCode; tracks: RCLocalTrack[] }>

createMicrophoneAudioTrack

Parameters

tag: string = 'RongCloudRTC'

Optional options: IMicphoneAudioProfile

Returns Promise<{ code: RCRTCCode; track?: RCMicphoneAudioTrack }>

createScreenVideoTrack

Parameters

tag: string = 'screenshare'

Optional options: IScreenVideoProfile

Returns Promise<{ code: RCRTCCode; track?: RCScreenVideoTrack }>

createScreenWithAudioTracks

Parameters

tag: string = 'screenshare'

Optional options: IScreenVideoProfile

Returns Promise<{ code: RCRTCCode; tracks?: (RCScreenVideoTrack | RCScreenAudioTrack)[] }>

downgradeToAudienceRoom

Parameters

room: RCLivingRoom

Returns Promise<{ CDNUris?: IJoinResCDNInfo; MCUTracks?: RCRemoteTrack[]; RTCTracks?: RCRemoteTrack[]; code: RCRTCCode; room?: RCAudienceLivingRoom; userIds?: string[] }>

getAudienceClient

Parameters

Optional useMutilPeerC: boolean

Returns RCAudienceClient

getCurrentId

Returns string

getJoinedRoomInfo

Returns Promise<{ code: RCRTCCode | ErrorCode; data?: IRTCJoinedInfo[] }>

joinCrossRTCRoom

Parameters

roomId: string

Optional joinType: RTCJoinType

Optional outerUserDatas: IRTCUserData

Optional useMutilPeerC: boolean

roomType: RTCMode = RTCMode.CROSS_MUTI