Google Home Sample App for Matter, Google Home Mobile SDK aşağıdakine benzer bir Android uygulaması Google Home app (GHA). Bu örnek uygulama aşağıdaki özellikleri sağlar:
- Fiziksel ve sanal Matter cihazları Yerel Android kumaşı
- Fiziksel ve sanal cihazları bir geliştirme yapısına dönüştürün
- Geliştirme kumaşınızdaki cihazları kontrol edin (ör. bir cihazı açmak için açık
- Çoklu yönetici özellikleri, geliştirme yapısında cihazları paylaşmanıza olanak tanır ve bunun aksine, geliştirilme sürecine dahil edebiliyorlar. diğer uygulamalardan paylaşılan kumaş cihazlar
- Geliştirici Yardımcı Programları
Bu kılavuzda, Sample App for Matter APK'sının nasıl yükleneceği ve kullanılacağı Matter cihazı için devreye sokmak, kontrol etmek ve paylaşmak.
Kaynak kodu indirmek için Mobile SDK ve Android Studio'da ekranları özelleştirmek için Sample App for Matter codelab'i.
Sample App for Matter codelab'ine gidin
Ön koşullar
- Test için hazır bir Android O (8.1, API düzeyi 27) veya daha yeni bir cihaz. Alıcı: cihazınızda en güncel Matter olduğundan emin olun destek almak için Matter modüllerini ve Hizmetler rehberini inceleyin.
- Açma/kapatma özelliklerine sahip bir Matter cihaz oluşturun. Bu
örnek uygulama bir sanal cihaz ve bir ESP32 ile çalışır.
- Matter Sanal Cihazı (MVD). Ortam sorunlarını en aza indirmek için MVD kullanmanızı önemle tavsiye ederiz seçeceğiz. Herhangi bir sorunla karşılaşırsanız bunu çözmek Örnek uygulamanın MVD'ye karşı kullanılıp kullanılmadığını araştırın.
- Matter Sanal Cihazı geliştirin
rootnode_dimmablelight_bCwGYSDpoe
uygulamasını kullanın. Google Takvim widget'ını Matter entegrasyonu oluşturun Google Home Developer Console içinde Tedarikçi Kimliğiniz olarak0xFFF1
ve Ürün Kimliğiniz olarak0x8000
kullanın. - Espressif Cihazı derleme
all-clusters-app
ile. Google Takvim widget'ını Matter entegrasyonu oluşturun Developer Console içinde Tedarikçi Kimliğiniz olarak0xFFF1
ve Ürün Kimliğiniz olarak0x8001
kullanın.
Komisyon yapmak için bir merkeze (ör. Google Nest Hub (2nd gen)) ihtiyacınız yoktur ve Sample App for Matter ile cihazları kontrol edin.
Yükle
Yayınlar bölümüne gidin. Sample App for Matter GitHub'da depodur. En son sürümü Öğeler bölümünde bulun adlı APK
GHSAFM-version-default-debug.apk
Lütfentargetcommissioner
Android Debug Bridge'i (adb) yükleyin:
Android cihazınızı USB ile bağlayıp Dosya Aktarımı'nı etkinleştirin, ardından APK'yı yükleyin:
$ adb unroot && adb install GHSAFM-version-default-debug.apk
Komisyon cihazları
Örnek uygulamayı ilk kez başlattığınızda ekranda Sample App for Matter codelab'inin bağlantısı. Bu mesajı tekrar gösterme'yi seçerseniz iletişim kutusunu geri getirebilirsiniz. istediğiniz zaman uygulamanın Yönetici bölümünde tercihlerinizi güncelleyebilirsiniz.
Sonraki adımlarda, cihazınıza bir Matter cihaz ekleyeceksiniz. Yerel Android kumaşı ve örneğin yerel bir geliştirme kumaşı yalnızca uygulamada kullanılabilir.
Matter kumaşı nedir?
Matter yapısı, cihazlar arasında ortak bir güven alanıdır birbirleriyle iletişim kurabilmelerini sağlayan bir ev ağında kullanılabilir.
Cihazların platform, uygulama veya etkileşim kuran cihaz grubu. Kumaşların benzersiz bir özelliği kimliği ve cihazlar aynı kimlik bilgilerini ve sertifika yetkilisi kümesini paylaşır (CA). Bu kimlik bilgileri Matter sırasında atanır devreye alma.
Matter cihaz için işlem yapmak üzere aşağıdaki adımları tamamlayın:
Ekle'ye
dokunun Devreye alma işlemini başlatmak için cihaz düğmesi.Ardından kontrol, kullanıma sunulan Google Play services hizmetine aktarılır Mobile SDK adlı kişiye yapılan çağrıdan. Kanıt göstermek için sahip olduğundan emin olun, QR kodunu tarayın veya Eşleme kodunu kullan'a dokunun.
Komisyon işlemi tamamlandığında Cihaz Adı girin, ardından Bitti'ye dokunun.
Cihazınız artık hem Yerel Android yapısına hem de tek bir proje yöneticisi olarak düşünebilirsiniz.
Tüm devreye alma işleri ve ilişkili ekranlar Cihazlar hizmete sunulurken Play services. Bu tutarlı bir kullanıcı deneyimi sunar ve hassas verileri Kablosuz ağ ve Thread kimlik bilgileri gibi.
Cihazları kontrol etme
Geliştirme yapısı, kontrol etmek için gereken kimlik bilgilerini oluşturur Doğrudan örnek uygulamadan Matter cihaz.
Ana ekrandan cihazınızı Açık veya Kapalı durumuna getirebilirsiniz. Ekrandaki cihaz ayrıntılarına erişmesini sağlayın.
Cihazları paylaşma
Cihaz paylaşımı çok yöneticili akışı olarak adlandırılır. Matter spesifikasyonu. Bir cihaz örnek uygulamaya aktarıldıktan sonra kolayca paylaşabilirsiniz diğer ekosistemlerle uyum içinde büyüyor.
Matter cihazınızı diğer ekosistemlerle paylaşmak için Android cihazınızda başka bir platformun yüklü olması gerekir. Bu harici platform, hedef komisyoncu olur. Farklı bir site haritası oluşturduk hedef komisyon temsilcisi olarak kullanabileceğiniz örnek uygulamanın örneği
Yayınlar bölümüne gidin. Sample App for Matter GitHub'da depodur. En son sürümü Öğeler bölümünde bulun adlı APK
GHSAFM-version-targetcommissioner-debug.apk
Lütfendefault
Hedef komisyoncuyu yükleyin.
$ adb unroot && adb install GHSAFM-version-targetcommissioner-debug.apk
Ana ekrandan, cihaz bilgilerini görüntülemek için cihaza dokunun. Dokunun Paylaş
Örnek uygulama, Mobile SDK Share API'yi çağırır ve bir kez daha denetim Play services alanına aktarıldı.
İstediğiniz uygulamayı veya platformu seçebileceğiniz bir paylaşım sayfası bulun. Bu ekranda cihaz:
- Hedef komisyon temsilcisi uygulamasıyla paylaşılacak kurulum kodu üzerinden manuel olarak
- Şu şekilde kayıtlı yerel bir Android uygulamasıyla: Matter delegesi
Hedef komisyoncu uygulaması GHSAFM-TC olarak etiketlenmiş. Bu cihazınızı paylaşmak için örnek uygulama.
Ardından harici uygulama (hedef temsilci), işlemini kendi kumaşına dönüştürmenizi sağlar.
Ayarlar
Ana ekrandan ayarları tıklayın
simgesi. Burada, bu adımı tamamlamak için kullanıcı tercihlerini güncelleme, yardım alma ve uygulamayla ilgili daha fazla bilgi edinme.Yarım sayfa bildirimi
Ayarlar ekranından, proaktif komisyonlanabilir olarak devre dışı bırakabilirsiniz. Matter cihaz için keşif bildirimleri.
Uygulamanız kendi Matter keşfini sunuyorsa veya devre dışı bırakma durumunu önlemek için bu bildirimleri dikkat edin. Komisyonlu keşfi engelleme bölümüne bakın bildirim konulu videomuzu izleyin.
Geliştirici yardımcı programları
Ayarlar ekranından Geliştirici yardımcı programlarına da erişebilirsiniz.
Cihaz ve Kullanıcı Tercihleri DataStore veri depolarının içeriğini incelemek için Logcat'te aşağıdaki adımları tamamlayın:
Günlük deposu içeriği'ni tıklayın.
İletişim kutusunda Tamam'ı tıklayın, ardından Logcat'i işaretleyin.
Geri bildirim ve yardım
Geliştirme sürecini nasıl daha iyi hale getirebileceğimizle ilgili düşüncelerinizi veya geri bildirimlerinizi Sample App for Matter ile ilgili deneyiminiz varsa Geri Bildirim Formumuzu doldurun.
Sample App for Matter ile ilgili sorun yaşıyorsanız şu işlemi tamamlamayı deneyin: ortamınızı doğrulamak için aşağıdaki adımları uygulayın:
Örnek uygulamayı kullanmayla veya bir kod hatasıyla karşılaşırsanız sorularınız olursa , sorunları GitHub deposundaki Sorun İzleyici'ye gönderebilir:
Teknik sorularla ilgili Google'dan resmi yardım almak için Smart Home'u kullanın Geliştirici Forumu:
Topluluktan teknik destek almak için şurada google-smart-home
etiketini kullanın:
Yığın Taşması: