Google Home Playground

Cloud-to-cloud    Local Home SDK    Home API'leri

Google Home Playground, yapılandırılabilir cihaz türleri ve özellikleriyle bir akıllı ev projesini simüle eden bir web uygulamasıdır. Sanal cihazlar oluşturabilir, cihaz özelliklerini ve durumlarını değiştirebilir, bu cihazları Google Home Graph uygulamasında görüntüleyebilir ve cihaz yapılandırmalarını içe veya dışa aktarabilirsiniz.

Hesap bağlama işlemini tamamlama

Google Home Playground aracını kullanmak için önce aracı hesabınıza bağlamanız önerilir. Telefonunuzda Google Home app (GHA) uygulamasını açın ve Google Home uygulamasında üçüncü taraf akıllı ev cihazlarını bağlama başlıklı makalede açıklanan hesap bağlama işlemini uygulayın.

  1. Google Home Playground başlıklı entegrasyonu arayın.
  2. Entegrasyonu seçtiğinizde GHA sizi oturum açma sayfasına yönlendirir. Google ile oturum aç'ı tıklayın ve oturum açmak için hesabınızı seçin.
  3. Hesap bağlamayı yetkilendirmek için Yetkilendir düğmesini tıklayın.
Bu resimde, Google Home Playground'u bağlamak için Google Home uygulaması hesap bağlama akışı gösterilmektedir.

Hesap bağlama işlemini tamamladıktan sonra, etkileşimde bulunabileceğiniz bir dizi varsayılan sanal cihaz GHA uygulamasında gösterilir.

Bu resimde, bir kullanıcı Google Home Playground'u hesabına başarıyla bağladığında doldurulan varsayılan cihaz listesi gösterilmektedir.

Oturum aç

Aşağıdaki düğmeyi tıklayarak Google Home Playground uygulamasını başlatın:

Playground'u başlat

Google ile oturum aç'ı tıklayın. Hesap bağlama işlemini tamamlamak için GHA uygulamasında kullandığınız hesapla oturum açtığınızdan emin olun.

Bu resimde Google Home Playground'un ilk durumu gösteriliyor ve sağ üst köşedeki oturum açma düğmesi vurgulanıyor.

Oturum açtıktan sonra Google Home Playground, Home Graph içinde depolanan sanal cihazları gösterir.

Bu resimde, Google Home Playground'un varsayılan görünümünün cihaz listesi, cihaz bilgileri ve günlük alanı gösterilmektedir.

Web kullanıcı arayüzü üç panelden oluşur:

  • Cihaz listesi, tüm sanal cihazlarınızı gösterir. Bu panelden belirli bir sanal cihazı seçerek bilgilerini görüntüleyebilir ve sanal cihazlar oluşturabilirsiniz.
  • Cihaz bilgileri, seçilen sanal cihazın bilgilerini gösterir. Ayrıca bu bilgileri düzenleyebilir ve seçili sanal cihazı panelden kaldırabilirsiniz.
  • Günlük alanı, Google Home Playground ile Home Graph arasındaki etkileşim günlüklerini gösterir. Sorun giderme için istek ve yanıt yüklerini incelemek üzere günlükleri genişletebilirsiniz.

Sanal cihaz

Sanal cihaz bilgilerini görüntüleme

Cihaz listesi panelinde, görüntülemek istediğiniz sanal cihazı seçin. Cihaz listesi panelinde, görüntülemek istediğiniz sanal cihazı seçin. Cihaz bilgileri panelinde, bilgiler beş sekme altında kategorize edilir:

  • Temel bilgiler: Cihaz türü, kimliği ve adı dahil olmak üzere cihazın üst düzey özellikleri.
  • Özellikler: Cihazın desteklenen özellikleri.
  • Özellikler: Cihazın özelliğe özgü nitelikleri.
  • Durumlar: Tüm cihaz durumları.
  • SUV: Cihazın ikincil kullanıcı doğrulama yapılandırması.

Sanal cihaz bilgilerini düzenleme

Sanal cihazların bilgilerini görüntülemenin yanı sıra Home Graph uygulamasında depolanan bilgileri Cihaz bilgileri panelinden doğrudan düzenleyebilirsiniz.

