Hub SDK 用戶端

在您的應用程式中包含標頭檔案 (.h) 和共用物件檔案 (.so)。

您必須在應用程式中包含公有標頭檔案 (.h) 和共用物件檔案 (.so)。對於 .so 檔案，您可以將它們放在 lib 資料夾中。最終配置將與此類似：

├── 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

在主要應用程式中建立 Hub SDK 用戶端。

1. 在主要應用程式中，您必須先初始化 Hub SDK 用戶端，才能用來處理請求。您可以直接使用 建構用戶端clientId。

2. 擁有用戶端之後，您可以將其連線至受管整合裝置 SDK。

   以下是建立 Hub SDK 用戶端以及如何連線的範例。

   #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();

   注意

   your_own_clientId 必須與您在使用者引導設定中 start-device-discovery 中指定的相同，或在簡單設定佈建流程中用於 create-managed-thing。

執行下列步驟來發佈和訂閱 。

1. 建立連線後，您現在可以訂閱來自受管整合 Hub SDK 的傳入任務。傳入的任務可以是控制任務或佈建任務。您也需要在收到任務時定義自己的回呼函數，以及您自己的自訂內容，以用於您自己的追蹤目的。

         // 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. 建立連線之後，您現在可以從應用程式將請求發佈到受管整合中樞 SDK。您可以定義自己的任務訊息類型，針對不同的業務用途使用不同的承載。請求可以同時包含控制請求和佈建請求，類似於訂閱流程。最後，您可以為 指派地址rspPayload，以同步方式從受管整合中樞開發套件取得回應。

   // 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);
     

建置您自己的 CMakeLists.txt，並從那裡建置您的應用程式。最終輸出可以是可執行的二進位檔，例如 MyFirstApplication