Konu İçin Google Home Örnek Uygulaması

Matter için Google Home Örnek Uygulaması

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

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

  1. 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:

    APK'yı indirin

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

    Adb'yi yükleme

  3. 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 için Google Home Örnek Uygulaması

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:

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

    Cihaz ekle

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

    QR Kodunu Tara

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

Cihaz Eklendi

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.

  1. 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:

    Target Commissioner'ı indirin

  2. Hedef komisyoncuyu yükleyin.

    $ adb unroot && adb install GHSAFM-1.4.1-targetcommissioner-debug.apk
    
  3. Ana ekranda, cihaz bilgilerini görüntülemek için cihaza dokunun. Paylaş'a dokunun.

    Cihazı paylaş

Ö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:

  1. Hedef komisyoncu uygulamasıyla paylaşılacak kurulum kodu aracılığıyla manuel olarak
  2. 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.

Ayarlar

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:

  1. Havuz içeriğini günlüğe kaydet'i tıklayın.

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

Geri bildiriminizi gönderin

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: