【譯】如何通過 INUIAddVoiceShortcutButtonDelegate 正確地使用 INUIAddVoiceShortcutButton

Oxton發表於2019-02-27
UI

本文翻譯自 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 相應的代理方法會被呼叫，以允許使用者設定自定義短語或者修改已有短語。

還有一件事不要忘了，就是實現 INUIAddVoiceShortcutViewControllerDelegate 和 INUIEditVoiceShortcutViewControllerDelegate 這兩個代理。以下是一個非常簡化的實現版本，你可以根據你的需要來擴充套件它：

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 的人。當我最開始試著新增的時候，我找不到任何優秀的文件來告訴我如何去做，這也就是為什麼我要寫這篇小文章。

相關文章