一、平台定位：一个接口，对接全部硬件
飞鱼科技不是"把多家厂商的设备抽象成一个接口"的聚合层，而是自研、自产、自销全部硬件设备，再把它们统一封装成一个对外开放的标准接口。这意味着你面对的不是一个黑盒适配层，而是同一家厂商、同一套协议、同一套服务——稳定、可控、好联调。
传统对接：多厂商多套 SDK
打印机、喇叭、扫码设备来自不同厂家，协议各异、文档散落、联调周期长，每加一款硬件都要重学一遍。
维护成本高、易失控
厂商停服、固件变更、接口调整都可能影响你的业务；出问题要在多家之间来回扯皮，责任难定位。
场景拼不齐
扫码、打印、播报往往分属不同系统，做"扫码核销后自动出单+播报"的闭环要自己缝多处，体验割裂。
上线慢、复制难
每家客户门店环境不同，硬件型号、网络条件千差万别，方案难标准化，一套方案无法快速复制到全国门店。
💡 飞鱼平台的核心差异
硬件自研、接口统一：全部 19 款设备由飞鱼自研自产，对外只暴露一套标准化 API/SDK，你无需关心底层品牌与协议差异。
一次对接、全矩阵可用：注册一个应用，即可调用云打印、语音播报、扫码核销、数据采集等全部能力，新增设备类型无需重新适配。
场景闭环开箱即用：扫码→核销→出单→播报→数据上报在平台内原生打通，软件公司专注自己的业务系统即可。
二、产品矩阵全景：全部 19 款自研设备
飞鱼硬件对接平台覆盖 5 大类、共 19 款自研设备。软件公司在为客户做方案时，按场景从下表挑选即可——所有型号均通过同一套 API控制，无需为不同型号分别开发。
PART 01 — 智能收款与通知设备（云喇叭）
型号 | 名称 | 连接 | 核心能力 | 适用场景 |
|---|---|---|---|---|
FY200W | WiFi 版云喇叭 | WiFi | 主流支付平台实时语音播报、大音量、成本低 | 中小型零售、餐饮、室内服务 |
FY200G | 4G 版云喇叭 | 内置 4G | 无需 WiFi、工业级稳定、断电续航、零延迟通知 | 流动摊贩、户外服务点、无 WiFi 门店 |
PART 02 — 智能扫码设备（扫码盒子 + 扫码平台）
型号 | 名称 | 连接 | 核心能力 | 适用场景 |
|---|---|---|---|---|
SMU | USB 扫码盒子 | USB | 即插即用、自助扫码、99.9% 识别率、小巧省空间 | 厂店、中小零售、餐饮小店固定收银 |
SM4G | 4G 独立扫码盒子 | 内置 4G | 自成一体支付终端、云端远程管理、离线缓存 | 无人售货机、共享设备、户外摊位 |
SLU | USB 扫码平台 | USB | 大视窗自动感应、全方位读取、即放即扫 | 大型超市、连锁便利店、高频扫码 |
SL4G | 4G 无线扫码平台 | 4G 无线 | 高速全景摄像头、云平台统一管理、摆脱线缆 | 高端零售、品牌餐饮连锁、酒店前台 |
PART 03 — 智能票据打印机（A款80mm / B款58mm）
型号 | 名称 | 连接 | 核心能力 | 适用场景 |
|---|---|---|---|---|
A-P80UC | A款 USB 打印机(80mm) | USB | 80mm 热敏、经济稳定 | 中大型餐厅、超市本地收银 |
A-P80WC | A款 WiFi 云打印机(80mm) | WiFi | 云端订单自动打印、无人值守 | 外卖餐饮线上接单 |
A-P80GC | A款 4G 打印机(80mm) | 内置 4G | 网络独立、不受 WiFi 限制 | 户外美食车、展会摊位 |
B-P58U | B款 USB 打印机(58mm) | USB | 58mm 便捷、机芯寿命长 | 小餐馆、便利店基础收银 |
B-P58W | B款 WiFi 智能版(58mm) | WiFi | 多平台订单自动打印与智能分单 | 中式连锁餐厅 |
B-P58G | B款 4G 全网通版(58mm) | 内置 4G | 高性能 + 4G 稳定性 | 复杂商业场景 |
PART 04 — 多功能智能终端
名称 | 核心能力 | 卖点 | 适用场景 |
|---|---|---|---|
WiFi 智能营销终端 | 扫码+电子收款码+广告屏+播报 四合一 | 云端远程内容发布、动态视觉远超海报 | 门店橱窗、餐桌桌面、商场大堂营销 |
4G 扫码收银电子秤 | 称重+计价+收银一体化 | 成本降约 30%、收银速度提 50%+、数据上云 | 生鲜超市、精品果蔬店、熟食店 |
WiFi 支付硬插件 | 传统收银机→扫码支付改造 | 加密传输、低成本灵活改造、无需换新机 | 零售、餐饮、商超等线下消费 |
PART 05 — "银印"系列智能物联网盒子
名称 | 核心功能 | 卖点 | 适用场景 |
|---|---|---|---|
银印 WiFi 电票屏 | 显示动态二维码、电子账单替代纸质小票 | 绿色环保降本、承载优惠券/会员信息提升复购 | 高端餐厅、新零售体验店、连锁品牌 |
银印 WiFi 打印云盒 | USB 热敏打印机→WiFi 云打印升级 | 即插即用、双模并行、不依赖飞鱼设备、适配多数 USB 热敏打印机 | 外卖自动打印、存量设备云化 |
银印 WiFi 营销盒 | 小票底部自动追加广告+二维码 | 开辟广告收入新渠道、场景投放转化率高 | 餐饮结账单、零售购物小票 |
银印 WiFi 数联盒 | 接传统小票机自动读取小票数据 | 打破数据孤岛、多维度经营报表辅助决策 | 连锁超市/便利店、餐饮连锁集团 |
💡 选型口决（给软件公司）
要出单 → 选云打印机（A款80mm内容多 / B款58mm省空间；WiFi或4G按现场网络）。
要播报 → 选云喇叭（有WiFi用FY200W，无WiFi用FY200G）。
要扫码核销 → 用4G版(SM4G/SL4G)可独立上云；USB版(SMU/SLU)需接已联网主机。
要改造/增值 → 银印系列盒子（打印云盒/营销盒/数联盒/电票屏）即插即用，不依赖飞鱼其他硬件。
三、技术架构：物联网四层模型
飞鱼硬件对接平台本质是一套统一云平台 + 自研硬件终端构成的物联网系统。所有业务逻辑（设备注册、协议适配、指令路由、扫码核销、打印调度、数据上报）都收敛到云端，前端软件公司只需对接云端一个 API，由平台把指令精准下发到对应门店的对应设备。下面自下而上拆解这四层。
图 1：飞鱼硬件对接平台物联网四层架构（飞鱼自研全部硬件 + 统一云平台，对外只暴露一个 API）
终端层：飞鱼科技自研全部硬件设备
终端层是平台在客户门店落地的全部实体设备，均由飞鱼自研自产、统一对接云平台：
云打印机（A款80mm / B款58mm，USB / WiFi / 4G）：负责小票、凭证、标签打印。
云喇叭（FY200W / FY200G）：负责收款语音播报、通知提醒，零延迟、大音量。
云扫码（SMU / SM4G / SLU / SL4G）：负责自助扫码、二维码识别与核销输入。
智能终端（营销终端 / 4G扫码电子秤 / 支付硬插件）：负责营销展示、称重收银、传统收银机改造。
"银印"系列盒子（电票屏 / 打印云盒 / 营销盒 / 数联盒）：即插即用的增值外设，适配市面主流设备。
网络层：通信传输
网络层承载云端与终端之间指令和数据的传输，按设备形态提供三种通道：
WiFi 无线：门店有 WiFi 时，打印机、喇叭、盒子走本地网络低成本上云。
4G 蜂窝网络：设备内置 4G 卡，无 WiFi 也能独立上云（户外、流动、无网门店首选）。
USB 直连：USB 版设备（如 SMU / SLU / 本地打印机）接在已联网的主机上，由主机代发指令上云。
全链路采用 MQTT 长连接 + TLS 加密，保障指令低延迟、不丢单、数据不泄露。
平台层：云端服务（飞鱼科技自研）
平台层是整个对接平台的大脑，所有硬件差异在云端被抹平，对外只输出统一能力：
设备管理与协议适配：统一纳管全部 19 款设备，屏蔽底层通信差异，软件公司无需关心型号协议。
指令路由下发：把来自上层业务的打印、播报、扫码等指令，精准推送到目标门店的目标设备。
扫码核销引擎：云端完成二维码/条码的核验、状态更新与防重复核销，结果回调业务系统。
打印 / 播报调度：协调多设备并发、断网缓存、重连补打，保证出单与播报不漏不重。
应用层：业务对接
应用层决定"指令从哪来、结果往哪去"，是软件公司集成平台的入口：
SaaS / 小程序：外卖聚合、社区团购、扫码点餐等，把订单/取件码直接推给平台自动出单核销。
餐饮 / 零售 ERP：后厨联单、门店收银、会员营销，统一调度打印与播报。
行业平台系统：景区票务、政务办事、快递驿站、加油站等垂直系统，复用同一套硬件能力。
开发者 API / SDK：软件公司只需对接飞鱼一个标准化接口，即可调用全矩阵硬件——一次集成、全国门店通用。
💡 一站式平台的核心价值
对软件公司而言，飞鱼平台把"硬件碎片化"的问题在平台层全部消化：你只面对云端一个 API，所有 19 款自研硬件由平台统一调度、统一协议、统一运维。无论是扫码核销、小票打印、语音播报还是数据采集，都是同一次对接里的一组接口，而非多家厂商的多套对接。
四、五步接入：从注册到出单
飞鱼平台的接入路径刻意做"轻"——软件公司无需采购测试硬件、无需研究设备协议，按下面五步即可打通全链路：
注册开发者应用
在飞鱼开放平台创建应用，获取 app_id 与 app_secret，并申请所需的硬件能力权限（打印 / 播报 / 扫码核销等）。
获取访问令牌
用 app_id / app_secret 调用鉴权接口换取 access_token，后续所有接口凭此令牌访问，令牌过期前自动续期。
绑定设备
客户门店设备上电联网后，在平台用设备序列号（SN）完成绑定与分组（可按门店、区域、连锁品牌组织），软件系统拿到 device_sn 即可下发指令。
调用业务接口
通过统一 API 推送打印任务、发起语音播报、提交扫码核销——平台自动把指令路由到对应设备，无需关心底层连接方式是 WiFi 还是 4G。
接收异步回调
配置 notify_url，平台把打印状态、核销结果、设备在线状态等事件主动推回你的系统，业务闭环完整可控。
五、核心能力 API 一览
飞鱼平台把全部硬件能力收敛为几组语义清晰、风格统一的 REST 接口。下表是开发者最常用的核心能力（示例路径，以正式开放平台文档为准）：
能力 | 接口（示例） | 说明 | 典型场景 |
|---|---|---|---|
鉴权 | POST /v1/auth/token | 换取 access_token | 所有接口前置步骤 |
打印 | POST /v1/device/print | 向指定打印机推送小票/凭证任务 | 外卖出单、自提凭证、票务凭条 |
语音播报 | POST /v1/device/voice | 向云喇叭推送播报文本 | 收款播报、叫号、通知提醒 |
扫码核销 | POST /v1/scan/verify | 云端核验二维码/条码并防重复 | 取件核销、票务核验、签到 |
设备状态 | GET /v1/device/status | 查询设备在线/缺纸/故障状态 | 运维监控、异常预警 |
数据上报 | GET /v1/data/report | 拉取数联盒采集的经营数据 | 连锁报表、销售分析 |
事件回调 | Webhook → notify_url | 异步推送核销/打印/状态事件 | 业务闭环、对账 |
六、接口示例（快速上手）
下面用最典型的四个调用，演示"一次对接"如何串起打印、播报、扫码核销与异步回调。示例采用 HTTPS + JSON，所有请求头携带 Authorization: Bearer {access_token}。