通信协议

栖屏系列副屏与上位机之间的轻量帧协议;歌词模式包含歌词行、元数据与进度帧。

概述

上位机与副屏之间通过 USB 串口或网络连接。歌词模式使用一套轻量帧协议, 包含歌词行帧、元数据帧与进度帧三类。

性能监控、Wallpaper Engine 壁纸与拓展屏模式使用各自的数据/视频通道, 具体字节定义与示例以产品资料中的协议文档为准。

帧结构

[HEAD][TYPE][LEN][PAYLOAD...][CRC]
  • HEAD:帧头,固定魔数
  • TYPE:帧类型(歌词行 / 元数据 / 进度)
  • LEN:负载长度
  • PAYLOAD:UTF-8 / GB2312 编码的内容
  • CRC:校验

帧类型

类型 说明
0x01 歌词行(当前显示文本)
0x02 元数据(歌名 / 歌手 / 专辑)
0x03 进度(当前时间 / 总时长)

性能数据、模式切换与拓展屏传输使用独立通道,详见产品资料。