tencent cloud

直播 SDK

动态与公告
TUILiveKit 产品动态
云直播推拉流 SDK 产品动态
新手指引
产品简介
产品概述
产品优势
性能数据
基本概念
购买指南
TRTC Live 价格总览
Live 视频直播计费说明
开通服务(TUILiveKit)
Demo 体验
Demo 体验指引
跑通 Demo(TUILiveKit)
接入指南
视频直播
准备工作
主播开播
观众观看
直播列表
语聊房
准备工作
主播开播
观众观看
直播列表
推流助手
推流助手(Electron 桌面应用)
推流助手(Web 桌面浏览器)
直播监播
监播页面(Web 桌面浏览器 React 版)
监播页面(Web 桌面浏览器 Vue 版)
UI 自定义
直播视频组件
视频源编辑组件
观众列表组件
聊天弹幕组件
媒体源配置面板
连麦管理面板
直播送礼组件
无 UI 集成
搭建视频直播
搭建语聊房
功能指南
关注主播(TUILiveKit)
至臻画质(TUILiveKit)
输入媒体流进房(TUILiveKit)
礼物系统(TUILiveKit)
客户端 API
Android
iOS
Web
服务端 API(TUILiveKit)
账号系统
REST API
第三方回调
错误码(TUILiveKit)
常见问题
平台编译
用户鉴权
云直播推拉流 SDK
产品简介
购买指南
Demo 体验
免费测试
SDK 下载
License 管理
高级功能
客户端 API
常见问题
无 UI 集成方案
API 文档
OSS information
OSS Attribution Notice

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
发送包数

帮助和支持

本页内容是否解决了您的问题?

填写满意度调查问卷,共创更好文档体验。

文档反馈