IoT Platform：Topik

Kategori Topik

Kategori topik didefinisikan dari aspek produk. Setiap kategori topik mencakup satu set topik untuk perangkat yang berbeda dalam produk yang sama. Anda dapat mendefinisikan beberapa kategori topik untuk sebuah produk. Kategori topik berlaku untuk semua perangkat dalam sebuah produk.

Berikut adalah cara menggunakan kategori topik:

• Definisikan fitur untuk kategori topik.

  Kategori topik terdiri dari beberapa bidang yang dipisahkan oleh garis miring (/). Contoh: /${productKey}/${deviceName}/user/update.

  Bidang ${productKey} dan ${deviceName} bersifat tetap. Bidang awalan dan akhiran digunakan untuk mengidentifikasi pesan dengan tujuan yang berbeda.

  • ${productKey}: ProductKey dari produk.

    Anda harus mengganti variabel tersebut dengan ProductKey yang sebenarnya.

  • ${deviceName}: DeviceName dari perangkat.

    Dalam kategori topik, ${deviceName} adalah variabel yang menunjukkan semua perangkat dalam produk. Anda tidak perlu mengganti variabel tersebut dengan DeviceName yang sebenarnya.

• Definisikan izin pada kategori topik.

  • Publish: Perangkat dari suatu produk dapat mempublikasikan pesan ke topik-topik dari kategori topik.

  • Subscribe: Perangkat dari suatu produk dapat berlangganan ke topik-topik dari kategori topik untuk menerima pesan.

  • Publish and Subscribe: Perangkat dapat mempublikasikan pesan ke dan menerima pesan dari topik-topik yang sesuai.

Definisikan Topik

${productKey}/${deviceName} dalam kategori topik menentukan perangkat unik. Topik perangkat dihasilkan setelah kedua variabel diganti dengan nilai sebenarnya.

Topik memiliki format yang sama dengan kategori topik. Perbedaan antara topik dan kategori topik adalah bahwa variabel ${deviceName} dalam kategori topik diganti dengan DeviceName sebenarnya dalam topik.

Contoh berikut menunjukkan topik dari perangkat device1 dan device2 dalam produk a19mzPZ***:

• /a19mzPZ****/device1/user/update

• /a19mzPZ****/device2/user/update

Fitur dan izin dari kategori topik dipetakan ke topik tertentu. Berikut adalah cara menggunakan topik:

• Topik digunakan untuk komunikasi pesan.

  Penting

  Saat men-debug pesan upstream dan downstream, pastikan topik yang ditentukan memiliki izin yang diperlukan.

• Topik hanya dapat digunakan oleh perangkat yang ditentukan.

  Sebagai contoh, topik /a19mzPZ****/device1/user/update milik perangkat bernama Device 1. Hanya Device 1 yang dapat mempublikasikan pesan ke atau menerima pesan dari topik yang dilanggan. Perangkat lain tidak dapat menggunakan topik tersebut.

• Kelola pesan dari perangkat.

  Untuk melihat status perangkat, lakukan langkah-langkah berikut: Masuk ke Konsol IoT Platform dan nonaktifkan perangkat di halaman Devices. Anda juga dapat memanggil operasi DisableThing di server untuk menonaktifkan perangkat. Jika Anda tidak ingin menonaktifkan perangkat, Anda dapat mengelola pesan yang dikirim ke perangkat.

Hasilkan Topik

Gambar berikut menunjukkan cara topik dihasilkan.

1. Masuk ke Konsol IoT Platform dan buat produk. Untuk informasi lebih lanjut, lihat Buat Produk.

   Setelah membuat produk, IoT Platform secara otomatis mendefinisikan kategori topik untuk produk tersebut, termasuk Topics for Basic Communications, Topics for TSL Communications, dan Custom Topics.

   Di halaman Product Details, klik tab Topic Categories untuk melihat kategori topik. Untuk informasi lebih lanjut, lihat Klasifikasi Topik. Di tab Topic Categories, klik Topic Category. Di tab Kategori Topik, klik Edit Kategori Topik, konfigurasikan parameter, lalu klik OK untuk membuat kategori topik kustom untuk produk. Untuk informasi lebih lanjut, lihat Gunakan topik kustom untuk komunikasi.

2. Tambahkan perangkat ke produk. Untuk informasi lebih lanjut, lihat Tambahkan Perangkat.

   Setelah perangkat ditambahkan, semua kategori topik produk secara otomatis dipetakan ke perangkat untuk menghasilkan topik tertentu. Fitur dan izin dari kategori topik juga dipetakan ke topik tertentu. Anda tidak perlu membuat topik untuk setiap perangkat.

   Penting

   • Topik ditampilkan di tab Topic List halaman Device Details hanya setelah Anda mengonfigurasi perangkat dan menghubungkan perangkat ke IoT Platform. Anda dapat menggunakan salah satu metode berikut untuk berlangganan topik di mana perangkat memiliki izin Subscribe dan melihat topik di tab Topic List.

     • Gunakan simulasi perangkat: Setelah perangkat online, IoT Platform secara otomatis berlangganan topik untuk komunikasi dasar dan topik untuk komunikasi Thing Specification Language (TSL) yang memiliki izin Berlangganan pada perangkat. Anda juga dapat berlangganan topik kustom dengan menggunakan fitur Upstream Debug dari topik kustom di halaman Simulasi Perangkat.

     • Gunakan MQTT.fx untuk mensimulasikan perangkat dan menghubungkan perangkat ke IoT Platform: Setelah perangkat online, Anda dapat menggunakan fitur Subscribe untuk berlangganan topik.

     • Kembangkan Link SDK untuk menghubungkan perangkat ke IoT Platform, aktifkan perangkat, lalu berlangganan topik. Untuk informasi lebih lanjut, lihat Langkah 3.

     • SubscribeTopic: Setelah Anda menghubungkan perangkat yang dikonfigurasi atau disimulasikan ke IoT Platform dan perangkat online seperti yang diharapkan, Anda dapat memanggil operasi ini untuk berlangganan topik untuk perangkat.

   • Saat men-debug pesan hulu dan hilir, pastikan topik yang ditentukan memiliki izin yang diperlukan.

     Di tab Topic Categories halaman Product Details, Anda dapat melihat parameter Allowed Operations dari setiap topik.

3. Konfigurasikan perangkat dan hubungkan perangkat ke IoT Platform.

   Sebelum perangkat dapat berkomunikasi dengan IoT Platform dan menggunakan banyak fitur IoT Platform, perangkat harus berlangganan topik terkait. Anda juga harus menentukan logika untuk mempublikasikan pesan ke topik yang memiliki izin Publikasikan. Untuk informasi lebih lanjut tentang cara mengonfigurasi perangkat, lihat Dokumentasi Link SDK.

   • Perangkat dapat mengirim perintah SUB untuk berlangganan topik tertentu dan mendapatkan pesan dari IoT Platform. Untuk informasi lebih lanjut tentang cara mengonfigurasi perangkat, lihat Dokumentasi Link SDK.

     Link SDK for C versi 3.1, 3.2, dan 4.x yang disediakan oleh IoT Platform mendukung langganan topik otomatis. Untuk informasi lebih lanjut tentang topik yang didukung, lihat Langganan Topik Otomatis.

     Penting

     Perangkat dapat berlangganan topik sistem yang telah ditentukan sebelumnya di IoT Platform, seperti /sys/${productKey}/${deviceName}/thing/service/property/set. Perangkat tidak dapat menggunakan ekspresi /sys/${productKey}/${deviceName}/# untuk berlangganan topik sistem yang namanya dimulai dengan /sys/${productKey}/${deviceName}.

   • Perangkat dapat mengirim pesan ke IoT Platform dengan mengirim perintah PUB ke topik yang memiliki izin Publikasikan. Untuk informasi lebih lanjut tentang cara mengonfigurasi perangkat, lihat Dokumentasi Link SDK.

   Verifikasi perangkat dan hubungkan perangkat ke IoT Platform. Untuk informasi lebih lanjut, lihat Verifikasi Perangkat.

   Setelah perangkat mengirim perintah SUB untuk berlangganan topik, lakukan langkah-langkah berikut untuk melihat topik: Masuk ke Konsol IoT Platform, pilih Devices > Devices, temukan perangkat, lalu klik View di kolom Aksi. Di halaman Device Details, klik Topic List. Di tab yang muncul, semua topik yang dilanggan ditampilkan di bagian Subscribed Topics.

   Catatan

   Perangkat dapat mengirim perintah UNSUB untuk berhenti berlangganan dari topik tertentu. Kemudian, topik tersebut dihapus dari bagian Subscribed Topics.

Gunakan Topik untuk Komunikasi

Gambar berikut menunjukkan proses komunikasi setelah perangkat terhubung ke IoT Platform.

Klasifikasikan Topik

Topik diklasifikasikan menjadi topik untuk komunikasi dasar, topik untuk komunikasi TSL, dan topik kustom. Tabel berikut menjelaskan jenis-jenis topik.

Batasan

Jumlah topik dalam kategori topik untuk suatu produk sama dengan jumlah perangkat yang ditambahkan ke produk tersebut. Untuk informasi lebih lanjut, lihat Batasan.