자체 AI 서비스 사용

자체 AI 서비스를 사용하더라도 별도의 기기 흐름을 만들 필요는 없습니다. 기기 연결, AI 요청 이벤트, 기기가 선택한 SCO 또는 Opus 오디오 경로, 세션 조정, 정리 작업은 해당 AIBuds 기능 문서에 정의된 흐름을 그대로 따릅니다.

달라지는 부분은 인증과 AI 처리입니다. 호스트 앱이 자체 서비스를 인증하고 그 결과를 기기에 알린 뒤, SDK 제공 AI 서비스 대신 자체 AI 구현을 사용합니다.

동작 흐름

자체 AI 인증 결과 전달

앱의 AI 서비스를 인증하고 결과를 기기에 알린 다음, 기기가 주도하는 표준 AI 흐름을 계속합니다.

앱 ↔ 기기

기기 연결

일반 AIBuds 기기 연결을 완료하고 필요한 기능 API가 준비될 때까지 기다립니다.

호스트 앱 ↔ 자체 AI

자체 AI 서비스 인증

호스트 앱이 자체 서비스 연동을 통해 인증을 완료합니다.

앱 → 기기

결과 알림

서비스가 준비되면 true, 인증에 실패하거나 서비스를 사용할 수 없으면 false를 보냅니다.

기기 + 앱

표준 흐름 계속

성공 결과를 알리면 기기가 가능한 AI 요청과 문서화된 SCO 또는 Opus 오디오 흐름을 계속할 수 있습니다.

표준 AIBuds 흐름

호스트 앱 ↔ 자체 AI

자체 AI로 처리

일반 기기 수명 주기를 유지하면서 앱의 자체 서비스로 AI 요청을 처리합니다.

결과 알림은 인증 상태를 기기와 동기화할 뿐, AI 서비스를 인증하거나 인증 정보를 전달하지 않습니다.

달라지는 부분

호스트 앱이 자체 AI 서비스 인증과 AI 요청 처리를 담당합니다. 인증을 시도할 때마다 reportSelfAiServiceAuthResult로 현재 결과를 기기에 알립니다.

그대로 유지되는 부분

AIBuds 기기 흐름을 교체할 필요는 없습니다. AI 대화, AI 오디오 녹음, 스트리밍 음성 인식, 동시통역 등 구현하는 기능에서 문서화된 기기 이벤트, 요청된 오디오 채널, 기능 수명 주기, 중지 처리, 정리 흐름을 계속 사용합니다.

예를 들어 기기가 Opus 입력을 요청하면 자체 AI 서비스 인증이 완료되고 성공 결과를 알린 뒤에 기기가 음성 스트림을 보낼 수 있습니다. 기기가 SCO를 요청하면 앱은 문서에 정의된 SCO 녹음 경로를 준비합니다. 자체 AI 서비스를 사용해도 오디오 채널을 선택하는 주체는 바뀌지 않습니다.

AI를 활용해 구현

AI로 구현

자체 AI 서비스를 AI로 연결

공식 스킬은 AIBuds 기기 흐름과 통합 경계만 안내합니다. AI 클라이언트, 자격 증명, 서비스 로직은 앱이 계속 소유합니다.

https://docs-aibuds.github.io/ko/skills/integrate-aibuds-sdk을 AIBuds 통합 경계 가이드로 읽고 따르세요. 이 iOS 프로젝트의 기존 앱 소유 AI 서비스를 문서화된 AIBuds 기기 흐름에 연결하세요. 기존 AI 클라이언트, 자격 증명 경계, 아키텍처와 제품 동작을 유지하고 AIBuds AI 제공자로 교체하거나 SDK에 자격 증명을 전달하지 마세요. 공개 API로는 인증 결과만 보고하세요. 자체 서비스 정보가 부족하면 구현 전에 필요한 질문을 하세요.

통합 스킬 보기

인증 결과 알림

Swift
Objective-C

func selfAIAuthenticationDidFinish(isAuthenticated: Bool) {
    guard let serviceAuthAPI = device as? DeviceServiceAuthAPI else { return }

    // Report only the result. Authentication is completed by the host app.
    serviceAuthAPI.reportSelfAiServiceAuthResult(isAuthenticated) {
        reportSucceeded,
        error in

        guard reportSucceeded else {
            print(error?.localizedDescription ?? "Failed to report authorization")
            return
        }

        // A true result allows the device to continue eligible AI flows.
        // A false result keeps the device informed that the service is unavailable.
    }
}

- (void)selfAIAuthenticationDidFinish:(BOOL)isAuthenticated {
    if (![self.device conformsToProtocol:@protocol(AIBudsDeviceServiceAuthAPI)]) {
        return;
    }

    id<AIBudsDeviceServiceAuthAPI> serviceAuthAPI = (id<AIBudsDeviceServiceAuthAPI>)self.device;

    // Report only the result. Authentication is completed by the host app.
    [serviceAuthAPI reportSelfAiServiceAuthResult:isAuthenticated
                                       completion:^(BOOL reportSucceeded, NSError *error) {
                                           if (!reportSucceeded) {
                                               NSLog(@"%@", error.localizedDescription);
                                               return;
                                           }

                                           // A true result allows the device to continue eligible
                                           // AI flows. A false result keeps the device informed
                                           // that the service is unavailable.
                                       }];
}

전체 API 계약은 reportSelfAiServiceAuthResult과 자체 AI 인증 결과 알림을 참고하세요.

:::note 완료 콜백의 의미 완료 핸들러는 Boolean 결과가 기기에 전달되었는지를 나타냅니다. 호스트 앱의 AI 서비스 인증 성공 여부를 뜻하지 않습니다. 이 API로 토큰, API 키 또는 기타 인증 정보를 보내지 마세요. :::

통합 점검 목록

호스트 앱에서 자체 AI 서비스를 인증합니다.
서비스가 AI 요청을 처리할 준비가 되었을 때만 true를 알립니다.
인증에 실패하거나 서비스를 사용할 수 없으면 false를 알립니다.
선택한 AI 기능에 문서화된 기기 이벤트, SCO 또는 Opus, 세션, 정리 흐름을 계속 사용합니다.
인증 정보는 앱의 안전한 자체 서비스 연동 내부에 보관하고, 기기에는 Boolean 결과만 알립니다.