设计器与工具
调试台
在 PrintLink 里开启的协议级调试台:示例中心、能力驱动的参数、受控上传与隔离边界。
最后更新
调试台(Playground)内嵌在 PrintLink 里,与服务共用同一个本机端口。 它面向开发者,用来验证连接、能力和打印流程。
开启
- 控制台「设置」里打开「调试台」(默认关闭)。
- 浏览器访问
http://127.0.0.1:17888/(端口以你的设置为准)。 - 「真实打印」是独立开关,默认关闭——关着时所有示例只走预览和校验,不出纸。
能做什么
- 示例中心:每个示例都声明目的、需要的能力和预期结果,代码就是实际执行的代码。
- 能力驱动的参数:纸张、双面、色彩等选项实时读自当前打印机的能力, 换打印机立即重建。打印机离线时如实显示不可用,不假装能选。
- 多页混合页(
/playground/mixed/):把多种内容排进一条任务,含配方卡与自选清单, 状态栏显示输出页数与纸张。 - HTTP 直连页(
/playground/http/):唯一不使用 SDK 的页面,每一步都是真实的fetch,并给出对应的curl代码(令牌已掩码)。适合移动端与服务端接入时对照。 - Hiprint 页(
/playground/hiprint/):粘贴模板 JSON 看转换结果与警告。
示例代码自带中英双语注释,编辑器里的补全说明跟随界面语言。
本地文件上传
PDF / 图片示例支持从本地选文件,走的是公开的资产上传接口(分块 + SHA-256 校验),和你自己的网页用的是同一条通道,没有任何特权后门。
隔离边界
调试台会执行你输入的代码:
- 代码跑在沙箱 iframe 里,有严格 CSP,碰不到桌面端 API 和父页面 DOM;
- 但它调用的是真实的本机服务——它能做的事,等于一个已配对站点能做的事。
所以:不要粘贴来路不明的代码。
端口改过之后
在控制台改了端口或监听范围后,已打开的调试台页面会收到通知,然后:
停止发起新请求、清理旧的连接意图、给出指向新地址的重连入口,不会在旧地址上
静默重试。你自己的页面也可以用 client.onServiceMigrated() 订阅同一事件。