Распространённые проблемы
Ниже приведены рекомендации по диагностике и устранению распространённых проблем.
1. Вызовы функций завершаются ошибкой сразу после подключения
BLE-соединение устанавливается раньше, чем SDK завершает обнаружение сервисов, открывает протокольный канал и загружает состояние устройства. В этот промежуток вызовы функций могут завершаться ошибкой, поскольку устройство ещё не готово.
Назначьте делегат устройства до подключения. Перед вызовом функции дождитесь deviceDidReady(...) или убедитесь, что isConnectedAndReady имеет значение true. После повторного подключения снова дождитесь нового события готовности.
2. Функция доступна в коде, но не работает на некоторых устройствах
SDK предоставляет общий набор API для разных моделей, однако фактическая поддержка зависит от модели устройства, версии прошивки, флагов возможностей и перечней поддерживаемых значений.
Проверяйте сведения о поддержке функции до её включения в интерфейсе. Если устройство возвращает deviceNotSupport, считайте функцию недоступной для этого устройства и не повторяйте тот же запрос.
3. Подключение к точке доступа выполнено, но операция не завершается
Импорт медиафайлов, RTSP и OTA камеры после управления по Bluetooth переходят на Wi-Fi-точку доступа устройства. Подключение к ней — лишь промежуточный этап.
Сохраняйте устройство, владельца процесса и обработчики обратного вызова до получения завершающего callback функции. Не запускайте параллельно другой процесс, использующий точку доступа. При потере соединения повторите весь процесс, не используя прежний URL. Необходимая настройка описана в разделе «Установка».
4. AI-функции недоступны после подключения устройства
Подключение по Bluetooth и авторизация AI-сервиса — независимые состояния.
При использовании встроенного поставщика инициализируйте AIBudsAISDK, настройте выбранного поставщика и дождитесь состояния авторизации устройства. Для собственного AI-сервиса выполните аутентификацию в приложении и передайте результат через reportSelfAiServiceAuthResult; иначе устройство не узнает, что сервис авторизован. См. «Передача результата авторизации собственного AI».
Если требуется дополнительная помощь
Используйте шаблон отчёта о проблеме, чтобы приложить сведения о среде, состоянии устройства, шагах воспроизведения, ошибке и диагностике, необходимых для анализа.