转自IT之家、从入门到精通：四个实例参透苹果 iOS “快捷指令”

天涯过客

楼主 天涯过客说：
《三分钟，带你入门 iOS 捷径》【链接】
启发，旨在用简明的语言，系统性讲解 iOS "快捷指令"的使用方法；
? 我会用四个例子介绍"快捷指令"中的基本概念，如"内容流""操作控制"等；考虑到单个帖子的篇幅，我把内容分成了"上、中、下"三个部分，每个部分只要 5 分钟的阅读时间；
? 阅读本系列后，您会掌握：
1. 上：看懂复杂的指令是如何运行的（本帖）
2. 中：尝试构建符合自己需求的指令（
点此跳转【链接】
）
3. 下：理解简易的编程概念，如 JavaScript，API，JSON 等（
点此跳转【链接】
）
废话不多说，进入正文。
— 启动"快捷指令"的方法 —
不会运行快捷指令，一切都白搭。目前有四种开启指令的方法。
1.通过"快捷指令" APP：
▼ 打开"快捷指令" APP，在"我的快捷指令"中轻点一个指令。
▼ 如果你在负一屏里添加了"快捷指令"的小组件，你可以轻点按钮来启动对应的指令；
▼ 当然，你还能将捷径添加到主屏幕
2.通过 Siri：
▼ 在 iOS 设备上唤出 Siri，说出某个指令的名称，该指令就会被运行；
3.通过"建议与搜索"：
▼ 从主屏幕下拉，唤出"搜索"界面，iOS 会根据用户日常操作推荐一些指令。你也可以在搜索框里直接输入某个指令。
4.通过其他 App 中的"分享"按钮
▼ 你可以在"快捷指令"中设置，是否在"分享列表"中显示某个指令。分享的内容会作为该指令的输入（详见后文）；
— 实例一：新手难度 —
我们先来看看最简单的快捷指令
? "IT 之家签到"【
下载链接【链接】
】
这类指令是 App 自带的，相当于把 IT 之家的"签到"按钮放到 App 外面。我们用户没有 DIY 的余地，"点击 — 运行"即可。
这个实例展示了"快捷指令"的本质：自动化。"打开之家、打开我的主页、点击签到"这三步，在轻点指令后会自动运行。这也许节省不了多少时间，但如果设定为"在每天早上运行该指令"，成为 50 级大佬不是梦????
— 实例二：入门难度 —
我们再看一个有点复杂的快捷指令
? "洗衣计时器"【
下载链接【链接】
】
1.用户手动输入洗涤时间；
2.当前时刻 + 洗涤时间 = 结束时刻
3.新建一个"提醒事项"，内容为"衣服已洗好！"，提醒时间为"结束时刻"
5.在"结束时刻"，用户会收到提醒
这个实例与"之家签到"的最大区别，在于操作的数量。乍看之下，我输入一个数字，得到一个提醒事项，好像很神奇的样子，实则不然。这个实例之所以能成立，说到底是"提醒事项"这个 App 适配了"快捷指令"，你因此能用"快捷指令"联动"提醒事项"来"创建新提醒"。
▼ "提醒事项"中的"新建"界面
▼ "快捷指令"中的"新建"界面
从上面的对比可以看出，"快捷指令"无非就是简化版的"提醒事项"，虽然一些选项，如"优先级""标签"，被无情阉割，但所有参数都被整合在"一句话"里。通过修改"这句话"中的元素，如"具体内容""特定时间"，我们其实就是在调整"提醒事项"中的具体参数。
我们把"这句话"称为一个"操作"。所有"操作"都是开发者适配后的产物，如果"操作"不存在，那相关功能也不可能实现。
"快捷指令"的"操作"可以分为四类：
1.可以输入，并产生结果的
▼ 如"添加新提醒事项"，你可以输入各种参数，运行指令后创建一个新提醒作为结果；
2.只接受输入，没有结果的
▼ 如"删除照片"，你告诉 iPhone "要删除哪张照片"，然后 iPhone 就帮你删了。没有产出任何新的东西；
3.只产生结果，没有输入的
▼ 如"获取当前天气"，iPhone 会自动查询当地的天气，然后以文本的形式返回结果。你无法输入任何参数；
（PS：大部分冠以"获取"的操作都属于"只出不进"）
4.既没有输入也没有结果的
▼ 如"使设备振动"，字面意思，执行这个操作时，设备会震一下；
我猜有的读者可能会杠："删除照片"怎么就没结果了，"删除"这事本身不算结果吗？"设备振动"怎么不需要输入，用户的"点击"难道不算输入？这里要强调下：
? 所谓"输入"，是指能在"操作"中修改的参数；
? 所谓"结果"，是指能在其他"操作"中充当"输入"的内容；
▼ "设备振动"既没有可编辑的参数，也无法与别的操作产生联系，所以它属于…
▼ "获取当前位置"可以为后续操作提供输入，但它本身没有可编辑的参数，所以它属于…
了解完"操作" "输入" "结果"这三个最基本的概念后，我们回到"洗衣计时器"。敏锐的读者可能会意识到：这条指令不就是在特定时间点创建了一条新提醒吗？我用"提醒事项" App 手动创建不也一样。恭喜！??能看透这点，你已经可驾驭90%的"快捷指令"了。
▼ "洗衣计时器"总共 4 步，前 3 步都是在告诉 iPhone如何计算衣服洗完的时刻
▼ 前面的步骤都是为了向第 4 步提供一个正确的输入（提醒时间），而"提醒内容"则是我输入的固定文本。
不知各位有没有注意到一个细节：
? 第 3 步向第 4 步传递了"结束时刻"，因此这两步间有一个连接符
这个标示代表"上一操作的结果会用做下一操作的输入"，且指令的运行顺序是从上至下；但是：
? 第 1 步中输入的"洗涤时间"在第 3 步的计算中也有用到，但它们并不相邻，我如何让"Step 1 的结果变成 Step 3 的输入"？
▼ 点击想要编辑的参数，底部会跳出一个菜单，名叫"变量"
此处，你可以指定该参数来自何处。有四个默认提供的选项：
? 剪贴板：把你拷贝的内容作为输入；
? 捷径指令输入：把"共享"的内容作为输入；
? 每次均询问：运行时手动输入内容；
? 当前日期：字面意思。
根据指令中已有的操作，"变量"菜单里还会出现各种可被选择的项目。如果你觉得文字描述太抽象，不妨点击下第一个按钮，"魔棒"：
▼此视图称为"魔法变量"，所有可供选择的"结果"都会高亮显示，你只需点击想要使用的"结果"即可。
此处，我点击第一个结果，即"提供的输入"，这就相当于在"加上  ？分钟"中填充我输入的"洗涤时间"。当前时刻 + 洗涤时间，我就得到了"结束时刻"。注意！请务必掌握"魔法变量"的用法，这是"快捷指令"最核心的功能之一！
— 上篇总结 —
本帖中，我使用了两个实例，介绍了 iOS "快捷指令"的基础功能。总结下就是：
? 巧妇难为无米之炊，那些看起来高端大气上档次的指令，其实都借助了手机 App 中已有的功能；高级一点的指令会调用网络中的 API，实现本地 App 所没有的功能，这在下篇会具体介绍；
? 任何指令都离不开三要素：操作、输入、结果。遇到复杂的指令，或是自己想创建一个指令，只要不断回答三个问题就行：
1.这一步在干什么？
2.这一步是否需要输入？输入来自何处？
3.这一步是否产生结果？结果是什么？
上篇的内容到此结束，希望各位有一个良好的阅读体验。中篇中，我会带领大家对"洗衣计时器"进行一些改良，以让各位拥有 DIY "快捷指令" 的能力（
）。如果文中出现错误，还请大佬们批评指正，在此谢过了～??
本帖来自爱盲客户端

