Обновление прошивки камеры

Camera OTA обновляет прошивку модуля камеры поддерживаемого устройства. Этот процесс выполняется отдельно от обновления основной прошивки устройства.

Приложение предоставляет совместимый локальный пакет прошивки камеры. SDK координирует весь процесс: настраивает точку доступа устройства, переводит камеру в режим OTA, запускает локальный HTTP-сервер, передаёт устройству URL прошивки, загружает пакет и прошивает модуль камеры. Показывайте текущий этап по соответствующим обратным вызовам, а окончательный результат определяйте только по финальному обработчику завершения.

Animated workflow

Путь доставки Camera OTA

Локальный пакет проходит проверку в приложении, передачу под управлением SDK, прошивку и завершается окончательным результатом.

Приложение

Проверка пакета

Проверьте целостность, совместимость с моделью камеры и доступность локального пути.

SDK + устройство

Настройка точки доступа

Подготовьте сеть устройства для процесса Camera OTA.

Устройство

Переход в режим OTA

Переведите модуль камеры в режим обновления прошивки.

SDK

Подключение к точке доступа

Подключитесь к SSID, созданному для сеанса обновления.

SDK

Запуск HTTP-сервера

Сделайте выбранный локальный пакет доступным устройству.

SDK → устройство

Передача URL прошивки

Передайте локальный HTTP-адрес, по которому устройство запросит пакет.

Этап с прогрессом

Передача прошивки

Отдавайте пакет, пока устройство загружает данные прошивки.

.transferring · 0...100

Этап с прогрессом

Прошивка камеры

Модуль камеры записывает переданную прошивку. Не прерывайте процесс.

.flashing · 0...100

Окончательный результат

Завершение

Результат обновления берите из финального обратного вызова, а не из прогресса передачи.

Окончательный результат определяйте по финальному обратному вызову.

Предварительные требования

Устройство подключено и поддерживает DeviceCameraOtaAPI.
Локальный файл прошивки доступен для чтения и соответствует модулю камеры.
Приложение может подключиться к точке доступа устройства, работать в локальной сети и поддерживать доступность локального HTTP-сервера.
Не запускайте одновременно импорт медиафайлов, Camera OTA и другие процессы через точку доступа.

Реализация с помощью AI

Разработка с AI

Реализуйте этот сценарий с AI

Используйте официальный навык «Обновление прошивки камеры AIBuds» и адаптируйте сценарий к приложению.

Прочитайте и выполните инструкции https://docs-aibuds.github.io/ru/skills/update-aibuds-camera-firmware. Используйте этот навык, чтобы реализовать «Обновление прошивки камеры AIBuds» в данном iOS-проекте и проверить результат.

Открыть официальный навык

Справочник API

Фреймворк

AIBuds.xcframework

Импорт

Swift
Objective-C

import AIBuds
import AIBudsFoundation

#import <AIBuds/AIBuds-Swift.h>
#import <AIBuds/AIBuds.h>

Протокол

Протокол DeviceCameraOtaAPI наследует DeviceAPI и предоставляет один метод экземпляра, выполняющий весь процесс Camera OTA.

Метод экземпляра

Swift
Objective-C

