Azure IoT Hub (TsgcIoTAzure_MQTT_Client) — sgcWebSockets

DE UN VISTAZO

TsgcIoTAzure_MQTT_Client

Cliente MQTT 3.1.1 de Azure IoT Hub — autenticación con token SAS o X.509, device twin (desired/reported), métodos directos, mensajes nube-a-dispositivo y convenciones de topics específicas de Azure.

Clase del componente

TsgcIoTAzure_MQTT_Client

Protocolo

Azure IoT Hub MQTT

Plataformas

Windows, macOS, Linux, iOS, Android

Edición

Standard / Professional / Enterprise

INICIO RÁPIDO

Configura el hub, configura credenciales, conecta

Configura el host del IoT Hub, deviceId y la clave SAS (o el certificado X.509), luego conéctate para suscribirte a $iothub/twin/... y publicar en devices/<id>/messages/events/.

uses
  sgcIoT;

var
  Azure: TsgcIoTAzure_MQTT_Client;
begin
  Azure := TsgcIoTAzure_MQTT_Client.Create(nil);
  Azure.IoT.Host     := '.azure-devices.net';
  Azure.IoT.DeviceId := 'sensor-001';

  // autenticación con token SAS
  Azure.IoT.Authentication := iotAuth_SAS;
  Azure.IoT.SAS.Key := 'base64-shared-access-key';

  Azure.OnMQTTConnect := procedure(Connection: TsgcWSConnection;
    const Session: Boolean; const ReasonCode: Integer;
    const ReasonName: string;
    const ConnectProperties: TsgcWSMQTTCONNACKProperties)
  begin
    // suscríbete a mensajes nube-a-dispositivo
    Azure.Subscribe('devices/sensor-001/messages/devicebound/#');

    // suscríbete a actualizaciones de propiedades deseadas del twin
    Azure.Subscribe('$iothub/twin/PATCH/properties/desired/#');
  end;

  Azure.Active := True;

  // publica telemetría
  Azure.Publish('devices/sensor-001/messages/events/',
    '{"temp":22.5}');
end;

// uses: sgcIoT
TsgcIoTAzure_MQTT_Client *Azure = new TsgcIoTAzure_MQTT_Client(this);
Azure->IoT->Host     = ".azure-devices.net";
Azure->IoT->DeviceId = "sensor-001";
Azure->IoT->Authentication = iotAuth_SAS;
Azure->IoT->SAS->Key = "base64-shared-access-key";

Azure->Active = true;

CARACTERÍSTICAS TÉCNICAS

Qué incluye

Un cliente MQTT preconfigurado para Azure IoT Hub que construye las cadenas de username/password/topic que Microsoft espera.

Autenticación con token SAS

Configura IoT.Authentication := iotAuth_SAS y proporciona la clave del dispositivo — el componente genera tokens SAS de corta duración con el URI de recurso correcto y los firma con HMAC-SHA256.

Autenticación X.509

Configura IoT.Authentication := iotAuth_Certificate y carga el certificado hoja / clave privada — admite tanto el thumbprint del IoT Hub como flujos firmados por CA.

Device twin

Suscríbete a $iothub/twin/PATCH/properties/desired/# para recibir cambios en propiedades deseadas; publica en $iothub/twin/PATCH/properties/reported/?$rid= para actualizar el estado reportado.

Métodos directos

Suscríbete a $iothub/methods/POST/# para invocaciones entrantes de métodos directos; responde en $iothub/methods/res/<status>/?$rid=<id> con la carga útil de respuesta.

Nube-a-dispositivo

Suscríbete a devices/<id>/messages/devicebound/# para mensajes encolados por el hub. El componente los entrega en el evento estándar OnMQTTPublish.

A prueba de reconexión

WatchDog en el cliente subyacente reautentica (nuevo token SAS) y se vuelve a suscribir a cada topic activo al reconectar — la aplicación ve un flujo continuo.

ESTÁNDARES

Especificaciones y referencias

Fuentes autorizadas del protocolo que implementa este componente.

RECURSOS

Documentación y demos

Accede a la referencia del componente, descarga el proyecto demo listo para ejecutar y la versión de prueba.

	Ayuda en línea — TsgcIoTAzure_MQTT_Client Referencia completa de propiedades, métodos y eventos de este componente.	Abrir
	Proyecto demo — Demos\10.IoT_Clients Proyecto de ejemplo listo para ejecutar. Se incluye dentro del paquete sgcWebSockets — descarga la prueba abajo.	Abrir
	Documento técnico (PDF) Características, inicio rápido, ejemplos de código para Delphi y C++ Builder y referencias a fuentes primarias — solo este componente.	Abrir
	Manual de usuario (PDF) Manual completo que cubre cada componente de la biblioteca.	Abrir

Azure IoT Hub