Google Home Sample App for Matter, Google Home app (GHA)'ye benzer bir Android uygulaması oluşturmak için Google Home Mobile SDK'yi kullanır. Bu örnek uygulama aşağıdaki özellikleri sunar:
- Yerel Android ağına fiziksel ve sanal Matter cihazlar ekleme
- Geliştirme ortamına fiziksel ve sanal cihazlar atamak
- Geliştirme kumaşınızdaki cihazları kontrol etme (ör. ışığı açma)
- Çok yöneticili özellikler, geliştirme kumaşındaki cihazları diğer uygulamalarla paylaşmanıza ve diğer uygulamalardan paylaşılan cihazları geliştirme kumaşına dahil etmenize olanak tanır.
- Geliştirici Araçları
Bu kılavuzda, Sample App for Matter APK'nın nasıl yükleneceği ve Matter cihazları etkinleştirmek, kontrol etmek ve paylaşmak için nasıl kullanılacağı açıklanmaktadır.
Kaynak kodunu indirmek, Mobile SDK'yi nasıl entegre edeceğinizi ve Android Studio'da ekranları nasıl özelleştireceğinizi öğrenmek için Sample App for Matter codelab'imizi deneyin.
Sample App for Matter codelab'ine gidin
Ön koşullar
- Test için kullanılabilecek Android O (8.1, API düzeyi 27) veya daha yeni bir cihaz. Cihazınızda en güncel Matter desteğinin bulunduğundan emin olmak için Matter Modülleri ve Hizmetlerini Doğrulama kılavuzunu inceleyin.
- Açma/kapatma özellikleri olan bir Matter cihaz oluşturun. Bu örnek uygulama, sanal cihaz ve ESP32 ile çalışır.
- Matter Sanal Cihaz (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 uygulamanın MVD'ye karşı kullanılıp kullanılmadığını incelemek çok daha kolay olur.
rootnode_dimmablelight_bCwGYSDpoeuygulamasıyla Matter sanal cihaz oluşturun. Google Home Developer Console'te Matter entegrasyonu oluştururken tedarikçi kimliğiniz olarak0xFFF1, ürün kimliğiniz olarak0x8000kullanın.all-clusters-appile Espressif cihaz oluşturma Developer Console'te Matter entegrasyonu oluştururken tedarikçi firma kimliğiniz olarak0xFFF1, ürün kimliğiniz olarak da0x8001kullanın.
Sample App for Matter ile cihazları devreye almak ve kontrol etmek için Google Nest Hub (2nd gen) gibi bir merkeze ihtiyacınız yoktur.
Yükle
Sample App for Matter GitHub deposunda Sürümler bölümüne gidin. En son sürüm için Öğeler 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ı etkinleştirme
Örnek uygulamayı ilk kez başlattığınızda Sample App for Matter codelab bağlantısının bulunduğu 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 tekrar açabilirsiniz.
Sonraki adımlarda, yerel Android kumaşına bir Matter cihaz ve yalnızca örnek uygulamaya yerel olan bir geliştirme kumaşı ekleyeceksiniz.
Matter kumaşlar nedir?
Matter kumaşı, ev ağındaki cihazların birbiriyle iletişim kurmasını sağlayan, cihazlar arasında paylaşılan bir güven alanıdır.
Cihazlarda, bir platforma, uygulamaya veya birlikte etkileşimde bulunan bir cihaz grubuna karşılık gelen bir veya daha fazla kumaş bulunabilir. Fabric'lerin benzersiz bir kimliği vardır ve cihazlar aynı kimlik bilgilerini ve sertifika yetkilisini (CA) paylaşır. Bu kimlik bilgileri, Matter devreye alma sırasında atanır.
Matter cihazı devreye almak için aşağıdaki adımları uygulayın:
Devreye alma işlemini başlatmak için Cihaz Ekle düğmesine dokunun.
Ardından, kontrol Google Play services'e aktarılır. Google Play services, Mobile SDK'a yapılan bir aramadan başlatılır. Mülkiyet kanıtı oluşturmak için QR kodunu tara'ya veya Eşleme kodunu kullan'a dokunun.
Devreye alma işlemi tamamlandığında bir 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ıdır.
Cihazların devreye alınması sırasında tüm devreye alma çalışmaları ve ilişkili ekranlar Play services tarafından yönetilir. Bu sayede tutarlı bir kullanıcı deneyimi sağlanır ve Wi-Fi ve Thread kimlik bilgileri gibi hassas izinleri işleme ihtiyacı ortadan kaldırılır.
Cihazları kontrol etme
Geliştirme kumaşı, cihazları kontrol etmek için kimlik bilgilerini doğrudan örnek uygulamadan oluşturur.Matter
Ana ekrandan cihazınızı Açık veya Kapalı duruma getirebilirsiniz. Cihaz ayrıntılarına erişmek için cihaza dokunun.
Cihazları paylaşma
Cihaz paylaşımı, Matter spesifikasyonunda çoklu yönetici akışı olarak adlandırılır. Bir cihaz, örnek uygulama için görevlendirildikten sonra diğer ekosistemlerle kolayca paylaşılabilir.
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 deposunda Sürümler bölümüne gidin. En son sürüm için Öğeler bölümünde
GHSAFM-version-targetcommissioner-debug.apkadlı APK'yı bulun.defaultseçeneğini belirlemeyin.Hedef komisyoncuyu 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 Paylaşım API'sini çağırır ve kontrol tekrar Play services'ye aktarılır.
Cihazınızı eşlemek istediğiniz uygulamayı veya platformu seçmenizi sağlayan bir paylaşım sayfası gösterilir. Bu ekranda cihazı paylaşmanın iki yolu sunulur:
- Hedef komisyoncu uygulamasıyla paylaşılacak bir kurulum kodu aracılığıyla manuel olarak
- Matter komisyon üyesi olarak kayıtlı yerel bir Android uygulamasıyla
Hedef komisyoncu uygulaması GHSAFM-TC olarak etiketlenir. Cihazınızı paylaşmak için örnek uygulamanın bu örneğine dokunun.
Ardından harici uygulama (hedef komisyoncu), cihazın kendi kumaşına devreye alınmasını tamamlar.
Ayarlar
Ana ekrandan ayarlar simgesini tıklayın. Buradan kullanıcı tercihlerini güncelleyebilir, yardım alabilir ve uygulama hakkında daha fazla bilgi edinebilirsiniz.
Yarım sayfa bildirimi
Ayarlar ekranından, Matter cihazlar için proaktif ücretli keşif bildirimlerini devre dışı bırakabilirsiniz.
Uygulamanız kendi Matter keşif veya devreye alma akışını sağlıyorsa kesintileri önlemek için bu bildirimleri devre dışı bırakabilirsiniz. Daha fazla bilgi için Komisyonlu keşif bildirimlerini engelleme 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 DataStore depolarının içeriğini incelemek için aşağıdaki adımları tamamlayın:
Depo içeriklerini günlüğe kaydet'i 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 hakkındaki düşüncelerinizi veya geri bildirimlerinizi göndermek için geri bildirim formumuzu doldurun.
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 kodda bir hata bulursanız GitHub deposundaki Sorun Takip Aracı'na sorun gönderebilirsiniz:
Teknik sorularla ilgili Google'dan resmi rehberlik 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: