Hub-SDK-Client

Nehmen Sie die Header-Dateien (.h) und die Dateien mit gemeinsam genutzten Objekten (.so) in Ihre Anwendung auf.

Sie müssen die öffentlichen Header-Dateien (.h) und Shared Object-Dateien (.so) in Ihre Anwendung aufnehmen. Die .so-Dateien können Sie in einem lib-Ordner ablegen. Das endgültige Layout wird dem folgenden ähneln:

├── include
│   ├── iotmi_device_sdk_client
│   │   └── iotmi_device_sdk_client_common_types.h
│   ├── iotmi_device_sdk_client.h
│   └── iotshd_status.h
├── lib
│   ├── libiotmi_devicesdk_client_module.so
│   └── libiotmi_log_c.so

Erstellen Sie einen Hub-SDK-Client in Ihrer Hauptanwendung.

1. In Ihrer Hauptanwendung müssen Sie zuerst den Hub SDK-Client initialisieren, bevor er zur Bearbeitung von Anfragen verwendet werden kann. Sie können den Client einfach mit einem clientId erstellen.

2. Sobald Sie den Client haben, können Sie ihn mit dem Geräte-SDK für verwaltete Integrationen verbinden.

   Im Folgenden finden Sie ein Beispiel für die Erstellung des Hub SDK-Clients und für die Herstellung einer Verbindung.

   #include <cstdlib>
   #include <string>
   #include "iotshd_status.h"
   #include "iotmi_device_sdk_client.h"
   
   auto client = std::make_unique<DeviceSDKClient>(your_own_clientId);
   iotmi_statusCode_t status = client->connect();

   Anmerkung

   your_own_clientIdmuss mit dem identisch sein, den Sie start-device-discoveryin der benutzergeführten Einrichtung oder create-managed-thingim Bereitstellungsablauf für die einfache Einrichtung angegeben haben.

Veröffentlichen und abonnieren Sie, indem Sie die folgenden Schritte ausführen.

1. Nachdem die Verbindung hergestellt wurde, können Sie jetzt eingehende Aufgaben über das Hub-SDK für verwaltete Integrationen abonnieren. Bei den eingehenden Aufgaben kann es sich um Steuerungs- oder Bereitstellungsaufgaben handeln. Sie müssen auch Ihre eigene Rückruffunktion für eingegangene Aufgaben und Ihren eigenen benutzerdefinierten Kontext für Ihre eigenen Nachverfolgungszwecke definieren.

         // subscribe to provisioning tasks
         iotmi_statusCode_t status = client->iotmi_provision_subscribe_to_tasks(
         example_subscriber_callback, custom_context);
         
         // subscribe to control tasks
         iotmi_statusCode_t status = client->iotmi_control_subscribe_to_tasks(
         example_subscriber_callback, custom_context);

2. Nachdem die Verbindung hergestellt wurde, können Sie nun Anfragen aus Ihrer Anwendung im Hub-SDK für verwaltete Integrationen veröffentlichen. Sie können Ihren eigenen Aufgabennachrichtentyp mit unterschiedlichen Payloads für unterschiedliche Geschäftszwecke definieren. Die Anfragen können sowohl Kontroll- als auch Bereitstellungsanforderungen enthalten, ähnlich wie beim Abonnement-Flow. Schließlich können Sie Ihnen eine Adresse zuweisen, rspPayload um die Antwort vom Hub-SDK für verwaltete Integrationen synchronisiert zu erhalten.

   // publish control request
     iotmi_client_request_t api_payload = {
               .messageType = C2MIMessageType::C2MI_CONTROL_EVENT,
               .reqPayload = (uint8_t *)"define_your_req_payload",
               .rspPayload = (uint8_t *)calloc(1000, sizeof(uint8_t))
     };
   
     status = client->iotmi_control_publish_request(&api_payload); 
     
     // publish provision request 
     iotmi_client_request_t api_payload = {
               .messageType = C2MIMessageType::C2MI_DEVICE_ONBOARDED,
               .reqPayload = (uint8_t *)"define_your_req_payload",
               .rspPayload = (uint8_t *)calloc(1000, sizeof(uint8_t))
     };
     status = client->iotmi_provision_publish_request(&api_payload);
     

Erstellen Sie Ihre eigene CMakeLists.txt und erstellen Sie Ihre Anwendung von dort aus. Die endgültige Ausgabe könnte eine ausführbare Binärdatei sein, wie MyFirstApplication