Perhatian! Program Pratinjau Developer yang baru akan segera diluncurkan. Daftar di sini dan jadilah salah satu developer pertama yang mencoba alat baru serta berikan masukan.

Halaman ini diterjemahkan oleh Cloud Translation API.

Switch to English

Perangkat Virtual Matter

Masalah SDK Perangkat

Perangkat virtual Matter berguna untuk mengembangkan dan menguji solusi Matter, serta dapat digunakan Google Home app (GHA), dan dikontrol menggunakan GHA serta Google Assistant, sama seperti perangkat Matter fisik.

Untuk developer aplikasi dan orang lain yang perlu menguji atau mengemulasikan perangkat Matter virtual, tetapi tidak memiliki resource untuk mem-build perangkat fisik atau virtual Matter milik mereka sendiri, Google menawarkan Matter Virtual Device (MVD). MVD adalah alat desktop Linux mandiri yang ringan yang menyimulasikan berbagai jenis perangkat Matter virtual dan menyediakan antarmuka pengguna grafis untuk mengontrol dan menampilkan status perangkat Matter virtual.

Tidak seperti perangkat Matter fisik, MVD tidak mengandalkan Bluetooth® Energi Rendah (BLE) atau Thread® untuk bergabung dengan kain Matter. Sebagai gantinya, opsi ini menggunakan koneksi jaringan Wi-Fi yang sudah ada pada komputer Linux host untuk komisi.

Dibandingkan dengan alat lain

MVD berbeda dengan Virtual Device Controller (VDC) karena merupakan solusi mandiri, yang menggabungkan perangkat virtual dengan UI untuk mengontrolnya. Sebaliknya, VDC digunakan untuk mengontrol perangkat Matter virtual terpisah, seperti perangkat yang kita buat di Matter Virtual Device Development Environment (MVD-DE).

Anda mungkin sudah menggunakan codelab MVD-DE. Dalam codelab ini, Anda akan mem-build satu jenis perangkat virtual, yaitu bohlam smart. Sebaliknya, MVD berisi beberapa perangkat virtual bawaan yang berbeda dan menyertakan UI terintegrasi untuk menjalankan dan mengontrolnya.

*Tabel: Perbandingan alat perangkat Matter virtual*
	MVD	VDC	MVD-DE (Codelab)
Mengemulasi perangkat Matter
Mengontrol perangkat Matter yang diemulasikan
Perlu upaya pengembangan
Download	kurang dari 100 MB	9 GB	20 GB

Perangkat yang didukung

Saat ini, MVD mendukung jenis perangkat Matter berikut:

*Tabel: Matter jenis perangkat yang didukung untuk MVD*
Matter Jenis Perangkat	Cluster Aplikasi	Jenis Ekosistem Rumah
Cahaya Suhu Warna	0x0300 0x0008 0x0006	Terang
Cahaya yang Dapat Diredupkan	0x0008 0x0006	Terang
Cahaya Warna Diperpanjang	0x0300 0x0008 0x0006	Terang
Sensor Jumlah Tamu	0x0406	Sensor
Lampu Nyala/Mati	0x0008 0x0006	Terang
Unit Plugin Aktif/Nonaktif	0x0008 0x0006	Stopkontak

Instal MVD

MVD berjalan di mesin prosesor x86 64 bit yang menjalankan Debian (11 atau yang lebih baru) atau Ubuntu (20.04 atau yang lebih baru).

Untuk menginstalnya:

Download paket MVD Debian (.deb)

Download file tanda tangan ASCII (.asc) berlapis baja

Kemudian, jalankan dpkg untuk menginstal paket MVD Debian (.deb):

sudo dpkg -i mvd_1.1.0_amd64.deb

Memeriksa penggunaan port

Modul pengontrol di MVD menggunakan port TCP 33000 untuk melakukan panggilan RPC ke perangkat virtual, jadi jika port ini sudah digunakan oleh proses lain di komputer Anda, pastikan untuk membebaskannya.

Untuk melihat apakah ada proses yang menggunakan port 33000:

sudo fuser -v 33000/tcp

Anda dapat menghentikan proses apa pun menggunakan port TCP 33000 dengan satu perintah:

sudo fuser -k 33000/tcp

Jalankan MVD

Jalankan MVD dari folder aplikasi Anda atau dari terminal:

mvd

Mengonfigurasi perangkat

Layar utama muncul saat peluncuran, dan memungkinkan Anda mengonfigurasi perangkat virtual:

Device Type: Pilih jenis perangkat (misalnya, Light, Switch, Sensor dan sebagainya).
Nama Perangkat: Beri nama yang mudah digunakan pada perangkat.
Discriminator: Angka 12 bit yang digunakan untuk membedakan beberapa iklan perangkat yang menggunakan komisi. (Default: 3840)
Matter Port: Port untuk Matter komisi dan komunikasi melalui jaringan IP. Matter menggunakan port TCP/UDP 5540 secara default, tetapi Anda dapat mengonfigurasi perangkat virtual untuk menggunakan port yang berbeda, selama tidak ada layanan lain yang menggunakannya.
ID Vendor: Saat ini hanya ID vendor pengujian 0xFFF1 yang didukung.
ID Produk: Saat ini hanya ID produk pengujian 0x8000 hingga 0x801F yang didukung.

Layar konfigurasi Perangkat
Virtual

Konfigurasi firewall Anda

Jika Anda memiliki firewall yang berjalan di komputer, nonaktifkan atau izinkan koneksi TCP/UDP masuk di port Matter.

Untuk melihat aturan firewall yang aktif untuk netfilter, jalankan:

sudo iptables -L -n

