Android Studio için Google Home Eklentisi

Matter ; Home API'leri

Google Home Plugin for Android Studio, Google Home Platform geliştiricileri için tasarlanmış ve oluşturulmuştur. Bu eklenti, akıllı ev geliştirme sürecinizi basitleştirmek için Google Assistant Simulator, Cloud Logging ve diğer araçlara erişmenizi sağlar.

Güvenlik bildirimi

Android Studio'nın sırları ve şifreleri saklamasını önlemek için aşağıdaki adımları uygulayın:

1. Dosya'yı, ardından Ayarlar...'ı tıklayın.
2. Görünüm ve Davranış bölümünde Sistem Ayarları'nı genişletin ve Şifreler'i tıklayın.
3. Kaydetme, yeniden başlatıldıktan sonra şifreleri unut'u seçin.

Özellikler

Asistan Simülasyon Aracı

Akıllı ev cihazlarınızın Google Home ekosistemiyle düzgün çalışıp çalışmadığını test etmek için Assistant Simulator ile Android Studio'den ayrılmadan istediğiniz zaman etkileşimde bulunabilirsiniz.

Assistant Simulator, sorgularınızı yazarak cihazlarınızı kolayca kontrol etmenizi sağlar. Örneğin, "Işığı aç." Android Studio içinde, Assistant Simulator komutlarınıza göre metin mesajlarıyla yanıt verir. Örneğin, "Tamam, ışığı açıyorum."

Cloud Logging'i görüntüleme

Google Cloud Logging İşleminizin kullanımıyla ilgili analizler sunmak için hata ayıklama bilgileri ve önemli metrikler sağlar. Geliştirme sürecini basitleştirmek için Google Home Plugin, sorun giderme sırasında kodunuzun hemen yanında Cloud Logging mesajlarını gösterir.

Anlık günlükleri görüntüleyebilir veya bir tarih aralığı seçebilirsiniz.

Toplu Konuşma

Assistant Simulator Tek bir ifadeye verilen yanıtlar deterministik değildir. Örneğin, yanıt aşağıdaki ifadelerden herhangi biri olabilir:

• Anlaşıldı, 2 ışığı açıyorum.
• Elbette, 2 ışık açılıyor.
• Anlaşıldı, 2 ışığı açıyorum.
• Tamam, 2 ışığı açıyorum.

Otomatik testler çalıştırmak ve Google entegrasyonlarınızın bu çeşitli yanıtlarla nasıl çalıştığını doğrulamak için Assistant Simulator'ya toplu ifadeler gönderebilirsiniz. Bir komut dosyası kaydedildikten sonra yanıtları toplayabilir ve sorgularınızla ilgili birden fazla test çalıştırabilirsiniz.

Home Graph Görüntüleyici

Home Graph Görüntüleyici, cihazlarınızın durumunu görüntülemenize ve tarayıcınızda Google Home Test Paketi'ni başlatmanıza olanak tanır.

Android Debug Bridge (adb) Günlük Görüntüleyici

Adb Log Viewer, günlük dosyalarını (ör. cihaz günlük dosyaları, Google Home günlükleri ve Android günlükleri) görüntülemek ve analiz etmek için kullanılan bir araçtır.Matter

Yükle

Google Home Plugin'ı Android Studio'e yüklemek için aşağıdaki adımları uygulayın:

1. Android Studio uygulamasını indirin veya güncelleyin. Android Studio'yu indirin
2. Dosya > Ayarlar'a (Android Studio > MacOS'te Tercihler) gidin.
3. Eklentiler bölümünde Marketplace'e gidin ve google home ifadesini arayın.
4. Aracı yükleyin ve Android Studio'ı yeniden başlatın.

Eklentiyi doğrudan JetBrains Marketplace'ten de indirebilirsiniz.

Kurulum

