Mulai tahun 2026, semua integrasi dan pengujian Matter akan memerlukan Uji Interop Alliance. Untuk mengetahui informasi selengkapnya, lihat halaman transisi Alliance Interop Test Lab.

Google uses AI technology to translate content into your preferred language. AI translations can contain errors.

Mulai menggunakan Matter

Program Developer Home Google memungkinkan produsen perangkat menghubungkan perangkat smart home mereka dengan ekosistem Google Home. Kami memperluas jalur fulfillment lokal Smart Home Actions dengan kemampuan untuk menambahkan perangkat yang kompatibel dengan Matter-enabled untuk penyiapan menggunakan Google Home app (GHA) dan mengontrolnya menggunakan Google Assistant, GHA, atau layar smart seperti Google Nest Hub (2nd gen).

Dokumentasi ini menjelaskan cara memulai membangun dan mengintegrasikan platform yang mendukung Matter di ekosistem Google Home.

Pernyataan penyangkalan

Terkait prosedur yang dijelaskan dalam Matter dokumentasi, perhatikan hal berikut:

Sebaiknya akun yang digunakan untuk pengembangan hanya memiliki satu Matter-enabled hub yang terhubung untuk pengujian. Beberapa hub yang kompatibel dengan Matter-enabled yang terhubung secara bersamaan atau terhubung ke struktur yang sama selama pengujian dapat menyebabkan perilaku yang tidak dapat diprediksi.
Semua prosedur mengasumsikan penggunaan mesin Linux yang menjalankan Ubuntu 20.04 untuk membangun dan mem-flash Matter sampel, yang telah diuji oleh Google. Meskipun mesin macOS didukung, Linux direkomendasikan. Petunjuk khusus untuk Mac akan dipanggil dalam prosedur sesuai kebutuhan.

Cara membuat agen

Untuk membuat perangkat yang kompatibel dengan Matter yang terintegrasi dengan ekosistem Google Home, Anda akan menggunakan papan pengembangan yang kompatibel dengan Matter dan Matter SDK.

Cara termudah untuk memulai adalah dengan mempelajari codelab kami. Sebaiknya lakukan setidaknya salah satu codelab berikut:

Setelah itu, lihat daftar perangkat yang didukung untuk memastikan bahwa hal yang Anda rencanakan untuk diintegrasikan didukung di ekosistem Google Home. Kemudian, baca Checklist Developer untuk memahami seluruh alur pengembangan dari pembuatan project hingga peluncuran.

Perangkat yang Didukung Checklist Developer

Definisi

Istilah berikut digunakan di seluruh dokumentasi ini:

Router pembatas: Hub yang menerapkan Router Pembatas Threadtujuan umum untuk perangkat yang kompatibel dengan Thread.
Hub: Perangkat Google Nest yang didukung, seperti Google Nest Hub (2nd gen). Hub diperlukan untuk mengontrol perangkat yang kompatibel dengan Matter melalui platform lain seperti Assistant, GHA, dan layar smart.
Perangkat yang kompatibel dengan Matter: Perangkat atau papan pengembangan yang telah di-flash dengan build atau aplikasi contoh yang kompatibel dengan Matter Matter.
Perangkat seluler: Ponsel pengujian yang digunakan untuk membantu proses pairing. Saat ini, ponsel tersebut adalah ponsel Android phone.

Prasyarat

Ekstensi IDE yang direkomendasikan untuk pengembangan Matter

Agar dapat mengintegrasikan perangkat yang kompatibel dengan Matter sepenuhnya dengan ekosistem Google Home, developer harus memiliki:

Hub Google dengan dukungan Thread untuk berfungsi sebagai Router Pembatas untuk perangkat yang kompatibel dengan Thread dan sebagai jalur fulfillment lokal untuk merutekan intent Smart Home.
Perangkat seluler (ponsel pengujian) yang memenuhi persyaratan minimum:
- Android O (8.1, level API 27 atau yang lebih baru)
- iOS (v16.5 atau yang lebih baru)
- Kemampuan BLE
ID Vendor (VID) dan ID Produk (PID) untuk perangkat yang Matter kompatibel.
Perangkat yang kompatibel dengan Matter. Perangkat ini harus merupakan salah satu jenis perangkat Matter yang didukung di ekosistem Google Home, dan dapat berupa:
- Produk Anda sendiri dengan firmware yang kompatibel dengan Matter.
- Salah satu perangkat Matter berikut untuk digunakan dalam verifikasi menyeluruh:

