Google'ın Home Developer programı, cihaz üreticilerinin akıllı ev cihazlarını Google Home ekosistemine bağlamasına olanak tanır. Google Home app (GHA)'i kullanarak kurulum için Matter özellikli cihazlar ekleme ve bunları Google Assistant, GHA veya Google Nest Hub (2nd gen) gibi akıllı ekranlar üzerinden kontrol etme özelliğiyle Akıllı Ev İşlemleri yerel yerine getirme yolunu genişletiyoruz.
Bu dokümanda, Google Home ekosisteminde Matter destekli bir platform oluşturma ve entegre etme hakkında bilgi verilmektedir.
Sorumluluk reddi beyanları
Matter dokümanlarında açıklanan prosedürlerle ilgili olarak aşağıdakileri göz önünde bulundurun:
- Geliştirme için kullanılan hesapta, test için yalnızca tek bir Matter özellikli hub'ın bağlı olmasını öneririz. Aynı anda bağlı olan veya test sırasında aynı yapıya bağlı olan birden fazla Matter özellikli hub, beklenmedik davranışlara neden olabilir.
- Tüm prosedürlerde, Google tarafından test edilmiş Matter örneklerini derlemek ve flaşlamak için Ubuntu 20.04 çalıştıran bir Linux makinesinin kullanıldığı varsayılır. macOS makineler desteklenir ancak Linux önerilir. Mac'e özgü talimatlar, gerektiğinde prosedürlerde belirtilir.
Derleme
Google Home ekosistemiyle entegre olan Matter özellikli bir cihaz oluşturmak için Matter uyumlu bir geliştirme kartı ve Matter SDK'sı ile çalışırsınız.
Başlamanın en kolay yolu, kod laboratuvarlarımızı incelemektir. Aşağıdaki kod laboratuvarlarından en az birini tamamlamanızı öneririz:
Google Home Oyun Alanı
Updated 6 Ocak 2025
Yapılandırılabilir cihaz türleri ve özelliklerle sanal bir ev oluşturup değiştirerek akıllı ev projesi simüle edin.
Android Studio için Google Home Eklentisi
Updated 6 Ocak 2025
Bu eklenti, akıllı ev geliştirme sürecinizi basitleştiren Google Asistan Simülatörü, Cloud Logging ve diğer araçlara erişmenizi sağlar.
Uzak Sanal Cihaz
Updated 6 Ocak 2025
Matter sanal cihazları için görsel durum ve kontroller sağlayan bağımsız bir masaüstü uygulaması.
Google Home Kullanıcı Arayüzü Otomatikleştirici
Updated 15 Mart 2024
Google Home uygulamasında devreye alma işlemini otomatikleştirin.
Entegrasyon hatalarını giderme
Updated 6 Ocak 2023
Monitoring metrikleri ve Google Cloud günlükleriyle ilgili sorunları nasıl gidereceğinizi öğrenin.
Home Graph Görüntüleyici
Updated 5 Ağustos 2022
Home Grafik Görüntüleyici'yi kullanarak Ana Sayfa Grafiği'ni görüntüleyin.
Google Home Test Paketi
Updated 13 Temmuz 2022
Hesabınızla ilişkilendirilmiş cihazlara ve özelliklere göre ve testler tamamlandığında görüntüleme durumları oluşturun ve çalıştırın.
VS Code için Google Home Uzantısı
Updated 31 Mayıs 2022
Google Asistan Simülatörü'ne, Cloud Logging'e ve akıllı ev geliştirme sürecinizi basitleştiren diğer araçlara erişmek için Google Home uzantısını kullanın.
Google Home ekosistemi için Cloud Monitoring
Updated 1 Şubat 2022
Akıllı ev İşlemlerinin kullanımını izleyin.
Google Home ekosistemi için Cloud Logging
Updated 1 Şubat 2022
Google Cloud'da hangi günlük kaydı analizlerinin kullanılabileceğini öğrenin.
WebRTC Doğrulayıcı Aracı Kullanım Kılavuzu
Updated 1 Kasım 2021
WebRTC akışındaki hataları ayıklamak için Akıllı Ekranlardaki WebRTC oynatıcısını Google Asistan'la taklit eder.
Smart Home SYNC Data Validator
Updated 24 Ağustos 2023
Verify the correctness of intent response payloads using the SYNC response validator.
Ardından, entegre etmeyi planladığınız cihazın Google Home ekosisteminde desteklenip desteklenmediğini öğrenmek için desteklenen cihazlar listemizi kontrol edin. Ardından, proje oluşturmadan lansmana kadar geliştirme akışının tamamını anlamak için Geliştirici Yapılacaklar Listesi'ni okuyun.
Desteklenen Cihazlar Geliştirici Kontrol Listesi
Tanımlar
Bu dokümanda aşağıdaki terimler kullanılmıştır:
- Sınır yönlendirici
- Thread özellikli cihazlar için genel amaçlı bir Thread Sınır Yönlendiricisi uygulayan bir merkez.
- Hub
- Google Nest Hub (2nd gen) gibi desteklenen bir Google Nest cihaz Matter özellikli cihazları Assistant, GHA ve akıllı ekranlar gibi diğer platformlardan kontrol etmek için bir merkez gerekir.
- Matter özellikli cihaz
- MatterEtkinleştirilmiş bir derleme veya örnek uygulamayla flaşının atıldığı bir cihaz ya da geliştirme kartı.
- Mobil cihaz
- Eşlemeye yardımcı olmak için kullanılan test telefonu. Şu anda bu bir Android telefon.
Ön koşullar
Matter özellikli bir cihazı Google Home ekosistemine tam olarak entegre etmek için geliştiricilerin şunları yapması gerekir:
- Hem Thread özellikli cihazlar için sınır yönlendirici hem de akıllı ev intent'lerini yönlendirmek için yerel bir karşılama yolu olarak kullanılacak Thread destekli bir Google hub.
- Minimum gereksinimleri karşılayan bir mobil cihaz (test telefonu):
- Android O (8.1, API düzeyi 27 veya daha yeni)
- iOS (16.5 veya daha yeni sürümler)
- BDE özelliği
- Matter özellikli cihazın Tedarikçi Firma Kimliği (VID) ve Ürün Kimliği (PID).
- Matter özellikli bir cihaz. Bu cihaz, Google Home ekosisteminde desteklenen Matter cihaz türlerinden biri olmalıdır ve şunlar olabilir:
- Matter özellikli donanım yazılımına sahip kendi ürününüz.
- Uçtan uca doğrulama için kullanılacak aşağıdaki Matter cihazlardan biri:
Satıcı | Platform | Thread Destek Ekibi | Kılavuz |
---|---|---|---|
Bouffalo Lab | BL602 | ||
BL702 | |||
Espressif | ESP32 | OTA Testi | |
Nordic Semiconductor | nRF52840 DK | OTA Testi | |
NXP | IOTZTB-DK006 geliştirme kiti | ||
Realtek | Ameba D Serisi | ||
Silicon Labs | EFR32MG24 Dev Kiti | ||
EFR32MG Zigbee ve Thread Başlangıç Seti | |||
Telink | TLSR9518 | ||
Texas Instruments | CC2652R7 LaunchPad geliştirme kiti |
Satıcı kimliği
Varsayılan olarak, CSA tarafından test amacıyla ayrılan VID'lerden birini kullanabilirsiniz. Aşağıdakilerden birini seçin:
0xFFF1
, 0xFFF2
, 0xFFF3
, 0xFFF4
.
Entegrasyonunuzun sertifikalandırılıp kullanıma sunulması için üretim VID'si kullanmanız gerekir. Bunun için öncelikle VID'nin CSA tarafından size verildiğini doğrulamak üzere Google tarafından doğrulanmasını sağlamanız gerekir.
Bu VID, cihazınızın donanım yazılımına uygulanmalıdır.
Matter cihazlar, Google Home ekosisteminde yalnızca belirli tedarikçi kimliği ve cihaz türü senaryolarında eşlenebilir.
- Test VID'si tüketici cihazlarında kullanılamaz.
- Üretim VID'niz Connectivity Standards Alliance (Alliance) tarafından düzenlenmelidir. Google, Google Home Developer Console'te kullanabilmeniz için bu VID'nin sahibi olduğunuzu doğrular. Bu işlem tamamlandıktan sonra, ilgili VID için entegrasyon oluşturabilirsiniz.
- Geliştirme ve Field Trial amacıyla, Developer Console'de bir proje ve ilgili VID ile PID kombinasyonuna sahip bir entegrasyon oluşturulmalıdır. Cihazı devreye alan kullanıcı, projenin üyesi veya Field Trial kullanıcıları listesine eklenmiş olmalıdır.
- Tüketici kullanıcılar, ürününüzü yalnızca Alliance tarafından sertifikalandırıldıktan sonra kullanabilir.
VID ve PID, tek bir entegrasyon için yalnızca bir kez kullanılabilir. Entegrasyonunuzda aynı VID veya PID'yi kullanmak istiyorsanız aşağıdakilerden birini yapmanız gerekir:
- VID veya PID'yi kullanarak entegrasyonu farklı bir VID veya PID ile düzenleyin.
- VID veya PID'yi kullanarak entegrasyonu silin.
Hangi kullanıcı türleri cihazı Google Home ekosistemine dahil edebilir? | |||
---|---|---|---|
VID türü | VID sertifikası ve konsol entegrasyonu durumu | Üretim
(Tüketici kullanıcılar) |
Geliştirme
(Geliştiriciler, Field Trial kullanıcıları) |
Test | Developer Console'te entegrasyon yok (sertifikalandırılamaz) | ||
Test | Developer Console'te entegrasyon mevcut (sertifikalandırılamaz) | ||
Üretim | Sertifikasız, entegrasyon Developer Console'te mevcut değil | ||
Üretim | Sertifikasız, entegrasyon Developer Console'te mevcut | ||
Üretim | Alliance DCL'de sertifikalandırılmış, Developer Console'te entegrasyon bulunmuyor | ||
Üretim | Alliance DCL sertifikalı ve Developer Console'da entegrasyon mevcut |
Ürün kimliği
Cihazla ilgili bilgiler Matter Temel Bilgi Kümesi'nden okunur. Cihazınızın donanım yazılımına kodlanan ürün kimliği, Developer Console'daki Matter entegrasyonunun ürün kimliğiyle eşleşmelidir.
Desteklenmeyen özellikler
Bazı Matter kümeleri henüz kullanıcılara gösterilmemektedir ancak sistem tarafından kullanılabilir. Çoğu durumda bu, bu kümeler aracılığıyla sunulan özelliklerin son kullanıcılar tarafından görülemediği anlamına gelir:
Cluster Type | Clusters |
---|---|
Core |
|
Application |
|
¹ Bu durumun açma/kapatma düğmeli ışık anahtarlarını nasıl etkilediği hakkında bilgi edinmek için Açık/Kapalı Düğmeli Işık Anahtarları başlıklı makaleyi inceleyin.