azure-iothub package

O cliente de serviço do Hub IoT é usado para se comunicar com dispositivos por meio de um Hub IoT do Azure. Ele permite que o usuário do SDK:

• enviar nuvem para dispositivo (também conhecido como comandos) para dispositivos: os comandos são enfileirados no Hub IoT e entregues de forma assíncrona somente quando o dispositivo está conectado. Somente 50 comandos podem ser enfileirados por dispositivo.
• invocar métodos diretos em dispositivos (que funcionarão somente se o dispositivo estiver conectado no momento: ele é uma maneira síncrona de se comunicar com o dispositivo)
• ouça mensagens de comentários enviadas por dispositivos para comandos anteriores.
• ouça as notificações de upload de arquivos de dispositivos.

Os usuários devem criar novas instâncias de Client chamando um dos métodos de fábrica, deConnectionString ou fromSharedAccessSignature, para criar um cliente de serviço do Hub IoT.

Cria uma representação de um dispositivo para uso com as APIs do registro de identidade do dispositivo.

Essa classe foi preterida porque o registro de identidade do dispositivo pode funcionar diretamente com objetos JSON que contêm uma descrição parcial do dispositivo, não necessariamente o objeto completo. Além disso, inicialmente, essa classe foi enviada com um erro de digitação no nome da propriedade symmetricKey (foi caso pascal em vez de maiúsculas e minúsculas). O SDK mantém essa classe por perto para não quebrar o código existente, mas isso será removido em uma atualização de versão principal futura e os clientes devem usar objetos JSON sem formatação.

Fornece métodos para criar, atualizar, monitorar e cancelar trabalhos de execução longa em uma instância do Hub IoT, bem como consultar trabalhos existentes. A API de Trabalhos no Hub IoT do Azure permite agendar chamadas de método direto e atualizações de gêmeos em vários dispositivos.

Espera-se que os usuários do SDK criem instâncias JobClient usando os métodos de fábrica fromConnectionString(string) e fromSharedAccessSignature(string).

A classe Registro fornece acesso ao serviço de identidade de dispositivo do Hub IoT. Os usuários do SDK devem criar uma instância dessa classe com um dos métodos de fábrica: deConnectionString ou fromSharedAccessSignature.

O protocolo usado para operações de registro de identidade do dispositivo é HTTPS.

A classe de transporte usada pelo cliente de serviço para se conectar ao hub IoT do Azure usando o protocolo AMQP em um soquete TLS seguro. Essa classe não deve ser usada diretamente e, em vez disso, ser passada para um dos métodos de fábrica Client: deConnectionString ou fromSharedAccessSignature.

A classe de transporte usada pelo cliente de serviço para se conectar ao hub IoT do Azure usando o protocolo AMQP em websockets seguros. Essa classe não deve ser usada diretamente e, em vez disso, ser passada para um dos métodos de fábrica Client: deConnectionString ou fromSharedAccessSignature.

Cria assinaturas de acesso compartilhado com base na cadeia de conexão passada para o construtor. Essa classe é usada pela camada de protocolo do SDK para adicionar cabeçalhos de autenticação a cada solicitação.

Um Dispositivo Gêmeo é um documento que descreve o estado de um dispositivo armazenado por um hub IoT do Azure e está disponível mesmo que o dispositivo esteja offline. Ele é criado em torno de três seções:

• Marcas: pares chave/valor acessíveis somente do lado do serviço
• Propriedades Desejadas: atualizadas por um serviço e recebidas pelo dispositivo
• Propriedades relatadas: atualizadas pelo dispositivo e recebidas pelo serviço.

Observe que, embora seja uma possibilidade, as propriedades desejadas e relatadas não precisam corresponder e que a lógica para sincronizar essas duas coleções, se necessário, é deixada para o usuário do SDK.

Para obter mais informações, consulte Noções básicas sobre dispositivos gêmeos.

A maneira recomendada de obter um Twin para um dispositivo específico é usar o método getTwin(string, HttpResponseCallback<Twin>).

O objeto Configuration representa a configuração de um único dispositivo ou pode representar uma implantação que pode ser aplicada como uma configuração a dispositivos com base no targetCondition.

Descreve os parâmetros disponíveis para uso com métodos diretos (também chamados de métodos de dispositivo)