azure-iot-device package

O Message objeto é usado para telemetria (dispositivo para nuvem) e comandos (nuvem para dispositivo) mensagens assíncronas entre o dispositivo e o serviço de Hub IoT. Ele é independente de transporte, o que significa que funciona da mesma maneira em AMQP, MQTT e HTTP.

Hub IoT cliente de dispositivo usado para conectar um dispositivo com um hub IoT do Azure.

Os usuários do SDK devem chamar um dos métodos de fábrica, fromConnectionString ou fromSharedAccessSignature para criar um cliente de dispositivo Hub IoT.

Representa os dados passados do serviço para o dispositivo quando um método de dispositivo é chamado da nuvem. Uma instância dessa classe é passada para o retorno de chamada registrado por meio de onDeviceMethod(string, (request: DeviceMethodRequest, response: DeviceMethodResponse) => void).

um objeto é fornecido ao usuário com cada DeviceMethodRequest um DeviceMethodResponse permitindo que o usuário construa e envie uma resposta bem formatada de volta ao serviço para cada chamada de método de dispositivo. Uma instância dessa classe é passada como o segundo parâmetro para o retorno de chamada registrado por meio onDeviceMethod(string, (request: DeviceMethodRequest, response: DeviceMethodResponse) => void)de .

Fornece uma implementação AuthenticationProvider que delega a geração de token a iotedged. Essa implementação deve ser usada ao usar o cliente do módulo com o IoT Edge do Azure.

Esse tipo herda de SharedAccessKeyAuthenticationProvider e é funcionalmente idêntico a esse tipo, exceto para a parte de geração de token que ele substitui implementando o _sign método .

Hub IoT cliente de dispositivo usado para conectar um dispositivo com um hub IoT do Azure.

Os usuários do SDK devem chamar um dos métodos de fábrica, fromConnectionString ou fromSharedAccessSignature para criar um cliente de dispositivo Hub IoT.

Fornece um AuthenticationProvider objeto que pode ser criado simplesmente com uma cadeia de conexão e, em seguida, é usado pelo cliente do dispositivo e transportes para autenticar com a instância do Hub IoT do Azure.

O SharedAccessKeyAuthenticationProvider objeto cuida da criação de tokens de assinatura de acesso compartilhado em uma cadência regular e emite o newTokenAvailable evento para que os transportes renovem suas credenciais com a instância do hub IoT do Azure e permaneçam conectados.

Fornece um AuthenticationProvider objeto que pode ser criado simplesmente com uma assinatura de acesso compartilhado e, em seguida, é usado pelo cliente do dispositivo e transportes para autenticar com a instância do Hub IoT do Azure.

O SharedAccessSignatureAuthenticationProvider objeto não renova automaticamente o token de assinatura de acesso compartilhado, portanto, o usuário precisa alimentar tokens de assinatura de acesso compartilhado não expirados para ele usando o updateSharedAccessSignature método . Para cada chamada a esse método, o SharedAccessSignatureAuthenticationProvider emitirá um newTokenAvailable evento que os transportes usarão para autenticar com a instância do Hub IoT do Azure.

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.

Fornece um AuthenticationProvider objeto que pode ser criado simplesmente com um certificado X509 e uma chave e, em seguida, é usado pelo cliente do dispositivo e transportes para autenticar com a instância do Hub IoT do Azure.

Ao contrário dos SharedAccessSignatureAuthenticationProvider objetos e SharedAccessKeyAuthenticationProvider , o X509AuthenticationProvider não emite um newTokenAvailable evento, pois não há nenhum token envolvido na autenticação X509. Os transportes obterão as credenciais usando o getDeviceCredentials método .

Opções específicas para o transporte AMQP.

Isso é passado para setOptions como uma propriedade chamada http dentro de um objeto DeviceClientOptions .

Consulte

Opções para o objeto Client. Passado para a função setOptions .

Exemplo

 var options = {
   cert: myX509Certificate,
   key: myX509Key,
   http: {
     receivePolicy: {
       interval: 10
     }
   }
 }
 client.setOptions(options, callback);

Estrutura de opções usada para configurar a frequência com que o receptor HTTP sonda mensagens. Cada uma dessas opções é mutuamente exclusiva, exceto para o drain booliano. Apenas um interval, atcron ou manualPolling deve estar presente na estrutura de opções.

Isso é configurado chamando setOptions com isso como uma propriedade chamada receivePolicy dentro de um objeto HttpTransportOptions que está dentro de um objeto DeviceClientOptions .

Consulte

Estrutura de opções para passar parâmetros de configuração opcionais para o Transporte Http.

Isso é passado para setOptions como uma propriedade chamada http dentro de um objeto DeviceClientOptions .

Consulte

Opções específicas para o transporte MQTT

Isso é passado para setOptions como uma propriedade chamada mqtt dentro de um objeto DeviceClientOptions .

Contém as propriedades desejadas e relatadas para o Gêmeo.