Eklentiyi yükledikten sonra Assistant Simulator uygulamasını kullanabilmek ve Cloud Logging'i görüntüleyebilmek için aşağıdaki adımları tamamlamanız gerekir:

• Google ile oturum aç
• Bir bulut projesi seçin

Google ile oturum aç

Google Home ev kontrol panelinden geliştirici hesabınızda oturum açabilir, Android Studio hizmetinin sizin adınıza Google hizmetleriyle iletişim kurmasına izin verebilirsiniz.

1. Android Studio penceresinin sol tarafındaki dikey sekme sütununda Google Home sekmesini tıklayın.

2. Sign in with (Şununla oturum aç) bölümünde Google'ı tıklayarak tarayıcınızı başlatın.

   

3. Akıllı ev cihazlarınızla bağlantılı hesabı seçin.

4. Google ile oturum açma yetkilendirme sayfasında İzin ver'i tıklayın.

5. Tarayıcı penceresini kapatın ve Android Studio'ya dönün.

Artık oturum açmış olmalısınız. Oturumu kapat seçeneğini kullanabilirsiniz.

Bir Cloud projesi seçin

Oturum açtıktan sonra açılır listeden bir Proje seçin. Proje listenizi filtrelemek için bir filtre ifadesi (örneğin matter) yazın ve Enter tuşuna basın.

Proje açılır listesinde, Filtre ayarınıza göre ilk 100 proje yüklenir. Seçimleriniz, Android Studio uygulamasından çıktığınızda korunur.

Proje filtreleriyle ilgili yardım için Google Cloud Referansı'ndaki Sorgu parametreleri bölümüne bakın.

Asistan Simülasyon Aracı'nı kullanma

Assistant Simulator'ı Android Studio içinde açmak için Google Home Plugin panelinden Utterances Panel'i (İfadeler Paneli) tıklayın.

Assistant Simulator'ya sorgu göndermenin çeşitli yolları vardır. Ardından, her seçeneği inceleyeceğiz.

Sorgu yazma ve yanıt toplama

Assistant Simulator ile etkileşim kurmak için sorgunuzu yazıp Enter tuşuna basın.

Sorgunuzun sonundaki cached yeniden gönder simgesini tıklayarak sorguyu yeniden gönderebilirsiniz.

Bir veya daha fazla sorgu gönderdikten sonra, sorgularınızı yeniden çalıştırmak ve yanıtlarınızı kontrol etmek için cached Yeniden oynat'ı tıklayın. İfadeler paneli, sorgularınızı ve yanıtlarınızı depolanmış bir önbellekte takip eder. Yeniden oynat, bu dahili önbelleğe yalnızca yeni yanıtlar ekler ve düğmeyi her tıkladığınızda sorgularınızı kopyalamaz.

save Kaydet'i tıklayarak İfadeler panelinde girdiğiniz sorguları ve yanıtları kaydedin. Etkileşimleriniz aşağıdaki biçimde JSON'a dönüştürülür:

• ask: Sorgunuz.
• answers: Olası Assistant Simulator yanıt dizisi.

Bu JSON dosyasını Android Studio içinde düzenleyebilirsiniz.

{
  "collected": false,
  "lines": [
    {
      "ask": "turn lights on",
      "answers": [
        "OK, turning 2 lights on.",
        "Sure, turning on 2 lights."
      ]
    }
  ]
}

Toplu yanıtları toplama

Google Home Plugin panelinde Utterances File'ı (Konuşma Dosyası) tıklayarak kayıtlı JSON dosyalarınızı yeni bir sekmede açın. Select Path (Yolu Seç) için bir dosya veya klasör seçebilirsiniz. Klasör seçerseniz Collect (Topla) ve Test (Test Et) bu klasördeki tüm .json dosyalarında çalışır.

Aynı dosya veya farklı dosyalar için birden fazla sekme açabilirsiniz. Örneğin, lights, lights(1) ve plug.