Catatan: Jika Anda menggunakan ufw, fitur tersebut dapat dinonaktifkan dengan:

sudo ufw disable

dan dapat diaktifkan kembali dengan:

sudo ufw enable

Menjalankan perangkat Anda

Setelah perangkat dikonfigurasi, klik Buat perangkat. Saat perangkat dibuat, layar Pengontrol akan muncul. Bergantung pada jenis perangkat yang dipilih, Anda mungkin melihat satu atau beberapa kontrol berikut:

Aktif/Nonaktif: Di sebagian besar perangkat.
Level: Misalnya, lampu dapat memiliki penggeser level untuk menyesuaikan kecerahan.
Warna: Misalnya, lampu warna dapat memiliki kontrol ini.
Hunian: Sensor Occupancy menawarkan kontrol ini, untuk menyimulasikan status terisi/tidak terisi.

Semua perangkat virtual memiliki kontrol berikut:

QRCode: Menampilkan kode QR yang digunakan untuk komisi.
Mulai ulang: Memulai ulang perangkat virtual. Perangkat terputus dari jaringan sebentar.
Reset: Mereset perangkat saat ini ke setelan pabrik dan menghapus semua status, termasuk komisi, status kontrol saat ini, dan sebagainya
Hapus: Menghancurkan perangkat dan kembali ke layar Buat perangkat.

Layar kontrol Perangkat
Virtual

Komisikan perangkat Anda

Perangkat dapat digunakan segera setelah dibuat.

Ada beberapa prasyarat untuk memesan perangkat:

Anda harus memiliki project di Google Home Developer Console. Project ini harus berisi integrasi Matter yang memiliki kombinasi VID/PID yang sama dengan yang Anda gunakan dalam menyiapkan perangkat virtual. Lihat panduan pembuatan project untuk mengetahui detailnya.
Anda harus memiliki Google Nest Hub yang mendukung Matter
Anda harus memiliki ponsel Android yang menjalankan Android 8.1 atau yang lebih baru, dengan GHA yang diinstal.
Ponsel Android harus terhubung ke jaringan Wi-Fi yang sama dengan hub.
Mesin host harus terhubung ke jaringan Wi-Fi.

Untuk memesan perangkat menggunakan GHA, klik QRCode untuk menampilkan kode QR perangkat, lalu ikuti petunjuk di Menghubungkan perangkat Matter yang menjelaskan cara mengaktivasi perangkat Matter menggunakan GHA. Anda juga dapat memesan perangkat menggunakan Google Home Sample App for Matter.

Lihat Matter Primer kami untuk mempelajari cara kerja Komisi Matter.

Mengontrol perangkat

Setelah memesan perangkat virtual, Anda dapat mengontrol perangkat menggunakan Aplikasi Google Home atau Asisten Google dengan suara. Anda dapat:

Mengontrol perangkat melalui GHA atau Assistant saat memantau perubahan status pada perangkat virtual, atau
Mengontrol perangkat menggunakan Sample App for Matter saat memantau perubahan status di perangkat virtual,atau
Mengontrol status perangkat melalui MVD itu sendiri saat memantau perubahan status di GHA atau Assistant.

Menguji dengan perangkat

Untuk menguji dengan Assistant, sebaiknya gunakan simulator ucapan seperti Ekstensi Google Home untuk Kode VS atau Plugin Google Home untuk Android Studio.

Melihat detail perangkat

Layar Detail perangkat menampilkan informasi perangkat secara mendetail:

Nama: Nama yang dikenal yang diberikan ke perangkat.
Device Type: Jenis perangkat yang dipilih.
Diskriminator: Diskriminator perangkat saat ini.
ID Vendor: ID vendor perangkat saat ini.
ID Produk: ID produk perangkat saat ini.
Port RPC: Port RPC yang berkomunikasi dengan perangkat dengan pengontrol (GUI).
Port Matter: Port yang digunakan oleh perangkat saat ini untuk berkomunikasi melalui jaringan IP.
Kode Sandi: PIN yang digunakan untuk menetapkan perangkat melalui jaringan.
Configuration Folder: Folder yang digunakan perangkat virtual untuk menyimpan konfigurasi.
Informasi Komisi: Menampilkan kain yang digunakan perangkat dan ID node perangkat di kain

Lihat log perangkat

Jika Anda meluncurkan MVD dari terminal, output log akan muncul di stdout. Anda juga dapat melihat log perangkat di tab Log perangkat.

Hentikan perangkat

Untuk menghentikan dan menghancurkan perangkat, klik Hapus.

Menghentikan aplikasi

Menutup jendela kontrol akan menghapus perangkat dan menghentikan aplikasi MVD. Jika diluncurkan dari terminal, Anda juga dapat menghentikan aplikasi dengan mengetik Ctrl-C di terminal.

Dapatkan bantuan

Untuk mendapatkan bantuan terkait MVD, melaporkan bug, atau meminta fitur baru, hubungi kontak dukungan Google Anda.

Mengklik tombol bantuan di sudut kanan atas jendela akan membawa Anda ke halaman ini.

Laporkan bug

Jika Anda merasa telah menemukan kerusakan di MVD, Anda dapat melaporkan bug dengan mengklik tombol Issue di pojok kanan atas jendela.

Kirim masukan

Untuk menyampaikan pendapat Anda tentang MVD atau cara kami dapat meningkatkan pengalaman Anda dengan alat ini, lengkapi Formulir Masukan kami.

Formulir dapat diluncurkan dari tombol masukan di pojok kanan atas jendela, atau dengan mengklik tombol di bawah.

Kirimkan masukan Anda