Google Home Oyun Alanı

Cihaz SDK'sı

Google Home Playground, yapılandırılabilir cihaz türleri ve özellikleriyle akıllı ev projelerini 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 tamamlayın

Google Home Playground kullanmak için önce aracı hesabınıza bağlamanız önerilir. Telefonunuzda Google Home app (GHA) uygulamasını açın ve hesap bağlama işlemini tamamlayın:

  1. Sol üst köşedeki artı (+) simgesini tıklayın.
  2. Cihazı kur > Google ile çalışır'ı seçin.
  3. Google Home Playground adlı işlemi arayın.
  4. İşlemi seçin. GHA sizi oturum açma sayfasına yönlendirir. Sign in with Google'ı (Google ile oturum aç) tıklayın ve oturum açmak için hesabınızı seçin.
  5. Hesap bağlamayı yetkilendirmek için Yetkilendir düğmesini tıklayın.
Bu şekilde, Google Home Playground'u bağlamak için
            Google Home uygulaması hesabı bağlama akışı gösterilmektedir.

Hesap bağlamayı tamamladıktan sonra GHA üzerinde, etkileşimde bulunabileceğiniz bir dizi varsayılan sanal cihaz gösterilir.

Bu şekilde, bir kullanıcı Google Home Playground'u hesabına başarılı bir şekilde 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 kullanıma sunma

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 şekilde Google Home Playground'un ilk durumu gösterilmektedir.
            Sağ üst köşedeki oturum açma düğmesi vurgulanmıştır.

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

Bu şekilde 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'nde tüm sanal cihazlarınız gösterilir. Bu panel aracılığıyla bilgilerini görüntülemek ve sanal cihazlar oluşturmak için belirli bir sanal cihazı seçebilirsiniz.
  • Cihaz bilgileri, seçilen sanal cihazla ilgili bilgileri sunar. Ayrıca, panelden bu bilgileri düzenleyebilir ve seçilen sanal cihazı 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 halinde sınıflandırılır:

  • 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ü özellikleri.
  • Durumlar: Tüm cihaz durumları.
  • SUV: Cihazın İkincil Kullanıcı Doğrulama yapılandırması.

Sanal cihaz bilgilerini düzenleyin

Sanal cihazların bilgilerini görüntülemenin yanı sıra, Home Graph içinde depolanan bilgileri Cihaz bilgileri panelini kullanarak doğrudan düzenleyebilirsiniz.

Desteklenen özellikleri değiştirin

  1. Özellikler sekmesini seçin ve Düzenle düğmesini tıklayın.
  2. Pop-up panelinde, cihazın o anda desteklediği özellikleri 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 öğesine uygulanır.
  4. Bu özellik güncellemelerini Günlük alanında görüntüleyebilirsiniz.
Bu şekilde, Google Home Playground'da belirli bir cihazda desteklenen özellikleri eklemeye veya silmeye yarayan kullanıcı deneyimi aracı gösterilmektedir.

Cihaz özelliklerini değiştirme

  1. Özellikler sekmesini seçin ve cihaz tarafından desteklenen özelliklere ilişkin özelliği düzenleyin.
  2. Düzenlemeyi tamamladığınızda Enter tuşuna basın. Özellik değişiklikleriniz Home Graph öğesine uygulanır.
  3. Bu güncellenen özellikleri Günlük alanı'nda görebilirsiniz.

Cihaz durumlarını değiştirme

  1. Eyaletler sekmesini seçin ve durumu doğrudan düzenleyin. Durum değişiklikleri Home Graph öğesine 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 bir SUV ekleyerek yarışmanın türünü ve her cihazdaki buna karşılık gelen davranışı yapılandırabilirsiniz. Sanal cihazlara bir SUV ekleyip sorgulamanın türünü ve her cihazdaki buna karşılık gelen davranışını yapılandırabilirsiniz.

Cihazda SUV'yi yapılandırın

  1. 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: Cihazda SUV'nin etkin veya devre dışı (Yarışma yok) olduğu.
    • Yarışma türü: SUV için açık onay mı (ackNeeded) yoksa kişisel kimlik numarası (pinNeeded) mı gerekiyor?
    • PIN: Geçerli PIN.
    • Yanlış PIN'in işlenmesi: PIN yanlış olduğunda, kullanıcıya tekrar sorup sorulmayacağı ve sorulmazsa yanıt verme hatası.
