M50 WebSocket 协议 46 命令全景速查地图
前面每篇只拆了一块,这篇把整份协议46 个 Request 命令一次摆出来,按功能域分类,方便你们当字典翻。我整理的时候才发现,协议从联网、供电、生物、权限到日志全链路都覆盖了,难怪能单独撑起一个对接系列。
说明:以下清单依据协议文档中的 Request 命令整理,以实际设备固件为准;远程控制类(如
TakeOffManager)详见设备控制篇。
命令能力地图
按域速查说明
| 功能域 | 命令 | 一句话用途 |
|---|---|---|
| 网络接口 | SetEthernet/GetEthernetSetting | 有线网卡 IP/网关/端口配置 |
| 网络接口 | SetWiFi/GetWiFiSetting | 无线 SSID/密钥/网络配置 |
| 电源与响铃 | SetPowerSetting/GetPowerSetting | 唤醒延时、休眠、定时重启计划 |
| 电源与响铃 | SetBellTime/GetBellTime | 一天 24 时段打铃配置 |
| 设备信息/状态 | GetDeviceInfo/GetDeviceInfoAll/GetDeviceInfoExt | 读设备参数(键值对 ParamName/Value) |
| 设备信息/状态 | SetDeviceInfo/SetDeviceInfoExt | 写设备参数 |
| 设备信息/状态 | GetDeviceStatus/GetDeviceStatusAll | 读设备运行状态 |
| 时钟与固件 | GetTime/SetTime | 设备时钟校准 |
| 时钟与固件 | GetFirmwareVersion/FirmwareUpgradeHttp | 读版本 / HTTP 方式升级固件 |
| 部门与时段 | SetDepartment | 部门名(base64 UTF-16 LE),编号 0~29 |
| 部门与时段 | SetAccessTimeZone | 门禁时段,编号 0~49,分钟数编码 |
| 部门与时段 | SetAutoAttendance | 自动考勤排班段 |
| 用户主数据 | SetUserData/GetUserCardNo/GetUserPassword/GetUserPhoto/GetUserQR/SetUserPhoto/SetTrIcon | 人员主数据全字段同步 |
| 用户批量拉取 | GetFirstUserData/GetNextUserData/GetNextUserDataExt | 游标批量拉全量人员 |
| 生物特征 | SetFaceData/GetFaceData | 人脸模板下发与回读 |
| 生物特征 | SetFingerData/GetFingerData | 指纹模板 |
| 生物特征 | SetPalmData/GetPalmData | 掌纹模板 |
| 生物特征 | EnrollFaceByPhoto/RemoteEnroll/ExitRemoteEnroll | 远程登记(含照片登记/终端登记) |
| 清空数据 | EmptyUserEnrollmentData/EmptyAllData | 清空生物/全部数据 |
| 日志拉取 | GetFirstGlog/GetNextGlog | 游标拉取历史考勤/管理日志 |
| 设备控制 | EnableDevice/TakeOffManager | 启用设备 / 远程强开强关重启消告警 |
| 连接鉴权 | Register/Login | 注册(带 CloudId)/ 登录(带 Token) |
主要的设备主动推送(Event)
TimeLog_v2:考勤/验证事件,字段含TransID、UtcTimezoneMinutes、LogImage等AdminLog_v2:管理操作事件(增删用户、改设置等)
(协议另有其它实时事件,以文档为准;前序篇章已详拆这两个核心事件。)
怎么用这份地图
- 找命令:按功能域定位,再回对应专篇看字段细节(比如
SetFaceData去生物特征篇,SetAccessTimeZone去部门时段篇)。 - 查能力边界:看这张图就知道这套协议能覆盖"联网 → 配设备 → 录人 → 采生物 → 排权限 → 拉日志 → 远程运维"全链路。
- 做方案评估:要给客户出对接方案,对照这张图就能判断哪些能力开箱即用、哪些要自己补。
这 46 条就是整套对接的武器库。配合前面每篇的字段细节,基本没有盲区。建议收藏,对接时对着翻。
本系列至此覆盖:WebSocket 总览 / 生物特征 / 人员同步 / 实时日志考勤 / 设备运维 / 网络电源响铃 / 部门时段门禁 / 接入安全 / 排障手册 / 最小服务端 / 命令地图,共 11 篇,均基于同一份 M50 WebSocket SDK 协议文档。更多门禁对接实战,可关注 weicontrol.cn。