Konu İçin Google Home Örnek Uygulaması

Matter için Google Home Örnek Uygulaması

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ı Local Android fabric'e ekleme
  • 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ı devreye almak, kontrol etmek ve paylaşmak için nasıl kullanılacağı açıklanmaktadır.

Kaynak kodunu indirmek, Mobile SDK simgesini entegre etmeyi öğrenmek ve Android Studio'da ekranları özelleştirmek için Mobile SDK codelab'imizi deneyin.Sample App for Matter

Sample App for Matter Codelab'e gidin

Ön koşullar

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

  1. Sample App for Matter GitHub deposundaki Releases (Yayınlar) bölümüne gidin. En son sürüm için Varlıklar bölümünde GHSAFM-version-default-debug.apk adlı APK'yı bulun. targetcommissioner seçeneğini belirlemeyin.

  2. Android Debug Bridge'i (adb) yükleyin:

    adb'yi yükleme

  3. 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 codelab'ine bağlantı içeren 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 geri getirebilirsiniz.

Sonraki adımlarda, Matter cihazını Local Android yapısına ve yalnızca örnek uygulamaya özel bir geliştirme yapısına ekleyeceksiniz.

Matter kumaşlar nedir?

Matter için Google Home Örnek Uygulaması

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 ile sertifika yetkilisi (CA) kümesini paylaşır. Bu kimlik bilgileri Matter devreye alma sırasında atanır.

Bir Matter cihazı devreye almak için aşağıdaki adımları tamamlayın:

  1. Hazırlama sürecini başlatmak için Cihaz Ekle düğmesine dokunun.

    Cihaz ekle

  2. 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.

    QR Kodunu Tara

  3. İ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. Wi-Fi 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ı olarak ayarlayabilirsiniz. Cihaz ayrıntılarına erişmek için cihaza dokunun.

Cihaz Eklendi

Cihazları paylaşma

Bir cihazı paylaşma işlemi, Matter spesifikasyonunda çoklu yönetici akışı olarak adlandırılır. Bir cihaz örnek uygulamaya eklendikten 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.

  1. Sample App for Matter GitHub deposundaki Releases (Yayınlar) bölümüne gidin. En son sürüm için Varlıklar bölümünde GHSAFM-version-targetcommissioner-debug.apk adlı APK'yı bulun. default seçeneğini belirlemeyin.

  2. Hedef komisyoneri yükleyin.

    $ adb unroot && adb install GHSAFM-version-targetcommissioner-debug.apk
    
  3. Ana ekranda cihaza dokunarak cihaz bilgilerini görüntüleyin. Paylaş'a dokunun.

    Cihazı paylaş

Örnek uygulama, Mobile SDK Share API'yi çağırır ve kontrol tekrar Play services'ye 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:

  1. Hedef komisyoner uygulamasıyla paylaşılacak bir kurulum kodu aracılığıyla manuel olarak
  2. 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 ekranda ayarlar simgesini tıklayın. Burada kullanıcı tercihlerini güncelleme, yardım alma ve uygulama hakkında daha fazla bilgi edinme seçenekleri bulunur.

Ayarlar

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 görevlendirme akışını sağlıyorsa kesintileri önlemek için bu bildirimleri devre dışı bırakmak isteyebilirsiniz. Daha fazla bilgi için Komisyon kazandıran keşif bildirimlerini devre dışı bırakma 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çeriklerini incelemek için aşağıdaki adımları tamamlayın:

  1. Log repositories content'i (Depo içeriğini günlüğe kaydet) tıklayın.

  2. İ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 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 kod hatası keşfederseniz GitHub deposundaki Sorun İzleyici'ye sorun 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: