Android Studio için Google Home Eklentisi

Google Home Plugin for Android Studio, Google Home Platform geliştiricileri için tasarlanmıştır. 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 adlı kullanıcının gizli anahtarları ve şifreleri depolamasını önlemek için aşağıdaki adımları uygulayın:

1. Dosya ve ardından Ayarlar... seçeneğini 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şlatma sonrasında şifreleri unut'u seçin.

Özellikler

Asistan Simülasyon Aracı

Akıllı ev cihazlarınızın Google Home ekosisteminde düzgün şekilde çalışıp çalışmadığını test etmek için istediğiniz zaman Android Studio uygulamasından ayrılmadan Assistant Simulator ile etkileşime geçebilirsiniz.

Actions on Google Console Konsolu'nda sağlanan mevcut Asistan Simülatör'e benzer şekilde 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 dayalı kısa mesajlarla yanıt verir. Örneğin, "Tamam, ışığı aç."

Cloud Logging'i göster

Google Cloud Logging, Action'ınızın kullanımıyla ilgili bilgi veren hata ayıklama bilgileri ve temel metrikler sunar. Google Home Plugin, geliştirme sürecini basitleştirmek için sorun giderme sırasında kodunuzun hemen yanında gerçek zamanlı Cloud Logging mesaj gösterir.

Gerçek zamanlı günlükleri görüntüleyebilir veya tarih aralığı seçebilirsiniz.

Toplu İfadeler

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

• Anladım, 2 lamba açılıyor.
• Elbette, 2 lamba açılıyor.
• Anladım, 2 lamba açılıyor.
• Peki, 2 lamba açılıyor.

Otomatik testler yapmak ve Google entegrasyonlarınızın bu farklı yanıtlarla nasıl çalıştığını doğrulamak için ifade komut dosyalarını çalıştırarak Assistant Simulator toplu ifadelerini 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 Görüntüleyici, günlük dosyalarını (ör. Matter cihaz günlük dosyaları, Google Home günlükleri ve Android günlükleri) gösteren ve analiz eden bir araçtır.

Yükle

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

1. Android Studio uygulamasını indirin veya güncelleyin. Android Studio'yu indirme bölümüne bakın
2. Dosya > Ayarlar'a (MacOS'te Android Studio > Tercihler) gidin.
3. Eklentiler bölümünde Pazar yeri'ne gidin ve google home araması yapın.
4. Aracı yükleyip Android Studio uygulamasını yeniden başlatın.

Eklentiyi doğrudan JetBrains Marketplace'ten de indirebilirsiniz.

Kurulum

Eklentiyi yükledikten sonra, Assistant Simulator özelliğini kullanabilmeniz 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çme

Google ile oturum açın

Google Home panelinden geliştirici hesabınızda oturum açarak Android Studio'nın sizin adınıza Google hizmetleriyle iletişim kurma yetkisini verebilirsiniz.

1. Android Studio penceresinin sol tarafındaki dikey sekme sütunundan Google Ana Sayfası sekmesini tıklayın.

2. Oturum aç bölümünde, tarayıcınızı başlatmak için Google'ı tıklayın.

   

3. Akıllı ev cihazlarınıza bağ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 uygulamasına dönün.

Bu durumda Oturumu Kapat seçeneğiyle giriş yapmış olmanız gerekir.

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 (ör. matter) yazıp Enter tuşuna basın.

Proje açılır menüsü, ilk 100 projeyi Filtrenize göre yükler. Seçiminizden çıktığınızda Android Studio seçimleriniz korunur.

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

Asistan Simülasyon Aracı'nı kullanma

Assistant Simulator öğesini Android Studio uygulamasında açmak için Google Home Plugin panelinde Alıntılar Paneli'ni tıklayın.

Assistant Simulator öğesine sorgu göndermenin çeşitli yolları vardır. Şimdi her bir seçeneği inceleyeceğiz.

Sorgu yazma ve yanıt toplama

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

Sorgunuzun sonundaki cachedyeniden gönder simgesini tıklayarak bir 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 Tekrar oynat'yı tıklayın. Söylentiler paneli, sorgularınızı ve yanıtlarınızı depolanan bir önbellekte tutar. Tekrar oynatma yalnızca bu dahili önbelleğe yeni yanıtlar ekler ve düğmeyi her tıkladığınızda sorgularınızın kopyasını oluşturmaz.

Söylentiler paneline girdiğiniz sorguları ve yanıtları kaydetmek için save Kaydet'i tıklayın. Etkileşimleriniz aşağıdaki biçimde JSON'a dönüştürülür:

• ask: Sorgunuz.
• answers: Olası Assistant Simulator yanıtları dizisidir.

Bu JSON dosyasını Android Studio uygulamasında düzenleyebilirsiniz.

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

Toplu yanıtları toplama

Kayıtlı JSON dosyalarınızı yeni bir sekmede açmak için Google Home Plugin panelinde Alıntılar Dosyası'nı tıklayın. Yol Seçin için bir dosya veya klasör seçebilirsiniz. Bir klasör seçerseniz Topla ve Test et seçeneği, söz konusu klasördeki .json dosyanın tüm ifadeleri üzerinde çalışır.

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

