设计器与工具

调试台

在 PrintLink 里开启的协议级调试台:示例中心、能力驱动的参数、受控上传与隔离边界。

最后更新

调试台(Playground)内嵌在 PrintLink 里,与服务共用同一个本机端口。 它面向开发者,用来验证连接、能力和打印流程。

开启

  1. 控制台「设置」里打开「调试台」(默认关闭)。
  2. 浏览器访问 http://127.0.0.1:17888/(端口以你的设置为准)。
  3. 「真实打印」是独立开关,默认关闭——关着时所有示例只走预览和校验,不出纸。

能做什么

  • 示例中心:每个示例都声明目的、需要的能力和预期结果,代码就是实际执行的代码。
  • 能力驱动的参数:纸张、双面、色彩等选项实时读自当前打印机的能力, 换打印机立即重建。打印机离线时如实显示不可用,不假装能选。
  • 多页混合页(/playground/mixed/):把多种内容排进一条任务,含配方卡与自选清单, 状态栏显示输出页数与纸张。
  • HTTP 直连页(/playground/http/):唯一不使用 SDK 的页面,每一步都是真实的 fetch,并给出对应的 curl 代码(令牌已掩码)。适合移动端与服务端接入时对照。
  • Hiprint 页(/playground/hiprint/):粘贴模板 JSON 看转换结果与警告。

示例代码自带中英双语注释,编辑器里的补全说明跟随界面语言。

本地文件上传

PDF / 图片示例支持从本地选文件,走的是公开的资产上传接口(分块 + SHA-256 校验),和你自己的网页用的是同一条通道,没有任何特权后门。

隔离边界

调试台会执行你输入的代码:

  • 代码跑在沙箱 iframe 里,有严格 CSP,碰不到桌面端 API 和父页面 DOM;
  • 但它调用的是真实的本机服务——它能做的事,等于一个已配对站点能做的事。

所以:不要粘贴来路不明的代码。

端口改过之后

在控制台改了端口或监听范围后,已打开的调试台页面会收到通知,然后: 停止发起新请求、清理旧的连接意图、给出指向新地址的重连入口,不会在旧地址上 静默重试。你自己的页面也可以用 client.onServiceMigrated() 订阅同一事件。

相关页面

本页目录