Google Home Sample App for Matter, Google Home app (GHA) uygulamasına benzer bir Android uygulaması oluşturmak için Google Home Mobile SDK kullanır. Bu örnek uygulama aşağıdaki özellikleri sunar:
- Fiziksel ve sanal Matter cihazları Local Android fabric'e ekleme
- Fiziksel ve sanal cihazları geliştirme ortamına sağlama
- Geliştirme ağınızdaki cihazları kontrol etme (ör. ışığı açma)
- Çoklu yönetici özellikleri, geliştirme ortamındaki cihazları diğer uygulamalarla paylaşmanıza ve diğer uygulamalardan paylaşılan cihazları geliştirme ortamına dahil etmenize olanak tanır.
- Geliştirici Yardımcı Programları
Bu kılavuzda, Sample App for Matter APK'sının nasıl yükleneceği ve Matter cihazları devreye almak, kontrol etmek ve paylaşmak için nasıl kullanılacağı açıklanmaktadır.
Kaynak kodunu indirmek, Mobile SDK simgesini entegre etmeyi öğrenmek ve Android Studio'da ekranları özelleştirmek için Mobile SDK codelab'imizi deneyin.Sample App for Matter
Sample App for Matter Codelab'e gidin
Ön koşullar
- Test için Android O (8.1, API düzeyi 27) veya daha yeni bir sürümün yüklü olduğu bir cihazınızın olması gerekir. Cihazınızın en yeni Matter desteğe sahip olduğundan emin olmak için Modülleri ve Hizmetleri Doğrulama kılavuzunu inceleyin.Matter
- Açma/kapatma özelliklerine sahip bir Matter cihazı oluşturun. Bu örnek uygulama, sanal cihaz ve ESP32 ile çalışır.
- Matter Virtual Device (MVD). Ortam sorunlarını en aza indirmek için başlangıçta MVD kullanmanızı önemle tavsiye ederiz. Herhangi bir sorunla karşılaşırsanız örnek uygulama MVD'ye karşı kullanılıyorsa sorunu incelemek çok daha kolay olur.
- Matter Sanal Cihaz'ı
rootnode_dimmablelight_bCwGYSDpoeuygulamasıyla oluşturun. Google Home Developer Console'da Matter entegrasyonu oluştururken0xFFF1satıcı kimliğiniz,0x8000ise ürün kimliğiniz olarak kullanılır. - Espressif Cihazı Oluşturma
all-clusters-appile. Developer Console içinde Matter entegrasyonu oluştururken,0xFFF1değerini satıcı kimliğiniz,0x8001değerini ise ürün kimliğiniz olarak kullanın.
Cihazları Sample App for Matter ile kullanıma almak ve kontrol etmek için Google Nest Hub (2nd gen) gibi bir hub'a ihtiyacınız yoktur.
Yükle
Sample App for Matter GitHub deposundaki Releases (Yayınlar) bölümüne gidin. En son sürüm için Varlıklar bölümünde
GHSAFM-version-default-debug.apkadlı APK'yı bulun.targetcommissionerseçeneğini belirlemeyin.Android Debug Bridge'i (adb) yükleyin:
Android cihazınızı USB ile bağlayın ve Dosya Aktarımı'nı etkinleştirin, ardından APK'yı yükleyin:
$ adb unroot && adb install GHSAFM-version-default-debug.apk
Cihazları devreye alma
Örnek uygulamayı ilk kez başlattığınızda Sample App for Matter codelab'ine bağlantı içeren bir iletişim kutusu gösterilir. Bu mesajı tekrar gösterme'yi seçerseniz uygulamanın Yönetici bölümündeki tercihlerinizi güncelleyerek iletişim kutusunu istediğiniz zaman geri getirebilirsiniz.
Sonraki adımlarda, Matter cihazını Local Android yapısına ve yalnızca örnek uygulamaya özel bir geliştirme yapısına ekleyeceksiniz.
Matter kumaşlar nedir?
Matter Yapı, ev ağındaki cihazlar arasında paylaşılan bir güven alanıdır ve bu cihazların birbiriyle iletişim kurmasını sağlar.
Cihazlarda bir platforma, uygulamaya veya birlikte etkileşimde bulunan bir cihaz grubuna karşılık gelen bir veya daha fazla kumaş olabilir. Grupların benzersiz bir kimliği vardır ve cihazlar aynı kimlik bilgileri ile sertifika yetkilisi (CA) kümesini paylaşır. Bu kimlik bilgileri Matter devreye alma sırasında atanır.
Bir Matter cihazı devreye almak için aşağıdaki adımları tamamlayın:
Hazırlama sürecini başlatmak için Cihaz Ekle düğmesine dokunun.
Ardından kontrol, Mobile SDK numarasına yapılan bir çağrıdan başlatılan Google Play services uygulamasına aktarılır. Mülkiyet kanıtı oluşturmak için QR kodunu tarayın veya Eşleme kodunu kullan'a dokunun.
İlk kullanıma hazırlama işlemi tamamlandığında Cihaz Adı girin ve Bitti'ye dokunun.
Cihazınız artık hem yerel Android kumaşına hem de geliştirme kumaşına bağlı.
Cihazların devreye alınması sırasında tüm devreye alma işlemleri ve ilişkili ekranlar Play services tarafından gerçekleştirilir. Bu sayede tutarlı bir kullanıcı deneyimi sağlanır ve hassas izinlerin (ör. Wi-Fi ve Thread kimlik bilgileri) işlenmesi gerekmez.
Cihazları kontrol etme
Geliştirme yapısı, Matter cihazları doğrudan örnek uygulamadan kontrol etmek için kimlik bilgileri oluşturur.
Ana ekrandan cihazınızı Açık veya Kapalı olarak ayarlayabilirsiniz. Cihaz ayrıntılarına erişmek için cihaza dokunun.
Cihazları paylaşma
Bir cihazı paylaşma işlemi, Matter spesifikasyonunda çoklu yönetici akışı olarak adlandırılır. Bir cihaz örnek uygulamaya eklendikten sonra, diğer ekosistemlerle kolayca paylaşabilirsiniz.
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. Hedef komisyoncu olarak kullanabileceğiniz örnek uygulamanın başka bir örneğini oluşturduk.
Sample App for Matter GitHub deposundaki Releases (Yayınlar) bölümüne gidin. En son sürüm için Varlıklar bölümünde
GHSAFM-version-targetcommissioner-debug.apkadlı APK'yı bulun.defaultseçeneğini belirlemeyin.Hedef komisyoneri yükleyin.
$ adb unroot && adb install GHSAFM-version-targetcommissioner-debug.apkAna ekranda cihaza dokunarak cihaz bilgilerini görüntüleyin. Paylaş'a dokunun.
Örnek uygulama, Mobile SDK Share API'yi çağırır ve kontrol tekrar Play services'ye aktarılır.
Bir paylaşım sayfası gösterilir. Bu sayfada, cihazı eşlemek istediğiniz uygulamayı veya platformu seçebilirsiniz. Bu ekranda cihazı paylaşmanın iki yolu vardır:
- Hedef komisyoner uygulamasıyla paylaşılacak bir kurulum kodu aracılığıyla manuel olarak
- Matter komisyon üyesi olarak kayıtlı yerel bir Android uygulamasıyla
Hedef komisyon üyesi uygulaması GHSAFM-TC olarak etiketlenir. Cihazınızı paylaşmak için örnek uygulamanın bu örneğine dokunun.
Ardından, harici uygulama (hedef görevli) cihazın kendi ağında devreye alınmasını tamamlar.
Ayarlar
Ana ekranda ayarlar simgesini tıklayın. Burada kullanıcı tercihlerini güncelleme, yardım alma ve uygulama hakkında daha fazla bilgi edinme seçenekleri bulunur.
Yarım sayfa bildirimi
Ayarlar ekranında, Matter cihazlar için proaktif komisyon kazandıran keşif bildirimlerini devre dışı bırakmayı seçebilirsiniz.
Uygulamanız kendi Matter keşif veya görevlendirme akışını sağlıyorsa kesintileri önlemek için bu bildirimleri devre dışı bırakmak isteyebilirsiniz. Daha fazla bilgi için Komisyon kazandıran keşif bildirimlerini devre dışı bırakma başlıklı makaleyi inceleyin.
Geliştirici yardımcı programları
Ayarlar ekranından Geliştirici yardımcı programlarına da erişebilirsiniz.
Logcat'te Cihaz ve Kullanıcı Tercihleri Veri Deposu depolarının içeriklerini incelemek için aşağıdaki adımları tamamlayın:
Log repositories content'i (Depo içeriğini günlüğe kaydet) tıklayın.
İletişim kutusunda Tamam'ı tıklayın, ardından Logcat'i işaretleyin.
Geri bildirim ve yardım
Sample App for Matter ile geliştirme deneyimini nasıl iyileştirebileceğimiz konusundaki düşüncelerinizi veya geri bildirimlerinizi göndermek için geri bildirim formumuzu doldurun.
Geri bildiriminizi bize gönderin
Sample App for Matter ile ilgili sorun yaşıyorsanız ortamınızı doğrulama adımlarını tamamlamayı deneyin:
Örnek uygulamayı kullanmayla ilgili sorularınız varsa veya kod hatası keşfederseniz GitHub deposundaki Sorun İzleyici'ye sorun gönderebilirsiniz:
Teknik sorularla ilgili Google'dan resmi yardım almak için Akıllı Ev Geliştirici Forumu'nu kullanın:
Topluluktan teknik destek almak için Stack Overflow'da google-smart-home etiketini kullanın: