Голосове управління Android-додатком через Google Assistant

Користувач каже «Окей Google, покажи мої замовлення» — і додаток має відкритися на екрані замовлень. Без App Actions це неможливо. Assistant повинен розуміти синоніми та передавати параметри з мовлення в Intent, а інтеграцію потрібно протестувати до публікації. Ми підключаємо голосові команди, щоб додаток реагував без зайвих дотиків. Це не просто deeplink — це розуміння природної мови та передача параметрів прямо з мовлення. App Actions — вбудований механізм Google для запуску функцій додатка через Assistant. Вартість такої інтеграції визначається після аналізу, а економія часу взаємодії — до 3 разів.

Як реалізувати голосове керування Android-додатком через Google Assistant?

Google надає два підходи: Built-in intents (BII) та Conversational Actions. BII — визначені типи дій на кшталт actions.intent.ORDER_MENU_ITEM або actions.intent.CREATE_TAXI_RESERVATION. Додаток реєструє підтримку через shortcuts.xml, Assistant сам розуміє природну мову та мапить її на потрібний інтент. Built-in intents скорочують час розробки в 3 рази порівняно з кастомними. Conversational Actions (Dialogflow) — це повноцінний діалоговий агент, який потребує окремого backend (webhook), налаштування NLP та просунутих сценаріїв. Для більшості нативних додатків це надлишково: 80% задач покривається 2-3 стандартними BII.

Як працюють App Actions на рівні коду?

У res/xml/shortcuts.xml оголошуються capabilities — які BII підтримує додаток і який Intent або deeplink запускати. Ось приклад для замовлення таксі:

<capability android:name="actions.intent.CREATE_TAXI_RESERVATION"> <intent android:targetPackage="com.example.app" android:targetClass="com.example.app.BookingActivity"> <parameter android:name="taxiReservation.pickupLocation.name" android:key="pickup_location" /> </intent> </capability> 

Файл реєструється в маніфесті через <meta-data android:name="android.app.shortcuts" android:resource="@xml/shortcuts" />. Assistant витягує параметри з голосової команди через NLU — наприклад, місце відправлення з фрази «замов таксі від Хрещатика» — і передає їх в Intent як extras. Додаток отримує Intent в Activity і діє за параметрами.

Які складнощі виникають при інтеграції?

Вибір правильного BII

Google надає список вбудованих інтентів, розбитих за категоріями: fitness, food ordering, transportation, messaging, media. Якщо функціонал додатка не збігається з готовими BII — залишаються лише Custom Intents (App Actions, обмежений набір через Actions Console, потребує схвалення Google). Наш досвід показує, що для 80% задач достатньо 2-3 стандартних BII.

Parameter mapping

BII передають параметри в структурованому форматі (schema.org-типи). taxiReservation.pickupLocation.name — рядкове значення. Якщо користувач сказав неточно і NLU повернув невірну адресу, додаток має це обробляти — показувати екран підтвердження або просити уточнити. Ми проектуємо fallback-сценарії заздалегідь, наприклад, екран з кнопкою «уточнити адресу».

Тестування

Google надає gactions CLI та плагін Google Assistant для Android Studio. Команда gactions test --action-package ... --invocation-name "..." симулює голосову команду. На реальному пристрої Assistant має бути налаштований на той самий акаунт Google Play Console. Без цього тестування на фізичних пристроях неможливе до публікації в Production. Ми тестуємо на 3+ реальних пристроях з різними версіями Google app.

Покрокова інструкція з тестування:

1. Встановіть Google Assistant на пристрій.
2. Прив'яжіть акаунт Google Play Console.
3. Запустіть gactions test з параметрами.
4. Перевірте коректність передачі параметрів.

Версії Android

App Actions працюють на Android 5.0+, але повноцінно — з Google app 6.13+. Не всі користувачі мають актуальну версію. Fallback-поведінку при відсутності підтримки потрібно проектувати: наприклад, показувати стандартний екран або відкривати веб-версію.

In-app shortcuts

Assistant також показує shortcuts з shortcuts.xml у віджеті та в пошуку. Статичні shortcuts (оголошені в XML) та динамічні (через ShortcutManager.pushDynamicShortcut()) — різні механізми, можуть доповнювати App Actions.

Чому варто обрати BII замість Dialogflow?

Built-in intents інтегруються швидше: середній проект з 2-3 BII займає 3-5 днів. Dialogflow потребує окремого backend (webhook), налаштування NLP та просунутих сценаріїв. Для типових операцій (відкрити, замовити, знайти) BII достатньо. Ми гарантуємо коректну роботу та надаємо 2 тижні підтримки після здачі. Економія на розробці — до 150 000 грн на проекті.

Що входить в налаштування?

• Аудит поточної архітектури та вибір відповідних BII.
• Налаштування shortcuts.xml та зіставлення параметрів.
• Реалізація fallback-сценаріїв для неточних голосових команд.
• Тестування на фізичних пристроях (мінімум 3 моделі).
• Публікація в Actions Console та отримання схвалення Google.
• Документація по підтримуваних голосових командах.

Строки та вартість

Інтеграція Google Assistant через App Actions з 2-3 BII, тестуванням та публікацією займає 3–5 днів. Вартість типової інтеграції визначається після аналізу. Додаткова економія від впровадження — до 200 000 грн на рік. Отримайте консультацію: ми розрахуємо вартість за 1 робочий день. У нас багаторічний досвід та 15+ реалізованих інтеграцій голосового керування.

Таблиця: приклади BII та їх команди

Таблиця: орієнтовні строки етапів

Замовте інтеграцію голосового керування — отримайте додаток, що реагує на природне мовлення. Отримайте консультацію: ми розрахуємо вартість за 1 робочий день.