Klien Hub SDK

Sertakan file header (.h) dan file objek bersama (.so) dalam aplikasi Anda.

Anda harus menyertakan file header publik (.h) dan file objek bersama (.so) dalam aplikasi Anda. Untuk file.so, Anda dapat menempatkannya di folder lib. Tata letak akhir akan mirip dengan ini:

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

Buat klien Hub SDK di aplikasi utama Anda.

1. Di aplikasi utama Anda, Anda harus terlebih dahulu menginisialisasi klien Hub SDK sebelum dapat digunakan untuk memproses permintaan. Anda dapat dengan mudah membangun klien denganclientId.

2. Setelah Anda memiliki klien, Anda dapat menghubungkannya ke integrasi terkelola Device SDK.

   Berikut ini adalah contoh pembuatan klien Hub SDK dan cara menghubungkannya.

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

   catatan

   your_own_clientIdharus sama dengan yang Anda tentukan start-device-discoverydalam pengaturan yang dipandu pengguna, atau untuk create-managed-thingdalam alur penyediaan pengaturan sederhana.

Publikasikan dan berlangganan dengan melakukan langkah-langkah berikut.

1. Setelah koneksi dibuat, Anda sekarang dapat berlangganan tugas masuk dari integrasi terkelola Hub SDK. Tugas yang masuk dapat berupa tugas kontrol atau tugas penyediaan. Anda juga perlu menentukan fungsi callback Anda sendiri pada tugas yang diterima, dan konteks kustom Anda sendiri untuk tujuan penelusuran Anda sendiri.

         // 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. Setelah koneksi dibuat, Anda sekarang dapat mempublikasikan permintaan dari aplikasi Anda ke integrasi terkelola Hub SDK. Anda dapat menentukan jenis pesan tugas Anda sendiri, dengan muatan yang berbeda untuk tujuan bisnis yang berbeda. Permintaan dapat mencakup permintaan kontrol dan permintaan ketentuan, mirip dengan alur berlangganan. Terakhir, Anda dapat menetapkan alamat rspPayload untuk mendapatkan respons dari integrasi terkelola Hub SDK dengan cara yang disinkronkan.

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

Bangun aplikasi Anda sendiri CMakeLists.txt dan bangun aplikasi Anda dari sana. Output akhir bisa berupa biner yang dapat dieksekusi seperti MyFirstApplication