Desteklenen özellikleri değiştirme

  1. Özellikler sekmesini seçin ve Düzenle düğmesini tıklayın.
  2. Pop-up panelde, cihazın şu anda desteklenen özelliklerini ve eklenebilecek özellikleri görebilirsiniz. Cihaz için desteklenen özellikleri eklemek veya kaldırmak üzere ok (arrow_forward/arrow_back) düğmelerini kullanın.
  3. Desteklenen özellikleri güncellemeyi tamamladığınızda Kaydet'i tıklayın. Güncellenen özellikler Home Graph cihazına uygulanır.
  4. Bu özellik güncellemelerini Günlük alanında görebilirsiniz.
Bu görselde, Google Home Playground'da seçili bir cihazda desteklenen özellikleri eklemek veya silmek için kullanılan kullanıcı deneyimi aracı gösterilmektedir.

Cihaz özelliklerini değiştirme

  1. Özellikler sekmesini seçin ve cihazın desteklediği özellikler için özelliği düzenleyin.
  2. Düzenlemeyi tamamladıktan sonra Enter tuşuna basın. Özellik değişiklikleriniz Home Graph için uygulanır.
  3. Güncellenen bu özellikleri Günlük alanında görüntüleyebilirsiniz.

Cihaz durumlarını değiştirme

  1. Eyaletler sekmesini seçin ve eyaleti doğrudan düzenleyin. Durum değişiklikleri Home Graph için uygulanacak.
  2. Bu durum değişikliklerini Günlük alanında görüntüleyebilirsiniz.

Sanal cihaza ikincil kullanıcı doğrulaması ekleme

Sanal cihazlara SUV ekleyebilir ve her cihazda SUV'nin sınama türünü ve ilgili davranışını yapılandırabilirsiniz. Sanal cihazlara SUV ekleyebilir, her cihazda sınama türünü ve buna karşılık gelen davranışı yapılandırabilirsiniz.

Cihazda SUV'yi yapılandırma

  1. Device list (Cihaz listesi) panelinde, yapılandırmak istediğiniz sanal cihazı seçin.
  2. Cihaz bilgileri panelinde SUV sekmesini seçin ve aşağıdakileri yapılandırın:
    • Etkin: SUV'nin cihazda etkin mi yoksa devre dışı mı (güvenlik sorgulaması yok) olduğu.
    • Sınama türü: SUV'nin açık onay (ackNeeded) veya kişisel kimlik numarası (pinNeeded) gerektirip gerektirmediği.
    • PIN: Geçerli PIN.
    • Yanlış PIN'in işlenmesi: PIN yanlış olduğunda kullanıcıya tekrar sorulup sorulmayacağı ve sorulmayacaksa yanıtlanacak hata.
Bu resimde, Google Home Playground'da seçili bir cihazda ikincil kullanıcı doğrulama özelliklerini etkinleştirmek için kullanılan kullanıcı deneyimi aracı gösterilmektedir.

SUV'yi etkinleştiren cihazları belirleme

Cihaz listesi panelinde, SUV özellikli her cihazın yanında bir anahtar simgesi key gösterilir.

Bu şekilde, ikincil kullanıcı doğrulamasını etkinleştirmesi önerilen cihazlar gösterilmektedir.

Aşağıdaki özellikler için SUV gerekir:

Yeni bir sanal cihaz oluşturma

  1. Cihaz listesi panelinde Cihaz ekle'yi tıklayın.
  2. Pop-up panelde cihaz türünü seçin ve yeni cihazınızın adını girin. Alternatif olarak, önceden tanımlanmış bir cihaz grubu seçerek ekleyebilirsiniz.
  3. Tüm adımları tamamladığınızda yeni cihaz Home Graph uygulamasına eklenir.
Bu görselde, Google Home Playground'da yeni bir cihaz türü eklemek için kullanılan kullanıcı deneyimi aracı gösterilmektedir.

