Голосовое управление Android-приложением через Google Assistant

Пользователь говорит «Окей Гугл, покажи мои заказы» — и приложение должно открыться на экране заказов. Без App Actions это невозможно. Assistant должен понимать синонимы и передавать параметры из речи в Intent, а интеграцию нужно протестировать до публикации. Мы подключаем голосовые команды, чтобы приложение реагировало без лишних касаний. Это не просто deeplink — это понимание естественного языка и передача параметров прямо из речи. App Actions — built-in механизм Google для запуска функций приложения через Assistant. Стоимость такой интеграции — от 75 000 ₽, а экономия времени взаимодействия — до 3 раз. Согласно официальной документации Google, App Actions поддерживаются на Android 5.0 и выше.

Как реализовать голосовое управление 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 дней. Стоимость типовой интеграции — от 75 000 ₽. Дополнительная экономия от внедрения — до 200 000 ₽ в год. Получите консультацию: мы рассчитаем стоимость за 1 рабочий день. У нас более 5 лет опыта и 15+ реализованных интеграций голосового управления.

Таблица: примеры BII и их команды

Таблица: ориентировочные сроки этапов

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