自动化
aTimeLogger Pro 是 Tasker 的插件，Tasker 是一款手机自动化应用。Tasker 可以开始、停止和暂停你的活动，读取哪些活动正在运行，还能在活动开始、停止、暂停或恢复时运行任务。
把两个应用装在同一部手机上即可。aTimeLogger Pro 中无需开启任何设置，插件也不需要 Pro 账户。
MacroDroid 也能运行 Tasker 插件。本页的步骤以 Tasker 为例。
插件为 Tasker 添加的内容
| Tasker 中的名称 | 位置 | 作用 |
|---|---|---|
| aTimeLogger Pro | 任务动作，插件（Plugin）类别 | 开始、停止或暂停活动 |
| Get Activities | 任务动作，插件类别 | 返回正在运行的活动 |
| Start/Stop/Pause/Resume | 配置文件（Profile）事件，插件类别 | 在活动开始、停止、暂停或恢复时运行任务 |
| TimeTrack Old | 任务动作，插件类别 | aTimeLogger Pro 动作的旧版本 |
TimeTrack Old 的界面相同，只是没有 Stop all running 和 Type ID variable (optional)。新建任务请使用 aTimeLogger Pro。
开始、停止或暂停活动
- 在 Tasker 中为任务添加一个动作：插件 → aTimeLogger → aTimeLogger Pro，然后打开它的配置。
- 点按活动类别，选择一个活动类别。
- 点按 Action，选择要执行的操作，见下表。
- 如有需要，填写备注。
- 点按保存。
必须选择活动类别才能保存，除非操作是 Stop all running，或者填写了 Type ID variable (optional)。否则应用会提示 Type or type ID variable is required。
操作
| 操作 | 作用 |
|---|---|
| Stop running and start | 停止所有正在运行和已暂停的活动，然后开始该类别的活动。这是默认操作 |
| Pause running and start | 暂停所有正在运行的活动，然后开始该类别的活动 |
| Start | 开始该类别的活动。其他正在运行的活动按设置中的开始新活动时处理 |
| Start or resume | 该类别的活动已暂停则恢复，否则开始。其他正在运行的活动按开始新活动时处理 |
| Stop if running | 停止该类别的活动，无论它正在运行还是已暂停 |
| Pause if running | 如果该类别的活动正在运行，则暂停它 |
| Stop all running | 停止所有正在运行和已暂停的活动。无需选择类别 |
如果该类别已在运行，前四个操作不会有任何效果。
如果在番茄钟设置中勾选了番茄钟，列表里会多出一个操作：类别属于设置需要进行番茄的活动时是 Start pomodoro，属于设置休息类型时是 Start break。它们分别把该类别作为一个番茄钟或一次短休息开始。
备注
备注是可选的，可以包含 Tasker 变量：动作运行时，Tasker 会填入变量的值。
该动作会把备注保存到它开始、恢复、停止或暂停的每个活动上，并替换这些活动原有的备注。备注留空时，已有的备注保持不变。
用变量选择类别
Type ID variable (optional) 让 Tasker 变量在任务运行时决定使用哪个类别，例如 Get Activities 返回的 Type ID。
- 变量的值是数字时，动作使用该 ID 对应的类别，而不是活动类别中选择的类别。
- 变量为空或是其他内容时，动作使用活动类别中选择的类别。
结果
该动作返回 Start in UTC：它所开始的活动的开始时间，以自 1970 年 1 月 1 日起的秒数表示。对于事件类型，是记录这次事件的时间。如果动作没有开始任何活动，该值为空。
查看正在运行的活动
添加动作 插件 → aTimeLogger → Get Activities。它没有任何设置。
它为每个正在运行的活动返回以下值。已暂停的活动不包括在内。
| 值 | 内容 |
|---|---|
| Type | 类别名称 |
| Path | 类别及其所在群组：群组/类别 |
| Type ID | 类别的 ID。可以传给 aTimeLogger Pro 动作的 Type ID variable (optional) |
| Start in UTC | 活动最近一次开始或恢复的时间，以自 1970 年 1 月 1 日起的秒数表示 |
活动变化时运行任务
- 在 Tasker 中添加一个配置文件，事件选择 插件 → aTimeLogger → Start/Stop/Pause/Resume，然后打开它的配置。
- 点按 Event，选择 Any event、开始、停止、暂停或恢复。
- 点按 Type，选择一个类别。如果不选，该配置文件会对所有类别做出响应。
- 点按 Save。
| 事件 | 触发时机 |
|---|---|
| 开始 | 活动开始。记录一次事件也算 |
| 停止 | 正在运行的活动被停止 |
| 暂停 | 正在运行的活动被暂停 |
| 恢复 | 已暂停的活动被恢复 |
| Any event | 以上任意一种 |
无论是在应用中、在通知中还是通过 Tasker 动作进行的操作，都会触发。
不发送事件的情况
- 开始另一个活动时，应用替你停止或暂停的活动：无论是因为开始新活动时设置，还是因为 Stop running and start 和 Pause running and start 操作。
- 停止一个已暂停的活动时。
- 活动运行时间短于最小活动持续时间时（见设置）。这段时间不会被保存。
任务可用的值
| 值 | 内容 |
|---|---|
| Name of operation | START、STOP、PAUSE 或 RESUME |
| Name of activity type | 类别名称 |
| Full path of activity type | 类别在群组中时，为“群组/类别” |
| Start | 活动开始的时间。停止和暂停事件：最近一次开始或恢复的时间。恢复事件：恢复的时间 |
| Finish | 停止或暂停的时间。开始和恢复事件时为空 |
| Start in UTC | UTC 时间的 Start，格式如 2026-10-27T09:15:00+0000 |
| Finish in UTC | UTC 时间的 Finish，格式相同 |
| Comment | 活动的备注 |
Start 和 Finish 使用本地时间：先是 yyyy-MM-dd 格式的日期，然后是按手机的 12 或 24 小时制显示的时间。如果任务需要比较或保存时间，请使用 Start in UTC 和 Finish in UTC。
主屏幕快捷方式
不用 Tasker，也可以把一个操作以图标的形式放到主屏幕上。
- 在启动器中打开小组件和快捷方式列表，添加 aTimeLogger Shortcut。
- 点按活动类别，选择一个类别。
- 点按 Action，选择 Stop running and start、Pause running and start、Start、Start or resume、Stop if running 或 Pause if running。
- 点按保存。如果没有选择类别，点按保存不会有任何反应。
图标显示该类别的图片，名称由操作和类别名组成，例如 Start or resume 工作。点按它的效果与同名的 Tasker 操作相同。
疑难解答
动作没有任何效果
- 该类别已在运行。此时 Stop running and start、Pause running and start、Start 和 Start or resume 会保持一切不变。
- 该类别已被删除，或者类别 ID 属于一个群组。该动作只适用于类别。
- Stop if running 和 Pause if running 只作用于所选类别的活动。
配置文件没有触发
- 请查看不发送事件的情况。
仍然无法解决？联系客服：更多 → 关于 → 联系我们。