Condividi tramite


azure-iot-device package

Classi

Message

L'oggetto Message viene usato per la telemetria (device-to-cloud) e i comandi (cloud-to-device) messaggistica asincrona tra il dispositivo e il servizio hub IoT. Si tratta di trasporto agnostico, ovvero funziona allo stesso modo su AMQP, MQTT e HTTP.

Client

hub IoT client del dispositivo usato per connettere un dispositivo con un hub IoT di Azure.

Gli utenti dell'SDK devono chiamare uno dei metodi factory, daConnectionString o daSharedAccessSignature per creare un client del dispositivo hub IoT.

DeviceMethodRequest

Rappresenta i dati passati dal servizio al dispositivo quando viene chiamato un metodo dispositivo dal cloud. Un'istanza di questa classe viene passata al callback registrato tramite onDeviceMethod(string, (request: DeviceMethodRequest, response: DeviceMethodResponse) => void).

DeviceMethodResponse

un DeviceMethodResponse oggetto viene fornito all'utente con ogni DeviceMethodRequest utente che consente all'utente di costruire e inviare una risposta ben formattata al servizio per ogni chiamata al metodo del dispositivo. Un'istanza di questa classe viene passata come secondo parametro al callback registrato tramite onDeviceMethod(string, (request: DeviceMethodRequest, response: DeviceMethodResponse) => void).

IotEdgeAuthenticationProvider

Fornisce un'implementazione AuthenticationProvider che delega la generazione di token a iotedged. Questa implementazione deve essere usata quando si usa il client del modulo con Azure IoT Edge.

Questo tipo eredita da SharedAccessKeyAuthenticationProvider e è funzionalmente identico a tale tipo, ad eccezione della parte di generazione del token che esegue l'override implementando il _sign metodo.

ModuleClient

hub IoT client del dispositivo usato per connettere un dispositivo con un hub IoT di Azure.

Gli utenti dell'SDK devono chiamare uno dei metodi factory, daConnectionString o daSharedAccessSignature per creare un client del dispositivo hub IoT.

SharedAccessKeyAuthenticationProvider

Fornisce un AuthenticationProvider oggetto che può essere creato semplicemente con una stringa di connessione e viene quindi usato dal client del dispositivo e i trasporti per l'autenticazione con l'istanza dell'hub IoT di Azure.

L'oggetto SharedAccessKeyAuthenticationProvider si occupa della creazione di token di firma di accesso condiviso in una frequenza regolare e genera l'evento newTokenAvailable per i trasporti per rinnovare le credenziali con l'istanza dell'hub IoT di Azure e rimanere connessi.

SharedAccessSignatureAuthenticationProvider

Fornisce un AuthenticationProvider oggetto che può essere creato semplicemente con una firma di accesso condiviso e viene quindi usato dal client del dispositivo e i trasporti per eseguire l'autenticazione con l'istanza dell'hub IoT di Azure.

L'oggetto SharedAccessSignatureAuthenticationProvider non rinnova automaticamente il token di firma di accesso condiviso, quindi l'utente deve inviare token di firma di accesso condiviso non scaduti a tale token usando il updateSharedAccessSignature metodo . Per ogni chiamata a questo metodo, verrà SharedAccessSignatureAuthenticationProvider generato un newTokenAvailable evento che i trasporti useranno per l'autenticazione con l'istanza dell'hub IoT di Azure.

Twin

Un dispositivo gemello è un documento che descrive lo stato di un dispositivo archiviato da un hub IoT di Azure ed è disponibile anche se il dispositivo è offline. Si basa su 3 sezioni:

  • Tag: coppie chiave/valore accessibili solo dal lato servizio
  • Proprietà desiderate: aggiornata da un servizio e ricevuta dal dispositivo
  • Proprietà segnalate: aggiornate dal dispositivo e ricevute dal servizio.

Si noti che, anche se è una possibilità, le proprietà desiderate e segnalate non devono corrispondere e che la logica per sincronizzare queste due raccolte, se necessario, viene lasciata all'utente dell'SDK.

Per altre informazioni, vedere Informazioni sui dispositivi gemelli.

X509AuthenticationProvider

Fornisce un AuthenticationProvider oggetto che può essere creato semplicemente con un certificato e una chiave X509 e viene quindi usato dal client del dispositivo e i trasporti per eseguire l'autenticazione con l'istanza dell'hub IoT di Azure.

A differenza degli oggetti eSharedAccessKeyAuthenticationProvider, l'oggetto SharedAccessSignatureAuthenticationProviderX509AuthenticationProvider non genera un newTokenAvailable evento poiché non sono presenti token coinvolti nell'autenticazione X509. I trasporti otterranno le credenziali usando il getDeviceCredentials metodo .

Interfacce

AmqpTransportOptions

Opzioni specifiche del trasporto AMQP.

Questa operazione viene passata a setOptions come proprietà denominata http all'interno di un oggetto DeviceClientOptions .

Vedere

DeviceClientOptions

Opzioni per l'oggetto Client. Passato alla funzione setOptions .

Esempio

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

Struttura delle opzioni usata per configurare la frequenza con cui il ricevitore HTTP esegue il polling dei messaggi. Ognuna di queste opzioni è reciprocamente esclusiva, ad eccezione del drain booleano. Nella struttura delle opzioni è presente solo un intervaloggetto , atcron o manualPolling .

Questa configurazione viene configurata chiamando setOptions con questa proprietà denominata receivePolicy all'interno di un oggetto HttpTransportOptions che si trova all'interno di un oggetto DeviceClientOptions .

Vedere

HttpTransportOptions

Struttura delle opzioni per passare i parametri di configurazione facoltativi nel trasporto Http.

Questa operazione viene passata a setOptions come proprietà denominata http all'interno di un oggetto DeviceClientOptions .

Vedere

MqttTransportOptions

Opzioni specifiche del trasporto MQTT

Questa operazione viene passata a setOptions come proprietà denominata mqtt all'interno di un oggetto DeviceClientOptions .

TwinProperties

Contiene le proprietà desiderate e segnalate per il gemello.

Alias tipo

BufferConvertible

Funzioni

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

Dettagli funzione

getUserAgentString(NoErrorCallback<string>)

function getUserAgentString(done: NoErrorCallback<string>)

Parametri

done

NoErrorCallback<string>

getUserAgentString()

function getUserAgentString(): Promise<string>

Restituisce

Promise<string>

getUserAgentString(string, NoErrorCallback<string>)

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

Parametri

productInfo

string

done

NoErrorCallback<string>

getUserAgentString(string)

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

Parametri

productInfo

string

Restituisce

Promise<string>