/// Start camera OTA upgrade.
///
/// - Parameters:
///   - filePath: The readable local path of the camera firmware file.
///   - configureHotspotStartingHandler: Called when hotspot configuration starts.
///   - hotspotConfigureCompletionHandler: Called when hotspot configuration completes.
///     - success: `true` if configuration succeeded; otherwise `false`.
///     - error: The failure information, or `nil` if configuration succeeded.
///   - enterCameraOtaModeStartingHandler: Called when entry into camera OTA mode starts.
///   - enterCameraOtaModeCompletedHandler: Called when entry into camera OTA mode completes.
///     - success: `true` if the device entered OTA mode; otherwise `false`.
///     - error: The failure information, or `nil` if entry succeeded.
///   - waitingForHotspotOpenHandler: Called while waiting for the device hotspot to open.
///   - connectDeviceHotspotStartingHandler: Called when connecting to the device hotspot starts.
///     - ssid: The SSID of the device hotspot.
///   - deviceHotspotConnectCompletionHandler: Called when the hotspot connection completes.
///     - success: `true` if the connection succeeded; otherwise `false`.
///     - error: The failure information, or `nil` if the connection succeeded.
///   - httpServerStartingHandler: Called when the local HTTP server is starting.
///   - httpServerStartCompletionHandler: Called when the HTTP server start attempt completes.
///     - success: `true` if the server started; otherwise `false`.
///     - error: The failure information, or `nil` if the server started.
///   - sendingFirmwareUrlHandler: Called before sending the firmware URL to the device.
///     - firmwareUrl: The local HTTP URL that will be sent.
///   - firmwareUrlSendCompletionHandler: Called when firmware URL delivery completes.
///     - success: `true` if the URL was sent; otherwise `false`.
///     - error: The failure information, or `nil` if delivery succeeded.
///   - startCompletionHandler: Called when the Camera OTA start command completes.
///     - success: `true` if the update started; otherwise `false`.
///     - error: The failure information, or `nil` if the update started.
///   - fileTransferStartedHandler: Called when firmware transfer starts.
///   - fileTransferCompletedHandler: Called when firmware transfer completes.
///   - waitingForFlashingHandler: Called while the device is preparing to flash.
///   - flashingStartedHandler: Called when firmware flashing starts.
///   - flashingCompletedHandler: Called when firmware flashing completes.
///   - phaseProgressHandler: Reports progress for transfer and flashing.
///     - phase: `.transferring` or `.flashing`.
///     - progress: The phase progress in the range `0...100`.
///   - completionHandler: Called when the complete Camera OTA workflow finishes.
///     - success: `true` if the upgrade succeeded; otherwise `false`.
///     - error: The failure information, or `nil` if the upgrade succeeded.
func startCameraOta(
    withFilePath filePath: String,
    configureHotspotStartingHandler: AIBudsCameraOtaConfigureHotspotStartingHandler?,
    hotspotConfigureCompletionHandler: AIBudsCameraOtaHotspotConfigureCompletionHandler?,
    enterCameraOtaModeStartingHandler: AIBudsEnterCameraOtaModeStartingHandler?,
    enterCameraOtaModeCompletedHandler: AIBudsEnterCameraOtaModeCompletionHandler?,
    waitingForHotspotOpenHandler: AIBudsCameraOtaStartingToWaitForHotspotOpenHandler?,
    connectDeviceHotspotStartingHandler: AIBudsCameraOtaConnectDeviceHotspotStartingHandler?,
    deviceHotspotConnectCompletionHandler: AIBudsCameraOtaDeviceHotspotConnectCompletionHandler?,
    httpServerStartingHandler: AIBudsCameraOtaHttpServerStartingHandler?,
    httpServerStartCompletionHandler: AIBudsCameraOtaHttpServerStartCompletionHandler?,
    sendingFirmwareUrlHandler: AIBudsCameraOtaSendingFirmwareUrlHandler?,
    firmwareUrlSendCompletionHandler: AIBudsCameraOtaFirmwareUrlSendCompletionHandler?,
    startCompletionHandler: AIBudsCameraOtaStartCompletionHandler?,
    fileTransferStartedHandler: AIBudsCameraOtaFileTransferStartedHandler?,
    fileTransferCompletedHandler: AIBudsCameraOtaFileTransferCompletedHandler?,
    waitingForFlashingHandler: AIBudsCameraOtaWaitingForFlashingHandler?,
    flashingStartedHandler: AIBudsCameraOtaFlashingStartedHandler?,
    flashingCompletedHandler: AIBudsCameraOtaFlashingCompletedHandler?,
    phaseProgressHandler: AIBudsCameraOtaPhaseProgressHandler?,
    completionHandler: AIBudsCameraOtaCompletionHandler?
)

