자주 발생하는 문제

아래 내용을 참고해 자주 발생하는 문제의 원인을 확인하고 해결하세요.

1. 기기를 연결한 직후 기능 호출이 실패하는 경우

BLE 연결이 완료된 뒤에도 SDK는 서비스 검색, 프로토콜 채널 연결 및 기기 상태 불러오기를 계속 진행합니다. 이 과정이 끝나기 전에 기능을 호출하면 기기가 아직 준비되지 않아 요청이 실패할 수 있습니다.

연결 전에 기기 delegate를 설정하고 deviceDidReady(...)가 호출될 때까지 기다리거나, isConnectedAndReady가 true인지 확인한 뒤 기능을 호출하세요. 기기를 다시 연결한 경우에도 새로운 준비 완료 이벤트를 기다려야 합니다.

2. 코드에 있는 기능이 일부 기기에서 동작하지 않는 경우

SDK는 여러 기기 모델에서 공통으로 사용할 수 있는 API를 제공하지만, 실제 지원 여부는 기기 모델, 펌웨어, 기능 지원 플래그 및 지원 값 목록에 따라 달라질 수 있습니다.

UI에서 기능을 활성화하기 전에 해당 기능의 지원 정보를 확인하세요. 기기가 deviceNotSupport를 반환하면 같은 요청을 반복하지 말고, 그 기기에서는 사용할 수 없는 기능으로 처리하세요.

3. 핫스팟에 연결됐지만 작업이 끝나지 않는 경우

미디어 파일 가져오기, RTSP 및 카메라 OTA는 Bluetooth 제어에서 기기가 제공하는 Wi-Fi 핫스팟으로 전환됩니다. 핫스팟 연결은 전체 작업의 중간 단계일 뿐입니다.

최종 기능 콜백이 올 때까지 기기 객체, 작업을 관리하는 객체 및 콜백을 유지하고, 여러 핫스팟 작업을 동시에 시작하지 마세요. 핫스팟 연결이 끊어지면 이전 URL을 재사용하지 말고 전체 작업을 처음부터 다시 시작하세요. 필요한 설정은 설치에서 확인할 수 있습니다.

4. 기기를 연결한 뒤에도 AI 기능을 사용할 수 없는 경우

Bluetooth 연결 상태와 AI 서비스 인증 상태는 서로 별개입니다.

SDK에 포함된 서비스 제공자를 사용하는 경우 AIBudsAISDK를 초기화하고 선택한 제공자를 설정한 뒤, 기기 인증 상태가 갱신될 때까지 기다리세요. 자체 AI 서비스를 사용하는 경우 호스트 앱에서 인증을 마친 다음 reportSelfAiServiceAuthResult를 통해 결과를 알려야 합니다. 이 결과를 알리지 않으면 기기는 해당 서비스가 인증되었는지 판단할 수 없습니다. 자세한 내용은 자체 AI 인증 결과 알림을 참고하세요.

추가 지원이 필요한 경우

문제 보고 템플릿을 사용해 주세요. 조사에 필요한 환경, 기기 상태, 재현 절차, 오류 및 진단 정보를 빠짐없이 전달할 수 있습니다.