Коннектор Android

Телефон как источник инструментов и триггеров

Приложение-компаньон для Android. Объявляет агенту каталог инструментов и триггеров телефона, сообщает о событиях устройства и выполняет входящие вызовы, приходящие по websocket.

Исходники и сборки — AgiMateIo/connector-android.

Не путайте с приложением для Android: то — мессенджер для разговора с агентами, это — источник инструментов телефона. Приложения разные и независимые.

Триггеры

  • call_incoming, call_missed — входящий и пропущенный звонок.
  • battery_low — заряд ниже порога.
  • wifi_connected, wifi_disconnected — подключение к сети и отключение от неё.
  • shake_detected — телефон встряхнули.
  • location_entered, location_exited — вход в геозону и выход из неё.

Номер звонящего не передаётся: начиная с Android 9 он доступен только приложениям с ролью телефона или скрининга звонков.

Инструменты

  • tts_speak — озвучить текст.
  • notification_show, notification_ask — показать уведомление, задать вопрос с вариантами ответа.
  • contacts_search — поиск по контактам.
  • calendar_search, calendar_create_event — чтение календаря и создание события.
  • geofence_add, geofence_remove, geofence_list — управление геозонами.
  • camera_capture — снимок с камеры.

Что стоит знать

Каталог объявляется целиком при привязке и при каждом переобъявлении заменяется полностью, поэтому выключенный в приложении инструмент агенту не виден вовсе. Триггеры работают через foreground-сервисы: без разрешений, которые приложение просит при установке, часть событий до агента не дойдёт.