Akıllı ev işlemlerinin nasıl geliştirileceğini öğrenmek için yeni adres olan Google Home Geliştirici Merkezi'ne hoş geldiniz. Not: Actions Console'da işlem oluşturmaya devam edersiniz.

Google Home Oyun Alanı

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

Cihaz SDK'sı

Google Home Playground, yapılandırılabilir cihaz türleri ve özelliklerle sanal bir ev simüle ederek bir akıllı ev projesini simüle etmenize olanak tanıyan bir web uygulamasıdır. Home Playground, sanal cihazlar oluşturmanıza, cihaz özelliklerini ve durumlarını değiştirmenize, bu cihazları Google Home Graph uygulamasında görüntülemenize ve cihaz yapılandırmalarını içe veya dışa aktarmanıza olanak tanır.

Hesap bağlama işlemini tamamlayın

Home Playground ürününü 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 başlıklı Action'ı arayın.
  4. İşlemi 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.
  5. Hesap bağlamayı yetkilendirmek için Yetkilendir düğmesini tıklayın.
Bu şekilde, Google Home Playground'u bağlamak için kullanılan Google Home uygulama hesabı bağlantı akışı gösterilmektedir.

Hesap bağlama işlemini tamamladıktan sonra etkileşimde bulunabilmeniz için GHA üzerinde bir dizi varsayılan sanal cihaz gösterilir.

Bu şekilde, 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 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 şekilde Google Home Playground'un ilk durumu gösterilir ve sağ üst köşedeki oturum açma düğmesi vurgulanır.

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

Bu şekilde Google Home Playground'un varsayılan görünümünde 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 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 cihazın bilgilerini gösterir. Panel aracılığıyla bu bilgileri düzenleyip seçili sanal cihazı kaldırabilirsiniz.
  • Günlük alanı, Home Playground ile Home Graph arasındaki etkileşim günlüklerini gösterir. Sorun giderme amacıyla istek ve yanıt yükünü incelemek için 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 bilgileri panelinde bilgiler beş sekmede sınıflandırılır:

  • Temel bilgiler: cihazın üst düzey özellikleri (cihaz türü, kimliği ve adı dahil).
  • Özellikler: Cihazın desteklenen özellikleri.
  • Özellikler: Cihazın özelliğe özgü özellikleri.
  • Durumlar: Tüm cihaz durumları.
  • SUV: Cihazın İkincil Kullanıcı Doğrulaması yapılandırması.

Sanal cihaz bilgilerini düzenleme

Sanal cihazın bilgilerini görüntülemenin yanı sıra Cihaz bilgileri panelini kullanarak Home Graph uygulamasında depolanan bilgileri 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 panelde, cihazın şu anda desteklenen özelliklerini ve ekleyebileceğiniz kullanılabilir ö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ıktan sonra Kaydet'i tıklayın. Güncellenen özellikler Home Graph ürününe uygulanır.
  4. Bu özellik güncellemelerini Günlük alanında görebilirsiniz.
Bu şekilde, Google Home Playground'da seçili bir cihazda desteklenen özellikleri eklemek veya silmek için kullanıcı deneyimi aracı gösterilmektedir.

Cihaz özelliklerini değiştirme

  1. Temel Bilgiler/Özellikler sekmesini seçin ve cihazın desteklediği ö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 uygulanacaktır.
  3. Bu güncellenmiş ö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 uygulanır.
  2. Bu durum değişikliklerini Günlük alanında görebilirsiniz.

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

Sanal cihazlara bir SUV ekleyebilir ve her ürünün sorgulama türünü ve ilgili davranışını yapılandırabilirsiniz.

Cihazda SUV'yı yapılandır

  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ışı (zorluk yok) olup olmadığını.
    • Meydan okuma türü: SUV'nin açık onay (ack Needed) veya kişisel kimlik numarası (pin Needed) gerektirip gerektirmediği.
    • PIN: Geçerli PIN.
    • Yanlış PIN'in işlenmesi: PIN yanlış olduğunda, kullanıcıya tekrar sorup sormayacağını ve hata yoksa yanıt verme hatasını gösterir.
Bu şekilde, Google Home Playground'da seçili bir cihazda ikincil kullanıcı doğrulama özelliklerini etkinleştirebileceğiniz kullanıcı deneyimi aracı gösterilmektedir.

SUV'yi etkinleştiren cihazları belirleme

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

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

Aşağıdaki özellik listesi için SUV gereklidir:

Yeni bir sanal cihaz oluşturun

  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 cihaz adını girin. Alternatif olarak, eklemek üzere önceden tanımlanmış bir cihaz grubu da seçebilirsiniz.
  3. Tüm adımları tamamladığınızda yeni cihaz Home Graph platformuna eklenir.
Bu şekilde, Google Home Playground'a yeni bir cihaz türü eklemek için kullanıcı deneyimi 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 seçin ve alt taraftaki Çöp kutusu simgesiCihazı kaldır'ı tıklayın.
  2. Cihaz kaldırma işlemini pop-up uyarısında onaylayın.
  3. Kaldırma işlemini onayladığınızda cihaz Home Graph cihazından kaldırılır.
Bu şekilde, Google Home Playground'daki sanal cihaz türlerini kaldırmak için kullanıcı deneyimi aracı gösterilmektedir.

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

Sorun giderme veya yeniden oluşturma sorunları için sanal cihazlarınızı durumlarıyla birlikte bir dosyaya dışa aktarabilir ve sanal cihazlarınızı içe aktarmak ve çoğaltmak için dosyayı başkalarıyla paylaşabilirsiniz.

Bu şekilde, Google Home Playground'da sanal cihazlar içe ve dışa aktarmayla ilgili kullanıcı deneyimi aracı gösterilmektedir.

Sanal cihazları bir dosyaya aktarma

  1. Sanal cihazları bir dosyaya aktarmak için düğmesini tıklayın.
  2. Dışa aktarmak istediğiniz dosya adını girip 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. Bir dosyadan sanal cihazları 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ığınızda Home Playground, dosyadaki durumların bulunduğu sanal cihazları içe aktarır ve Home Graph cihazındaki içe aktarılan cihazların bilgilerini ve durumlarını günceller.

Etkileşim günlüklerini inceleme

Sanal cihazlarla etkileşimde bulunduğunuzda Home Playground, değişikliğinizi otomatik olarak Home Graph uygulamasına uygular. Home Graph ile olan etkileşimler Günlük alanı paneline kaydedilir. Bu API'de, her isteği Home Graph API isteği ve yanıt yükünü incelemek için 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 gövde metni. Her yöntemin biçimi için 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 bakın.

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

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

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

Geri bildirim ve sorun bildirme

Görüşlerinizi almak istiyoruz. Sağ üstteki smiley yüz simgesini sentiment_satisfied tıklayarak geri bildirimde bulunun veya ünlem işareti simgesini geri bildirim kullanarak karşılaştığınız sorunları bildirin.

Bu şekilde, Google Home Playground'da geri bildirim ve raporlama sorunları sağlayan simgeler gösterilmektedir.