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 ürününün gizli anahtarları ve şifreleri depolamasını önlemek için aşağıdaki adımları tamamlayın:
- Dosya ve ardından Ayarlar... seçeneğini tıklayın.
- Görünüm ve Davranış'ta, Sistem Ayarları'nı genişletin, ardından Şifreler'i tıklayın.
- Kaydetme, yeniden başlattıktan sonra şifreleri unut'u seçin.
Özellikler
Asistan Simülatörü
Akıllı ev cihazlarınızın Google Home ekosistemiyle düzgün çalışıp çalışmadığını test etmek için Android Studio ürününden ayrılmadan istediğiniz zaman Assistant Simulator ile etkileşimde bulunabilirsiniz.
Actions on Google Console Konsolu'nda sunulan mevcut Asistan Simülatörü'ne 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 uygun şekilde kısa mesajlarla yanıt verir. Örneğin, "Tamam, ışığı açıyorum."
Cloud Logging'i göster
Google Cloud Logging, işleminizin kullanımıyla ilgili analizler için hata ayıklama bilgileri ve temel metrikler sağlar. Geliştirmeyi kolaylaştırmak için Google Home Plugin, sorun giderme sırasında kodunuzun hemen yanında gerçek zamanlı Cloud Logging mesajları gösterir.
Gerçek zamanlı günlükleri görüntüleyebilir veya bir tarih aralığı seçebilirsiniz.
Toplu İfadeler
Tek bir ifadeye verilen Assistant Simulator yanıtları belirleyici değildir. Örneğin, yanıt aşağıdaki ifadelerden herhangi biri olabilir:
- Anladım, 2 lamba açılıyor.
- Tamamdır, 2 lamba açılıyor.
- Anladım, 2 lamba açılıyor.
- Peki, 2 lamba açılıyor.
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 telaffuz komut dosyalarını çalıştırarak Assistant Simulator'ye 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 Viewer cihazlarınızın durumunu görüntülemenizi ve tarayıcınızda Google Home Test Suite'i başlatmanızı sağlar.
Android Debug Bridge (adb) Günlük Görüntüleyici
Adb Günlüğü 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örüntüleme ve analiz etmeye yarayan bir araçtır.
Yükle
Google Home Plugin uygulamasını Android Studio uygulamasına yüklemek için şu adımları uygulayın:
- Android Studio uygulamasını indirin veya güncelleyin. Android Studio'yu indirin
- Dosya > Ayarlar'a (MacOS'te Android Studio > Tercihler) gidin.
- Eklentiler bölümünde Marketplace'e gidin ve
google homeifadesini arayın. - Aracı yükleyin ve Android Studio uygulamasını yeniden başlatın.
Eklentiyi doğrudan JetBrains Marketplace'ten de indirebilirsiniz.
Kurulum
Eklentiyi yükledikten sonra Assistant Simulator ürününü kullanabilmek ve Cloud Logging'i görüntüleyebilmek için aşağıdaki adımları tamamlamanız gerekir:
Google ile oturum açın
Google Home panelinden geliştirici hesabınızda oturum açarak Android Studio sitesine sizin adınıza Google hizmetleriyle iletişim kurma yetkisi verebilirsiniz.
Android Studio penceresinin sol tarafındaki dikey sekme sütununda bulunan Google Home sekmesini tıklayın.
Oturum aç bölümünde, tarayıcınızı başlatmak için Google'ı tıklayın.
Akıllı ev cihazlarınıza bağlı hesabı seçin.
Google ile oturum açma yetkilendirme sayfasında İzin ver'i tıklayın.
Tarayıcı penceresini kapatın ve Android Studio uygulamasına dönün.
Bu aşamada giriş yapmış olmanız ve Oturumu Kapat seçeneğini belirlemeniz 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 Filter ifadesi yazın (ör. matter) ve ardından Enter tuşuna basın.
Proje açılır listesi, Filtrenize bağlı olarak ilk 100 projeyi yükler. Android Studio uygulamasından çıktığınızda seçimleriniz korunur.
Proje filtreleriyle ilgili yardım için Google Cloud Referansı'ndaki Sorgu parametreleri bölümüne bakın.
Asistan Simülatörü'nü kullanma
Assistant Simulator panelini Android Studio içinde açmak için Google Home Plugin panelinden İfadeler Paneli'ni tıklayın.
Sorguları Assistant Simulator aracına göndermenin birkaç yolu vardır. Şimdi her bir seçeneği ele alacağız.
Sorgu yazma ve yanıtları toplama
Assistant Simulator ile etkileşim kurmak için sorgunuzu yazın ve Enter tuşuna basın.
Sorgunuzun sonundaki 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 Tekrar Oynat'ı tıklayın. İfadeler paneli, sorgularınızı ve yanıtlarınızı depolanan bir önbellekte tutar. Tekrar oynat, bu dahili önbelleğe yalnızca yeni yanıtlar ekler ve düğmeyi her tıkladığınızda sorgularınızı çoğaltmaz.
İfadeler paneline girdiğiniz sorguları ve yanıtları kaydetmek için 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ı dizisi.
Bu JSON dosyasını Android Studio üzerinde düzenleyebilirsiniz.
{
"collected": false,
"lines": [
{
"ask": "turn lights on",
"answers": [
"OK, turning 2 lights on.",
"Sure, turning on 2 lights."
]
}
]
}
Toplu yanıtları toplama
Kaydettiğiniz JSON dosyalarını yeni bir sekmede açmak için Google Home Plugin panelinde Utterances File'ı (Utterances Dosyası) tıklayın. Yol Seçin alanında bir dosya veya klasör seçebilirsiniz. Bir klasör seçerseniz Topla ve Test, bu klasördeki .json dosyalarındaki tüm ifadeler ü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ı göstermek için sarı veya yeşil bir nokta ve .json ifadesinin dosya yolunu görüntüler. Topla'yı tıkladıktan sonra Assistant Simulator, sorgularınızı çalıştırır.
Yeni bir yanıt alındığında bildirim alırsınız ve sorgularınız işlenirken Durum Çubuğu bir sayaç görüntüler.
Topla 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."
]
}
]
}
Toplama işlemini erkenden Durdurursanız .json yolunuz toplandı olarak işaretlenmez.
Toplu ifadeleri test etme
Yanıtlarınızı topladıktan sonra Test'i tıklayarak sorgularınızı tekrar oynatıp 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ğıdaki yanıta benzer bir bildirim alırsınız:
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ı olmuşsa Durum Çubuğunda bir kontrolü görüntülenir.
Cloud Logging'i göster
Bulut Günlükleri araç penceresinde bir proje sekmesi açmak için Google Home Plugin panelinde Bulut Günlükleri'ni tıklayın. Projelerinizin her biri için ayrı Cloud Log sekmeleri açabilirsiniz.
Sorgu terimleri
Seçtiğiniz projede, günlükleri Sorgu alanını kullanarak da filtreleyebilirsiniz.
Örneğin, light anahtar kelimesi için günlükleri filtrelemek için:
Logging sorgu dilini kullanmak için Use QL'yi (QL Kullan) seçin.
Başlamanıza yardımcı olacak birkaç QL sorgusu örneğini burada bulabilirsiniz:
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 Sonra ve Önce tıklanarak etkinleştirilebilir. Sağlanan metin alanına tarih ve saat biçiminizi yazabilir (ör. 5/11/22, 12:37 PM) veya tarih seçmek için tarih seçicileri kullanarak tarihi seçebilir, ardından metin alanına saati girebilirsiniz.
5/1/22tarihinden sonra olan bir tarih seçmek için Sonrası'nı seçin ve tarih simgesini tıklayın.5/1/22tarihinden önceki bir tarihi seçmek için Önce'yi seçin ve tarih simgesini tıklayın.5/1/22ile6/30/22arasında bir tarih seçmek için Önce ve Sonra'yı seçin, ardından tarih simgesinden tarihlerinizi seçin.
Yayındaki proje günlüklerini getirmek için Gerçek zamanlı'yı seçin. Gerçek zamanlı bir feed'i sonlandırmak için Durdur'u tıklayın.
Önem düzeyi
Açılır listeden Minimum Önem Derecesi de seçebilirsiniz.
Sorgu sonuçları
Sorgu parametrelerinizi göndermek için Getir'i tıklayın.
Günlükler yüklendikten sonra JSON yükünün tamamını genişletmek için herhangi bir kaydı tıklayın. İletinin tamamını görüntülemek için 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.
Ana Sayfa Grafiği'ni Görüntüleyin ve Testleri Çalıştırın
Cihazlarınızı listelemek için Google Home Plugin panelinden Home Graph'i (Ana Sayfa Grafiği) seçin.
Seçilen projeyle ilişkilendirilmiş cihazlarınız için Cihaz adı, Cihaz kimliği ve Cihaz türü bilgilerini görüntülemek için Yenile'yi tıklayın. Ayrı projeler için birden fazla Google Home Graph paneliniz açık olabilir.
Cihazlarınız yüklendikten sonra JSON yükünün tamamını genişletmek için herhangi bir kaydı tıklayın.
Cihazlarınızın JSON yüklerini görüntülemek ve gizlemek için Genişlet ve Daralt seçeneklerini de kullanabilirsiniz.
Belirli bir cihazda Test Paketi'ni başlatmak için Test'i tıklayın. Tarayıcınızda Test Paketi'ni, cihazınız seçili ve teste hazır bir şekilde başlatırsınız. Başlat'ı tıklayın ve test sonuçlarını bekleyin.
Test ayrıntılarını kontrol edebilir ve testler tamamlandıktan sonra günlükleri görüntüleyebilirsiniz.
Android Debug Bridge (adb) Günlük Görüntüleyici
Adb Günlüğü araç penceresinde bir proje sekmesi açmak için Google Home eklentisi araç çubuğundan (solda) Adb Log komutunu tıklayın. Günlük dosyalarınızın her biri için ayrı Adb Günlüğü sekmeleri açabilirsiniz. Bir sekmeyi silmek için simgesini tıklayın.
Görüntülenecek belirli bir günlük kaydı bileşeni seçmek için Seç alanını ve yalnızca günlük önem derecesine uyan girişleri görüntülemek için Önem derecesi açılır menüsünü kullanın.
Seçtiğiniz adb günlüğünüz için Filtre alanını isteğe bağlı Büyük/küçük harfe duyarlı veya Regex değiştiricileriyle birlikte kullanarak günlük girişlerini filtreleyebilirsiniz.
Ayrıca:
- Bul alanı ile Sonrakini Bul ( simgesi) ve Öncekini Bul ( simgesi) komutlarını kullanarak belirli girişleri bulabilirsiniz.
- İsteğe bağlı Büyük/küçük harfe duyarlı veya Regex değiştiricileri kullanın.
- Günlükte belirli bir satıra (sayıya göre) atlamak için satıra atla.
Satır numaraları eklenmiş 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 Raw'u seçin.
Kaynaklar ve geri bildirim
Geliştirici araçlarının 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.
