在 iPhone 或 iPad 上配合“快捷指令”使用 X-Callback-URL
“快捷指令”支持 x-callback-url,允许调用 App 在特定交互完成后接收回复(即 Callback)。你可以用与在 iPhone 或 iPad 上使用 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。此参数可用于连接多步的任务核对清单,在其中打开 x-callback-url 以运行快捷指令,然后通过 URL 返回清单并移到下一个任务。
通过 x-cancel
,你可以提供应变 URL,如果快捷指令在运行完成前停止,它就会启动。由于快捷指令未运行完成,它不会提供输出。
通过 x-error
,你可以提供应变 URL,如果快捷指令在运行时遇到错误而无法完成,它就会启动。在此情况下,你可以启动另一个 URL 来处理这个问题。