Создание приложения Todo List с поддержкой голоса в Ios с интеграцией Siri

Создание RemoveTaskIntent

Повторите процесс для с параметром . Ответ может быть «Удален {{taskName}}» или «{{taskName}} не найден». Вы также можете добавить тип ответа Неудачи , когда задача не существует.

Создание ShowTasksIntent

Для вам могут не понадобиться какие-либо параметры. Вместо этого, полагайтесь на ответ, чтобы содержать список задач. В разделе ответа добавьте Содержание Свойство типа Строк . Используйте шаблон ответа, такой как «У вас есть задачи {{count}}: {{content}}». может быть пользовательским свойством, установленным программно.

Генерация намеренных классов

После определения всех намерений создайте свой проект. Xcode автоматически сгенерирует классы Swift для каждого намерения и его ответа. Эти классы живут в папке DerivedData, но видны в редакторе. Вы будете использовать их в коде обработчика.

Реализация намерений по работе с вашим приложением и расширением

Теперь, когда намерения определены, вам нужно написать код, который обрабатывает их, когда Siri вызывает ваше приложение.

Обработка намерений в расширении намерений

Цель расширения намерений включает в себя файл по умолчанию , который открывается и заменяется классом, соответствующим сгенерированным протоколам обработки намерений.

import Intents

class IntentHandler: INExtension, AddTaskIntentHandling, RemoveTaskIntentHandling, ShowTasksIntentHandling {

 override func handler(for intent: INIntent) -> Any? {
 return self
 }

 // MARK: - Add Task
 func handle(intent: AddTaskIntent, completion: @escaping (AddTaskIntentResponse) -> Void) {
 guard let taskName = intent.taskName else {
 completion(AddTaskIntentResponse.failure(taskName: "unknown"))
 return
 }
 // Persist the task to your data store (Core Data, UserDefaults, etc.)
 // For simplicity, we'll assume a shared data manager
 TaskDataManager.shared.addTask(taskName: taskName, listName: intent.listName ?? "Default")
 completion(AddTaskIntentResponse.success(taskName: taskName))
 }

 func resolveTaskName(for intent: AddTaskIntent, with completion: @escaping (INStringResolutionResult) -> Void) {
 if let taskName = intent.taskName, !taskName.isEmpty {
 completion(.success(with: taskName))
 } else {
 // Prompt user for a task name
 completion(.needsValue())
 }
 }

 // MARK: - Remove Task
 func handle(intent: RemoveTaskIntent, completion: @escaping (RemoveTaskIntentResponse) -> Void) {
 guard let taskName = intent.taskName else {
 completion(.failure(taskName: "unknown"))
 return
 }
 let removed = TaskDataManager.shared.removeTask(taskName: taskName)
 if removed {
 completion(.success(taskName: taskName))
 } else {
 completion(.notFound(taskName: taskName))
 }
 }

 // MARK: - Show Tasks
 func handle(intent: ShowTasksIntent, completion: @escaping (ShowTasksIntentResponse) -> Void) {
 let tasks = TaskDataManager.shared.allTasks()
 let taskList = tasks.map { $0.name }.joined(separator: ", ")
 let count = tasks.count
 let response = ShowTasksIntentResponse.success(count: count, content: taskList)
 completion(response)
 }
}

Shared Data Store

Код выше ссылается на гипотетический . Поскольку расширение намерения выполняется в отдельном процессе, вы не можете напрямую получить доступ к основной модели данных вашего приложения. вам нужно использовать общий контейнер (App Group) для хранения задач в общем месте, таком как общий набор UserDefaults или хранилище основных данных, которое живет в каталоге группы приложений. Настройте возможность группы приложений как в вашем основном приложении, так и в расширении намерений и используйте тот же идентификатор для сохранения задач.

Обработка намерений в главном приложении

Когда ваше приложение находится на переднем крае, и пользователь запускает ярлык Siri, вы также можете захотеть обрабатывать намерения непосредственно в главном приложении (без расширения). Вы можете сообразовать делегата приложения или делегата сцены с теми же протоколами намерения. Однако для большинства случаев использования расширения достаточно, потому что оно работает независимо от того, находится ли приложение на переднем плане.

Расширяя функциональность: подтверждение, удаление и параметры

Основная обработка намерений - это только начало. Чтобы сделать ваш список дел с поддержкой голоса надежным, добавьте поддержку диалогов подтверждения и разрешение параметров.

Методы разрешения

Для каждого параметра можно реализовать метод , который проверяет или просит разъяснения. Например, если пользователь говорит «Добавить яйца» без указания того, какой список, ваш метод может подсказать: «К какому списку вы хотите добавить яйца?» Если у вас есть только один список, автоматически решите этот список.

Ответы на подтверждение

Вы можете позволить Siri попросить пользователя подтвердить действие перед его выполнением. Это полезно для разрушительных операций, таких как удаление задач. В классе ответа на намерение добавьте тип ответа на подтверждение . При обработке намерения вы можете вернуть ответ на подтверждение, который включает в себя детали. Siri затем попросит пользователя подтвердить, и если он подтвердится, ваш метод будет вызван снова с флагом.