设备视频流数据
通过 WebSocket 直接拉取指定设备的实时视频流,适用于自定义播放器、录制、实时分析等场景。
接口地址
ws://127.0.0.1:23158/player/设备ID直接连接本地 23158 端口即可拉取视频流。
| 参数 | 说明 |
|---|---|
| 设备ID | 目标设备 ID,例如 P72578581E07 |
数据输出
连接成功后,服务端持续向客户端推送 H.264 baseline 裸流。
基本使用(以NodeJs举例)
javascript
const deviceId = 'P72578581E07'
const ws = new WebSocket(`ws://127.0.0.1:23158/player/${deviceId}`)
ws.binaryType = 'arraybuffer'
ws.onmessage = (_event) => {
// _event.data 为 H.264 baseline 裸流二进制数据
// 交给你的解码器 / 播放器处理
}
ws.onclose = () => {
console.log('视频流连接已关闭')
}
// 业务不再需要画面时,主动关闭连接
// ws.close()⚠️ 重要机制说明
内核服务端会实时检测设备的全部拉流连接(包含 iClick 控制台):
- 当设备不存在任何拉流客户端时,内核会下发指令通知设备停止推流,用于节省双端的带宽、算力资源。
- 业务不再需要投屏画面数据时,请主动关闭 WebSocket 连接,释放设备与宿主机端资源。