Características pós-comissionamento para integração de câmeras

Os traits que podem ser usados depois que o dispositivo é provisionado são:

OtaSoftwareUpdateRequestorTrait

Esse trait fornece uma interface para monitorar uma atualização de software OTA no dispositivo da câmera. Depois de provisionada, a câmera inicia a atualização e informa o estado dela ao app. Quando o app recebe o status de que a atualização de software foi concluída, a câmera pode começar a transmissão ao vivo.

O exemplo de código e a explicação a seguir demonstram como o trait pode ser usado.

device.types.subscribe(OtaRequestorDeviceType.self)
  .receive(on: DispatchQueue.main)
  .compactMap { $0.traits[Matter.OtaSoftwareUpdateRequestorTrait.self] }
  .removeDuplicates()
  .timeout(.seconds(30), scheduler: DispatchQueue.main)
  .sink { [weak self] completion in
    guard let self else { return }
    Logger.debug("OTA trait subscription completed unexpectedly: \(completion).")
    if case .otaDownload = self.step {
      Logger.debug("Advancing to settings step due to OTA trait subscription completion")
      self.step = .settings
    }
  } receiveValue: { [weak self] otaTrait in
    Logger.debug(
      "OTA update is in progress, state: \(otaTrait.attributes.updateState), progress: \(otaTrait.attributes.updateStateProgress ?? 0)"
    )

    self.step = .otaDownload(
      state: otaTrait.attributes.updateState ?? .querying,
      progress: Double(otaTrait.attributes.updateStateProgress ?? 0) / 100.0)
    }
  }
  .store(in: &cancellables)

  • Como se inscrever em traits de dispositivos: ele se inscreve nos traits do dispositivo, procurando especificamente o OtaSoftwareUpdateRequestorTrait para detectar informações de atualização OTA.

  • Como definir um tempo limite: ele define um tempo limite de 30 segundos. Se nenhuma atualização for recebida do trait dentro desse período, a assinatura será encerrada.

  • Como processar atualizações de status OTA (receiveValue): quando o OtaSoftwareUpdateRequestorTrait fornece um novo status, esse bloco é executado. Ele registra o estado atual e o progresso da atualização OTA. Em seguida, atualiza o estado interno do aplicativo (step) para refletir essas novas informações.

  • Como processar a conclusão (sink): esse bloco é executado quando a assinatura termina e registra a conclusão. Se o processo estava em um estado de download, o estado do aplicativo avança para a próxima etapa (.settings).

  • Como gerenciar o ciclo de vida da assinatura: a .store(in: &cancellables) linha garante que a assinatura seja gerenciada e cancelada corretamente quando o objeto que a possui é desalocado.

Para mais informações, consulte a referência do trait OtaSoftwareUpdateRequestorTrait.

ConfigurationDoneTrait

Esse trait não é necessário para a ativação da câmera, mas permite que o app acompanhe quando o dispositivo estiver totalmente configurado e utilizável, definindo o atributo AppConfigurationComplete como true. Esse trait precisa ser usado após o OtaSoftwareUpdateRequestorTrait.

let configDoneTrait = try await device.types.get(OtaRequestorDeviceType.self)?.traits[Google.ConfigurationDoneTrait.self]
_ = try await configDoneTrait?.update {
  $0.setAppConfigurationComplete(true)
}