Bu şekilde, Google Home Playground'da seçili bir cihazda ikincil kullanıcı doğrulama özelliklerini etkinleştiren kullanıcı deneyimi aracı gösterilmektedir.

SUV'nin kullanılabileceği cihazları tanımlayın

Cihaz listesi panelinde, SUV özellikli her cihazın yanında bir anahtar simgesi anahtar görüntülenir.

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

Özelliklerin listesi SUV gerektirmektedir:

Yeni sanal cihaz oluştur

  1. Cihaz listesi panelinde, Cihaz ekle'yi tıklayın.
  2. Pop-up panelinde cihaz türünü seçin ve yeni cihazınızın cihaz adını girin. Alternatif olarak, eklemek için önceden tanımlanmış bir cihaz grubu da seçebilirsiniz.
  3. Tüm adımları tamamladığınızda yeni cihaz Home Graph adlı eve eklenecek.
Bu şekilde, Google Home Playground'a yeni bir cihaz türü eklemek için kullanılan UX aracı gösterilmektedir.

Sanal cihazı kaldırma

  1. Cihaz listesi panelinde, kaldırmak istediğiniz cihazı seçin. Ardından, Cihaz bilgileri panelinde Temel Bilgiler sekmesini ve ardından Cihaz bilgileri panelinde Temel Bilgiler sekmesini seçip en alttaki Çöp kutusu simgesiCihazı kaldır'ı tıklayın.
  2. Pop-up uyarısında cihaz kaldırma işlemini onaylayın.
  3. Cihazın kaldırılmasını onayladığınızda cihaz Home Graph konumundan kaldırılır.
Bu şekilde, Google Home Playground'daki bir sanal cihaz türünü kaldırmaya yönelik kullanıcı deneyimi aracı gösterilmektedir.

Senkronizasyon Yanıtı Düzenleyici

Senkronizasyon yanıtınızı Google Home Playground sayfasında doğrulayabilir veya güncelleyebilirsiniz. Yerleştirilmiş bir IDE açmak için Senkronizasyon Yanıtı Düzenleyici'yi tıklayın.

Bu şekilde, senkronizasyon yanıtı düzenleyicisini açma düğmesi gösterilmektedir.

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

Bu şekilde, senkronizasyon yanıtının düzenleneceği pencere 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 dışa aktarabilir ve sanal cihazlarınızı içe aktarıp çoğaltmaları için dosyayı başkalarıyla paylaşabilirsiniz.

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

Sanal cihazları bir dosyaya aktarın

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

Sanal cihazları bir dosyadan içe aktarın

  1. Sanal cihazları bir dosyadan içe aktarmak için simgesini tıklayın.
  2. İçe aktarmak istediğiniz dosyayı seçin ve Tamam'ı tıklayın.
  3. İçe aktarılacak dosyayı onayladığınızda Google Home Playground, dosyadaki durumları içeren sanal cihazları içe aktarır ve içe aktarılan cihazların bilgileri ile durumlarını Home Graph üzerinde günceller.

Etkileşim günlüklerini inceleme

Sanal cihazlarla etkileşime girdiğinizde Google Home Playground, değişikliğinizi Home Graph cihazına otomatik olarak uygular. Home Graph ile etkileşimler Günlük alanı paneline kaydedilir. Burada, Home Graph API isteğini ve yanıt yüklerini incelemek için her bir girişi genişletebilirsiniz.

Her günlük girişi, aşağıdaki yapının öğelerini 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övdesini belirtin. Her yöntemin biçimi için referans belgeleri referans belgelerini inceleyin.
response object Home Graph API çağrısının yanıt gövdesi. Her yöntemin biçimi için referans belgeleri referans belgelerini inceleyin.

Desteklenen cihaz türlerini ve özellikleri görüntüleyin

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

Bu şekilde, Google Home Playground'a yeni bir cihaz türü eklemek için kullanılan UX aracı gösterilmektedir.

Sorun bildirme

Görüşlerinizi öğrenmek isteriz. Karşılaşılan sorunları sağ üstteki ünlem işareti simgesini geri bildirimi kullanarak bildirin.

Bu şekilde, Google Home Playground'da geri bildirim sağlamak ve sorun bildirmek için kullanılan simgeler gösterilmektedir.