百家云 |
您所在的位置:网站首页 › 百家云播放器 › 百家云 |
LocalStream 本地音视频流,通过 createStream 创建。 Index Properties streamCodecOption Accessors audioTrack videoTrack Methods init destroy addTrack removeTrack replaceTrack replay fire getAudioDeviceId getAudioLevel getAudioTrack getAudioVolume getStreamId getUserId getAudioOn isLocalStream setAudioProfile setScreenProfile setVideoEncoderConfiguration isScreenStream setVideoProfile getVideoFrame getVideoOn getVideoTrack hasAudio hasVideo isPlaying muteAudio muteVideo resume stop unmuteAudio unmuteVideo off on one play getStats switchDevice getMediaStream PropertiesstreamCodecOption本地流配置项 localStream.streamCodecOption: streamCodecOption详情 详见 streamCodecOption AccessorsaudioTrack本地音频轨道 localStream.audioTrack(): MediaStreamTrack返回 MediaStreamTrackvideoTrack本地视频轨道 localStream.videoTrack(): MediaStreamTrackMediaStreamTrack返回 MediaStreamTrack Methodsinit初始化 LocalStream 实例 localStream.init(): Promise返回 Promisedestroy销毁音视频流 localStream.destroy():void返回 voidaddTrack添加音频或视频轨道 localStream.addTrack(track: MediaStreamTrack): Promise返回 Promise详情 调用该方法将音频或视频轨道添加到本地流,若该本地流已经被发布,则会自动更新发往远端的音视频流,此时远端会收到 Client.on('stream-updated') 事件通知 请注意,一个 Stream 对象中最多只能同时包含一路音频轨道和一路视频轨道。如果你想要更换同类型的轨道,请使用 replaceTrack() 新的音视频轨道可以通过 createStream/getAudioTrack|getVideoTrack 获取, 或者直接通过 getUserMedia、captureStream 获取removeTrack移除视频轨道 localStream.removeTrack(track: MediaStreamTrack): Promise返回 Promise详情 调用该方法会移除本地流中的视频轨道,若本地流已经被发布,则会自动更新发往远端的视频流,此时远端会收到 Client.on('stream-updated') 事件通知 请注意,一个已经发布的Stream对象中至少要有一个媒体轨道,如果你想完全删除本地流中的音视频轨道,请直接通过 unpublish 取消发布, 然后再通过 destroy 关闭本地流replaceTrack更换音频或视频轨道 localStream.replaceTrack(track: MediaStreamTrack): Promise返回 Promise详情 调用该方法更换本地流中的同类型轨道,若本地流已经被发布,该方法会自动更新发往远端的音视频流,此时远端会收到 Client.on('stream-updated') 事件通知 在更换视频轨道时,要求视频分辨率跟 setVideoProfile设置保持一致,否则会抛出异常 支持 Chrome 65+、Safari 浏览器replay重新播放流 localStream.replay(): Promise返回 Promisefire提交事件 localStream.fire(类型: string, data: any):void参数 名称 类型 描述 type string 事件类型 Optional data any 事件数据返回 voidgetAudioDeviceId获取当前播放的扬声器设备id localStream.getAudioDeviceId():string返回 stringgetAudioLevel获取当前音量大小 localStream.getAudioLevel():number返回 number详情 只有当本地流或远端流中有音频数据才有效 返回值在(0.0, 1.0)之间,通常认为值大于0.1为用户正在说话getAudioTrack获取音频轨道 localStream.getAudioTrack():MediaStreamTrack返回 MediaStreamTrackgetAudioVolume获取当前播放音量 localStream.getAudioVolume():number返回 numbergetStreamId获取 stream id localStream.getStreamId():string返回 stringgetUserId获取 userId localStream.getUserId(): string返回 stringgetAudioOn获取流音频是否挂起 localStream.getAudioOn(): boolean返回 booleanisLocalStream判断是否是本地流 localStream.isLocalStream(): boolean返回 booleansetAudioProfile设置音频 profile localStream.setAudioProfile(profile: AudioProfile): void参数 名称 描述 profile AudioProfile配置项返回 void详情 该方法需要在调用 init 之前调用。setScreenProfile设置屏幕分享 profile localStream.setScreenProfile(profile: ScreenProfile): void参数 名称 描述 profile ScreenProfile配置项返回 void详情 该方法需要在调用 init 之前调用setVideoEncoderConfiguration设置自定义视频编码配置 localStream.setVideoEncoderConfiguration(options: StreamCodecOption): void参数 名称 描述 profile StreamCodecOption配置项返回 void详情 该方法可以根据需要灵活设置本地流的视频分辨率、帧率和码率isScreenStream是否是屏幕分享流 localStream.isScreenStream(): boolean参数 名称 描述 profile StreamCodecOption配置项返回 booleansetVideoProfile设置视频 profile localStream.setVideoProfile(profile: VideoProfile): void参数 名称 描述 profile VideoProfile配置项返回 void详情 该方法需要在调用 init 之前调用getVideoFrame截取当前流的一帧视频数据(base64格式的图片) localStream.getVideoFrame(): string返回 string详情 该方法需要在 play 后调用,并且 Stream 中有视频流才有效getVideoOn获取流视频是否挂起 localStream.getVideoOn(): boolean返回 booleangetVideoTrack获取视频轨道 localStream.getVideoTrack(): MediaStreamTrack返回 MediaStreamTrackhasAudio是否有音频 localStream.hasAudio(): boolean返回 booleanhasVideo是否有本地视频 localStream.hasVideo(): boolean返回 booleanisPlaying流是否正在播放 localStream.isPlaying():boolean返回 booleanmuteAudio禁用音频轨道 localStream.muteAudio():boolean返回 boolean详情 对于本地流,调用该方法会停止发送音频,远端会触发 Client.on(‘mute-audio’) 事件 对于远端流,调用该方法会停止播放音频,但是仍然接收音频数据muteVideo禁用视频轨道 localStream.muteVideo():boolean返回 boolean详情 对于本地流,调用该方法会停止发送视频,远端会触发 Client.on(‘mute-video’) 事件 如果视频是从摄像头采集,此时摄像头灯仍然是亮着的 若想完全禁用视频轨道(即关闭摄像头)可以使用 removeTrack() 删除视频轨道然后调用 MediaStreamTrack.stop() 关闭视频轨道(关闭摄像头) 对于远端流,调用该方法会停止播放视频,但是仍然接收视频数据resume恢复播放音视频 localStream.resume(): void返回 void详情 在某些版本浏览器上移动传入 play() 的 div 容器可能会导致音视频播放器进入 ‘PAUSED’ 状态,此时 需要调用该接口恢复播放 由于浏览器自动播放策略的限制,在 play() 返回 PLAY_NOT_ALLOWED 错误后需要引导用户通过手势 调用该接口恢复播放stop停止播放流 localStream.stop(): void返回 voidunmuteAudio启用音频轨道 localStream.unmuteAudio(): boolean返回 boolean详情 对于本地流,调用该方法会触发远端 Client.on(‘unmute-audio’) 事件 音频轨道默认是开启的,若你调用 muteAudio() 后可用该方法重新启用音频unmuteVideo启用视频轨道 localStream.unmuteVideo(): boolean返回 boolean详情 对于本地流,调用该方法会触发远端 Client.on(‘unmute-video’) 事件 视频轨道默认是开启的,若你调用 muteVideo() 后可用该方法重新启用视频off取消事件监听 localStream.off(类型: string, fn: Function): this参数 名称 类型 描述 type string 事件类型 fn Function 事件回调返回 实例本身Stream详情 只传 类型 取消此事件的所有监听 不传任何参数取消所有事件的监听on监听Stream事件 localStream.on(类型: string, fn: Function): this参数 名称 类型 描述 type string 事件类型 fn Function 事件回调返回 实例本身Streamone监听一次事件,执行一次之后自动取消监听 localStream.one(类型: string, fn: Function): this参数 名称 类型 描述 type string 事件类型 fn Function 事件回调返回 实例本身Streamplay播放流本地流 localStream.play(videoId: string | HTMLDivElement, options: StreamPlayOption): Promise‹any›参数 名称 类型 描述 videoId string | HTMLDivElement 挂载Dom Default value options StreamPlayOption 播放选项返回 Promise‹any›详情 由于浏览器自动播放策略的影响,调用该接口可能会返回 PLAY_NOT_ALLOWED 错误, 此时需要引导用户通过手势操作调用 resume 恢复音视频播放getStats获取流的传输信息 localStream.getStats(): Promise返回 PromiseswitchDevice切换媒体输入设备,调用该方法可更换本地流的媒体输入设备 localStream.switchDevice(type: TrackType, deviceId: string): promise返回 Promise‹any›getMediaStream获取 MediaStream 实例 localStream.getMediaStream(): MediaStream返回 Promise |
今日新闻 |
推荐新闻 |
CopyRight 2018-2019 办公设备维修网 版权所有 豫ICP备15022753号-3 |