打印机通知如何在不经云端控制打印机的情况下工作

通知服务并不需要变成打印机的云端控制器。Printer Tools 将推送协调与直接的打印机连接分开：API 可以帮助唤醒或通知已注册的客户端，而客户端则通过其现有的本地路径或授权的远程路径读取打印机。

这种设计可以避免 API 以用户的名义例行登录打印机。

Printer Tools

在一个面板中管理您的所有 3D 打印机

通过一个应用监控 Bambu Lab、Klipper、OctoPrint、Creality、Snapmaker、Anycubic、Flashforge、Elegoo 和 Prusa 打印机

支持 Android、iPhone、iPad 和 Mac，并提供 Apple Watch 与 Wear OS 配套应用，以及通过 VPN、OctoEverywhere 或 Obico 实现的可选远程访问

打印机连接归客户端所有

手机或电脑上的 Printer Tools 会保存受支持打印机的配置，并打开本地协议。应用读取状态，并判断打印机正在报告什么。

API 不会用通用的云端连接取代 Bambu MQTT、Moonraker、OctoPrint 或其他本地服务。

推送协调负责唤醒应用

在受支持的平台上，推送基础设施可以通知客户端刷新，或传递与活动监控会话相关的更新。何时允许后台工作、通知如何显示，都由平台规则决定。

推送令牌标识的是应用安装或 Live Activity 通道，而不是打印机密码。令牌可能会轮换，因此当平台提供新令牌时，客户端会更新注册信息。

监控会话在不活跃时会过期

Printer Tools 不会让被遗弃的通知会话永远保持活动。推送流程设有 24 小时的不活跃期限。在监控进行期间，客户端必须维持其注册或心跳。

如果在长时间没有活动后通知停止，请重新打开 Printer Tools 和打印机会话，而不是削弱不活跃保护。

本地可达性仍然重要

推送唤醒本身无法穿过被阻断的本地网络。如果手机被唤醒后无法访问打印机，就无法获取最新的本地数据。在家时，请修复 Wi-Fi、VLAN 或凭据。外出时，请使用授权的 VPN 或受支持的远程服务。

推送只是协调手段，而不是通往私有打印机的隧道。

平台权限决定显示方式

只允许你真正需要的通知类别，并检查锁屏上的可见性。即使底层连接是安全的，打印机或文件名称也可能暴露私人活动。

电池限制、后台限制和通知设置都可能影响送达。请将它们与打印机连接问题分开诊断。

永久性和临时性令牌错误不同

在出现永久性平台错误（例如令牌无效或已过期）后，服务可以注销设备的注册。服务商的临时故障则应重试，而不应丢弃所有已注册设备。

用户通常通过打开更新后的应用并让它重新注册来解决令牌轮换问题，而不是分享令牌。

通知无法保证的事

通知不能证明打印是安全的，不能替代现场监督，也不能证明摄像头正在实时播放。过时或延迟的平台通知不应成为防范打印机危险状况的唯一保护。

如需持续查看，请参阅 Live Activities、Dynamic Island 和 CarPlay。

常见问题

API 会登录我的打印机吗？

在常规通知架构中不会。客户端使用其授权的打印机连接。

为什么推送已经到达，数据却仍然是旧的？

唤醒可能已经成功，但客户端仍无法访问打印机所在的网络。

为什么不活跃的会话会停止？

24 小时的不活跃期限可以防止被遗弃的监控无限期继续。

我应该把推送令牌发给支持人员吗？

不应该。请将设备令牌和活动令牌视为敏感的诊断数据。

官方资料: Apple — Handling notification responses from APNs · Firebase — FCM error codes