*Tabel: Matter contoh dari vendor silikon*
Vendor	Platform	Panduan
Bouffalo Lab	BL602
Bouffalo Lab	BL702
Espressif	ESP32	Pengujian OTA
Nordic Semiconductor	nRF52840 DK	Pengujian OTA
NXP	Kit pengembangan IOTZTB-DK006 kit
Realtek	Ameba D Series
Silicon Labs	EFR32MG24 Dev Kit
Silicon Labs	EFR32MG Zigbee and Thread Starter Kit
Telink	TLSR9528	Panduan Developer Matter Telink
Texas Instruments	Kit pengembangan CC2652R7 LaunchPad kit

ID Vendor

Secara default, Anda dapat menggunakan salah satu VID yang dialokasikan oleh Alliance untuk tujuan pengujian. Pilih salah satu dari berikut: 0xFFF1, 0xFFF2, 0xFFF3, 0xFFF4.

Untuk menggunakan VID Produksi agar integrasi Anda dapat disertifikasi dan diluncurkan, Anda harus terlebih dahulu memverifikasinya oleh Google untuk memastikan bahwa VID tersebut telah dikeluarkan untuk Anda oleh Alliance.

VID ini harus diterapkan dalam firmware perangkat Anda.

Perangkat Matter hanya dapat dipasangkan di ekosistem Google Home dalam skenario jenis perangkat dan ID Vendor tertentu.

VID pengujian tidak dapat digunakan di perangkat konsumen.
VID produksi Anda harus dikeluarkan oleh Connectivity Standards Alliance (Alliance). Google akan memvalidasi bahwa Anda adalah pemilik VID tersebut sebelum Anda dapat menggunakannya di Google Home Developer Console. Setelah itu, Anda akan dapat membuat integrasi untuk VID tersebut.
Untuk tujuan pengembangan dan Field Trial, project dan integrasi dengan kombinasi VID dan PID yang sesuai harus dibuat di Developer Console. Pengguna yang melakukan commissioning perangkat harus menjadi anggota project atau disertakan dalam daftar pengguna Field Trial.
Pengguna konsumen hanya dapat menggunakan produk Anda setelah produk tersebut disertifikasi oleh Alliance.

VID dan PID hanya dapat digunakan satu kali untuk satu integrasi. Jika ingin menggunakan VID atau PID yang sama dalam integrasi, Anda harus:

Mengedit integrasi menggunakan VID atau PID ke VID atau PID yang berbeda.
Menghapus integrasi menggunakan VID atau PID.

*Tabel: Skenario pairing jenis perangkat dan ID Vendor (VID)*
		Jenis pengguna mana yang dapat melakukan commissioning perangkat ke ekosistem Google Home?
Jenis VID	Status integrasi konsol dan sertifikasi VID	Produksi (Pengguna konsumen)	Pengembangan (Developer, Field Trial pengguna)
Pengujian	Tidak ada integrasi di Developer Console (tidak dapat disertifikasi)
Pengujian	Integrasi ada di Developer Console (tidak dapat disertifikasi)
Produksi	Tidak disertifikasi, integrasi tidak ada di Developer Console
Produksi	Tidak disertifikasi, integrasi ada di Developer Console
Produksi	Disertifikasi di Alliance DCL, integrasi tidak ada di Developer Console
Produksi	Disertifikasi di Alliance DCL dan integrasi ada di Developer Console

ID Produk

Informasi tentang perangkat dibaca dari the Matter Basic Information Cluster. ID Produk yang dienkode dalam firmware perangkat Anda harus cocok dengan ID Produk integrasiMatter Matter di Konsol Developer.

Fitur yang tidak didukung

Beberapa Matter cluster belum ditampilkan kepada pengguna, meskipun dapat digunakan oleh sistem. Dalam sebagian besar kasus, hal ini berarti bahwa atribut yang ditampilkan melalui cluster ini tidak terlihat oleh pengguna akhir:

*Table: Matter clusters not exposed to users in the Google Home ecosystem*
Cluster Type	Clusters
Core	Binding ¹ Label Fixed Label User Label Actions Group Key Localization Configuration Time Format Localization Unit Localization Power Source Configuration Power Source Diagnostics clusters (Diagnostic Logs, General Diagnostics, Software Diagnostics, Thread Network Diagnostics, Wi-Fi Network Diagnostics, Ethernet Network Diagnostics) Time Synchronization Mode Select
Application	Groups and Scenes are not directly supported. Equivalent functionality is available via Routines. All Media clusters. Equivalent functionality is available via Google Cast.

¹ Lihat Sakelar Lampu On/Off untuk mengetahui pengaruhnya terhadap Sakelar Lampu On/Off.

Berikutnya

Checklist developer

Mulai menggunakan Matter Tetap teratur dengan koleksi Simpan dan kategorikan konten berdasarkan preferensi Anda.