如果你想要在Siri界面直接进行一些操作,而不是让Siri打开APP。那么你可能需要使用Intent Extension了。
在Framework添加Intens.framework和IntentsUI.framework
然后File->New,选择“SiriKit Intent Definition File”
这样会生成一个后缀名为.intentdefinition的文件,选择,然后点击“+”,选择"New Intent",创建一个Inten文件.
创建完成后,编译一下项目,Xcode 会自动生成对应的类,类名取决于右边的Custom Class的名字。每个类包含了 IntentHandling 协议和 IntentResponse 类等所需要的内容。
需要注意的是,这些类不会出现在项目的目录中,有点和 Core Data 类似。
但你可以正常使用,可以为其新建 Category 或者导入头文件就可以直接使用。
观察一下plist,可以看到多了这项内容。如果没有,可以手动添加。Value为前面提到的自动生成的文件的类名。
Category根据自己的需求来选就行了,每一个参数属性到时候都会对应生成一个resolveParametter方法
"User confirmation required"这个选项决定了生成的视图有没有确认按钮选项
没有勾选时生成的视图
勾选后生成的图,按钮的值由前面设置的Category决定
title的显示需要为变量,那么在Parameters那边新增一个变量(我这边设定为actName)。然后再Supported Combinations,添加这个属性。Summary那边添加值{Your_Parameter}。这样在添加到Siri界面,图片下面的文本就是对应的变量值了。
同时将Shortcuts app的勾去掉。这样到时候生成的快捷指令,下面的title就是对应你的变量的内容了。
接下来,创建Intents Extension。File->New target,选择Intents Extension。
为了让 Extension 的界面便于控制,我选择了 Include UI Extension。这样就同时创建了两个Extension。
创建之后,回到前面的intentdefinition文件,选中,观察一下右边的Target Membership,除了主target还要勾选上Intent Extension 和Intent ExtensionUI这两个target ,否则在这两个扩展里,无法访问到前面创建的Intent类。
然后在新生成的这两个target里的plist文件里,也添加上前面生成的Intent类型,这样到时候才能正确识别出这个intent。
同样的,Intent Extension中也可以使用语言国际化。选择intentdefinition文件,选中右边的Localize...按钮就可以了。然后添加一下自己需要的语言。一般来说,貌似会把本体target中,你使用到的语言放到待选栏中让你选择。
看一下生成的多语言文件。跟在本体target中使用一致,不过,前面的部分看着感觉像加了密呢。
如果用到了swift和OC的混编,扩展里面也是需要桥接文件的
数据共享——app Groups
在需要数据共享的target中,使用同一个GroupID
另外需要注意一下,Extension支持的系统和App是独立设置的。当初在做的时候Xcode升级到最新版本,Extension默认的target系统版本是iOS13.2,后面一直没改过来。导致只有在iOS13.2的手机才能执行siri。把Extension的修改过来就可以了。
Demo
备注:这个我自己重新剥离项目用OC写的一份简易Demo,可能和文中的几个地方细节有所不同,请见谅。
参考:
WWDC 2018 Shorcuts
iOS12 Siri ShortCuts 应用
苹果官方 Siri ShortCuts Demo
iOS12 Siri Shortcuts(二)
iOS 12 新特性 Sirishortcut(捷径)调研(二)
APP Extension 与 APP之间的数据共享
iOS Action Extension开发教程,实现跨APP的数据共享