天涯过客

沙发 天涯过客说：
在上一篇帖子中，我介绍了"快捷指令"的工作原理：把一系列操作编织在一起，以达到自动执行多个操作的目的；
? 每一步操作都有三要素：输入，具体过程，结果。紧扣这三要素，才不会让自己陷入混乱；
? 本帖将继续使用"实例二：洗衣计时器"【
废话不多说，正文开始
- 改良一：老化的洗衣机 -
假设我家的洗衣机因为老化的关系，"实际运行时间"会比设定的"洗涤时间"多 10 分钟，我该如何调整该指令呢？
▼ 大家应该都想得到：我只要给"洗涤时间"加上 10 分钟，再把新的数字作为"实际时间"与"当前时刻"相加，就能得到"实际结束时刻"了；
▼ 我们在"快捷指令"的底部搜索框中输入"计算"，发现 iPhone 支持加减乘除的操作；
▼ 轻点插入"计算"，并将该操作拖动到"洗涤时间"下方，此时被加数会自动变成上一个操作的结果（即"洗涤时间"）；把加数改成 10；
▼ 别忘了把第 3 步中的参数改成"计算结果"，试试"魔法变量"！
至此，我们就获得一个老化洗衣机的计时器了。若想验证下你的指令是否可用，请点击底栏的"运行"按钮；
此时指令会试运行，正在进行的步骤会变成绿色并转圈圈。如果指令遇到问题，你可以轻松发现出错的地方。
如果想要一步一步的 Debug，可以搜索并插入"退出快捷指令"这一操作。你可以把这个操作当成休止符，指令会在遇到它时停止运行。把它放在不同位置，你就能一步步检验流程中的问题了。
- 改良二：社畜的洗衣机 -
大家是不是觉得"加 10 分钟"实在是太简单了？请思考一个更复杂的例子：我是一只加班狗??，每天都有开不完的会，衣服只能在会议的间隙中洗。因此，我想制作一款指令，满足两个需求：
1.在可以洗衣时给我一个提醒；
2.在衣服洗好时给我一个提醒；
这该怎么办？其实思路很简单：
? 找到时间最长的会议间隙；
?（假设在会议结束后立刻去洗衣服，）可以洗衣的时刻 = 会议结束的时刻；
? 衣服洗好的时刻 =会议结束的时刻 + 洗涤时间；
? 分别在"可以洗衣的时刻"与"衣服洗好的时刻"创建一个提醒就行了；
▼ 首先，我肯定要让 iPhone 知道我的日程安排。在底部搜索栏输入"日历"，发现一个名为"获取临近日程"的操作；
▼ 遇到陌生的"操作"不要害怕，微笑着面对它，尝试编辑各个参数，你就能理解其中的含义；
?"所有日历"：从哪一个日历查询日程信息，你可以把节假日、节气这种去掉；
? "3 个日程"：获取多少个日程，太多没必要；
? "任一天"：查询今天、明天或任一天的日程；
▼ 获取日程信息后，我得在三个日程中挑一个，以便在这个日程结束后洗衣服。怎么办？搜索"选取"即可；
▼ 指令运行时，该操作会把输入的内容以列表的形式呈现，并让用户选择一个，如下图所示。记住！遇到不熟悉的操作，动手试一试是最好的办法！
▼ 显然，"周四例行会议"与"临时会议"的间隔时间最长，是洗衣服的好时机。在指令执行时，我会选择"周四例行会议"作为这一步操作的"结果"；在编辑指令时，使用"魔法变量"，将"选取"这一操作的结果作为下一个操作的输入；
▼ 此时会跳出一个菜单，让你选择日程中的具体信息。显然，我是要在会议结束后再去洗衣服，所以选择"结束日期"；
▼ 至此，我们已经满足了第一个需求，（假设我在会议结束时立刻去洗衣服，）iPhone 会在洗衣结束时通知我们；
▼ 如法炮制一个新的"添加新提醒事项"的操作，并将"提醒时间"设为日程的"结束日期"，将"具体内容"设为"赶快洗衣服！" iPhone 就会在可以洗衣时通知我们了；
- "内容图"引擎 -
我猜看到这里的读者，可能已经感到枯燥了。这实属正常，因为指令中的流程一多，操作间传递的变量就变得抽象了起来：一会儿是日程，一会儿是时刻，一会儿是纯数字，有点混乱。
其实，苹果为了防止用户因为一堆变量而放弃使用"快捷指令"，推出了一款名为"内容图"的引擎，内置在"快捷指令"中。这个引擎有什么用？请看下图：
乍看之下，这个指令难以理解：当前播放的歌曲是"音频"，而相册里储存的是"图片"，歌曲怎么可能保存到相册里？
运行该指令后，我们发现，保存下来的并不是"音频"，而是"歌曲的封面"！
▼ 正在播放的歌曲
▼ 在相册中保存的封面
这就是"内容图"引擎的强大之处：当输入的内容与要求的类型不符时，"内容图"会自动将该内容转化为合适的类型。下面是"内容图"可视化后的亚子（是动图，需要加载时间??）：
可以看到，以" iTunes 媒体"为核心发散出了一系列节点，每个节点中都存储了一些信息。这很好理解，一首歌不仅有音频信息，还有歌词、歌名、歌手、专辑等一系列附加信息。点击某个节点，我们就能看到这个节点具体包含了哪些信息（是动图，需要加载时间??）
一般来说，机器是无法理解"媒体"这种复杂变量的。如果用户不告诉机器"我具体需要什么"，机器就会卡死。"内容图"引擎通过自动提取所需信息的方式，维持了"快捷指令"的正常运作。
以刚刚的会议日程为例，虽然我们指定了"结束时间"，但结束时间究竟是如何表示的？2020年5月28日？28 / 5 / 2020？精确到小时、分钟还是秒？在 iOS 中，这些都不需要用户来思考，"内容图"引擎会把一切调整到可以运行的状态。
- 中篇总结 -
本帖中，我使用了两个对"洗衣计时器"的改良，介绍了按照自己意愿修改现有指令的方法。总结下就是：
?明确自己的需求。首先抛开"快捷指令"思考，正常情况下我是如何满足自己需求的，然后把这个过程分割为一个个步骤，看看"快捷指令"中有没有对应的"操作"；
? 多多翻阅"操作"库。想要制作一个实用的捷径，没有任何速成的方法，必须花时间去了解"快捷指令" App 中到底提供了哪些操作；
? 不要把事情想复杂。在"内容图"引擎的帮助下，用户不需要像编程一样，先定义某个变量，再调用这个变量；相反，你只要按照直觉把相关的操作放在一起就行了；
?人工判断与机器相结合。在"社畜的洗衣机"中，判断"时间最长的间隙"自然是可以用"快捷指令"实现的，但把判断过程交给用户也未尝不可，这让指令简洁了不少；
中篇的内容到此结束，希望各位有一个良好的阅读体验。下篇中，我会带领大家制作实用工具：纯本地的"图片九宫格分割"，以及利用百度 API 的 "OCR 文字识别"
本帖来自爱盲客户端

