iPhoneまたはiPadの「ショートカット」でx-callback-urlを使用する
「ショートカット」では、特定の操作が終了しときに呼び出し元アプリで応答(コールバック)を受け取るためのx-callback-urlがサポートされます。「iPhoneまたはiPadでURLスキームを使用してショートカットを実行する」で説明したものと同じパラメータを使用して、x-callback-urlからショートカットを実行できます。例を示します:
shortcuts://x-callback-url/run-shortcut?name=Calculate%20Tip&input=text&text=24.99&x-success=...&x-cancel=...
x-callback-url標準によると、次の追加パラメータを指定できます:
x-success(任意): 操作が成功したとき(たとえば、ショートカットが読み込まれた後や実行が完了した後)に開くURL。ショートカットが実行されると、URLに
result
という名前のパラメータが付加されます。このパラメータには、ショートカットのテキスト出力が含まれます。x-cancel(任意): 操作がユーザによってキャンセルされたときに開くURL。
x-error(任意): エラーが発生して操作が失敗したときに開くURL。URLに
errorMessage
という名前のパラメータが付加されます。このパラメータには、エラーの説明が含まれます。
x-success
を使用すると、ショートカットの実行が正常に完了した後に開くURLを指定できます。これは複数の手順からなる作業チェックリストと組み合わせて使用できます。x-callback-urlを開いてショートカットを実行し、リストに戻り、次のタスクに移動する、という流れをURLを使って実行できます。
x-cancel
を使用すると、ショートカットが実行を完了する前に停止した場合に開く不測事態用のURLを用意できます。ショートカットは完了しなかったため、ショートカットからの出力はありません。
x-error
を使用すると、ショートカットの実行中にエラーが発生して完了できなかった場合に開く不測事態用のURLを用意できます。この場合は、別のURLを起動して問題に対処できます。