/// Start camera OTA upgrade from a local firmware path.
///
/// - Parameters:
///   - filePath: The readable local path of the camera firmware file.
///   - configureHotspotStartingHandler: Called when hotspot configuration starts.
///   - hotspotConfigureCompletionHandler: Returns configuration success and error.
///   - enterCameraOtaModeStartingHandler: Called when entry into camera OTA mode starts.
///   - enterCameraOtaModeCompletedHandler: Returns OTA-mode entry success and error.
///   - waitingForHotspotOpenHandler: Called while waiting for the device hotspot to open.
///   - connectDeviceHotspotStartingHandler: Returns the device hotspot SSID.
///   - deviceHotspotConnectCompletionHandler: Returns hotspot connection success and error.
///   - httpServerStartingHandler: Called when the local HTTP server is starting.
///   - httpServerStartCompletionHandler: Returns HTTP server start success and error.
///   - sendingFirmwareUrlHandler: Returns the local firmware URL before it is sent.
///   - firmwareUrlSendCompletionHandler: Returns URL delivery success and error.
///   - startCompletionHandler: Returns Camera OTA start success and error.
///   - fileTransferStartedHandler: Called when firmware transfer starts.
///   - fileTransferCompletedHandler: Called when firmware transfer completes.
///   - waitingForFlashingHandler: Called while the device prepares to flash.
///   - flashingStartedHandler: Called when firmware flashing starts.
///   - flashingCompletedHandler: Called when firmware flashing completes.
///   - phaseProgressHandler: Returns `Transferring` or `Flashing` and progress from `0` to `100`.
///   - completionHandler: Returns final upgrade success and error.
- (void)startCameraOtaWithFilePath:(NSString *_Nonnull)filePath
          configureHotspotStartingHandler:(AIBudsCameraOtaConfigureHotspotStartingHandler _Nullable)
                                              configureHotspotStartingHandler
        hotspotConfigureCompletionHandler:
            (AIBudsCameraOtaHotspotConfigureCompletionHandler _Nullable)
                hotspotConfigureCompletionHandler
        enterCameraOtaModeStartingHandler:
            (AIBudsEnterCameraOtaModeStartingHandler _Nullable)enterCameraOtaModeStartingHandler
       enterCameraOtaModeCompletedHandler:
           (AIBudsEnterCameraOtaModeCompletionHandler _Nullable)enterCameraOtaModeCompletedHandler
             waitingForHotspotOpenHandler:
                 (AIBudsCameraOtaStartingToWaitForHotspotOpenHandler _Nullable)
                     waitingForHotspotOpenHandler
      connectDeviceHotspotStartingHandler:
          (AIBudsCameraOtaConnectDeviceHotspotStartingHandler _Nullable)
              connectDeviceHotspotStartingHandler
    deviceHotspotConnectCompletionHandler:
        (AIBudsCameraOtaDeviceHotspotConnectCompletionHandler _Nullable)
            deviceHotspotConnectCompletionHandler
                httpServerStartingHandler:
                    (AIBudsCameraOtaHttpServerStartingHandler _Nullable)httpServerStartingHandler
         httpServerStartCompletionHandler:
             (AIBudsCameraOtaHttpServerStartCompletionHandler _Nullable)
                 httpServerStartCompletionHandler
                sendingFirmwareUrlHandler:
                    (AIBudsCameraOtaSendingFirmwareUrlHandler _Nullable)sendingFirmwareUrlHandler
         firmwareUrlSendCompletionHandler:
             (AIBudsCameraOtaFirmwareUrlSendCompletionHandler _Nullable)
                 firmwareUrlSendCompletionHandler
                   startCompletionHandler:
                       (AIBudsCameraOtaStartCompletionHandler _Nullable)startCompletionHandler
               fileTransferStartedHandler:
                   (AIBudsCameraOtaFileTransferStartedHandler _Nullable)fileTransferStartedHandler
             fileTransferCompletedHandler:
                 (AIBudsCameraOtaFileTransferCompletedHandler _Nullable)fileTransferCompletedHandler
                waitingForFlashingHandler:
                    (AIBudsCameraOtaWaitingForFlashingHandler _Nullable)waitingForFlashingHandler
                   flashingStartedHandler:
                       (AIBudsCameraOtaFlashingStartedHandler _Nullable)flashingStartedHandler
                 flashingCompletedHandler:
                     (AIBudsCameraOtaFlashingCompletedHandler _Nullable)flashingCompletedHandler
                     phaseProgressHandler:
                         (AIBudsCameraOtaPhaseProgressHandler _Nullable)phaseProgressHandler
                        completionHandler:
                            (AIBudsCameraOtaCompletionHandler _Nullable)completionHandler;

