当前位置：首页 > news >正文

Protocol Launcher 系列：MultiTimer 多计时器的协议支持

news 2026/7/16 17:16:44

在介绍了 miCal 的协作后，今天，我们将介绍如何通过Protocol Launcher与MultiTimer联动，让多计时器管理变得更加高效。

作为效率达人或时间管理者，你可能经常遇到这些场景：

在任务管理应用中点击按钮，直接在 MultiTimer 中启动专注计时。
在自动化工作流中集成计时器控制，实现任务开始自动计时。
通过快捷指令快速暂停或恢复正在进行的计时任务。

现在，通过Protocol Launcher，你可以以类型安全的方式轻松控制 MultiTimer 中的计时器。

MultiTimer 与深度链接

MultiTimer 是一款适用于 iPhone、iPad、Mac、Apple Watch 和 Apple Vision 的多功能计时器应用。它支持同时运行多个计时器，并提供面板（Board）功能来组织不同的计时场景。

MultiTimer 提供了强大的 URL Scheme 支持，允许从第三方应用直接触发启动、停止、暂停和恢复计时器等操作。

然而，手动拼接这些链接需要处理参数编码，且缺乏类型提示，容易出错。

核心能力：全功能计时器控制

Protocol Launcher 为 MultiTimer 专门提供了protocol-launcher/multi-timer模块，支持以下核心功能：

启动计时器：支持指定计时器名称和可选的面板。
停止计时器：结束正在运行的计时器。
暂停计时器：临时暂停计时器而不重置。
恢复计时器：继续之前暂停的计时器。

快速上手

首先，确保你的项目中已安装：

npminstallprotocol-launcher

在代码中你可以根据场景选择两种导入方式：

按需加载（通过子路径导入），支持 Tree Shaking，体积更小；
全量导入（从根包导入），写法更简单，但会引入所有已支持应用的逻辑。

// ✅ 推荐：按需加载 MultiTimer 模块import{startTimer,stopTimer,pauseTimer,resumeTimer}from'protocol-launcher/multi-timer'// 也可以从根包导入，但会包含所有应用模块// import { multiTimer } from 'protocol-launcher'

场景一：启动计时器 (`startTimer`)

这是最常用的功能。你可以启动一个新的计时器，并可选地指定它所属的面板：

import{startTimer}from'protocol-launcher/multi-timer'// 启动基础计时器consturl=startTimer({name:'Lunch',// 计时器名称})// 在指定面板上启动计时器consturl=startTimer({name:'Work Session',// 计时器名称board:'Work',// 可选：面板名称})

场景二：停止计时器 (`stopTimer`)

当你需要结束一个正在运行的计时器时：

import{stopTimer}from'protocol-launcher/multi-timer'consturl=stopTimer({name:'Lunch',// 计时器名称board:'Work',// 可选：面板名称})

场景三：暂停计时器 (`pauseTimer`)

当你需要临时暂停计时器而不重置它时：

import{pauseTimer}from'protocol-launcher/multi-timer'consturl=pauseTimer({name:'Lunch',// 计时器名称board:'Work',// 可选：面板名称})

场景四：恢复计时器 (`resumeTimer`)

当你需要继续之前暂停的计时器时：

import{resumeTimer}from'protocol-launcher/multi-timer'consturl=resumeTimer({name:'Lunch',// 计时器名称board:'Work',// 可选：面板名称})

为什么选择 Protocol Launcher？

自动参数编码：库内部会自动处理所有的 URL 参数转义逻辑，确保生成的 URL 在唤起应用时绝不乱码。
类型安全与参数提示：TypeScript 的智能补全会确保你提供了必要的name参数，并提醒你可选的board参数。
一致的用户体验：通过封装复杂的协议逻辑，你可以专注于业务功能的实现，而不用担心不同操作系统下协议触发的细微差异。
极致的按需加载 (Tree Shaking)：采用了模块化设计，支持按需加载以最小化包体积：
- 推荐方式：使用子路径导入（如import { startTimer } from 'protocol-launcher/multi-timer'），这样构建工具只会打包相关的代码。
- 全量方式：也可以从根包导入（如import { multiTimer } from 'protocol-launcher'），建议生产环境始终使用按需加载。