Google Home Sample App for Matter, Google Home app (GHA) benzeri bir Android uygulaması oluşturmak için Google Home Mobile SDK kodunu kullanır. Bu örnek uygulama aşağıdaki özellikleri sağlar:
- Fiziksel ve sanal Matter cihazları Yerel Android dokusu için devreye sokun
- Fiziksel ve sanal cihazları bir geliştirme dokusu için devreye sokma
- Geliştirme yapınızdaki cihazları kontrol edin. Örneğin, ışık modu açma
- Çok yöneticili özellikler sayesinde geliştirme yapısındaki cihazları diğer uygulamalarla paylaşabilir, diğer uygulamalardan paylaşılan geliştirme dokularına cihaz ekleyebilirsiniz.
- Geliştirici Yardımcı Programları
Bu kılavuzda, Sample App for Matter APK'sının nasıl yükleneceği ve Matter cihazları komisyonlamak, kontrol etmek ve paylaşmak için nasıl kullanılacağı açıklanmaktadır.
Kaynak kodu indirmek, Mobile SDK entegrasyonunu nasıl yapacağınızı 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 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üllerini ve Hizmetlerini Doğrulama kılavuzunu inceleyin.
- Açma/kapatma özelliklerine sahip bir Matter cihaz oluşturun. Bu örnek uygulama, sanal cihaz ve ESP32 ile çalışır.
- Konu Sanal Cihazı (MVD). Çevreyle ilgili sorunları en aza indirmek için başlangıç olarak 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ı araştırmak çok daha kolay olacaktır.
rootnode_dimmablelight_bCwGYSDpoe
uygulamasıyla bir Matter Sanal Cihazı oluşturun. Google Home Developer Console ürününde Matter entegrasyonu oluşturduğunuzda tedarikçi kimliğiniz olarak0xFFF1
, ürün kimliğiniz olarak0x8000
kullanın.all-clusters-app
ile Espressif Cihazı oluşturun. Developer Console'da Matter entegrasyonu oluşturduğunuzda tedarikçi kimliğiniz olarak0xFFF1
, ürün kimliğiniz olarak0x8001
kullanın.
Sample App for Matter ile cihazları komisyon 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.apk
adlı APK'yı bulun.targetcommissioner
seçimini yapmayın.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 Sample App for Matter codelab'in bağlantısını içeren bir iletişim kutusu görürsünüz. Bu mesajı bir daha gösterme'yi seçerseniz uygulamanın Yönetici bölümünde tercihlerinizi güncelleyerek dilediğiniz zaman iletişim kutusunu geri getirebilirsiniz.
Sonraki adımlarda, Yerel Android yapısına bir Matter cihazıyla birlikte yalnızca örnek uygulamada yerel olan bir geliştirme dokusu ekleyeceksiniz.
Matter kumaşları nedir?
Matter yapısı, ev ağındaki cihazların birbiriyle iletişim kurmasını sağlayan ortak bir güven alanıdır.
Cihazlarda; bir platforma, uygulamaya veya cihaz grubuna karşılık gelen bir ya da daha fazla kumaş olabilir. Kumaşların benzersiz bir kimliği vardır ve cihazlar aynı kimlik bilgisi grubunu ve sertifika yetkilisini (CA) paylaşır. Bu kimlik bilgileri, Matter kaydolma işlemi sırasında atanır.
Bir Matter cihazı kullanıma sunmak için aşağıdaki adımları tamamlayın:
Devreye alma işlemini başlatmak için
Cihaz Ekle düğmesine dokunun.Daha sonra kontrol, Mobile SDK aramasından başlatılan Google Play services öğesine aktarılır. Adrese sahip olduğunuza dair kanıt sağlamak için QR kodunu tarayın veya Eşleme kodunu kullan'a dokunun.
Devreye alma işlemi tamamlandığında bir Cihaz Adı girip Bitti'ye dokunun.
Cihazınız artık hem Yerel Android yapısına hem de geliştirme yapısına bağlıdır.
Cihazlar devreye alınırken tüm devreye alma işleri ve ilgili ekranlar Play services tarafından yönetilir. Bu, tutarlı bir kullanıcı deneyimi sağlar ve Wi-Fi ve Thread kimlik bilgileri gibi hassas izinleri işleme ihtiyacını ortadan kaldırır.
Cihazları kontrol etme
Geliştirme yapısı, Matter cihazlarını 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
Cihaz paylaşma, Matter spesifikasyonunda çoklu yönetici akışı olarak adlandırılır. Bir cihaz örnek uygulama için hizmete sunulduğunda, bunu diğer ekosistemlerle kolayca paylaşabilirsiniz.
Matter cihazınızı diğer ekosistemlerle paylaşmak için Android cihazınızda başka bir platform yüklü olmalıdır. Bu harici platform, hedef komisyoncu haline gelir. Hedef komisyoncu olarak kullanabileceğiniz başka bir örnek uygulama örneği 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.apk
adlı APK'yı bulun.default
seçimini yapmayın.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. Paylaş'a dokunun.
Örnek uygulama, Mobile SDK Share API'yi çağırır ve kontrol bir kez daha Play services öğesine aktarılır.
Cihazı eşlemek istediğiniz uygulamayı veya platformu seçmenize olanak tanıyan bir paylaşım sayfası görüntülenir. Bu ekranda, cihazı paylaşmanız için iki yol 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 komisyon üyesi uygulaması GHSAFM-TC olarak etiketlenmiştir. Cihazınızı paylaşmak için örnek uygulamanın bu örneğine dokunun.
Ardından, harici uygulama (hedef komisyoncu) cihazın devreye alınmasını tamamlar ve kendi yapısında çalışır.
Ayarlar
Ana ekrandan ayarlar
simgesini tıklayın. Burada kullanıcı tercihlerini güncelleme, yardım alma ve uygulama hakkında daha fazla bilgi edinme seçenekleriniz bulunur.Yarım sayfa bildirimi
Ayarlar ekranından, Matter cihaz için proaktif komisyonlu 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 gizlemek isteyebilirsiniz. Daha fazla bilgi için Komisyonlanabilir keşif bildirimlerini gizleme 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 Cihaz ve Kullanıcı Tercihleri DataStore depolarının içeriğini incelemek için aşağıdaki adımları tamamlayın:
Günlük depo içeriği'ni tıklayın.
İletişim kutusunda OK'i (Tamam) tıklayın, ardından Logcat'ı işaretleyin.
Geri bildirim ve yardım
Sample App for Matter ile geliştirme deneyimini nasıl iyileştirebileceğimiz konusunda 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 bir kod hatasıyla karşılaşırsanız sorunları GitHub deposundaki Sorun İzleyici'ye 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: