如何通过 INUIAddVoiceShortcutButtonDelegate 正确地使用 INUIAddVoiceShortcutButton

栏目: IOS · 发布时间: 5年前

内容简介:本文翻译自 Funkenstrahlen 发布的文章《How to use INUIAddVoiceShortcutButton correctly with INUIAddVoiceShortcutButtonDelegate》,原文链接:Siri 捷径是 Apple 在 iOS 12 上重点推介的一项功能。它允许用户通过给 Siri 添加自定义短语来运行由 app 提供的特定动作。app 可以通过多种方式向用户提供这个捷径的入口,其中很重要的一种就是你可以自行设计一个定制化的按钮,但是 Apple 更鼓

本文翻译自 Funkenstrahlen 发布的文章《How to use INUIAddVoiceShortcutButton correctly with INUIAddVoiceShortcutButtonDelegate》,原文链接: funkenstrahlen.de/blog/2018/0…

Siri 捷径是 Apple 在 iOS 12 上重点推介的一项功能。它允许用户通过给 Siri 添加自定义短语来运行由 app 提供的特定动作。app 可以通过多种方式向用户提供这个捷径的入口,其中很重要的一种就是 在应用内展示一个按钮

你可以自行设计一个定制化的按钮,但是 Apple 更鼓励你使用官方的 INUIAddVoiceShortcutButton 。样式也可以设置(黑或白),而且如果使用得当的话,你会发现

官方的 INUIAddVoiceShortcutButton 文档 提供了一些示例代码:

