Кастомні Siri Intents: від INExtension до AppIntents

Користувачі продовжують відкривати додаток вручну, тому що Siri не розуміє їхні команди. Кастомні Intents вирішують цю проблему: ви визначаєте голосові команди, Siri диктує параметри та виконує дію у фоні. Ми реалізували понад 30 проєктів із SiriKit — середня інтеграція займає 2 тижні. На відміну від базових Shortcuts, кастомні Intents підтримують діалоги з уточненням параметрів. Це знижує помилки введення та підвищує задоволеність. За внутрішніми даними, впровадження інтенцій збільшує частоту використання додатку на 15–20%. Один клієнт заощадив 2 000 000 рублів на рік на підтримці старого коду після міграції на AppIntents.

Як працює INExtension на практиці?

INExtension — процес, який запускає Siri при вимові команди. Він містить хендлери для кожного Intent, визначеного в .intentdefinition. Xcode генерує код класів Intent, Response та параметрів. Розглянемо структуру параметра:

Parameter: date Type: Date (INDateComponentsResolutionResult) Display Name: "дата" Prompt: "На яке число?" Siri Dialog: "На яке число призначити зустріч?" 

Типи параметрів: String, Integer, Boolean, Date, CLPlacemark (геолокація), INPerson (контакт з адресної книги), кастомні INObject-типи для сутностей вашого додатку. Siri отримує параметри через INObject — кастомний тип, що описує сутності. У INExtension потрібно реалізувати provide…Options…Collection, який повертає об'єкти для вибору.

Проблеми, які вирішуємо

Extension не викликається — найчастіша причина. Переконайтеся, що Intent додано до NSExtension.NSExtensionAttributes.IntentsSupported в Info.plist extension, а також в основний таргет. App Group не пробрасується — extension і додаток у різних sandbox. Використовуйте FileManager.default.containerURL(forSecurityApplicationGroupIdentifier: "group.com.yourapp") або UserDefaults(suiteName: "group.com.yourapp"). Siri не розуміє специфічні терміни — INVocabulary.shared().setVocabularyStrings(projectNames, of: .organizationName) та глобальний AppIntentVocabulary.plist для статичних термінів.

Як вирішити проблему нерозуміння термінів Siri?

Використовуйте INVocabulary та AppIntentVocabulary.plist для реєстрації назв проєктів, задач або інших сутностей. Це дозволить Siri розпізнавати їх голосом без додаткових уточнень. В одному з проєктів ми додали понад 200 термінів, і точність розпізнавання зросла з 70% до 95%.

Як ми розробляємо кастомні Intents

Перший крок — створення файлу .intentdefinition з параметрами та діалогами. Потім генеруємо Swift-класи та пишемо хендлери:

// Кастомний INObject class ProjectObject: INObject { // identifier та displayString обов'язкові } // У IntentHandler func provideProjectOptionsCollection( for intent: CreateTaskIntent, with completion: @escaping (INObjectCollection<ProjectObject>?, Error?) -> Void ) { let projects = ProjectRepository().fetchAll() let objects = projects.map { ProjectObject(identifier: $0.id, display: $0.name) } completion(INObjectCollection(items: objects), nil) } 

Resolve, Confirm, Handle — три методи життєвого циклу: Resolve — валідація та уточнення кожного параметра:

func resolveTaskName(for intent: CreateTaskIntent, with completion: @escaping (INStringResolutionResult) -> Void) { guard let name = intent.taskName, name.count >= 2 else { completion(.needsValue()) // Siri: "Як назвати задачу?" return } guard name.count <= 255 else { completion(.unsupported(forReason: .tooLong)) return } completion(.success(with: name)) } 

Confirm — фінальна перевірка:

func confirm(intent: CreateTaskIntent, completion: @escaping (CreateTaskIntentResponse) -> Void) { guard ProjectRepository().exists(id: intent.project?.identifier) else { let response = CreateTaskIntentResponse(code: .failure, userActivity: nil) response.failureReason = "Проєкт не знайдено" completion(response) return } completion(CreateTaskIntentResponse(code: .ready, userActivity: nil)) } 

Handle — виконання:

func handle(intent: CreateTaskIntent, completion: @escaping (CreateTaskIntentResponse) -> Void) { let store = TaskStore(appGroup: "group.com.yourapp") let task = store.create( name: intent.taskName!, projectId: intent.project?.identifier, dueDate: intent.dueDate?.dateComponents ) let response = CreateTaskIntentResponse(code: .success, userActivity: nil) response.task = TaskObject(identifier: task.id, display: task.name) completion(response) } 

Response-шаблони задаються в .intentdefinition: Siri вимовить «Задача "$(taskName)" створена в проєкті "$(project)"».

Процес роботи

1. Аналітика — вивчаємо бізнес-логіку та визначаємо команди.
2. Проєктування — створюємо .intentdefinition з параметрами та діалогами.
3. Реалізація — пишемо хендлери, INObject, інтеграцію з App Group та INVocabulary.
4. Тестування — симуляція Siri на реальному пристрої, перевірка всіх сценаріїв відмови.
5. Деплой — підготовка App Store Review, при необхідності — оновлення конфіг-файлів.

Що входить у роботу

• Файл .intentdefinition з параметрами та діалогами.
• INExtension з повним циклом resolve/confirm/handle.
• Налаштування App Group для спільної бази даних.
• Інтеграція з INVocabulary для голосового розпізнавання.
• (опціонально) Міграція на AppIntents для актуальних версій iOS.
• Документація з інтеграції.

Орієнтовні строки

Порівняння SiriKit та AppIntents

AppIntents (актуальні версії iOS) використовує async/await, більш лаконічний, підтримує SwiftUI та працює у віджетах. Старий код вимагає до 150 рядків на Intent, новий — близько 40. AppIntents у 2–3 рази швидший у реалізації та легше підтримується. Якщо ваш додаток уже використовує сучасні патерни, AppIntents — очевидний вибір. Детальніше: AppIntents.

Отримайте консультацію досвідченого розробника для оцінки вашого проєкту. Зв'яжіться з нами, щоб обговорити деталі та замовити аудит поточного SiriKit-рішення. Замовте розробку кастомних Intents — гарантуємо проходження App Store Review та повну підтримку інтеграцій.