Part4: 设置自定义词汇
在这里放出原文链接地址
Part 4.1: 指定自定义词汇
App 含有自定义词汇时, 应该告知 Siri 这些自定义词汇的用途. 所谓自定义词汇指的是 Siri 本身不能理解的一些语义. 例如: 一个行程预订的 App, 指定了一个特殊的载具类型 Vroom, 此时就可以自定义一个词汇, 并且提供一个使用如何使用这个词汇的例子. 定义自定义的词汇将会更好的帮助 Siri 去理解用户的指令, 来更好的协同你的 App, 这将会大大提升用户体验.
为你的 App 指定自定义词汇的方法有如下两种:
- 使用
INVocabulary对象来为指定的用户注册自定义词汇. - 为你的添加一个全局词汇文件 ( global vocabulary file ), 为所有的用户注册自定义词汇.
重要:
Siri 会尽可能多的合并你自定义的词汇. 你需要将注意力放在那些语义近似有可能产生混淆的词汇上, 否则你就需要对你的词汇列表进行排序, 将最终要的一个放在列表的第一位.
除了定义自定义词汇外, 你还需要使用全局词汇文件 ( global vocabulary file ) 为你 App 支持的所有 Intent 添加实用范例 ( example phrases ). Siri 将会在 Siri Guide 中展示你的实用范例 ( example phrases ), 这样用户将更容易了解如何唤起你 App 的服务.
Part 4.2: 为指定用户设置自定义词汇
使用 INVocabulary 对象未指定的用户设置自定义短语. 指定用户的自定义词汇必须属于以下分类的其中之一:
- 联系人名称
- 联系人组
- 相片标签
- 相册名称
- 锻炼名称
- 车辆名称 (只支持 CarPlay)
当选择注册的词汇时, 尽可能选择一些会让陌生人难以理解的词汇, 不要注册一些非常易懂的词汇, 例如: "我的相册"、"我的健身"等. 你可以注册一些从字面上看不出来你的用途的词汇.
使用 INVocabulary 的 setVocabularyStrings:ofType: 方法来注册词汇. 你所注册的每一组词汇都必须关联一个指定的分类. 为一个指定的分类注册一个新的词汇集合时, 将会替换掉上一次注册的内容, 所以你每次调用该方法的时候, 最好包含你所需要的所有词汇. 在你创建的 NSOrderedSet对象中, 你应该将最重要的词汇放在第一位.
下面代码块中, 展示了一个注册自定义锻炼名称词汇的例子.
NSOrderedSet* workoutNames = [self sortedWorkoutNames];
INVocabulary* vocabulary = [INVocabulary sharedVocabulary];
[vocabulary setVocabularyStrings:workoutNames
ofType:INVocabularyStringTypeWorkoutActivityName];
获取更多为指定用户注册词汇的信息,请查看: INVocabulary Class Reference
Part 4.3: 创建全局词汇文件( Global Vocabulary File )
创建全局词汇文件( Global Vocabulary File ) 为你的 App 指定使用范例 ( example phrases ) 和 为所有的用户注册自定义词汇. 所有的 App 都必须提供至少几个使用范例 ( example phrases ), Siri 将会在 Siri Guide 中使用使用范例 ( example phrases )作为一个如何使用你的 App 的例子来向用户进行展示. 你同样可以使用这个文件为使用你 App 的所有用户进行自定义词汇的注册.
注意:
我们推荐你为你的 App 提供一个全局词汇文件( Global Vocabulary File ), 在文件中为你支持的所有Intent提供一个或多个使用范例 ( example phrases ). 尽管全局词汇文件( Global Vocabulary File )不是必须的, App Store 将会提示一个警告: 该 App 支持 Siri, 但是并没有为它的Intent设置使用范例 ( example phrases )
全局词汇必须属于下面两个分类的其中之一:
- 路线选择
- 锻炼名称
全局词汇文件( Global Vocabulary File ) 实际就是一个在你 App 包内的一个被命名为 AppIntentVocabulary.plist 的 plist 文件. 把该文件放在你的app开发语言对应的.lproj目录下, 并且将该文件的本地化版本放到每一个你的 App 特定语言的 .lproj 目录下. 在Xcode中，你可以在文件检查器中自动创建本地化的版本。
创建 全局词汇文件( Global Vocabulary File ) 的步骤:
-
选择 New -> File
-
在 iOS标签下的
Resource中选择Property List. 点击 Next.
-
将文件名设置为
AppIntentVocabulary.plist. 点击 Create.
-
选中
AppIntentVocabulary.plist文件, 在根元素下面 添加两个 Key:- ParameterVocabularies: 这个 Key 定义 App 的自定义术语和适用的
Intent参数 -
IntentPhrases: 这个 Key 包含了设计到你 App 服务的 使用范例 ( example phrases ), 如果你为你的 App 设置了自定义的词汇, 你至少需要提供一些 使用范例 ( example phrases ) 来向你的用户展示如何去使用这些词汇.
- ParameterVocabularies: 这个 Key 定义 App 的自定义术语和适用的
-
按照 App Vocabulary File Format 的描述来配置剩下的 key.
词汇必须和 Intent 对象的一个指定的属性相关联, 当 Siri 听到了一个自定义词汇, 他将会使用这个自定义词汇去填充Intent 对象响应的属性. 有时你可能需要在不同的Intent 中关联相同的词汇. 例如: 一个自定义的健身名称可能会应用到所有健身相关的Intent 中.
重要:
在开发中, Xcode 将全局词汇文件( Global Vocabulary File )递交给Siri, 但是对你的开发设备的词汇可用性进行限制. 递交所有的词汇数据不是一瞬间完成的, 你可能需要耐心的等待1-2分钟, 然后再测试你的自定义词汇.
获取更多全局词汇文件( Global Vocabulary File )相关的内容, 请查看: App Vocabulary File Format
Lemon龙说:
如果您在文章中看到了错误 或 误导大家的地方, 请您帮我指出, 我会尽快更改
如果您有什么疑问或者不懂的地方, 请留言给我, 我会尽快回复您
如果您觉得本文对您有所帮助, 您的喜欢是对我最大的鼓励
如果您有好的文章, 可以投稿给我, 让更多的 iOS Developer 在简书这个平台能够更快速的成长