// Add an "Add to Siri" button to a view.
func addSiriButton(to view: UIView) {
    let button = INUIAddVoiceShortcutButton(style: .blackOutline)
    button.translatesAutoresizingMaskIntoConstraints = false

    view.addSubview(button)
    view.centerXAnchor.constraint(equalTo: button.centerXAnchor).isActive = true
    view.centerYAnchor.constraint(equalTo: button.centerYAnchor).isActive = true

    button.addTarget(self, action: #selector(addToSiri(_:)), for: .touchUpInside)
}

// Present the Add Shortcut view controller after the
// user taps the "Add to Siri" button.
@objc
func addToSiri(_ sender: Any) {
    if let shortcut = INShortcut(intent: orderSoupOfTheDayIntent) {
        let viewController = INUIAddVoiceShortcutViewController(shortcut: shortcut)
        viewController.modalPresentationStyle = .formSheet
        viewController.delegate = self // Object conforming to `INUIAddVoiceShortcutViewControllerDelegate`.
        present(viewController, animated: true, completion: nil)
    }
}
复制代码

然而这份示例代码并没有实现一个好的用户体验!

  • 当捷径已经被用户添加过时,按钮没有自动更新UI(变成“Added to Siri”)
  • 点击按钮无法对已有的捷径进行编辑

关于这里有太多可以优化的地方,但不幸的是,Apple 并没有在文档中说明这一情况。

要实现更好的用户体验,关键就在于 INUIAddVoiceShortcutButtonDelegate 。它可以让你根据用户是否已经创建过捷径来决定应该展示 INUIAddVoiceShortcutViewController 还是 INUIEditVoiceShortcutViewController

代理方法可以这样实现:

extension MyViewController: INUIAddVoiceShortcutButtonDelegate {
    func present(_ addVoiceShortcutViewController: INUIAddVoiceShortcutViewController, for addVoiceShortcutButton: INUIAddVoiceShortcutButton) {
        addVoiceShortcutViewController.delegate = self
        addVoiceShortcutViewController.modalPresentationStyle = .formSheet
        present(addVoiceShortcutViewController, animated: true, completion: nil)
    }

    func present(_ editVoiceShortcutViewController: INUIEditVoiceShortcutViewController, for addVoiceShortcutButton: INUIAddVoiceShortcutButton) {
        editVoiceShortcutViewController.delegate = self
        editVoiceShortcutViewController.modalPresentationStyle = .formSheet
        present(editVoiceShortcutViewController, animated: true, completion: nil)
    }
}
复制代码

别忘了指定 INUIAddVoiceShortcutButtonDelegate

let button = INUIAddVoiceShortcutButton(style: .black)
button.translatesAutoresizingMaskIntoConstraints = false
button.shortcut = INShortcut(intent: WarningLevelIntent())!
button.delegate = self
// then add the button as a subview and create constraints to place it correctly
复制代码

你还需要把你要设置的捷径赋值给 button.shortcut ,这样就可以使按钮在已有捷径的场景下自动更新UI了。当按钮被点击时, INUIAddVoiceShortcutButtonDelegate 相应的代理方法会被调用,以允许用户设置自定义短语或者修改已有短语。

还有一件事不要忘了,就是实现 INUIAddVoiceShortcutViewControllerDelegateINUIEditVoiceShortcutViewControllerDelegate 这两个代理。以下是一个非常简化的实现版本,你可以根据你的需要来扩展它:

extension MyViewController: INUIAddVoiceShortcutViewControllerDelegate {
    func addVoiceShortcutViewController(_ controller: INUIAddVoiceShortcutViewController, didFinishWith voiceShortcut: INVoiceShortcut?, error: Error?) {
        controller.dismiss(animated: true, completion: nil)
    }

    func addVoiceShortcutViewControllerDidCancel(_ controller: INUIAddVoiceShortcutViewController) {
        controller.dismiss(animated: true, completion: nil)
    }
}

extension MyViewController: INUIEditVoiceShortcutViewControllerDelegate {
    func editVoiceShortcutViewController(_ controller: INUIEditVoiceShortcutViewController, didUpdate voiceShortcut: INVoiceShortcut?, error: Error?) {
        controller.dismiss(animated: true, completion: nil)
    }

    func editVoiceShortcutViewController(_ controller: INUIEditVoiceShortcutViewController, didDeleteVoiceShortcutWithIdentifier deletedVoiceShortcutIdentifier: UUID) {
        controller.dismiss(animated: true, completion: nil)
    }

    func editVoiceShortcutViewControllerDidCancel(_ controller: INUIEditVoiceShortcutViewController) {
        controller.dismiss(animated: true, completion: nil)
    }
}
复制代码

希望这篇文章可以真正帮助到那些想在 app 中添加 INUIAddVoiceShortcutButton 的人。当我最开始试着添加的时候,我找不到任何优秀的文档来告诉我如何去做,这也就是为什么我要写这篇小文章。


以上所述就是小编给大家介绍的《如何通过 INUIAddVoiceShortcutButtonDelegate 正确地使用 INUIAddVoiceShortcutButton》,希望对大家有所帮助,如果大家有任何疑问请给我留言,小编会及时回复大家的。在此也非常感谢大家对 码农网 的支持!

查看所有标签

猜你喜欢:

本站部分资源来源于网络,本站转载出于传递更多信息之目的,版权归原作者或者来源机构所有,如转载稿涉及版权问题,请联系我们

怪诞行为学2

怪诞行为学2

[美]丹·艾瑞里 / 赵德亮 / 中信出版社 / 2010-1-9 / 42.00元

《怪诞行为学2:非理性的积极力量》编辑推荐:尝试用“非理性”的决策方式,彻底颠覆工作和生活中的“逻辑”,你将获得意想不到的成就感与幸福感!畅销书《怪诞行为学》作者卷土重来,掀起新一轮“非理性”狂潮。 《写给中国人的经济学》作者王福重、著名行为经济学家董志勇倾情作序。 诺贝尔经济学奖得主阿克尔洛夫、《免费》作者安德森高度评价。 《纽约时报》《哈佛商业评论》《波士顿环球报》等全球顶级......一起来看看 《怪诞行为学2》 这本书的介绍吧!

RGB转16进制工具
RGB转16进制工具

RGB HEX 互转工具

Base64 编码/解码
Base64 编码/解码

Base64 编码/解码

HEX HSV 转换工具
HEX HSV 转换工具

HEX HSV 互换工具