Google Home Sample App for Matter, Google Home app (GHA) benzeri bir Android uygulaması oluşturmak için Google Home Mobile SDK uygulamasını kullanır. Bu örnek uygulama aşağıdaki özellikleri sağlar:
- Fiziksel ve sanal Matter cihazları Yerel Android kumaşına aktarın
- Fiziksel ve sanal cihazları bir geliştirme kumaşına yaptırın
- Geliştirme kumaşınızdaki cihazları kontrol edin. Örneğin, bir ışığı açmak
- Çoklu yönetici özellikleri, geliştirme kumaşındaki cihazları diğer uygulamalarla paylaşmanıza ve tersine diğer uygulamalardan paylaşılan geliştirme cihazı listesine ekleme yapmanıza olanak tanır
- Geliştirici Yardımcı Programları
Bu rehberde, Sample App for Matter APK'nın nasıl yükleneceği ve Matter cihazların komisyon alması, kontrol edilmesi ve paylaşılması için nasıl kullanılacağı açıklanmaktadır.
Kaynak kodu indirmek, Mobile SDK uygulamasını nasıl entegre edeceğinizi öğrenmek ve Android Studio'da ekranları özelleştirmek için Sample App for Matter codelab'imizi deneyin.
Sample App for Matter codelab'e gidin
Ön koşullar
- Test için kullanılabilen Android O (8.1, API düzeyi 27) veya daha yeni bir cihaz. Cihazınızda en son Matter desteğinin bulunduğundan emin olmak için Matter Modüllerini ve Hizmetleri Doğrulama kılavuzunu inceleyin.
- Açık/kapalı özellikleriyle bir Matter cihazı oluşturun. Bu örnek uygulama bir sanal cihaz ve ESP32 ile çalışır.
rootnode_dimmablelight_bCwGYSDpoe
uygulamasıyla bir Matter Sanal Cihaz oluşturun. Google Home Developer Console hizmetinde bir Matter entegrasyonu oluşturduğunuzda tedarikçi kimliği olarak0xFFF1
ve ürün kimliğiniz olarak0x8000
kullanın.all-clusters-app
ile bir Espressif Cihazı oluşturun. Developer Console ürününde Matter entegrasyonu oluşturduğunuzda tedarikçi kimliği olarak0xFFF1
, Ürün kimliğiniz olarak0x8001
kullanın.
Sample App for Matter ile cihazları çalıştırmak ve kontrol etmek için bir merkeze (ör. Google Nest Hub (2nd gen)) ihtiyacınız yoktur.
Yükle
Sample App for Matter GitHub deposundaki Sürümler bölümüne gidin.
GHSAFM-1.4.1-default-debug.apk
adlı APK'yı bulun.targetcommissioner
öğesini seçmeyin: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-1.4.1-default-debug.apk
Komisyon cihazları
Örnek uygulamayı ilk kez başlattığınızda Sample App for Matter codelab bağlantısını içeren bir iletişim kutusu görürsünüz. Bu mesajı bir daha gösterme'yi seçerseniz istediğiniz zaman uygulamanın Yönetici bölümünde tercihlerinizi güncelleyerek iletişim kutusunu geri getirebilirsiniz.
Sonraki adımlarda, Yerel Android kumaşına bir Matter cihazı ve yalnızca örnek uygulamaya özgü bir geliştirme kumaşı ekleyeceksiniz.
Matter kumaş nedir?
Matter kumaşı, ev ağındaki cihazlarda birbirleriyle iletişim kurabilmelerini sağlayan paylaşımlı bir güven alanıdır.
Cihazlar; birlikte etkileşimde bulunan bir platforma, uygulamaya veya cihaz grubuna karşılık gelen bir veya daha fazla kumaşa sahip olabilir. Kumaşlar benzersiz bir kimliğe sahiptir ve cihazlar aynı kimlik bilgisi grubunu ve sertifika yetkilisini (CA) paylaşır. Bu kimlik bilgileri, Matter komisyonu sırasında atanır.
Bir Matter cihazını çalıştırmak için aşağıdaki adımları tamamlayın:
Deneme sürecini başlatmak için
Cihaz Ekle düğmesine dokunun.Ardından kontrol, Mobile SDK çağrısından başlatılan Google Play services öğesine aktarılır. Sahip olduğunuzu kanıtlamak için QR kodunu tarayın veya Eşleme kodunu kullan'a dokunun.
Komisyon alma işlemi tamamlandığında bir Cihaz Adı girin, ardından Bitti'ye dokunun.
Cihazınız artık hem Yerel Android kumaşına hem de geliştirme kumaşına bağlandı.
Tüm komisyonlama çalışmaları ve ilişkili ekranlar, cihaz çalışmalarında Play services tarafından gerçekleştirilir. Bu, tutarlı bir kullanıcı deneyimi sağlar ve kablosuz ağ ile ileti dizisi kimlik bilgileri gibi hassas izinleri işleme ihtiyacını ortadan kaldırır.
Cihazları kontrol etme
Geliştirme kumaşı Matter cihazlarını doğrudan örnek uygulamadan kontrol etmek için kimlik bilgilerini oluşturur.
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
Bir cihazın paylaşılması, Matter spesifikasyonunda çoklu yönetici akışı olarak adlandırılır. Bir cihaz örnek uygulamaya uygulandıktan sonra 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 platformun yüklü olması gerekir. Bu harici platform, hedef komisyoncusu olur. Hedef komisyoncu olarak kullanabileceğiniz başka bir örnek uygulama örneği oluşturduk.
Sample App for Matter GitHub deposundaki Sürümler bölümüne gidin.
GHSAFM-[version]-targetcommissioner
adlı en yeni APK'yı bulun. Örneğin:GHSAFM-1.4.1-targetcommissioner-debug.apk
:Hedef komisyoncuyu yükleyin.
$ adb unroot && adb install GHSAFM-1.4.1-targetcommissioner-debug.apk
Ana ekranda, 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, tekrar Play services uygulamasına 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 ekran, cihazı paylaşmak için iki yol sağlar:
- Hedef komisyoncu uygulamasıyla paylaşılacak kurulum kodu aracılığıyla manuel olarak
- Matter komisyoncusu olarak kayıtlı yerel bir Android uygulamasıyla
Hedef komisyoncu uygulaması GHSAFM-TC olarak etiketlenir. Cihazınızı paylaşmak için bu örnek uygulamanın örneğine dokunun.
Ardından, harici uygulama (hedef komisyoncusu), cihazın kendi kumaşına yaptırılması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çeneklerine sahipsiniz.Yarım bildirim
Ayarlar ekranından, Matter cihazlar için proaktif olarak yürütülebilir keşif bildirimlerini devre dışı bırakabilirsiniz.
Uygulamanız kendi Matter keşif veya taahhüt akışını sağlıyorsa kesintileri önlemek için bu bildirimleri kapatabilirsiniz. Daha fazla bilgi için Komisyon alınabilir keşif bildirimlerini engelleme bölümüne bakın.
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:
Havuz içeriğini günlüğe kaydet'i tıklayın.
İletişim kutusunda Tamam'ı tıklayın ve Logcat'i işaretleyin.
Geri bildirim ve yardım
Sample App for Matter ile geliştirme deneyimini nasıl iyileştirebileceğimizle ilgili 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ı kullanma hakkında sorularınız varsa veya bir kod hatasıyla karşılaşırsanız sorunları GitHub deposundaki Sorun İzleyici'ye gönderebilirsiniz:
Google'dan teknik sorularla ilgili resmi rehberlik almak için Smart Home Geliştirici Forumu'nu kullanın:
Topluluktan teknik destek almak için Stack Overflow'da google-smart-home
etiketini kullanın: