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. クライアントを取得したら、マネージド統合 Device 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. 接続が確立されたら、アプリケーションからマネージドインテグレーション Hub SDK にリクエストを発行できるようになりました。独自のタスクメッセージタイプを定義し、ビジネス目的に応じてペイロードを変更できます。リクエストには、サブスクライブフローと同様に、コントロールリクエストとプロビジョニングリクエストの両方を含めることができます。最後に、 のアドレスを割り当てrspPayloadて、 マネージド統合 Hub SDK から同期された方法でレスポンスを取得できます。

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