天涯过客

板凳 天涯过客说：
在中篇里，我介绍了向指令中添加新操作的方法，以及调整输入、使用结果的技巧；
? 自行设计实用指令的关键是：明确需求，找出步骤，搜索对应操作；
? 本帖将使用两个新的实例，"图片九宫格切割器"以及" OCR 文字识别"，为大家展现"快捷指令"的真正实力。可能会涉及到的概念：
1. JavaScript，一种构建网页的编程语言；
2. API，又叫"应用程序接口"，是软件 App 间传递数据的通道；
3. JSON，软件 App 通过 API 传递数据时，数据使用的格式；
废话不多说，开始正文。
- "实例三：图片九宫格分割器" -
这个工具在主流社交平台很有用， IT 圈也好，微信的朋友圈也好，图片预览的数量都是 9 张，且排列成九宫格。我们只要把一张图片分为九等份，它们就能在九宫格视图里重新组成完整的图片。
首先思考??正常情况下，我们是如何利用 iPhone 将图片九等分的？
1."九等分"的本质是"裁剪"，而 iOS 原生相册就支持"裁剪"功能；
2.考虑到"九宫格"整体是一个"正方形"，我们得先把矩形的图片裁剪为正方形，才能进一步对其"九等分"；
3.如果是手工裁剪的话：
▼ 首先利用网格线看准左上、右上、左下、右下等几个"九等分"的位置；
▼ 然后将裁剪框拖到相应位置，并将裁切操作重复 9 次，我们就能得到"九等分"的图片了；
显然，手工"九等分"完全靠感觉，无法做到绝对准确，有强迫症的用户不喜欢；但以上步骤说明了一件事：iPhone 原生功能是可以实现"九等分"的，如此一来，"快捷指令"中有相应"操作"的可能性就很高。
▼ 不出所料，在"快捷指令"中搜索"裁剪"，果然有此功能
▼ 遇到不熟悉的"操作"，还是那句话，添加进去试一试就懂了
? 输入：照片；
? 位置：裁剪框放置的位置；
? 宽度：裁剪框的水平边的长度；
? 高度：裁剪框的垂直边的长度；
至此，大家心里应该隐约知道，"九宫格分割器"是如何运作了吧？与"洗衣计时器"一样，前者是以"创建新提醒"为核心，通过计算"洗衣结束时刻"来实现定点通知；后者是以"图片裁剪"为核心，通过设定裁剪框的位置、大小，来实现精确的"九等分"。
不过，正如最开始的步骤所言，一张图片想要"九等分"，它自己就必须是"正方形"，所以我们得先添加一个"将原始图片裁剪为正方形"的步骤：
1. 裁剪框的位置：虽然照片的主体未必在正中，但一般来说，保留中央区域对照片观感不会产生太大影响，所以我们选择"中间"；
2. 正方形裁剪：小学几何知识，正方形是四边等长的矩形，只要保证"宽度"和"高度"一样即可；
3. 正方形的边长具体是多少：这个是问题的关键，为了最大限度地保留照片内容，我们肯定会让"正方形的边长"与"照片的短边长度"相同，即撑满画面，如下图所示
所以，为了实现"原图的正方形裁剪"，指令的逻辑是：
1.找到图片的短边；
2.把短边长度设为"正方形边长"；
3.居中裁剪；
▼ 获取边长的"操作"，怎么找到它不需要再重复了吧？搜索，搜索，搜索
▼ 将所选照片的"宽度" "高度"都获取一次
▼ 判定的逻辑，用大白话说就是，如果"宽度"小于"高度"，那"宽度"就是短边长，我们就把"宽度"作为"正方形边长"；否则的话，就把"高度"作为"正方形边长"。在"快捷指令"里搜索"如果"，发现 iPhone 支持这种逻辑；
▼ 遇到陌生的操作，不要害怕，插入看看你就瞬间明白了：只要把后续的指令拖动到"如果"或"否则"的下面，它们就会按照"如果…否则…"的逻辑运行了；
▼ 先按照大白话，把"如果"的条件输进去。记得使用"魔法变量"来选择参数！
▼ 目前指令中尚不存在名叫"正方形边长"的变量，为了让指令看起来清晰一点，我们搜索"变量"，找到一个"设定变量"的操作；
▼ 仍然是大白话，把"正方形边长"设为"宽度"
▼ 如法炮制，"否则"的部分大家应该知道怎么做了吧？
▼ 别忘了把"图片裁剪"中的"高度" "宽度"设为"正方形边长"！
▼ 我们运行下指令，看看效果如何：
虽然有种大功告成的感觉，但我们只进行了九宫格分割的第一步：将原图裁剪为正方形备用。不过随着你对"快捷指令"的不断熟悉，我们的步伐可以加快一些了。
接下来要将图片九等分。我们只需要将裁剪框设置成一个 1/9 的正方形，然后在九个方位依次裁剪，产生9 个"小正方形"，不就可以了？
所以实现"九宫格"裁剪的逻辑是：
1.确定"小正方形"的边长，并将它的边长作为裁剪框的边长；
2.分别将裁剪框定位在↖?↗?↙?↘?等 9 个位置，裁剪 9 次；
3.保存裁剪后的 9 张图片；
▼ 根据小学几何知识，"小正方形"边长= 1/3 的"正方形边长"
▼ 接着，我们要将"小正方形"准确地放到图片的 9 个方位上，以实现"九等分"的裁剪效果。还记得"图片裁剪"里的位置参数吗？这个参数是可以自定义的：
▼ 所以，问题的关键就变成，如何算出裁剪框的坐标位置？这里科普一个小常识：所谓"裁剪"的坐标，指的是裁剪框左上角的位置，如下图：
? X 坐标的值：相当于裁剪框与左边缘的距离；
? Y 坐标的值：相当于裁剪框与上边缘的距离；
这个功能好啊！在原生相册中，我们九等分图片全靠感觉；没想到在"快捷指令"中，"裁剪"这个功能相比相册居然得到了强化，以至于能准确设定裁剪的位置。
1. 左上角小正方形坐标：
? X = 0，Y = 0
? 因为它同时贴着左边缘和上边缘；
2. 右下角小正方形坐标：
? X = 2 × "小正方形边长"，Y = 2 × "小正方形边长"
? 因为它与左边缘和上边缘都隔了 2 个小正方形；
我把所有小正方形的坐标列成了一个表格，请看：
举例：如果我想裁剪右下角位置的小正方形（第九个），则需要在"裁剪图片"中设置：
敏锐的读者会发现，的确，我只要把"裁剪图像"这个操作重复 9 次，每次都输入相应的 X、Y 坐标，最后就能输出 9 张等分的图片，但我有这精力，还要什么"快捷指令"呢？直接手动裁剪不是更快吗？
说得好！所以我们搜索下，发现 iPhone 能代替你完成"重复"的步骤；
这个"操作"也属于一看就会的类型，放在"重复"和"结束重复"之间的操作，会被重复 ？次；
但是，我们并不是把完全相同的任务重复 9 次；每次重复，小正方形的坐标都需要修改，这该怎么办？显然，iPhone 没那么蠢，当然可以在每次重复中使用不同的参数。
iPhone 会给每次"重复"进行编号，比如第一次重复记为 1，第二次重复记为 2，这个编号被称为"重复索引"，我更喜欢称为"第 X 次重复"。
拥有编号，事情就简单了。我们只需要一个列表，这个列表的每一行代表了一次重复。比如第 2 行，这一行会指导iPhone 在第 2 次重复时应该怎么做。见下图：
但是但是，"快捷指令"不是只能像做填空题一样，修改特定的参数吗？列表该怎么办？其实，你只要搜索一个叫做"词典"的"操作"，问题就解决了；
（注意！"词典"是个很关键的概念，它是"快捷指令"使用网络 API 实现高阶功能的基础）
虽然名字叫"词典"，但它本质上就是个表格，如下图（值的类型要选择"词典"）：
一行就代表一次"重复"。然后，我们需要在每一行中填充"做什么"。以右下角的小正方形，即第 9 个小正方形为例，它会在第 9 次重复时被裁剪出来，因此我在第 9 行中输入对应的参数（值的类型要选择"数字"）
? X = 2，代表 2 倍的小正方形边长；
? Y = 2，代表 2 倍的小正方形边长；
以此类推，我们把整张表格填完，并把这张指导"iPhone 应该如何重复"的表格放进"重复"的"操作"里。接下来的逻辑就很简单了：
1.假设现在是第 3 次重复，那"重复索引"的值就是 3；
2.我首先让 iPhone 去表格中找到第 3 行（学到这里，大家应该能够自己找到这个"操作"吧？"获取词典值"）
3. iPhone 成功找到了第 3 行，里面记录了 X、Y 坐标关于"小正方形边长"的倍数信息。我只要让"倍数"与"边长"相乘，不就能得到 X、Y 坐标的具体值了？这里用到的操作仍然是"获取词典值"，因为每一行也相当于一个"小词典"。
4.将相关结果输入到"图片裁剪"操作中去，大功告成！
5.别忘了在 9 次重复结束后，把生成的 9 张照片"保存到相册"
我们来试运行一下吧：
▼ 原图：
▼ 九宫格分割后：
- 下篇总结 -
本帖中，我从零开始制作了一个"图片九宫格分割器"，至此各位已经见识到了"快捷指令"中 99% 的操作。总结下就是：
? 总共有三种逻辑：
1. 如果…否则…：指令会根据某个条件，在岔路口二选一，当然，你也可以进行套娃，这样就能四选一、八选一了；
2. 重复：指令会重复执行相关操作，我们只要使用一张表格，就能实现每次重复时调用不同的参数；
3. 选取：这是在"社畜的洗衣机"中用到的逻辑，类似"如果…否则…"，不过选项能有很多，且最后用哪个选项完全看用户的意愿；
? 虽说"魔法变量"使得用户不需要"定义一个变量，使用一个变量"，但有时引入变量并不会使逻辑变得混乱，反而能帮助用户进行后续的思考；
下篇内容到此结束，希望各位有一个良好的阅读体验。细心的读者可能发现，说好的 Java 呢？说好的 API 呢？这些内容也很有趣，但本帖的篇幅已经超标了，所以请各位期待一个"番外篇"吧。
本帖来自爱盲客户端

时光的回忆

地板 时光的回忆说：
哦。

来自：掌上乐园

铭鑫

5楼 铭鑫说：
顶
本帖来自安卓秘书