본문으로 건너뛰기

오프라인 음성 어시스턴트 인증

선택적 AIBudsVoiceAssistant 모듈은 지원 기기의 오프라인 음성 어시스턴트를 인증합니다. 이 인증 브리지는 음성 어시스턴트에서 비활성, 기본, 고급 작동 모드를 선택하는 것과 별개입니다.

Animated workflow

오프라인 음성 어시스턴트 인증

연결된 지원 기기에 인증이 필요할 때만 Core가 등록된 플러그인을 실행합니다.

기기 + Core

기기 연결

지원 기기의 일반 연결 흐름을 완료합니다.

AIBuds Core

인증 필요 여부 확인

Core가 음성 어시스턴트 인증이 필요한지 판단합니다.

음성 어시스턴트

플러그인 시작

기기 식별 정보를 등록된 음성 어시스턴트 브리지에 전달합니다.

플러그인 ↔ 기기

불투명 데이터 교환

호스트에서 해석하지 않고 암호화된 인증 데이터를 중계합니다.

브리지 통신
호스트 앱

최종 결과 수신

SDK 또는 기기 델리게이트로 성공 또는 오류를 전달합니다.

브리지 전송 성공은 중간 진행 상태입니다. 델리게이트로 전달되는 인증 결과가 호스트 앱의 최종 신호입니다.

인증 흐름​

Core 기기 구현이 인증 필요 시점을 결정합니다. 등록된 OnDeviceVoiceAssistantBridgePlugin은 OnDeviceVoiceAssistantDevice를 통해 해석하지 않는 브리지 데이터를 교환합니다. 호스트 앱은 최종 결과만 관찰해야 하며 브리지 페이로드를 해석, 저장 또는 변경해서는 안 됩니다.

AI를 활용해 구현

AI로 구현

AI로 이 워크플로 구현

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

https://docs-aibuds.github.io/ko/skills/manage-aibuds-on-device-voice-assistant을 읽고 지침을 따르세요. 이 스킬로 “AIBuds 온디바이스 음성 비서 관리”을 이 iOS 프로젝트에 구현하고 검증하세요.
공식 스킬 보기

등록 관리 주체​

AIBudsAllInOneSDK.initialize는 OnDeviceVoiceAssistantPlugin.shared를 등록합니다. 모듈식 통합에서는 AIBudsVoiceAssistant를 포함하고 기기를 연결하기 전에 브리지를 등록해야 합니다. Core 초기화와 같은 애플리케이션 수준 주체가 등록을 관리하세요.

앱에서 직접 호출하는 “지금 인증” 기능 API는 없습니다. SDK가 필요하다고 판단하면 지원 기기 연결 흐름 중 인증이 시작됩니다.

최종 결과 확인​

SDK 또는 기기 델리게이트 콜백을 구현합니다.

Swift
func device(
    _ device: DeviceConvertible,
    didReceiveOnDeviceVoiceAssistantAuthResult isSuccess: Bool,
    error: NSError?
) {
    // Update product state on the main queue.
}

이 콜백이 호스트 앱의 최종 신호입니다. 브리지 데이터를 성공적으로 보냈다는 것은 전송이 진행되었다는 뜻일 뿐 인증 성공을 의미하지 않습니다.

실행 순서와 재시도​

다른 AI 인증 브리지도 필요한 기기에서는 SDK가 앞선 인증 결과 이후에 오프라인 음성 어시스턴트 인증을 실행할 수 있습니다. UI 코드에서 별도의 인증을 동시에 시작하지 마세요.

현재 공개 계약에는 수동 재시도 API, 제한 시간, 인증 상태의 보존 기간 또는 전체 오류 코드별 복구 표가 정의되어 있지 않습니다. 실패하면 진단을 위해 오류를 보존하고, 제품 정책상 인증이 필요한 어시스턴트 모드는 계속 비활성화하세요. 다음 시도는 문서화된 재연결 흐름 또는 향후 SDK 재시도 계약에 따라야 합니다.

보안 경계​

  • 브리지 데이터는 내부 구조를 해석하지 않는 인증 정보로 취급합니다.
  • 운영 환경에서 페이로드 바이트, 기기 식별 정보, 파생 비밀 값을 로그에 남기지 않습니다.
  • 브리지 패킷을 캐시하거나 다시 전송하지 않습니다.
  • 플러그인과 암호화 의존성의 SDK 버전을 일치시킵니다.
  • 사용자에게는 조치 가능한 실패 상태만 표시하고 상세 오류는 보호된 진단 정보에 보관합니다.

검증 점검 목록​

  • 기기 연결 전에 브리지 플러그인을 등록합니다.
  • All-in-One 등록과 모듈식 등록을 함께 사용하지 않습니다.
  • UI는 최종 델리게이트 콜백을 기다립니다.
  • 호스트 앱에서 브리지 패킷을 해석하거나 저장하지 않습니다.
  • 실패 후 인증이 필요한 어시스턴트 모드를 몰래 활성화하지 않습니다.
  • 지원하는 기기 제품군마다 연결 해제 및 재연결 동작을 테스트합니다.