Durum çubuğunda son testinizin sonucu (varsa), dosyanın toplanıp toplanmadığını belirten sarı veya yeşil bir nokta ve .json dosya yolu gösterilir. tocTopla'yı tıkladıktan sonra Assistant Simulator, sorgularınızı çalıştırır. Yeni bir yanıt toplandığında size bildirim gönderilir ve sorgularınız işlenirken durum çubuğunda bir sayaç gösterilir.

Toplama işlemi tamamlandığında Durum Çubuğu, .json yolunuzun önünde yeşil bir onay işaretiyle güncellenir ve ifade dosyalarınız olası yanıtlarla doldurulur.

{
  "collected": true,
  "lines": [
    {
      "ask": "turn lights on",
      "answers": [
        "OK, turning 2 lights on.",
        "Sure, turning on 2 lights.",
        "Sure, turning 2 lights on.",
        "Got it, turning 2 lights on.",
        "Alright, turning on 2 lights.",
        "OK, turning on 2 lights.",
        "Got it, turning on 2 lights.",
        "Alright, turning 2 lights on."
      ]
    }
  ]
}

Erken veri toplamayı durdurursanız .json yolunuz toplanmış olarak işaretlenmez.

Toplu test konuşmaları

Yanıtlarınızı topladıktan sonra, sorgularınızı yeniden oynatmak ve yanıtlarınızı ve günlüklerinizi kontrol etmek için switch_left Test'i tıklayın. Toplu ifadeleri test ettiğinizde Assistant Simulator, JSON dosyanıza kaydedilen yanıtları bekler. Testiniz toplanmamış bir yanıt döndürürse aşağıdaki yanıta benzer bir bildirim alırsınız:

error Expected one of: "Got it, turning on 2 lights."

Bu senaryo, testin başarısız olduğunu gösterir. Aksi takdirde, Assistant Simulator her sorgunuzu çalıştırır ve bir yanıt döndürür. Test başarılı olursa durum çubuğunda bir check işareti gösterilir.

Cloud Logging'i görüntüleme

Cloud Logs araç penceresinde bir proje sekmesi açmak için Google Home Plugin panelinden Cloud Logs'u tıklayın. Projelerinizin her biri için ayrı Cloud Günlükleri sekmeleri açabilirsiniz.

Sorgu terimleri

Seçtiğiniz proje için günlükleri Sorgu alanını kullanarak da filtreleyebilirsiniz. Örneğin, günlükleri light anahtar kelimesine göre filtrelemek için:

Günlük kaydı sorgu dilini kullanmak için QL'yi kullan'ı seçin.

Başlamanıza yardımcı olacak birkaç QL sorgusu örneği:

severity = (DEBUG OR INFO OR NOTICE OR WARNING OR ERROR OR CRITICAL OR ALERT OR EMERGENCY) AND resource.type="assistant_action_project" AND timestamp > "2022-04-07T00:40:18Z"

jsonPayload.executionLog.executionResults.actionResults.action.trait = "TRAIT_ON_OFF"

jsonPayload.executionLog.executionResults.actionResults.action.actionType = "ONOFF_ON"

Tarih ve saat sorguları

Günlükleri tarihe göre sorgulamak da isteğe bağlıdır ve After (Sonra) ile Before (Önce) seçenekleri tıklanarak etkinleştirilebilir. Tarih ve saat biçiminizi sağlanan metin alanına (ör. 5/11/22, 12:37 PM) yazabilir veya tarih seçicileri calendar_month kullanarak tarihinizi seçip metin alanına saati girebilirsiniz.

• 5/1/22 tarihinden sonraki bir tarihi seçmek için Sonra'yı seçin ve tarih simgesini calendar_month tıklayın.
• 5/1/22 tarihinden önceki bir tarihi seçmek için Önce'yi seçin ve tarih simgesini calendar_month tıklayın.
• 5/1/22 ile 6/30/22 arasında bir tarih seçmek için Önce ve Sonra'yı seçip tarih simgesinden calendar_month tarihlerinizi belirleyin.