Durum Çubuğu, son testinizin sonucunu (varsa), dosyanın toplanıp toplanmadığını belirten sarı veya yeşil noktayı ve .json dosya yolunu gösterir. tocTopla'yı tıkladığınızda Assistant Simulator, sorgularınızı çalıştırır. Yeni bir yanıt alındığında size bildirim gönderilir ve sorgularınız işlenirken Durum Çubuğu bir sayaç görüntüler.

Toplama işlemi tamamlandığında Durum Çubuğu .json yolunuzun önünde yeşil bir onay işaretiyle güncellenir ve seslendirme dosyalarınız olası yanıtlar ile 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."
      ]
    }
  ]
}

Veri toplama işlemini erken durdurursanız .json yolunuz "toplandı" olarak işaretlenmez.

Toplu ifadeleri test etme

Yanıtlarınızı topladıktan sonra sorgularınızı yeniden oynatmak için switch_left Test et'i tıklayın ve yanıtlarınızı ve günlüklerinizi kontrol edin. 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ğıdakine 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 sorgularınızın her birini çalıştırır ve bir yanıt döndürür. Test başarılı olduysa Durum Çubuğu'nda bir check kontrolü görüntülenir.

Cloud Logging'i göster

Cloud Logging aracı penceresinde bir proje sekmesi açmak için Google Home Plugin panelinde Cloud Logging'i tıklayın. Projelerinizin her biri için ayrı Cloud Log sekmeleri açabilirsiniz.

Sorgu terimleri

Seçtiğiniz proje için, Sorgu alanını kullanarak günlükleri de filtreleyebilirsiniz. Örneğin, light anahtar kelimesinin günlüklerini filtrelemek için:

Loging sorgu dilini kullanmak için QL kullan'ı seçin.

Aşağıda, başlamanıza yardımcı olacak birkaç QL sorgusu örneği verilmiştir:

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 sorgulama da isteğe bağlıdır ve Önce ile Önce seçeneklerini tıklayarak etkinleştirilebilir. Tarih ve saat biçiminizi sağlanan metin alanına (ör. 5/11/22, 12:37 PM) yazabilir veya tarihi seçmek için tarih seçicileri kullanabilir calendar_month ve ardından metin alanına saati girebilirsiniz.

• 5/1/22 tarihinden sonra olan bir tarih 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 tarihleri arasında bir tarih seçmek için Önce ve Sonra'yı seçin ve tarih simgesinden calendar_month tarihlerinizi belirleyin.

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

Önem düzeyi

Ayrıca, açılır menüden Minimum Önem Derecesi de seçebilirsiniz.

Sorgu sonuçları

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

Günlükler yüklendikten sonra JSON yükünün tamamını genişletmek için herhangi bir kaydı chevron_right tıklayın. Mesajın tamamını görüntülemek için chevron_left simgesini tekrar 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ırmak ve orijinal getirme sonuçlarına geri dönmek için x simgesini tıklayın.

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

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

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

Cihazlarınız yüklendikten sonra, JSON yükünün tamamını genişletmek için herhangi bir kaydı chevron_right tıklayın.

Cihazlarınızın JSON yükünü görüntülemek ve gizlemek için Genişlet ve Daralt seçeneklerini de kullanabilirsiniz.

Belirli bir cihaz için Test Paketi'ni başlatmak istiyorsanız Test et'i tıklayın. Bunu yaptığınızda, cihazınızda cihazınız seçili ve test edilmeye hazır olarak Test Paketi başlatılır. Başlat'ı tıklayın ve test sonuçlarını bekleyin.

Test ayrıntılarını kontrol edebilir ve testler tamamlandığında günlükleri görüntüleyebilirsiniz.

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

Adb Log aracı penceresinde bir proje sekmesi açmak için soldaki Google Home eklenti araç çubuğunda Adb Log komutunu tıklayın. Günlük dosyalarınızın her biri için ayrı Adb Log sekmeleri açabilirsiniz. Bir sekmeyi silmek için clear simgesini tıklayın.

Görüntülenecek belirli bir günlük kaydı bileşeni seçmek için Select (Seç) alanını, yalnızca eşleşen günlük önem derecesine sahip girişleri görüntülemek için Önem derecesi açılır menüsünü kullanın.

Seçtiğiniz adb günlüğü için isteğe bağlı Büyük/küçük harfe duyarlı veya Regex değiştiricilere sahip Filtre alanını kullanarak günlük girişlerini filtreleyebilirsiniz.

Ayrıca:

• Bul alanını ve Sonrakini Bul (arrow_downward simgesi) ve Öncekini Bul (arrow_upward simgesi) komutlarını kullanarak belirli girişleri bulun.
• İsteğe bağlı Büyük/küçük harfe duyarlı veya Normal ifade değiştiricileri kullanın.
• Günlükte belirli bir satıra (sayıya göre) atlamak için satıra atlayın.

Satır numaralarının eklendiği günlük satırlarını görüntülemek için Numaralı'yı seçin. 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 konusunda düşüncelerinizi veya geri bildirimlerinizi göndermek için Geri Bildirim'i tıklayın.