IoT Platform:Contoh

Prosedur

1. Inisialisasi klien.

   Untuk informasi lebih lanjut, lihat Langkah 1: Inisialisasi Klien.

2. Konfigurasikan fitur yang diperlukan.

   Untuk informasi lebih lanjut, lihat Langkah 2: Konfigurasi Fitur.

3. Buat koneksi.

   Untuk informasi lebih lanjut, lihat Langkah 3: Buat Koneksi.

4. Opsional. Jika Anda ingin mengirim pesan siaran ke semua perangkat dalam suatu produk, perangkat harus memanggil fungsi aiot_mqtt_sub untuk berlangganan topik tertentu.

   • Kode contoh:

         {
             char *sub_topic = "/broadcast/a18wP******/test";
     
             res = aiot_mqtt_sub(mqtt_handle, sub_topic, NULL, 1, NULL);
             if (res < 0) {
                 printf("aiot_mqtt_sub gagal, res: -0x%04X\n", -res);
                 return -1;
             }
         }

   • Parameter:

     Parameter	Contoh	Deskripsi
     sub_topic	/broadcast/a18wP******/test	Topik tempat pesan siaran dikirim. Format: /broadcast/${productKey}/<bidang kustom>. Parameter dalam contoh ini: a18wP****** adalah ProductKey dari perangkat. test menunjukkan bidang kustom. Untuk informasi lebih lanjut, lihat Topik.

5. Terima pesan siaran.

   1. Setelah perangkat terhubung ke IoT Platform, Anda dapat memanggil operasi PubBroadcast dari IoT Platform untuk mengirim pesan siaran ke perangkat.

      Penting

      Disarankan untuk mengirim maksimal satu pesan siaran per menit untuk mencegah pembatasan laju.

      Untuk informasi lebih lanjut, lihat Pesan Siaran.

   2. Perangkat memanggil fungsi aiot_mqtt_recv untuk menerima pesan siaran. Kemudian, fungsi callback dipanggil untuk melakukan operasi yang diperlukan.

      Dalam contoh ini, fungsi callback bernama demo_mqtt_default_recv_handler digunakan.

   3. Tentukan fungsi callback untuk memproses pesan siaran.

      Periksa apakah pesan tersebut merupakan pesan siaran berdasarkan format topik.

      • Jika Anda ingin mengirim pesan siaran ke semua perangkat online dari suatu produk, perangkat tidak perlu berlangganan topik siaran. Setelah setiap perangkat menerima pesan siaran, Anda dapat memeriksa apakah pesan tersebut merupakan pesan siaran berdasarkan format topik siaran. Format topik siaran adalah /sys/${productKey}/${deviceName}/broadcast/request/${MessageId}.

      • Jika Anda ingin mengirim pesan siaran ke semua perangkat yang berlangganan topik siaran kustom, perangkat harus berlangganan topik tersebut. Format topik siaran kustom adalah /broadcast/${productKey}/<bidang kustom>.

      Anda dapat menentukan logika pemrosesan callback sesuai dengan kebutuhan bisnis Anda. Dalam contoh ini, pesan siaran dicetak.

      void demo_mqtt_default_recv_handler(void *handle, const aiot_mqtt_recv_t *packet, void *userdata)
      {
          switch (packet->type) {
              ……
              ……
              case AIOT_MQTTRECV_PUB: {
                  printf("pub, qos: %d, topic: %.*s\n", packet->data.pub.qos, packet->data.pub.topic_len, packet->data.pub.topic);
                  printf("pub, payload: %.*s\n", packet->data.pub.payload_len, packet->data.pub.payload);
                  /* TODO: Cetak pesan siaran */           
              }
              break;
      
              ……
              ……       
      
              default: {
      
              }
          }
      }

6. Tutup koneksi.

   Untuk informasi lebih lanjut, lihat Langkah 8: Putuskan Koneksi Perangkat dari IoT Platform.

7. Keluar dari program.

   Untuk informasi lebih lanjut, lihat Langkah 9: Keluar dari Program.