См. startCameraOta в справочнике API.

Возвращаемое значение

Метод не возвращает значение напрямую. Запуск, переходы между этапами, прогресс и окончательный результат передаются через обработчики.

Этапы процесса

Это этапы обратных вызовов процесса Camera OTA, а не значения CameraOtaProgressPhase.

Этап	Связанные обработчики
Настройка точки доступа	`configureHotspotStartingHandler`, `hotspotConfigureCompletionHandler`
Переход в режим Camera OTA	`enterCameraOtaModeStartingHandler`, `enterCameraOtaModeCompletedHandler`
Подключение к точке доступа устройства	`waitingForHotspotOpenHandler`, `connectDeviceHotspotStartingHandler`, `deviceHotspotConnectCompletionHandler`
Запуск локального HTTP-сервера	`httpServerStartingHandler`, `httpServerStartCompletionHandler`
Передача URL прошивки	`sendingFirmwareUrlHandler`, `firmwareUrlSendCompletionHandler`
Запуск обновления	`startCompletionHandler`
Передача прошивки	`fileTransferStartedHandler`, `fileTransferCompletedHandler`
Подготовка и прошивка	`waitingForFlashingHandler`, `flashingStartedHandler`, `flashingCompletedHandler`
Завершение	`completionHandler`

Фазы прогресса

CameraOtaProgressPhase содержит два открытых значения. Аргумент progress — целое число от 0 до 100 для указанной фазы.

Swift	Objective-C	Исходное значение	Значение
`.transferring`	`AIBudsCameraOtaProgressPhaseTransferring`	`1`	Прогресс передачи файла прошивки.
`.flashing`	`AIBudsCameraOtaProgressPhaseFlashing`	`2`	Прогресс прошивки камеры.

Примеры использования

В примерах сохранены все обратные вызовы из демо SDK. В рабочем приложении обновляйте интерфейс в главной очереди.

Swift
Objective-C

guard let cameraOtaDevice = device as? DeviceCameraOtaAPI else {
    print("Camera OTA is not supported")
    return
}

