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

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

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

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

    Adb'yi yükle

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

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:

  1. Devreye alma işlemini başlatmak için Cihaz Ekle düğmesine dokunun.

    Cihaz ekle

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

    QR Kodunu Tara

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

Cihaz Eklendi

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.

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

  2. Hedef komisyoncuyu yükleyin.

    $ adb unroot && adb install GHSAFM-version-targetcommissioner-debug.apk
    
  3. Ana ekrandan, 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 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:

  1. Hedef komisyoncu 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 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.

Ayarlar

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:

  1. Günlük depo içeriği'ni tıklayın.

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

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