Partager via


azure-iothub package

Classes

Client

Le client de service IoT Hub est utilisé pour communiquer avec les appareils via un hub Azure IoT. Il permet à l’utilisateur du Kit de développement logiciel (SDK) :

  • envoyer des commandes cloud-à-appareil (également appelées commandes) aux appareils : les commandes sont mises en file d’attente sur IoT Hub et remises de manière asynchrone uniquement lorsque l’appareil est connecté. Seules 50 commandes peuvent être mises en file d’attente par appareil.
  • appeler des méthodes directes sur des appareils (qui fonctionnent uniquement si l’appareil est actuellement connecté : il s’agit d’un moyen synchrone de communiquer avec l’appareil)
  • écoutez les messages de commentaires envoyés par les appareils pour les commandes précédentes.
  • écoutez les notifications de chargement de fichiers à partir d’appareils.

Les utilisateurs doivent créer de nouvelles instances Client en appelant l’une des méthodes de fabrique, fromConnectionString ou à partir deSharedAccessSignature, pour créer un client de service IoT Hub.

Device

Crée une représentation d’un appareil à utiliser avec le registre d’identités d’appareil API.

Cette classe est déconseillée, car le registre d’identités d’appareil peut fonctionner directement avec des objets JSON contenant une description partielle de l’appareil, pas nécessairement l’objet complet. Au-dessus de cela initialement cette classe a été livré avec une faute de frappe sur le nom de la propriété symmetricKey (il a été casé pascal au lieu de chameau cased). Le Kit de développement logiciel (SDK) conserve cette classe afin de ne pas rompre le code existant, mais il sera supprimé dans une prochaine mise à jour de version majeure et les clients doivent utiliser plutôt des objets JSON bruts.

JobClient

Fournit des méthodes pour créer, mettre à jour, surveiller et annuler des travaux de longue durée sur une instance IoT Hub, ainsi que pour interroger des travaux existants. L’API Travaux dans Azure IoT Hub permet de planifier des appels de méthode directs et des mises à jour de jumeaux sur plusieurs appareils.

Les utilisateurs du Kit de développement logiciel (SDK) doivent créer des instances JobClient à l’aide des méthodes de fabrique fromConnectionString(string) et fromSharedAccessSignature(string).

Registry

La classe Registry fournit l’accès au service d’identité d’appareil IoT Hub. Les utilisateurs du Kit de développement logiciel (SDK) doivent instancier cette classe avec l’une des méthodes de fabrique : fromConnectionString ou fromSharedAccessSignature.

Le protocole utilisé pour les opérations de Registre des identités d’appareil est HTTPS.

Amqp

Classe de transport utilisée par le client de service pour se connecter au hub Azure IoT à l’aide du protocole AMQP via un socket SÉCURISÉ (TLS). Cette classe ne doit pas être utilisée directement et être passée à l’une des méthodes de fabrique Client : fromConnectionString ou fromSharedAccessSignature.

AmqpWs

Classe de transport utilisée par le client de service pour se connecter au hub Azure IoT à l’aide du protocole AMQP sur des websockets sécurisés. Cette classe ne doit pas être utilisée directement et être passée à l’une des méthodes de fabrique Client : fromConnectionString ou fromSharedAccessSignature.

DigitalTwinClient
IoTHubTokenCredentials

Crée des signatures d’accès partagé en fonction de la chaîne de connexion transmise au constructeur. Cette classe est utilisée par la couche de protocole du Kit de développement logiciel (SDK) pour ajouter des en-têtes d’authentification à chaque requête.

Twin

Un jumeau d’appareil est un document décrivant l’état d’un appareil stocké par un hub Azure IoT et disponible même si l’appareil est hors connexion. Il est construit autour de 3 sections :

  • Étiquettes : paires clé/valeur uniquement accessibles du côté service
  • Propriétés souhaitées : mise à jour par un service et reçue par l’appareil
  • Propriétés signalées : mise à jour par l’appareil et reçue par le service.

Notez que bien qu’il soit possible, les propriétés souhaitées et signalées n’ont pas besoin de correspondre et que la logique de synchronisation de ces deux collections, si nécessaire, est laissée à l’utilisateur du Kit de développement logiciel (SDK).

Pour plus d’informations, consultez Understanding Device Twins.

La méthode recommandée pour obtenir un Twin pour un appareil spécifique consiste à utiliser la méthode getTwin(string, HttpResponseCallback<Twin>).

Interfaces

ServiceReceiver
Transport
TransportConfigOptions
Authentication
Capabilities
X509Thumbprints
BulkRegistryOperationResult
DeviceDescription
DeviceRegistryOperationError
JobStatus
QueryDescription
RegistryStatistics
TransportConfig
Configuration

L’objet Configuration représente la configuration d’un seul appareil ou peut représenter un déploiement qui peut être appliqué en tant que configuration aux appareils en fonction de targetCondition.

ConfigurationContent
ConfigurationMetrics
DeviceMethodParams

Décrit les paramètres disponibles pour une utilisation avec des méthodes directes (également appelées méthodes d’appareil)

Module

Alias de type

TransportCtor
ConnectionState
DeviceStatus
JobCallback
BulkRegistryOperationType
JobCallback
ResponseCallback