配合“捷径”使用 X-Callback-URL
“捷径”支持 X-Callback-URL,允许调用应用在特定交互完成后接收回复(即 Callback)。您可以用使用 URL 方案运行捷径和使用 URL 方案导入捷径中讨论的相同参数从 X-Callback-URL 导入和运行捷径。示例如下:
shortcuts://x-callback-url/run-shortcut?name=%E8%AE%A1%E7%AE%97%E5%B0%8F%E8%B4%B9&input=text&text=24.99&x-success=...&x-cancel=...
根据 X-Callback-URL 标准,可以提供以下附加参数:
x-success(可选):交互成功时打开的 URL。例如,当捷径导入或运行完成时。如果捷径已运行,会将一个叫做
result
的参数追加到 URL 中,其中包含捷径的文本输出。x-cancel(可选):用户取消交互时打开的 URL。
x-error(可选):交互由于发生错误而失败时打开的 URL。一个叫做
errorMessage
的参数会追加到 URL 中,其中包含对错误的描述。
通过 x-success
,您可以提供一个可在捷径成功完成运行后打开的 URL。此参数可用于在 OmniFocus 中连接多步的任务核对清单,在 OmniFocus 中打开 X-Callback-URL 以运行捷径,然后通过 URL 返回清单并移到下一个任务。
通过 x-cancel
,您可以提供应变 URL,如果捷径在运行完成前停止,它就会启动。由于捷径未运行完成,它不会提供输出。
通过 x-error
,您可以提供应变 URL,如果捷径在运行时遇到错误而无法完成,它就会启动。在此情况下,您可以启动另一个 URL 来处理这个问题。