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 时，删除原始图片。默认不删除。