cameraOtaDevice.startCameraOta(
    withFilePath: filePath,
    configureHotspotStartingHandler: {
        print("Configuring device hotspot")
    },
    hotspotConfigureCompletionHandler: { success, error in
        print(
            success
                ? "Hotspot configured"
                : "Hotspot configuration failed: \(error?.localizedDescription ?? "Unknown error")")
    },
    enterCameraOtaModeStartingHandler: {
        print("Entering Camera OTA mode")
    },
    enterCameraOtaModeCompletedHandler: { success, error in
        print(
            success
                ? "Camera OTA mode ready"
                : "Could not enter Camera OTA mode: \(error?.localizedDescription ?? "Unknown error")"
        )
    },
    waitingForHotspotOpenHandler: {
        print("Waiting for device hotspot")
    },
    connectDeviceHotspotStartingHandler: { ssid in
        print("Connecting to \(ssid)")
    },
    deviceHotspotConnectCompletionHandler: { success, error in
        print(
            success
                ? "Device hotspot connected"
                : "Hotspot connection failed: \(error?.localizedDescription ?? "Unknown error")")
    },
    httpServerStartingHandler: {
        print("Starting local HTTP server")
    },
    httpServerStartCompletionHandler: { success, error in
        print(
            success
                ? "HTTP server ready"
                : "HTTP server failed: \(error?.localizedDescription ?? "Unknown error")")
    },
    sendingFirmwareUrlHandler: { firmwareURL in
        print("Sending firmware URL: \(firmwareURL)")
    },
    firmwareUrlSendCompletionHandler: { success, error in
        print(
            success
                ? "Firmware URL sent"
                : "URL delivery failed: \(error?.localizedDescription ?? "Unknown error")")
    },
    startCompletionHandler: { success, error in
        print(
            success
                ? "Camera OTA started"
                : "Camera OTA could not start: \(error?.localizedDescription ?? "Unknown error")")
    },
    fileTransferStartedHandler: {
        print("Firmware transfer started")
    },
    fileTransferCompletedHandler: {
        print("Firmware transfer completed")
    },
    waitingForFlashingHandler: {
        print("Waiting for flashing")
    },
    flashingStartedHandler: {
        print("Firmware flashing started")
    },
    flashingCompletedHandler: {
        print("Firmware flashing completed")
    },
    phaseProgressHandler: { phase, progress in
        switch phase {
        case .transferring:
            print("Transfer: \(progress)%")
        case .flashing:
            print("Flashing: \(progress)%")
        }
    },
    completionHandler: { success, error in
        if success {
            print("Camera OTA completed successfully")
        } else {
            print("Camera OTA failed: \(error?.localizedDescription ?? "Unknown error")")
        }
    }
)

id<AIBudsDeviceCameraOtaAPI> cameraOtaDevice = (id<AIBudsDeviceCameraOtaAPI>)self.device;

if (![cameraOtaDevice conformsToProtocol:@protocol(AIBudsDeviceCameraOtaAPI)]) {
    NSLog(@"Camera OTA is not supported");
    return;
}

[cameraOtaDevice startCameraOtaWithFilePath:filePath
    configureHotspotStartingHandler:^{
        NSLog(@"Configuring device hotspot");
    }
    hotspotConfigureCompletionHandler:^(BOOL success, NSError *_Nullable error) {
        NSLog(@"%@", success ? @"Hotspot configured" : error.localizedDescription);
    }
    enterCameraOtaModeStartingHandler:^{
        NSLog(@"Entering Camera OTA mode");
    }
    enterCameraOtaModeCompletedHandler:^(BOOL success, NSError *_Nullable error) {
        NSLog(@"%@", success ? @"Camera OTA mode ready" : error.localizedDescription);
    }
    waitingForHotspotOpenHandler:^{
        NSLog(@"Waiting for device hotspot");
    }
    connectDeviceHotspotStartingHandler:^(NSString *_Nonnull ssid) {
        NSLog(@"Connecting to %@", ssid);
    }
    deviceHotspotConnectCompletionHandler:^(BOOL success, NSError *_Nullable error) {
        NSLog(@"%@", success ? @"Device hotspot connected" : error.localizedDescription);
    }
    httpServerStartingHandler:^{
        NSLog(@"Starting local HTTP server");
    }
    httpServerStartCompletionHandler:^(BOOL success, NSError *_Nullable error) {
        NSLog(@"%@", success ? @"HTTP server ready" : error.localizedDescription);
    }
    sendingFirmwareUrlHandler:^(NSString *_Nonnull firmwareUrl) {
        NSLog(@"Sending firmware URL: %@", firmwareUrl);
    }
    firmwareUrlSendCompletionHandler:^(BOOL success, NSError *_Nullable error) {
        NSLog(@"%@", success ? @"Firmware URL sent" : error.localizedDescription);
    }
    startCompletionHandler:^(BOOL success, NSError *_Nullable error) {
        NSLog(@"%@", success ? @"Camera OTA started" : error.localizedDescription);
    }
    fileTransferStartedHandler:^{
        NSLog(@"Firmware transfer started");
    }
    fileTransferCompletedHandler:^{
        NSLog(@"Firmware transfer completed");
    }
    waitingForFlashingHandler:^{
        NSLog(@"Waiting for flashing");
    }
    flashingStartedHandler:^{
        NSLog(@"Firmware flashing started");
    }
    flashingCompletedHandler:^{
        NSLog(@"Firmware flashing completed");
    }
    phaseProgressHandler:^(AIBudsCameraOtaProgressPhase phase, NSInteger progress) {
        if (phase == AIBudsCameraOtaProgressPhaseTransferring) {
            NSLog(@"Transfer: %ld%%", (long)progress);
        } else if (phase == AIBudsCameraOtaProgressPhaseFlashing) {
            NSLog(@"Flashing: %ld%%", (long)progress);
        }
    }
    completionHandler:^(BOOL success, NSError *_Nullable error) {
        NSLog(@"%@", success ? @"Camera OTA completed successfully" : error.localizedDescription);
    }];

