• 实时音视频
    • 实时音视频>客户端 API>Web

    Web

    编辑文档 更新于
    概览BRTCClientStreamLocalStreamRemoteStreamEventsBRTCErrorOption

    Stream 接口提供的方法用于定义音视频流对象的行为,例如流的播放控制、音视频的编码配置等。

    • 你可以通过 createStream 创建 Stream对象
    • 一个Stream对象指通话中发布的本地音视频流或订阅的远端音视频流
    • Stream 方法如无特别说明,本地 LocalStream 和远端 RemoteStream 音视频流均可调用
    • 一个 Stream 中最多只能同时包含一个音频 track 和一个视频 track

    一个远端用户可发送至多两个远端流对象,其中一个远端流对象包含一路音频和一路主路视频,另一个远端流对象仅仅包含一路辅路视频。 这两种远端流对象的类型可通过 userID 对应流的后缀来区别:

    • “0”表示主视(main)频流
    • “1”表示辅助(assist)视频流

    Hierarchy

    Stream

    Index

    Accessors

    Methods

    init destroy replay
    fire getAudioDeviceId getAudioLevel
    getAudioTrack getAudioVolume getStreamId
    getUserId getAudioOn getStats
    getVideoFrame getVideoOn getVideoTrack
    hasAudio hasVideo isLocalStream
    isPlaying isScreenStream muteAudio
    unmuteAudio muteVideo unmuteVideo
    off on one
    play resume stop

    Properties

    streamCodecOption
    流配置项 

    stream.streamCodecOption: streamCodecOption

    详情

    Accessors

    audioTrack
    音频轨道 

    stream.audioTrack(): MediaStreamTrack

    返回

    • MediaStreamTrack

    videoTrack
    视频轨道 

    stream.videoTrack(): MediaStreamTrackMediaStreamTrack

    返回

    • MediaStreamTrack

    Methods

    init
    初始化实例 

    stream.init(): Promise<any>

    返回

    • Promise

    destroy
    销毁音视频流 

    stream.destroy():void

    返回

    • void

    replay
    重新播放流 

    stream.replay(): Promise<void>

    返回

    • void

    fire
    提交事件 

    stream.fire(type: string, data: any):void

    参数

    名称 类型 描述
    type string 事件类型
    Optional data any 事件数据

    返回

    • void

    getAudioDeviceId
    获取当前播放的扬声器设备 id 

    stream.getAudioDeviceId():string

    返回

    • string

    getAudioLevel
    获取当前音量大小 

    stream.getAudioLevel():number

    返回

    • number

    详情

    • 只有当本地流或远端流中有音频数据才有效
    • 返回值在(0.0, 1.0)之间,通常认为值大于0.1为用户正在说话

    getAudioTrack
    获取音频轨道 

    stream.getAudioTrack():MediaStreamTrack

    返回

    • MediaStreamTrack

    getAudioVolume
    获取当前播放音量 

    stream.getAudioVolume():number

    返回

    • number

    getStreamId
    获取 stream id 

    stream.getStreamId():string

    返回

    • string

    getUserId
    获取 userId 

    stream.getUserId(): string

    返回

    • string

    getAudioOn
    获取流音频是否挂起 

    stream.getAudioOn(): boolean

    返回

    • boolean

    getStats
    获取流的传输信息

    stream.getStats(): Promise<RemoteStreamStats>

    返回

    getVideoFrame
    截取当前流的一帧视频数据（base64 png)

    stream.getVideoFrame(): string

    返回

    • string

    详情

    • 该方法需要在 play 后调用,并且 Stream 中有视频流才有效

    getVideoOn
    获取流视频是否挂起

    stream.getVideoOn(): boolean

    返回

    • boolean

    getVideoTrack
    获取视频轨道

    stream.getVideoTrack(): MediaStreamTrack

    返回

    • MediaStreamTrack

    hasAudio
    是否有音频

    stream.hasAudio(): boolean

    返回

    • boolean

    hasVideo
    是否有本地视频

    stream.hasVideo(): boolean

    返回

    • boolean

    isLocalStream
    判断是否是本地流 

    stream.isLocalStream(): boolean

    返回

    • boolean

    isPlaying
    流是否正在播放

    stream.isPlaying():boolean

    返回

    • boolean

    isScreenStream
    是否是屏幕分享流

    stream.isScreenStream(): boolean

    返回

    • boolean

    muteAudio
    禁用音频轨道

    stream.muteAudio():boolean

    返回

    • boolean

    详情

    • 对于本地流,调用该方法会停止发送音频,远端会触发 Client.on(‘mute-audio’) 事件
    • 对于远端流,调用该方法会停止播放音频,但是仍然接收音频数据

    unmuteAudio
    启用音频轨道

    stream.unmuteAudio(): boolean

    返回

    • boolean

    详情

    • 对于本地流,调用该方法会触发远端 Client.on(‘unmute-audio’) 事件
    • 音频轨道默认是开启的,若你调用 muteAudio 后可用该方法重新启用音频

    muteVideo
    禁用视频轨道

    stream.muteVideo():boolean

    返回

    • boolean

    详情

    • 对于本地流,调用该方法会停止发送视频,远端会触发 Client.on(‘mute-video’) 事件
    • 如果视频是从摄像头采集,此时摄像头灯仍然是亮着的
    • 对于远端流,调用该方法会停止播放视频,但是仍然接收视频数据

    unmuteVideo
    启用视频轨道

    stream.unmuteVideo(): boolean

    返回

    • boolean

    详情

    • 对于本地流,调用该方法会触发远端 Client.on(‘unmute-video’) 事件
    • 视频轨道默认是开启的,若你调用 muteVideo 后可用该方法重新启用视频

    off
    取消事件监听

    stream.off(type: string, fn: Function): this

    参数

    名称 类型 描述
    type string 事件类型
    fn Function 事件回调

    返回

    详情

    • 只传 类型 取消此事件的所有监听

    • 不传任何参数取消所有事件的监听

    on
    监听Stream事件

    stream.on(类型: string, fn: Function): this

    参数

    名称 类型 描述
    type string 事件类型
    fn Function 事件回调

    返回

    详情

    one
    监听一次事件,执行一次之后自动取消监听

    stream.one(类型: string, fn: Function): this

    参数

    名称 类型 描述
    type string 事件类型
    fn Function 事件回调

    返回

    play
    播放远端流

    stream.play(videoId: string | HTMLDivElement , options: StreamPlayOption): Promise‹any›

    参数

    名称 类型 描述
    videoId string HTMLDivElement 挂载Dom
    Default value options StreamPlayOption 播放选项

    返回

    • Promise‹any›

    详情

    • 由于浏览器自动播放策略的影响,调用该接口可能会返回 PLAY_NOT_ALLOWED 错误, 此时需要引导用户通过手势操作调用 resume 恢复音视频播放

    resume
    恢复音视频播放

    stream.resume(): void

    返回

    • void

    详情

    • 在某些版本浏览器上移动传入 play 的 div 容器可能会导致音视频播放器进入 ‘PAUSED’ 状态,此时 需要调用该接口恢复播放
    • 由于浏览器自动播放策略的限制,在 play 返回 PLAY_NOT_ALLOWED 错误后需要引导用户通过手势 调用该接口恢复播放

    stop
    停止播放流

    stream.stop(): void

    返回

    • void
    {{allComment[version]}} ×
    • 暂无评论
    • {{comment.author}}
      {{ comment.createdAt | date: 'yyyy-MM-dd HH:mm:ss '}}
      {{comment.content}}
    您需要 后才能评论