음성 어시스턴트 개요

오프라인 음성 어시스턴트는 웨어러블 기기에서 지원되는 호출어 감지와 명령 처리를 수행합니다. 앱에서는 OnDeviceVoiceAssistantAPI를 통해 기기의 지원 기능과 현재 모드를 확인하고, 호환되는 모드로 변경할 수 있습니다.

기능 개요

📄️오프라인 음성 어시스턴트 지원 여부 조회

연결된 기기의 오프라인 음성 어시스턴트 지원 기능 확인

📄️오프라인 음성 어시스턴트 모드 조회 및 설정

연결된 기기의 오프라인 음성 어시스턴트 모드 조회 및 변경

AI를 활용해 구현

AI로 구현

AI로 이 워크플로 구현

공식 “AIBuds 온디바이스 음성 비서 관리” 스킬을 사용해 앱에 맞게 구현하세요.

https://docs-aibuds.github.io/ko/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 통합을 준비하고 인증과 기기 지원 기능을 확인한 뒤, 호환되는 어시스턴트 모드만 제공합니다.

호스트 앱

SDK 초기화

호스트 앱에 기본 AIBuds SDK를 설치하고 초기화합니다.

호스트 앱

통합 모듈 설치

서비스 인증이 필요하면 AIBudsVoiceAssistant를 추가합니다.

서비스

인증 완료

필요한 음성 어시스턴트 서비스 인증을 마칩니다.

기기

기기 연결

현재 기기가 OnDeviceVoiceAssistantAPI를 지원하는지 확인합니다.

기기 → 앱

지원 기능 및 모드 확인

지원되는 동작과 현재 활성화된 어시스턴트 모드를 확인합니다.

호스트 앱 → 기기

호환 모드 적용

유효한 모드만 제공하고 선택을 적용한 뒤, 완료 또는 변경 콜백에 따라 UI를 갱신합니다.

기기 지원 기능에 따라 제공할 모드를 결정해야 하며, .unknown은 설정하지 마세요.

사전 요구 사항

기기가 연결되어 사용할 준비가 된 상태여야 합니다.
필요한 서비스 인증이 완료되어야 합니다.
기기가 OnDeviceVoiceAssistantAPI를 제공하고 .none 이외의 기능을 지원해야 합니다.

기능 개요​