X-Callback-URL
X-Callback-URLとは？¶
Picsewはx-callback-urlプロトコルを実装しています。これは汎用的なURL Schemeプロトコルです。異なるアプリ間でのコミュニケーションを可能にします。Workflow、Launch Center Proなどのアプリがx-callback-urlをサポートしているため、Picsewもそれらとの連携をサポートしています。
PicsewのX-Callback-URLフォーマットは以下の通りです：
アクション¶
/scroll¶
指定された画像をスクロールショットステッチに使用します。
/vert¶
指定された画像を垂直ステッチに使用します。
/hori¶
指定された画像を水平ステッチに使用します。
アクションパラメータ¶
-
in （必須） 入力画像の取得方法を指定します。許可される値は
paste、latest、recentです。pasteの場合、クリップボードから画像を取得します。latestの場合、フォトアルバムから最新のN枚の画像を取得し、Nは別のパラメータcountによって決定されます。recentの場合、最新のスクリーンショットが自動的に検出されます。 -
count
in=latestの場合、これは必須パラメータで、取得する画像の枚数を指定します。 -
out （必須） ステッチ結果の出力方法を指定します。許可される値は
copy、save、save_copyです。copyの場合、結果をクリップボードにコピーします。saveの場合、結果をフォトアルバムに保存します。save_copyの場合、結果を保存してコピーします。 -
watermark （オプション） ウォーターマークを追加するかどうかを指定します。許可される値は
singleとrepeatです。デフォルトではウォーターマークは追加されません。ウォーターマークのテキストと位置は、アプリのデフォルトウォーターマーク設定を使用します。デフォルト設定が適切に構成されていない場合、最終結果にウォーターマークは表示されません。singleの場合、結果画像のデフォルト位置に単一のウォーターマークを追加します。repeatの場合、各画像のデフォルト位置にウォーターマークを追加します。 -
border （オプション） ボーダーを追加するかどうかを指定します。許可される値は
inside、outside、allです。デフォルトではボーダーは追加されません。insideの場合、結果画像の内側にボーダーを追加します。outsideの場合、結果画像の外側にボーダーを追加します。allの場合、結果画像の内側と外側にボーダーを追加します。幅を指定したい場合は、最後に_<0~100>を追加できます。例：inside_60。 -
mockup 利用不可、mockup2にアップグレードされました。
-
mockup2 （オプション） モックアップを追加するかどうかを指定します。許可される値については、「モックアップパラメータ」のドキュメントを参照してください。
-
clean_status （オプション） ステータスバーをクリアする必要があるかどうかを指定します。
yesの場合、ステータスバーが自動的にクリアされます。デフォルトではクリアされません。 -
remove_scrollbar （オプション） スクロールバーを削除する必要があるかどうかを指定します。
yesの場合、スクロールバーが自動的に削除されます。デフォルトでは削除されません。 -
delete_source （オプション） 元の画像を削除する必要があるかどうかを指定します。
yesの場合、元の画像が削除されます。デフォルトでは削除されません。
例¶
- 最新のスクリーンショットをスクロールショットステッチに使用し、自動的にステータスバーをクリアし、iPhone 14 Blueのモックアップを追加し、結果をフォトアルバムに保存してから、元の画像を削除します。
picsew://x-callback-url/scroll?in=recent&out=save&clean_status=yes&mockup2=iphone-14-blue&delete_source=yes
- フォトアルバムの最新3枚の画像を使用して垂直ステッチを行い、各画像にデフォルトウォーターマークを追加し、結果をクリップボードにコピーします。