x-callback-url
什麼是 X-Callback-URL？¶
Picsew 實現了 x-callback-url 協議，這是一種通用的 URL Scheme 協議。它能讓你在不同的 App 之間通信，捷徑、Launch Center Pro 等 App 都支援 x-callback-url，因此 Picsew 也支援與它們協作。
Picsew 的 x-callback-url 格式為：
不想閱讀冗長的參數說明？點一下下方按鈕，直接開始建立 x-callback-url。
動作¶
| 動作 | 用途 | 最低 Picsew 版本 |
|---|---|---|
scroll |
使用指定的圖片進行長截圖拼接 | 2.7.1 |
vert |
使用指定的圖片進行豎向拼接。 | 2.7.1 |
hori |
使用指定的圖片進行橫向拼接。 | 2.7.1 |
動作參數¶
in¶
2.7.1 必要
指定取得輸入圖片的方式。
| 值 | 行為 |
|---|---|
paste |
從剪貼簿取得圖片。 |
latest |
取得相簿中最後 N 張圖片；使用 count 指定 N。 |
recent |
自動偵測最近的截圖。 |
count¶
2.7.1 in=latest 時為必要
當 in=latest 時，這是必要參數，用於指定要獲取的圖片數量。
out¶
2.7.1 必要
指定輸出拼接結果的方式。
| 值 | 行為 |
|---|---|
copy |
將結果複製到剪貼簿。 |
save |
將結果儲存到相簿。 |
save_copy |
將結果儲存到相簿並複製到剪貼簿。 |
watermark¶
2.7.1 可選
指定是否加入浮水印。預設不加入浮水印。浮水印文字和位置沿用 App 中的預設浮水印設定；如果未正確設定，最終結果不會出現浮水印。
| 值 | 行為 |
|---|---|
single |
在結果的預設位置加入一個浮水印。 |
repeat |
在每張圖片的預設位置加入浮水印。 |
border¶
2.7.2 可選
指定是否以及在何處加入邊框。預設不加入邊框。如果要指定寬度，可在值後加入 _<0~100>，例如 inside_60。其中，outside 與自訂寬度後綴最低需要 Picsew 2.10。
| 值 | 行為 |
|---|---|
inside |
在結果內部加入邊框。 |
outside |
在結果外部加入邊框。 |
all |
在結果內部和外部加入邊框。 |
mockup-name¶
3.18.1 可選
指定套殼檔案名稱。可用的檔案名稱請在 Picsew App 內參閱「套殼參數」說明頁面。
mockup-name=iphone-air-sky-blue
mockup-background-width¶
3.18.1 可選
需要 Picsew 3.18.1 或以上版本。選填，填寫套殼檔案名稱後輸入 0～100 的整數。調整裝置外框之外的背景寬度，不是裝置外框本身，也不是拼接邊框。
這是獨立的 query 參數，與 mockup-name 或相容舊名稱 mockup2 搭配使用，不嵌套在它們的值中。
picsew://x-callback-url/scroll?in=paste&out=save&mockup-name=iphone-air-sky-blue&mockup-background-width=50
mockup2¶
3.9.2 可選
mockup-name 的相容舊名稱。新 URL 請使用 mockup-name（需要 Picsew 3.18.1 或以上版本）。
mockup¶
2.7.1 可選
更早的參數，例如 mockup=black_iphone63。裝置型號後綴自 Picsew 2.8 起支援。Picsew 仍會辨識它，但會繼續提示升級套殼。請勿在新的 URL 中使用。
clean_status¶
2.7.1 可選
指定是否需要清理狀態欄，當為 yes 時，自動清理狀態欄。默認不清理。
remove_scrollbar¶
3.9.4 可選
指定是否需要移除滾動條，當為 yes 時，自動移除滾動條。默認不移除。
delete_source¶
2.7.1 可選
指定是否需要刪除原始圖片，當為 yes 時，刪除原始圖片。默認不刪除。