Canlı proje günlüklerini getirmek için Gerçek zamanlı'yı seçin. Anlık feed'i sonlandırmak için Durdur'u tıklayın.

Önem düzeyi

Açılır listeden En Düşük Önem Derecesi'ni de seçebilirsiniz.

Sorgu sonuçları

Sorgu parametrelerinizi göndermek için cached Getir'i tıklayın.

Günlükler yüklendikten sonra herhangi bir kaydı tıklayarak chevron_right tam JSON yükünü genişletin. Tam mesajı görüntülemek için tekrar chevron_left tıklayın.

İsteğe bağlı olarak, günlük sonuçlarınızı daraltmak için Filtre kutusuna bir anahtar kelime yazabilirsiniz. Filtrenizi kaldırıp orijinal getirme sonuçlarına dönmek için x simgesini tıklayın.

Home Graph'i görüntüleme ve test çalıştırma

Cihazlarınızı listelemek için Google Home Plugin panelinden Home Graph'ı seçin.

Seçili projeyle ilişkili cihazlarınızın Cihaz adı, Cihaz kimliği ve Cihaz türü bilgilerini görüntülemek için cached Yenile'yi tıklayın. Ayrı projeler için birden fazla Google Home Graph panel açabilirsiniz.

Cihazlarınız yüklendikten sonra herhangi bir kaydı tıklayarak chevron_right tam JSON yükünü genişletin.

Cihazlarınızın JSON yüklerini göstermek ve gizlemek için Genişlet ve Daralt seçeneklerini de kullanabilirsiniz.

Belirli bir cihaz için Test Paketi'ni başlatmak üzere Test'i tıklayın. Bu işlem, tarayıcınızda Test Paketi'ni başlatır. Cihazınız seçilmiş ve test etmeye hazır durumdadır. Başlat'ı tıklayın ve test sonuçlarını bekleyin.

Testler tamamlandıktan sonra test ayrıntılarını kontrol edebilir ve günlükleri görüntüleyebilirsiniz.

Android Debug Bridge (adb) Günlük Görüntüleyici

Proje sekmesini Adb Log araç penceresinde açmak için Google Home eklenti araç çubuğunda (solda) Adb Log komutunu tıklayın. Her günlük dosyanız için ayrı Adb Log sekmeleri açabilirsiniz. Sekmeyi silmek için clear simgesini tıklayın.

Görüntülenecek belirli bir günlük kaydı bileşenini seçmek için Seç alanını, yalnızca eşleşen günlük kaydı önem derecesine sahip girişleri görüntülemek için ise Önem Derecesi açılır listesini kullanın.

Seçtiğiniz adb günlüğü için, Büyük/küçük harfe duyarlı veya Regex değiştiricileriyle birlikte Filtre alanını kullanarak günlük girişlerini filtreleyebilirsiniz.

Ayrıca şunları yapabilirsiniz:

• Bul alanını, Sonrakini Bul (arrow_downward simgesi) ve Öncekini Bul (arrow_upward simgesi) komutlarını kullanarak belirli girişleri bulabilirsiniz.
• İsteğe bağlı Büyük/küçük harfe duyarlı veya Normal ifade değiştiricilerini kullanın.
• Günlükte belirtilen satıra (numaraya göre) gitmek için Satıra git'i kullanın.

Satır numaraları eklenmiş günlük satırlarını görüntülemek için Numaralı'yı, ham günlük girişlerini görüntülemek için Ham'ı seçin.

Kaynaklar ve geri bildirim

Geliştirici araçları ve kaynaklarının listesi için Kaynaklar'ı tıklayın.

Google Home Plugin ile geliştirme deneyimini nasıl iyileştirebileceğimiz konusundaki düşüncelerinizi veya geri bildiriminizi göndermek için Geri bildirim'i tıklayın.