通过 wacp.js 完成「设计模板 → 下发到本机 → 触发打印」全流程(模板内容由三方自行存储)
1. 「Token」:必填,通过 API Key + serviceType=Poster 换取,用于授权三方访问设计器
2. 「模板 ID」:三方自行生成和管理模板 ID,填入下方输入框,用于保持 ClientPrinter 与三方系统的一致性
3. 「打开设计器」:调用 wacp.openDesigner(token, opts, onReady),新窗口打开模板设计器;保存后回调返回 templateContent(模板完整内容),由三方自行存储
4. 「下发模板」:调用 wacp.sendTemplate(templateId, templateContent),将模板内容推送到本机 ClientPrinter
5. 「打印」:调用 wacp.print(templateId, { rows, copies }, templateContent),通过模板 ID 匹配已下发的模板进行打印
Token 用于授权三方打开设计器;在 接口身份核验 页面通过 API Key + serviceType=Poster 换取
模板 ID 由三方自行生成和管理,用于保持 ClientPrinter 与三方系统的一致性
连接状态:未连接
单位 px;传入 templateData 时该字段被忽略
热敏标签/小票 203,激光打印机 300,照片打印 600;不传则设计器默认 203
可选;仅设计期可见。加载已有模板且未配置字段时使用模板自带字段
每个对象的 key 需与模板里绑定的字段名一致;多个对象将连续打印
让 ClientPrinter 启动本机 Edge / Chrome 浏览器,以 --kiosk --app=URL 模式真全屏打开指定页面。
无标题栏、无边框、无地址栏、无任务栏。关闭方式:调 wacp.closeNativeWebView()。
前置条件:客户端机器需有 Edge(Win10/11 自带)或 Chrome 浏览器。
调用本地截图工具,框选区域后点击工具栏「上传」按钮,将截图返回为 Base64,可上传到三方服务器