跳转到内容

使用 计时器+ URL 方案

其他 App 可以通过 URL 方案启动 计时器+。这适用于能够打开 URL 并向 计时器+ 传递计时器详情的自动化类和启动器类 App。

使用此 URL 创建并启动快速计时器。快速计时器结束后会被移除。

timerplus://app/quick-timers/new?hours=[hours]&minutes=[minutes]&seconds=[seconds]&name=[name]

所有参数均为可选,除 name 外都接受整数:

  • hours
  • minutes
  • seconds
  • name

例如:

timerplus://app/quick-timers/new?hours=1&minutes=23&seconds=45

会启动一个 1 小时 23 分 45 秒的计时器。要启动一个名为 Laundry 的 50 分钟计时器:

timerplus://app/quick-timers/new?minutes=50&name=Laundry

如果省略时长,或提供的时长总计为 0,计时器+ 会改为启动快速秒表。

使用此 URL 启动快速秒表:

timerplus://app/quick-stopwatches/new?name=[name]

例如:

timerplus://app/quick-stopwatches/new?name=Plank

快速秒表使用完毕后会被移除。

计时器+ 支持 x-callback-url 规范中的 x-source 和 x-success 参数。要使用这些参数,请将 timerplus://app/ 替换为 timerplus://x-callback-url/。

例如:

timerplus://x-callback-url/quick-timers/new?minutes=50&name=Laundry&x-source=[source]&x-success=[success-url]

设置 x-success 后,计时器+ 会在完成所请求的操作后尝试打开该 URL。