Sanal cihazları kaldırma

  1. Cihaz listesi panelinde, kaldırmak istediğiniz cihazı seçin. Ardından, Cihaz bilgileri panelinde Temel Bilgiler sekmesini seçin ve Ardından, Cihaz bilgileri panelinde Temel Bilgiler sekmesini seçin ve alttaki Çöp kutusu simgesiCihazı kaldır'ı tıklayın.
  2. Pop-up uyarıda cihazın kaldırılmasını onaylayın.
  3. Cihazın kaldırılmasını onayladığınızda cihaz Home Graph uygulamasından kaldırılır.
Bu resimde, Google Home Playground'da sanal cihaz türünü kaldırmak için kullanılan kullanıcı deneyimi aracı gösterilmektedir.

Senkronizasyon Yanıt Düzenleyici

Senkronizasyon yanıtınızı Google Home Playground içinde doğrulayabilir veya güncelleyebilirsiniz. Yerleşik bir IDE açmak için Sync Response Editor'ı (Senkronizasyon Yanıt Düzenleyici) tıklayın.

Bu resimde, senkronizasyon yanıt düzenleyiciyi açma düğmesi gösterilmektedir.

Senkronizasyon yanıtınızı düzenleyin veya kopyalayıp yapıştırın ve değişiklikleri uygulayarak Google Home ekosisteminde nasıl çalıştığını görmek için Kaydet'i tıklayın.

Bu resimde, senkronizasyon yanıtını düzenleme penceresi gösterilmektedir.

Sanal cihazları içe ve dışa aktarma

Sorunları gidermek veya yeniden oluşturmak için sanal cihazlarınızı durumlarıyla birlikte bir dosyaya aktarabilir ve sanal cihazlarınızı içe aktarıp kopyalamak için dosyayı başkalarıyla paylaşabilirsiniz.

Bu resimde, Google Home Playground'da sanal cihazları içe ve dışa aktarmak için kullanılan kullanıcı deneyimi aracı gösterilmektedir.

Sanal cihazları bir dosyaya aktarma

  1. Sanal cihazları bir dosyaya aktarmak için simgesini tıklayın.
  2. Dışa aktarmak istediğiniz dosya adını girin ve Tamam'ı tıklayın.
  3. Dosya adını girdikten sonra tarayıcı, dışa aktarılan sanal cihazların dosyasını indirir.

Sanal cihazları bir dosyadan içe aktarma

  1. Sanal cihazları bir dosyadan içe aktarmak için simgesini tıklayın.
  2. İçe aktarmak istediğiniz dosyayı seçip Tamam'ı tıklayın.
  3. İçe aktarılacak dosyayı onayladıktan sonra Google Home Playground, sanal cihazları dosyadaki durumlarıyla içe aktarır ve içe aktarılan cihazların bilgilerini ve durumlarını Home Graph içinde günceller.

Etkileşim günlüklerini inceleme

Sanal cihazlarla etkileşimde bulunduğunuzda Google Home Playground, yaptığınız değişiklikleri otomatik olarak Home Graph cihazına uygular. Home Graph ile etkileşimler Günlük alanı paneline kaydedilir. Burada her girişi genişleterek Home Graph API isteği ve yanıt yüklerini inceleyebilirsiniz.

Her günlük girişi, aşağıdaki yapıya sahip öğeler içeren bir JSON dizisidir:

{
  "uri": string,
  "request": object,
  "response": object
}
Alanlar Tür Açıklama
uri string Home Graph API çağrısının URL'si.
request object Home Graph API çağrısının istek gövdesi. Her yöntemin biçimi için referans belgelerine referans belgelerine bakın.
response object Home Graph API çağrısının yanıt gövdesi. Her yöntemin biçimi için referans belgelerine referans belgelerine bakın.

Desteklenen cihaz türlerini ve özelliklerini görüntüleme

Sağ üstteki soru işareti yardım simgesi, Google Home Playground tarafından desteklenen mevcut cihaz türünü ve özellik listesini gösterir.

Bu görselde, Google Home Playground'da yeni bir cihaz türü eklemek için kullanılan kullanıcı deneyimi aracı gösterilmektedir.

Sorun bildirme

Görüşlerinizi öğrenmekten memnuniyet duyarız. Karşılaştığınız sorunları sağ üstteki ünlem işareti simgesini geri bildirim kullanarak bildirin.

Bu resimde, Google Home Playground'da geri bildirim gönderme ve sorun bildirme simgeleri gösterilmektedir.