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.

Android Studio için Google Home Eklentisi

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:

  1. Dosya ve ardından Ayarlar... seçeneğini tıklayın.
  2. Görünüm ve Davranış'ta, Sistem Ayarları'nı genişletin, ardından Şifreler'i tıklayın.
  3. Kaydetme, yeniden başlattıktan sonra şifreleri unut'u seçin.
Android Studio için Google Home Eklentisi

Ö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."

Asistan Simülatörü ile Test Et

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.

Cloud Logging Görünümü

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:

  1. Android Studio uygulamasını indirin veya güncelleyin. Android Studio'yu indirin
  2. Dosya > Ayarlar'a (MacOS'te Android Studio > Tercihler) gidin.
  3. Eklentiler bölümünde Marketplace'e gidin ve google home ifadesini arayın.
  4. 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.

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

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

    Android Studio Google ile Oturum Açma
  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 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 seçin

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.

İfadeler Panelini Aç

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.

Asistan Simülatörü ile Söylenenleri Tekrar Oynatma

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

Asistan Simülatörü ile Konuşmaları Toplayın

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.

Asistan Simülatörü ile Konuşmaları Toplayın
{
  "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."

Asistan Simülatörü ile Anlatım Çalıştırma

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.

Asistan Simülatörü ile Anlatım Çalıştırma

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.

Cloud Logging Sekmeleri

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:

Cloud Logging Sorgusu

Logging sorgu dilini kullanmak için Use QL'yi (QL Kullan) seçin.

Cloud Logging Sorgu Dili

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/22 tarihinden sonra olan bir tarih seçmek için Sonrası'nı seçin ve tarih simgesini tıklayın.
  • 5/1/22 tarihinden önceki bir tarihi seçmek için Önce'yi seçin ve tarih simgesini tıklayın.
  • 5/1/22 ile 6/30/22 arası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.

Cloud Logging'i göster

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.

Home Graph JSON Yükü

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

Home Grafiği JSON'u Genişletme ve Daraltma

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.

Home Graph Çalıştırma Testleri

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

Ana Sayfa Grafiği Tamamlanan Testler

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.

Adb Günlüğü Görüntüleyici

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.

Geri bildirim gönder