Google Home Sample App for Matter, Google Home app (GHA) uygulamasına benzer bir Android uygulaması oluşturmak için Google Home Mobile SDK öğesini kullanır. Bu örnek uygulama aşağıdaki özellikleri sunar:
- Fiziksel ve sanal Matter cihazlarını Yerel Android yapısına entegre edin
- 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ını devreye almak, kontrol etmek ve paylaşmak için nasıl kullanılacağı açıklanmaktadır.
Kaynak kodu indirmek, Mobile SDK entegre etmeyi öğrenmek ve Android Studio'da ekranları özelleştirmek için Sample App for Matter kod laboratuvarımızı deneyin.
Sample App for Matter kod laboratuvarına gidin
Ön koşullar
- Test için Android O (8.1, API seviyesi 27) veya daha yeni bir cihaz mevcut. 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 özelliğine sahip bir Matter cihazı oluşturun. Bu örnek uygulama sanal bir cihaz ve bir ESP32 ile çalışır.
- Madde Sanal Aygıtı (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 olacaktır.
rootnode_dimmablelight_bCwGYSDpoeuygulamasıyla bir Matter Sanal Cihazı oluşturun. Google Home Developer Console'de bir Matter entegrasyonu oluşturduğunuzda, Satıcı Kimliğiniz olarak0xFFF1ve Ürün Kimliğiniz olarak0x8000kullanın.- Espressif Cihazı Oluşturma
all-clusters-appile. Developer Console'te Matter entegrasyonu oluşturduğunuzda, Satıcı Kimliğiniz olarak0xFFF1ve Ürün Kimliğiniz olarak0x8001kullanı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 Sürümler 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.targetcommissioneröğesini seçmeyin.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 kod laboratuvarına giden bir bağlantı içeren bir iletişim kutusu göreceksiniz. Bu mesajı bir daha gösterme'yi seçerseniz, uygulamanın Yönetici bölümünde tercihlerinizi güncelleyerek iletişim kutusunu istediğiniz zaman geri getirebilirsiniz.
Sonraki adımlarda, yalnızca örnek uygulamaya yerel olan bir geliştirme yapısıyla birlikte Yerel Android yapısına bir Matter aygıtı 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 kümesini ve sertifika yetkilisini (CA) paylaşır. Bu kimlik bilgileri Matter devreye alma sırasında atanır.
Bir Matter cihazını 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. kablosuz 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ı konumuna getirebilirsiniz. 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 kaydedildikten 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 Sürümler 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 Paylaşım API'sini çağırır ve kontrol bir kez daha Play services'e 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 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 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 ekrandan ayarlar simgesine tıklayın. Burada kullanıcı tercihlerini güncelleme, yardım alma ve uygulama hakkında daha fazla bilgi edinme seçenekleriniz var.
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 hizmete alma akışını sağlıyorsa kesintileri önlemek için bu bildirimleri devre dışı bırakmak isteyebilirsiniz. Daha fazla bilgi için Komisyona tabi keşif bildirimlerini bastırma bölümüne bakın.
Geliştirici yardımcı programları
Ayarlar ekranından Geliştirici yardımcı programlarına da erişebilirsiniz.
Logcat'teki Aygıt ve Kullanıcı Tercihleri DataStore depolarının içeriğini 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'a tıklayın ve 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 bir kod hatası keşfederseniz GitHub deposundaki Sorun İzleyici'ye sorun gönderebilirsiniz:
Teknik sorularınızla 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: