NFC 3D 钥匙扣
这个周边由两部分组成：
- 可自行打印的 3D 钥匙扣外壳；
- 放入外壳内的 NFC 标签或芯片。
在 iPhone 上配置个人自动化后，触碰钥匙扣可以打开 Leelaa Reader，并继续最近播放或定位指定内容。
NFC 3D 钥匙扣
拖动旋转，滚轮或双指缩放。预览模型来自页面提供的 3MF 打印文件。
正在加载模型…
打印与组装
- 点击上方“下载 3MF”保存打印文件；
- 使用 Bambu Studio 或其他兼容 3MF 的切片软件打开；
- 根据打印机和耗材调整层高、支撑与填充；
- 打印前确认 NFC 标签的直径和厚度；
- 将 NFC 标签固定在预留位置，避免挤压、折弯或接触金属钥匙环。
NFC 芯片位置
金属会影响 NFC 感应。芯片不要紧贴大面积金属，并在封装前先用手机测试触碰距离。
Apple 快捷指令支持的动作
iOS 客户端当前支持以下 URL：
| 操作 | URL | 说明 |
|---|---|---|
| 继续最近播放 | leelaareader://continue | 优先从服务端最近阅读记录恢复，失败时尝试本地稳定进度 |
| 打开指定书籍 | leelaareader://play?bookId=123 | 将 123 替换为真实书籍 ID |
| 打开指定章节 | leelaareader://play?bookId=123&chapterId=456 | 章节定位必须使用真实 chapterId |
| 打开搜索 | leelaareader://search | 打开客户端搜索页 |
最推荐 NFC 使用：
text
leelaareader://continue它不需要把某本书或章节永久写进 NFC 标签，更适合日常“碰一下继续听”。
在 iPhone 上配置 NFC 自动化
不同 iOS 版本的按钮名称可能略有差异，基本流程如下：
- 打开系统「快捷指令」App；
- 进入「自动化」，新建个人自动化；
- 选择 NFC 作为触发条件；
- 扫描钥匙扣中的 NFC 标签，并给标签命名；
- 添加“打开 URL”或等效动作；
- 输入：
text
leelaareader://continue- 根据系统提供的选项，关闭不必要的运行前询问；
- 保存自动化，然后锁屏或切换到其他 App 进行触碰测试。
指定书籍或章节
如果钥匙扣专门对应某一本书，可以使用：
text
leelaareader://play?bookId=书籍ID需要指定章节时使用：
text
leelaareader://play?bookId=书籍ID&chapterId=章节ID不要使用章节在页面中的列表下标。章节顺序可能变化，持久定位必须使用服务端返回的 chapterId。
NFC 标签应该写什么
推荐让 NFC 只作为自动化触发器，URL 保存在 iPhone 的快捷指令自动化中。这样以后修改动作时不需要重新写入 NFC 芯片。
如果使用第三方 NFC 工具直接写入 URL，也应优先写入：
text
leelaareader://continue但直接写入 URL 的系统行为会因设备、系统版本和 NFC 工具而不同，不作为当前推荐验收路径。
使用限制
- 当前 URL Scheme 只在 iOS 客户端中有已确认实现；
- 首次触发前需要安装并登录 Leelaa Reader；
- 服务地址不可用、登录失效或书籍被删除时，无法恢复播放；
- iOS 可能根据锁屏、权限、自动化设置或系统音频状态要求额外确认；
- “打开到播放器”和“任何状态下立即发声”不是同一个保证；
- NFC 周边不会绕过服务端授权、账号权限或播放队列规则。
排障
触碰后没有反应
- 确认手机支持 NFC 自动化；
- 移除较厚或带金属的手机壳后重试；
- 在快捷指令中重新扫描标签；
- 确认自动化没有被停用。
打开了 App，但没有进入播放器
- 确认 URL 完整且使用
leelaareader://； - 先手动打开 App 并完成登录；
- 使用
leelaareader://continue排除书籍 ID 或章节 ID 错误； - 确认当前账号仍能访问最近播放的书籍。
指定章节定位错误
- 检查使用的是
chapterId，不是列表序号； - 从服务端接口或页面实际数据重新确认书籍 ID 与章节 ID；
- 队列顺序以后端返回为准，不要在快捷指令中保存自定义章节下标。