Обработка ошибок

Ошибки Camera OTA используют AIBudsSDK.CameraOtaErrorDomain и SdkCameraOtaErrorCode. Открытое перечисление охватывает проверку локального файла, сбои сети и точки доступа, жизненного цикла задачи, перехода в режим OTA и передачи URL прошивки.

Коды	Типичная причина
`unknown`, `networkRequestFailed`, `networkTimeout`	SDK не может точнее классифицировать ошибку либо произошёл сетевой сбой.
`cameraOtaFileNotFound`, `invalidCameraOtaFile`, `cameraOtaTaskCreateFailedDueToFileNotFound`	Локальный файл не найден или пакет прошивки недействителен.
`hotspotDisconnectedDuringTransfer`, `invalidHotspotConfig`	Точка доступа устройства работает нестабильно или настроена неверно.
`stageTwoTimeout`, `interruptedByShutdownOrLowBattery`	Прошивка зависла близко к завершению либо устройство прервало обновление.
`cameraOtaTaskAlreadyRunning`	Уже выполняется другая задача Camera OTA.
`4003...4009`	Ошибка подключения, тайм-аут, сбой настройки точки доступа, перехода в OTA, HTTP-сервера или передачи URL.
`5001...5010`	Устройство отклонило переход в OTA или URL из-за команды, хранилища, разрешений, канала или текущего состояния.

Показывайте этап, на котором произошла ошибка, а не общее сообщение об обновлении. После начала прошивки не выполняйте автоматический повтор, отключение, выключение или другой процесс через точку доступа. SDK пока не задаёт безопасные границы повтора: прежде чем предложить другой пакет, проверьте состояние восстановления и версию прошивки камеры.

Примечания

Camera OTA использует локальный файл; SDK не обращается к удалённому сервису обновлений и не загружает пакет.
phaseProgressHandler сообщает только о передаче и прошивке. Для остальных этапов предусмотрены отдельные обратные вызовы.
Значение 100 для передачи ещё не означает завершение Camera OTA: далее выполняется прошивка и приходит финальный результат.
Безопасное автоматическое повторение операции пока не определено открытым контрактом SDK.

Проверка пакета

Настройка точки доступа

Переход в режим OTA

Подключение к точке доступа

Запуск HTTP-сервера

Передача URL прошивки

Передача прошивки

Прошивка камеры

Завершение

Предварительные требования​

Реализация с помощью AI

Справочник API​

Фреймворк​

Импорт​

Протокол​

Метод экземпляра​

Возвращаемое значение​

Этапы процесса​

Фазы прогресса​

Примеры использования​

Обработка ошибок​

Рекомендации​

Примечания​