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 uyarısı
Android Studio uygulamasının gizli anahtarları ve şifreleri depolamasını önlemek için aşağıdaki adımları tamamlayın:
- Dosya'yı ve ardından Ayarlar... seçeneğini tıklayın.
- Görünüm ve Davranış bölümünde, Sistem Ayarları'nı genişletin, ardından Şifreler'i tıklayın.
- Kaydetmeyin, yeniden başlattıktan sonra şifreleri unutun'u seçin.
Özellikler
Asistan Simülasyon Aracı
Akıllı ev cihazlarınızın Google Home ekosisteminde düzgün çalışıp çalışmadığını test etmek için Android Studio uygulamasından ayrılmadan Assistant Simulator ile istediğiniz zaman etkileşim kurabilirsiniz.
Actions on Google Console konsolunda sağlanan mevcut Asistan Simülatörü gibi, Assistant Simulator da sorgularınızı yazarak cihazlarınızı kolayca kontrol etmenizi sağlar. Örneğin, "Işıkı aç" Android Studio içinde Assistant Simulator, komutlarınıza göre kısa mesajlarla yanıt verir. Örneğin, "Tamam, ışığı aç."
Cloud Logging'i göster
Google Cloud Logging, İşleminizin kullanımıyla ilgili analizler sunan hata ayıklama bilgileri ve temel metrikler sunar. Geliştirme sürecini kolaylaştırmak için Google Home Plugin, 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 bir 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 olabilir:
- Anladım, 2 lamba açılıyor.
- Elbette, 2 lamba açılıyor.
- Anladım, 2 lamba açılıyor.
- Tamam, 2 lamba açılıyor.
Otomatik testler çalıştırmak ve Google entegrasyonlarınızın bu çeşitli yanıtlardan nasıl yararlandığını doğrulamak için toplu komut dosyalarını Assistant Simulator komut dosyasına göndererek sesli komut dosyaları çalıştırabilirsiniz. Bir komut dosyası kaydedildikten sonra yanıtları toplayabilir ve sorgularınıza karşı 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.
Yükle
Google Home Plugin uygulamasını Android Studio ürününe yüklemek için aşağıdaki 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 Pazar Yeri'ne gidin ve
google homeiçin arama yapın. - Aracı yükleyip Android Studio uygulamasını yeniden başlatın.
Kurulum
Eklentiyi yükledikten sonra Assistant Simulator kullanıp Cloud Logging'i görüntüleyebilmek için aşağıdaki adımları tamamlamanız gerekir:
Google ile oturum aç
Google Home panelinden geliştirici hesabınızda oturum açarak Android Studio sizin adınıza Google hizmetleriyle iletişim kurma yetkisi verebilirsiniz.
Android Studio penceresinin sol tarafındaki dikey sekme sütununda Google Ana Sayfası 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ç yetkilendirme sayfasında İzin ver'i tıklayın.
Tarayıcı penceresini kapatın ve Android Studio uygulamasına dönün.
Şimdi Oturumu Kapat seçeneği ile giriş yapmış olmanız gerekir.
Cloud projesi seçin
Oturum açtıktan sonra, açılır listeden Proje seçin. Proje listenizi filtrelemek için bir Filtre ifadesi (örneğin, matter) yazıp Enter tuşuna basın.
Proje açılır listesi, ilk 100 projeyi Filtrenize göre yükler. Android Studio çıkışı yaptığınızda seçimleriniz korunur.
Proje filtreleriyle ilgili yardım almak için Google Cloud referansında Sorgu parametreleri bölümüne bakın.
Asistan Simülasyon Aracı'nı kullanma
Assistant Simulator öğesini Android Studio uygulamasında açmak için Google Home Plugin panelinden Sinyaller Paneli'ni tıklayın.
Assistant Simulator hizmetine sorgu göndermenin çeşitli yolları vardır. Şimdi her bir seçeneği ele alacağız.
Sorgu yazma ve yanıt toplama
Assistant Simulator ile etkileşim kurmak için sorgunuzu yazıp 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 Tekrar oynat'ı tıklayarak sorgularınızı yeniden çalıştırın ve yanıtlarınızı kontrol edin. Söylentiler paneli, sorgularınızı ve yanıtlarınızı depolanan bir önbellekte tutar. Tekrar oynat seçeneği bu dahili önbelleğe yalnızca yeni yanıtlar ekler ve düğmeyi her tıkladığınızda sorgularınızın kopyaları oluşturulmaz.
İ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ı şurada düzenleyebilirsiniz: Android Studio.
{
"collected": false,
"lines": [
{
"ask": "turn lights on",
"answers": [
"OK, turning 2 lights on.",
"Sure, turning on 2 lights."
]
}
]
}
Toplu yanıtları topla
Kayıtlı JSON dosyalarınızı yeni bir sekmede açmak için Google Home Plugin panelinde Söylentiler Dosyası'nı tıklayın. Yol Seçin bölümünde bir dosya veya klasör seçebilirsiniz. Bir klasör seçerseniz Topla ve Test Et seçeneği, söz konusu klasördeki tüm .json kelime öbekleri ü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 bir noktayı ve .json dosya yolunu gösterir. Topla'yı tıklamanızın ardından
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österir.
Toplama tamamlandığında Durum Çubuğu, .json yolunuzun önünde yeşil bir onay işaretiyle güncellenir ve sesli komut 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 Test et'i tıklayarak sorgularınızı tekrar oynatın ve yanıtlarınız ile 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:
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ı olursa Durum Çubuğu'nda kontrolü gösterilir.
Cloud Logging'i göster
Cloud Logging aracı penceresinde bir proje sekmesi açmak için Google Home Plugin panelinden Cloud Loggings'i tıklayın. Projelerinizin her biri için ayrı Cloud Logging sekmeleri açabilirsiniz.
Sorgu terimleri
Seçili projenizde, Sorgu alanını kullanarak günlükleri de filtreleyebilirsiniz.
Örneğin, light anahtar kelimesine ait günlükleri filtrelemek için:
Logging sorgu dilini kullanmak için QL kullan'ı seçin.
Başlamanıza yardımcı olacak birkaç QL sorgusu örneğini aşağıda 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üklerin tarihe göre sorgulanması da isteğe bağlıdır ve Önce ile Önce seçeneklerini tıklayarak etkinleştirilebilir. Sağlanan metin alanına (ör. 5/11/22, 12:37 PM) tarih ve saat biçiminizi girebilir veya tarih seçiciyi kullanarak
tarihinizi seçip metin alanına saati girebilirsiniz.
5/1/22tarihinden sonra olan bir tarih seçmek için Sonra'yı seçin ve tarih simgesini tıklayın.5/1/22tarihinden önce olan bir tarihi seçmek için Önce öğesini seçin ve tarih simgesini tıklayın.5/1/22ile6/30/22tarihleri arasında bir tarih belirlemek için Önce ve Sonra seçeneklerini belirleyip tarih simgesinden tarihleri seçin .
Canlı proje günlüklerini getirmek için Gerçek zamanlı'yı seçin. Gerçek zamanlı bir özet akışını sonlandırmak için Durdur'u tıklayın.
Önem düzeyi
Açılır menüden Minimum Önem Derecesi de seçebilirsiniz.
Sorgu sonuçları
Sorgu parametrelerinizi göndermek için Getirme'yi 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 simgesini tekrar tıklayın.
İsterseniz 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 dönmek için x simgesini tıklayın.
Ev Grafiğini Görüntüle ve Testleri Çalıştır
Cihazlarınızı listelemek için Google Home Plugin panelinden Ana Sayfa Grafiği'ni seçin.
Seçilen projeyle ilişkili cihazlarınıza ait Cihaz adı, Cihaz kimliği ve Cihaz türünü görüntülemek için Yenile'yi tıklayın. Ayrı projeler için birden çok Google Home Graph paneliniz açık olabilir.
Cihazlarınız yüklendikten sonra JSON yükünü tam olarak genişletmek için herhangi bir kaydı tıklayın.
Cihazlarınızın JSON yükünü görüntülemek ve gizlemek için Genişlet ve Daralt'ı da 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 seçili ve test için hazır olan test paketi tarayıcınızda açı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.
Kaynaklar ve geri bildirim
Geliştirici araçları ve kaynaklarının listesi için Kaynaklar'ı tıklayın.
Google Home Plugin ile ilgili geliştirme deneyimini nasıl geliştirebileceğimize dair düşüncelerinizi veya geri bildirimlerinizi göndermek için Geri bildirim'i tıklayın.
