Обзор голосового помощника

Локальный голосовой помощник выполняет на носимом устройстве поддерживаемое пробуждение и обработку команд. Через OnDeviceVoiceAssistantAPI приложение может узнать возможности устройства, текущий режим и запросить совместимый режим.

Возможности

📄️Проверка локального голосового помощника

Получение возможностей локального голосового помощника подключённого устройства

📄️Получение и настройка локального режима

Получение и изменение режима локального голосового помощника подключённого устройства

Реализация с помощью AI

Разработка с AI

Реализуйте этот сценарий с AI

Используйте официальный навык «Управление голосовым помощником AIBuds» и адаптируйте сценарий к приложению.

Прочитайте и выполните инструкции https://docs-aibuds.github.io/ru/skills/manage-aibuds-on-device-voice-assistant. Используйте этот навык, чтобы реализовать «Управление голосовым помощником AIBuds» в данном iOS-проекте и проверить результат.

Открыть официальный навык

Возможности и режим

OnDeviceVoiceAssistantCapability описывает возможности устройства:

Возможность	Поддерживаемое поведение
`.none`	Локальные голосовые команды не поддерживаются.
`.keywordWakeup`	Только пробуждение по ключевой фразе, например «Hi Buds».
`.common`	Основные команды: управление воспроизведением, треками и громкостью.

OnDeviceVoiceAssistantMode описывает активный режим:

Режим	Поведение
`.unknown`	Текущий режим неизвестен. Не задавайте это значение.
`.disabled`	Локальный голосовой помощник отключён.
`.basic`	Пробуждение и базовые голосовые команды.
`.advanced`	Базовые функции и голосовое управление состоянием вызова.

Набор предлагаемых режимов определяется возможностями устройства. Текущий Demo предлагает отключённый и базовый режимы для .keywordWakeup, а для .common — отключённый, базовый и расширенный.

Порядок интеграции

Animated workflow

Порядок интеграции голосового помощника

Подготовьте интеграцию SDK, проверьте авторизацию и возможности устройства, затем предложите только совместимые режимы помощника.

Host app

Initialize SDK

Install and initialize the base AIBuds SDK for the host application.

Host app

Install Integration

Add AIBudsVoiceAssistant when service authentication is required.

Service

Complete Authorization

Finish the required voice-assistant service authorization flow.

Device

Connect Device

Verify OnDeviceVoiceAssistantAPI conformance on the active device.

Device → app

Read Capability & Mode

Inspect supported behavior and the currently active assistant mode.

Host app → device

Apply Compatible Mode

Offer only valid modes, apply the selection, and update UI from completion or change callbacks.

Возможности устройства определяют доступные режимы; никогда не применяйте .unknown.

Предварительные условия

Устройство подключено и готово.
Необходимая авторизация сервиса завершена.
Устройство реализует OnDeviceVoiceAssistantAPI, а его возможность отличается от .none.

Возможности​