tencent cloud

文档反馈

TXLivePusherObserver

最后更新时间:2022-10-13 11:40:07
    腾讯云直播推流的回调通知,回调包括推流器状态,统计信息,警告以及错误信息。

    onError

    直播推流器错误通知,推流器出现错误时,会回调该通知。
    onError(code: number, msg: string, extraInfo: Object): void;
    参数
    code:错误码,请参见 推流错误码
    msg:错误信息。
    extraInfo:扩展信息,目前未用到。

    onWarning

    直播推流器警告通知。
    onWarning(code: number, msg: string, extraInfo: Object): void;
    参数
    code:错误码,请参见 推流错误码
    msg:错误信息。
    extraInfo:扩展信息,目前未用到。
    说明
    打开摄像头、麦克风、屏幕录制失败时返回的错误信息,可参见 getUserMedia 异常getDisplayMedia 异常

    onCaptureFirstAudioFrame

    首帧音频采集完成的回调通知。
    onCaptureFirstAudioFrame(): void;

    onCaptureFirstVideoFrame

    首帧视频采集完成的回调通知。
    onCaptureFirstVideoFrame(): void;

    onPushStatusUpdate

    推流器连接状态回调通知。
    onPushStatusUpdate(status: number, msg: string, extraInfo: Object): void;
    参数
    status:连接状态码,请参见 推流状态码
    msg:连接状态信息。
    extraInfo:扩展信息,目前未用到。

    onStatisticsUpdate

    直播推流器统计数据回调,主要是 WebRTC 相关的统计数据,不同浏览器返回的数据可能不一致。
    onStatisticsUpdate(statistics: Object): void;
    参数
    statistics:推流统计数据,请参见 推流统计数据

    推流错误码

    onErroronWarning 中用到的错误码如下:
    枚举值
    数值
    描述
    TXLIVE_ERROR_WEBRTC_FAILED
    -1
    WebRTC 接口调用失败
    TXLIVE_ERROR_REQUEST_FAILED
    -2
    请求服务器推流接口返回报错
    TXLIVE_WARNING_CAMERA_START_FAILED
    -1001
    打开摄像头失败
    TXLIVE_WARNING_MICROPHONE_START_FAILED
    -1002
    打开麦克风失败
    TXLIVE_WARNING_SCREEN_CAPTURE_START_FAILED
    -1003
    打开屏幕录制失败
    TXLIVE_WARNING_MEDIA_FILE_START_FAILED
    -1004
    打开本地媒体文件失败
    TXLIVE_WARNING_CAMERA_INTERRUPTED
    -1005
    摄像头被中断(设备被拔出或者权限被用户取消)
    TXLIVE_WARNING_MICROPHONE_INTERRUPTED
    -1006
    麦克风被中断(设备被拔出或者权限被用户取消)
    TXLIVE_WARNING_SCREEN_CAPTURE_INTERRUPTED
    -1007
    屏幕录制被中断(Chrome 浏览器单击自带的停止共享按钮)

    推流状态码

    onPushStatusUpdate 用到的状态码如下:
    枚举值
    数值
    描述
    TXLIVE_PUSH_STATUS_DISCONNECTED
    0
    与服务器断开连接
    TXLIVE_PUSH_STATUS_CONNECTING
    1
    正在连接服务器
    TXLIVE_PUSH_STATUS_CONNECT_SUCCESS
    2
    连接服务器成功
    TXLIVE_PUSH_STATUS_RECONNECTING
    3
    重连服务器中

    推流统计数据

    通过 onStatisticsUpdate 回调接口可以监听直播推流过程中 WebRTC 相关的统计数据。SDK 会以一秒一次的频率统计数据,返回的对象基本结构如下:
    字段
    说明
    timestamp
    数据采样的时间,自1970年1月1日(UTC)起经过的毫秒数
    视频流相关的数据
    音频流相关的数据

    video

    字段
    说明
    bitrate
    视频码率,单位:bit/s
    framesPerSecond
    视频帧率
    frameWidth
    视频宽度,Firefox下不存在
    frameHeight
    视频高度,Firefox下不存在
    framesEncoded
    编码帧数
    framesSent
    发送帧数,Firefox下不存在
    packetsSent
    发送包数
    nackCount
    NACK(Negative ACKnowledgement)数
    firCount
    FIR(Full Intra Request),关键帧重传请求数
    pliCount
    PLI(Picture Loss Indication),视频帧丢失重传数
    frameEncodeAvgTime
    平均编码时间,单位:ms,Safari / Firefox 下不存在
    packetSendDelay
    数据包发送之前本地缓存的平均时间,单位:ms,Firefox 下不存在

    audio

    字段
    说明
    bitrate
    音频码率,单位:bit/s
    packetsSent
    发送包数
    联系我们

    联系我们,为您的业务提供专属服务。

    技术支持

    如果你想寻求进一步的帮助,通过工单与我们进行联络。我们提供7x24的工单服务。

    7x24 电话支持