Compartir a través de


azure-iot-device package

Clases

Message

El objeto Message se usa para la telemetría (dispositivo a nube) y la mensajería asincrónica (de nube a dispositivo) entre el dispositivo y el servicio IoT Hub. Es independiente del transporte, lo que significa que funciona de la misma manera a través de AMQP, MQTT y HTTP.

Client

Cliente de dispositivo de IoT Hub que se usa para conectar un dispositivo con una instancia de Azure IoT Hub.

Los usuarios del SDK deben llamar a uno de los métodos de fábrica, fromConnectionString o fromSharedAccessSignature para crear un cliente de dispositivo de IoT Hub.

DeviceMethodRequest

Representa los datos pasados del servicio al dispositivo cuando se llama a un método de dispositivo desde la nube. Una instancia de esta clase se pasa a la devolución de llamada registrada a través de onDeviceMethod(string, (request: DeviceMethodRequest, response: DeviceMethodResponse) => void).

DeviceMethodResponse

se proporciona un objeto DeviceMethodResponse al usuario con cada DeviceMethodRequest que permite al usuario construir y enviar una respuesta con formato correcto al servicio para cada llamada al método de dispositivo. Una instancia de esta clase se pasa como segundo parámetro a la devolución de llamada registrada a través de onDeviceMethod(string, (request: DeviceMethodRequest, response: DeviceMethodResponse) => void).

IotEdgeAuthenticationProvider

Proporciona una implementación de AuthenticationProvider que delega la generación de tokens a iotedged. Esta implementación está pensada para usarse al usar el cliente del módulo con Azure IoT Edge.

Este tipo hereda de SharedAccessKeyAuthenticationProvider y es funcionalmente idéntico a ese tipo, excepto la parte de generación de tokens que invalida mediante la implementación del método _sign.

ModuleClient

Cliente de dispositivo de IoT Hub que se usa para conectar un dispositivo con una instancia de Azure IoT Hub.

Los usuarios del SDK deben llamar a uno de los métodos de fábrica, fromConnectionString o fromSharedAccessSignature para crear un cliente de dispositivo de IoT Hub.

SharedAccessKeyAuthenticationProvider

Proporciona un objeto AuthenticationProvider que se puede crear simplemente con una cadena de conexión y, a continuación, lo usa el cliente del dispositivo y los transportes para autenticarse con la instancia de Azure IoT Hub.

El objeto SharedAccessKeyAuthenticationProvider se encarga de crear tokens de firma de acceso compartido en una cadencia regular y emite el evento newTokenAvailable para que los transportes renueven sus credenciales con la instancia de Azure IoT Hub y permanezcan conectados.

SharedAccessSignatureAuthenticationProvider

Proporciona un objeto AuthenticationProvider que se puede crear simplemente con una firma de acceso compartido y, a continuación, lo usa el cliente del dispositivo y los transportes para autenticarse con la instancia de Azure IoT Hub.

El objeto SharedAccessSignatureAuthenticationProvider no renueva automáticamente el token de firma de acceso compartido, por lo que el usuario debe alimentar los tokens de firma de acceso compartido no expirados mediante el método updateSharedAccessSignature. Para cada llamada a este método, el SharedAccessSignatureAuthenticationProvider emitirá un evento newTokenAvailable que los transportes usarán para autenticarse con la instancia de Azure IoT Hub.

Twin

Un dispositivo gemelo está documentando el estado de un dispositivo almacenado por una instancia de Azure IoT Hub y está disponible incluso si el dispositivo está sin conexión. Se construye alrededor de 3 secciones:

  • Etiquetas: pares clave-valor solo accesibles desde el lado del servicio
  • Propiedades deseadas: actualizadas por un servicio y recibidas por el dispositivo
  • Propiedades notificadas: actualizadas por el dispositivo y recibidas por el servicio.

Tenga en cuenta que, aunque es una posibilidad, las propiedades deseadas y notificadas no tienen que coincidir y que la lógica para sincronizar estas dos colecciones, si es necesario, se deja al usuario del SDK.

Para obtener más información, consulte Understanding Device Twins.

X509AuthenticationProvider

Proporciona un objeto AuthenticationProvider que se puede crear simplemente con un certificado y una clave X509 y, a continuación, lo usa el cliente del dispositivo y los transportes para autenticarse con la instancia de Azure IoT Hub.

A diferencia de los objetos SharedAccessSignatureAuthenticationProvider y SharedAccessKeyAuthenticationProvider, el X509AuthenticationProvider no emite un evento de newTokenAvailable, ya que no hay ningún token implicado en la autenticación X509. Los transportes obtendrán las credenciales mediante el método getDeviceCredentials.

Interfaces

AmqpTransportOptions

Opciones específicas del transporte AMQP.

Esto se pasa a setOptions como una propiedad denominada http dentro de un objeto DeviceClientOptions.

Ver

DeviceClientOptions

Opciones para el objeto Client. Se pasa a la función setOptions .

de ejemplo de

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

Estructura de opciones usada para configurar la frecuencia con la que el receptor HTTP sondea los mensajes. Cada una de estas opciones es mutuamente excluyente, excepto el drain booleano. Solo una interval, at, cron o manualPolling estará presente en la estructura de opciones.

Esto se configura llamando a setOptions con esta propiedad denominada receivePolicy dentro de un objeto httpTransportOptions de que está dentro de un objeto DeviceClientOptions.

Ver

HttpTransportOptions

Estructura de opciones para pasar parámetros de configuración opcionales al transporte Http.

Esto se pasa a setOptions como una propiedad denominada http dentro de un objeto DeviceClientOptions.

Ver

MqttTransportOptions

Opciones específicas del transporte MQTT

Esto se pasa a setOptions como una propiedad denominada mqtt dentro de un objeto DeviceClientOptions.

TwinProperties

Contiene las propiedades deseadas y notificadas para el gemelo.

Alias de tipos

BufferConvertible

Funciones

getUserAgentString(NoErrorCallback<string>)
getUserAgentString()
getUserAgentString(string, NoErrorCallback<string>)
getUserAgentString(string)

Detalles de la función

getUserAgentString(NoErrorCallback<string>)

function getUserAgentString(done: NoErrorCallback<string>)

Parámetros

done

NoErrorCallback<string>

getUserAgentString()

function getUserAgentString(): Promise<string>

Devoluciones

Promise<string>

getUserAgentString(string, NoErrorCallback<string>)

function getUserAgentString(productInfo: string, done: NoErrorCallback<string>)

Parámetros

productInfo

string

done

NoErrorCallback<string>

getUserAgentString(string)

function getUserAgentString(productInfo: string): Promise<string>

Parámetros

productInfo

string

Devoluciones

Promise<string>