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ı yerel Android yapısına ekleyin.
- Fiziksel ve sanal cihazları bir geliştirme yapısına ekleme
- Geliştirme yapınızdaki cihazları kontrol etme (ör. ışığı açma)
- Çoklu yönetici özellikleri, geliştirme yapısındaki cihazları diğer uygulamalarla paylaşmanıza ve diğer uygulamalardan paylaşılan cihazları geliştirme yapısı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 kodunu indirmek, Mobile SDK entegrasyonunu öğrenmek ve Android Studio'da ekranları özelleştirmek için Sample App for Matter codelab'imizi deneyin.
Sample App for Matter codelab'ine gidin
Ön koşullar
- Test için kullanılabilecek bir 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 bir 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. Sorun yaşarsanız örnek uygulamanın MVD'ye göre kullanılıp kullanılmadığını araştırmak çok daha kolay olur.
rootnode_dimmablelight_bCwGYSDpoeuygulamasını kullanarak Matter sanal cihazı oluşturun. Google Home Developer Console'da Matter entegrasyonu oluştururken satıcı kimliği olarak0xFFF1, ürün kimliği olarak0x8000değerini kullanın.all-clusters-appile Espressif cihaz oluşturun. Developer Console'da Matter entegrasyonu oluştururken Tedarikçi Kimliği olarak0xFFF1, Ürün Kimliği olarak0x8001değerini kullanın.
Sample App for Matter ile cihazları devreye 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 Assets (Öğ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ı temel hazırlama
Örnek uygulamayı ilk kez başlattığınızda Sample App for Matter codelab'e yönlendiren bir bağlantının yer aldığı bir iletişim kutusu gösterilir. 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, yerel Android yapısına bir Matter cihazı ve yalnızca örnek uygulamaya özel bir geliştirme yapısı ekleyeceksiniz.
Matter yapıları nedir?
Matter yapısı, ev ağındaki cihazlar arasında paylaşılan bir güven alanıdır ve cihazların birbirleriyle iletişim kurmasını sağlar.
Cihazlarda bir platforma, uygulamaya veya birlikte etkileşimde bulunan bir cihaz grubuna karşılık gelen bir ya da daha fazla yapı olabilir. Fabric'lerin benzersiz bir kimliği vardır ve cihazlar aynı kimlik bilgileri ile sertifika yetkilisi (CA) grubunu paylaşır. Bu kimlik bilgileri, Matter devreye alma işlemi sırasında atanır.
Bir 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, Mobile SDK çağrısından başlatılan Google Play services öğesine aktarılır. Sahiplik kanıtı oluşturmak için QR kodunu tarayın veya Eşleme kodu 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ı.
Cihazları temel hazırlığa tabi tutarken tüm temel hazırlık çalışmaları ve ilgili ekranlar Play services tarafından yönetilir. Bu sayede tutarlı bir kullanıcı deneyimi sağlanır ve kablosuz ağ ile Thread kimlik bilgileri gibi hassas bilgilere erişim izinlerini yönetme ihtiyacı ortadan kalkar.
Cihazları kontrol etme
Geliştirme yapısı, 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 yetkilendirildikten 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 yetkilendiren olur. Örnek uygulamanın, hedef yetkilendirici olarak kullanabileceğiniz 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 Assets (Öğeler) bölümünde
GHSAFM-version-targetcommissioner-debug.apkadlı APK'yı bulun.defaultseçeneğini belirlemeyin.Hedef yetkilendirme aracını yükleyin.
$ adb unroot && adb install GHSAFM-version-targetcommissioner-debug.apkAna 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österilir. Bu ekranda, cihazı paylaşmanız için iki yöntem sunulur:
- Hedef yetkilendirme uygulamasıyla paylaşılacak bir kurulum kodu aracılığıyla manuel olarak
- Matter yetkilisi olarak kayıtlı yerel bir Android uygulamasıyla
Hedef yetkilendirme uygulaması GHSAFM-TC olarak etiketlenir. Cihazınızı paylaşmak için örnek uygulamanın bu örneğine dokunun.
Ardından, harici uygulama (hedef yetkilendirici), cihazı kendi yapısına yetkilendirme işlemini tamamlar.
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çenekleri sunulur.
Yarım sayfa bildirimi
Ayarlar ekranından Matter cihazlar için proaktif yetkilendirilebilir 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 gizleyebilirsiniz. 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 Veri Deposu depolarının içeriğini incelemek için aşağıdaki adımları tamamlayın:
Log repositories content'i (Günlük depoları içeriği) tıklayın.
İletişim kutusunda OK'i (Tamam) tıklayın, ardından Logcat'i kontrol edin.
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ğrulamak için aşağıdaki adımları tamamlamayı deneyin:
Örnek uygulamayı kullanmayla ilgili sorularınız varsa veya kodda bir hata bulursanız GitHub deposundaki Issue Tracker'a sorun bildirebilirsiniz:
Teknik sorularla ilgili olarak 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: