Gunakan topik kustom untuk komunikasi - IoT Platform

Kategori topik kustom mencakup semua topik yang digunakan oleh perangkat dalam suatu produk. Bagian ini menjelaskan cara mendefinisikan kategori topik kustom untuk sebuah produk dan cara menggunakan topik kustom untuk komunikasi.

Informasi latar belakang

Untuk informasi lebih lanjut tentang cara mendefinisikan dan menggunakan topik, lihat Topik.

Tambahkan kategori topik kustom

Masuk ke Konsol IoT Platform.
Di halaman Overview, klik All environment. Pada tab All environment, temukan instance yang ingin dikelola dan klik ID atau nama instance tersebut.
Di panel navigasi sebelah kiri, pilih Devices > Products.
Di halaman Products, temukan produk tempat Anda ingin menambahkan kategori topik kustom dan klik View.
Di halaman Product Details, pilih Topic Categories > Topic Category > Edit Topic Category.

Di kotak dialog Edit Kategori Topik, konfigurasikan parameter yang diperlukan dan klik OK. Tabel berikut menggambarkan parameter tersebut.

Parameter	Deskripsi
Otorisasi Operasi Perangkat	Izin perangkat pada kategori topik. Nilai valid: Publish, Subscribe, dan Publish and Subscribe.
Kategori Topik	Kategori topik terdiri dari beberapa bidang. Pisahkan bidang dengan garis miring (`/`). Nama dapat berisi huruf, angka, dan garis bawah (_). Setiap bidang dari kategori topik tidak boleh kosong. Jika Anda menggunakan produk gateway cloud, tidak ada awalan yang ditentukan secara otomatis. Anda harus menentukan nilai kustom untuk parameter ini. Nilai tersebut dapat berisi karakter wildcard, termasuk tanda tambah (`+`) dan tanda pagar (`#`). Anda dapat menggunakan variabel `${deviceName}` untuk menentukan NamaPerangkat. Jika Anda menggunakan produk non-cloud gateway, perhatikan item berikut: Jika Anda menetapkan parameter Otorisasi Operasi Perangkat dari kategori topik menjadi Subscribe, Anda dapat menentukan karakter wildcard tanda tambah (`+`) dan tanda pagar (`#`) dalam kategori topik untuk memungkinkan perangkat berlangganan beberapa topik secara bersamaan. `/${productKey}/${deviceName}/user/` ditentukan secara otomatis sebagai awalan nilai parameter. Anda hanya perlu menentukan nama kustom untuk kategori topik. Catatan Untuk informasi lebih lanjut tentang cara menggunakan karakter wildcard, lihat Topik kustom dengan karakter wildcard.
Aktifkan Langganan Delegasi	Parameter ini tersedia hanya jika Anda menetapkan parameter Otorisasi Operasi Perangkat menjadi Subscribe atau Publish and Subscribe. Jika langganan delegasi diaktifkan, IoT Platform membantu perangkat menyelesaikan langganan ketika perangkat produk terhubung ke IoT Platform.
Aktifkan Kompresi atau Dekompresi	Anda dapat mengaktifkan kompresi dan dekompresi data untuk topik kustom instance Exclusive Enterprise Edition. Untuk informasi lebih lanjut tentang fitur ini, lihat Kompresi data.
Deskripsi	Deskripsi kategori topik. Anda dapat mengonfigurasi parameter ini untuk membedakan fitur-fitur dari kategori topik yang berbeda.

Kelola kategori topik

Pada tab Topic Category, temukan kategori topik kustom. Anda dapat melakukan beberapa operasi pada kategori topik tersebut. Tabel berikut menggambarkan operasi yang tersedia.

Operasi	Prosedur
Ubah kategori topik	Klik Edit di kolom Actions. Di kotak dialog Edit Topic Category, ubah parameter Device Operation Authorizations, Topic Category, dan Description. Di pesan yang muncul, klik OK.
Hapus kategori topik	Peringatan Setelah Anda menghapus kategori topik kustom, layanan komunikasi yang terkait dengan kategori topik kustom menjadi tidak tersedia. Ini dapat mengganggu bisnis Anda. Lanjutkan dengan hati-hati. Klik Delete di kolom Actions. Di pesan yang muncul, klik OK.
Tentukan apakah akan mengaktifkan langganan delegasi	Temukan kategori topik yang parameternya Device Operation Authorizations disetel ke Berlangganan atau Publikasikan dan Berlangganan dan matikan atau nyalakan Enable Delegated Subscription.

Topik kustom dengan karakter wildcard

Tabel berikut menggambarkan karakter wildcard yang dapat digunakan saat mengonfigurasi kategori topik kustom di Konsol IoT Platform.

Catatan

Topik yang mencakup satu atau lebih karakter wildcard mewakili sekumpulan topik. Jika Anda memberikan izin Publikasikan atau Berlangganan pada topik dan perangkat berlangganan ke topik tersebut, Anda tidak dapat menggunakan topik untuk mengirim pesan.

Pada tab Topic List halaman detail perangkat, tindakan Publish Message tidak tersedia untuk topik tersebut. Anda tidak dapat mengirim pesan ke perangkat menggunakan topik tersebut.

Karakter wildcard

Deskripsi

Karakter wildcard ini harus ditentukan untuk bidang terakhir dalam topik dan dapat mencocokkan semua nilai bidang di tingkat saat ini dan sub-tingkat.

Sebagai contoh, Anda membuat kategori topik /a1aycMA****/${deviceName}/user/#. Jika Perangkat 1 berlangganan ke topik /a1aycMA****/device1/user/#, perangkat tersebut berlangganan ke semua topik yang dimulai dengan /a1aycMA****/device1/user/, termasuk /a1aycMA****/device1/user/update dan /a1aycMA****/device1/user/update/error.

Karakter wildcard ini dapat mencocokkan semua nilai bidang di tingkat saat ini.

Sebagai contoh, Anda membuat kategori topik /a1aycMA****/${deviceName}/user/+/error. Jika Perangkat 1 berlangganan ke topik /a1aycMA****/device1/user/+/error, perangkat tersebut berlangganan ke beberapa topik, seperti /a1aycMA****/device1/user/get/error dan /a1aycMA****/device1/user/update/error.

Komunikasi berbasis topik kustom

Dari IoT Platform ke Perangkat
IoT Platform memanggil operasi API Pub untuk mempublikasikan pesan ke topik. Perangkat menerima pesan dari IoT Platform dengan berlangganan ke topik tersebut.
Dari Perangkat ke IoT Platform
Perangkat mempublikasikan pesan ke topik kustom. IoT Platform dapat menerima pesan dari perangkat dengan menggunakan langganan server-side AMQP (Advanced Message Queuing Protocol) atau fitur penerusan data.

Untuk informasi lebih lanjut tentang cara menggunakan topik kustom, lihat Gunakan Topik Kustom untuk Komunikasi.