Android Studio için Google Home Eklentisi

Koleksiyonlar ile düzeninizi koruyun İçeriği tercihlerinize göre kaydedin ve kategorilere ayırın.

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.

Android Studio için Google Home Eklentisi

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:

  1. Dosya'yı 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, ardından Şifreler'i tıklayın.
  3. Kaydetmeyin, yeniden başlattıktan sonra şifreleri unutun'u seçin.
Android Studio için Google Home Eklentisi

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

Asistan Simülasyon Aracı ile test etme

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.

Cloud Logging Görünümü

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:

  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 Pazar Yeri'ne gidin ve google home için arama 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 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.

  1. Android Studio penceresinin sol tarafındaki dikey sekme sütununda 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.

    Android Studio Google ile Oturum Açma
  3. Akıllı ev cihazlarınıza bağlı hesabı seçin.

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

  5. 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 seçin

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.

Söylemeler Paneli'ni aç

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.

Asistan Simülatörü ile Söylemeleri Tekrarlama

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

Asistan Simülatörü ile Telaffuzları Toplama

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.

Asistan Simülatörü ile Telaffuzları Toplama
{
  "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."

Asistan Simülasyon Aracı ile Söylemeler Yapın

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.

Asistan Simülasyon Aracı ile Söylemeler Yapın

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.

Cloud Logging Sekmeleri

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:

Cloud Logging Sorgusu

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

Cloud Logging Sorgu Dili

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

Cloud Logging'i göster

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.

Home Graph JSON Yükü

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

Home Graph genişlet ve JSON'ı daralt

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.

Home Graph Run Testleri

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

Home Graph Completed Testleri

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.

Geri bildirim gönder