本地用户流
获取本地媒体资源
您可以使用以下方法从本地摄像头、麦克风设备捕获默认音频 track、视频 track 资源。调用以下获取资源的 API,SDK 内部会把浏览器原生 API 获取的 mediaStream 对象转换为 RCLocalTrack 实例对象,用于后续集成。
提示
同时捕获音视频流
使用初始化时获取的 RCRTCClient
实例的 createMicrophoneAndCameraTracks 方法可同时捕获音视频流。
接口
typescript
rtcClient.createMicrophoneAndCameraTracks(tag: string = 'RongCloudRTC', options?: { audio?: IMicphoneAudioProfile, video?: ICameraVideoProfile })
参数说明
参数 | 类型 | 必填 | 说明 |
---|---|---|---|
tag | string | 否 | 资源标识,默认为 RongCloudRTC |
options.audio | IMicphoneAudioProfile | 否 | 音频配置参数 |
options.video | ICameraVideoProfile | 否 | 视频参数配置 |
示例代码
typescript
/**
* @description tracks 是一个数组,当 `code !== RCRTCCode.SUCCESS` 时,tracks 长度为 0
* @param tag 资源标识,不传时默认为 RongCloudRTC,代表浏览器摄像头、麦克风资源,
* 也可传入其他包含 A-Z、a-z、0-9、+、=、- 的字符串
* @param options 音视频配置项,可参考上述 1、2 中的介绍
*/
const { code, tracks } = await rtcClient.createMicrophoneAndCameraTracks(tag: string = 'RongCloudRTC', options?: { audio?: IMicphoneAudioProfile, video?: ICameraVideoProfile })
if (code === RCRTCCode.SUCCESS) {
// tracks 包含一个 RCMicphoneAudioTrack 实例和一个 RCCameraVideoTrack 实例
const [ audioTrack, videoTrack ] = tracks
}
捕获音频流
使用初始化时获取的 RCRTCClient
实例的 createMicrophoneAudioTrack 由麦克风捕获音频流:
typescript
rtcClient.createMicrophoneAudioTrack(tag: string = 'RongCloudRTC', options?: IMicphoneAudioProfile)
参数说明
参数 | 类型 | 必填 | 说明 |
---|---|---|---|
tag | string | 否 | 资源标识,默认为 RongCloudRTC |
options | IMicphoneAudioProfile | 否 | 音频配置参数 |
示例代码
typescript
/**
* @description 仅当 `code === RCRTCCode.SUCCESS` 时 audioTrack 有值,
* audioTrack 为 RCMicphoneAudioTrack 类型实例
* @param tag 资源标识,不传时默认为 RongCloudRTC,代表浏览器麦克风资源,
* 也可传入其他包含 A-Z、a-z、0-9、+、=、- 的字符串
* @param IMicphoneAudioProfile 音频配置项,可选参数
* @param IMicphoneAudioProfile.micphoneId 指定麦克风设备 ID
* @param IMicphoneAudioProfile.sampleRate 指定音频采样率
*/
const { code, track: audioTrack } = await rtcClient.createMicrophoneAudioTrack(tag: string = 'RongCloudRTC', options?: IMicphoneAudioProfile)
捕获视频流
使用初始化时获取的 RCRTCClient
实例的 createCameraVideoTrack 方法由摄像头捕获视频流。如需设置视频帧率、分 辨率,可参考「视频管理」下的文档。
接口
typescript
rtcClient.createCameraVideoTrack(tag: string = 'RongCloudRTC', options?: ICameraVideoProfile)
参数说明
参数 | 类型 | 必填 | 说明 |
---|---|---|---|
tag | string | 否 | 资源标识,默认为 RongCloudRTC |
options | ICameraVideoProfile | 否 | 视频参数配置 |
示例代码
typescript
/**
* @description 仅当 `code === RCRTCCode.SUCCESS` 时 videoTrack 有值
* videoTrack 为 RCCameraVideoTrack 类型实例
* @param tag 资源标识,不传时默认为 RongCloudRTC,代表浏览器摄像头资源,
* 也可传入其他包含 A-Z、a-z、0-9、+、=、- 的字符串
* @param ICameraVideoProfile 视频配置项,可选参数
* @param ICameraVideoProfile.cameraId 指定摄像头设备 ID
* @param ICameraVideoProfile.frameRate 指定视频帧率,默认为 RCFrameRate.FPS_15
* @param ICameraVideoProfile.resolution 指定视频分辨率,默认为 RCResolution.W640_H480
*/
const { code, track: videoTrack } = await rtcClient.createCameraVideoTrack(tag: string = 'RongCloudRTC', options?: ICameraVideoProfile)
播放本地音视频资源
本地预览时,请使用 RCTrack 下的 play 方法在本端播放采集的数据。
提示
不要在本端播放本端采集的音频流,否则可能会引起回声问题。
接口
typescript
Track.play(element, options)
参数说明
参数 | 类型 | 必填 | 说明 |
---|---|---|---|
element | HTMLElement | 否 | 用于承载媒体流的元素标签,音频流可传空 |
options | { volume?: number; audioDeviceId?: string } | 否 | 配置参数,volume:播放音频资源的音量,audioDeviceId:指定播放音频的音频设备 ID |