Dikkat! Yeni Geliştirici Önizleme programları yakında kullanıma sunulacak. Buradan başvurun ve yeni araçları deneyip geri bildirim gönderen ilk kişilerden biri olun.

Google Home Test Paketi

Buluttan buluta    Yerel Ev SDK'sı

Google Home Test Suite, akıllı ev Action'ınızı kendi kendinize test etmenize olanak tanıyan bir web uygulamasıdır. Test Suite, hesabınızla ilişkilendirilen cihazlara ve özelliklere göre otomatik olarak test durumları oluşturur ve çalıştırır. Testleri tamamladığınızda, test sonuçlarını görüntüleyebilir veya test sonuçlarını Google'a göndermek için gönderim formunu doldurabilirsiniz.

Test Suite tarafından yürütülen testler aşağıdakileri içerir ancak bunlarla sınırlı değildir:

  • Cihazlarınız ve özellikleriniz için Rapor Durumu ve Senkronizasyon İste etkinliklerinin uygulanıp uygulanmadığını kontrol eder.

  • Cihazınız için QUERY amacının uygulandığını ve sonuçlarının Rapor Durumu sonuçlarıyla eşleştiğini doğrular.

Aşağıdaki düğmeyi tıklayarak Test Suite aracını başlatabilirsiniz:

Başlat Test Suite

İşleminizi kendi kendinize test etme

Aşağıdaki bölümde Test Suite uygulamasını cihazınızda ve akıllı ev Action projenizde nasıl çalıştırabileceğiniz açıklanmaktadır. Test Suite, Google Home Graph cihazınızda cihazları inceleyebilmek ve doğrudan Google Assistant komutlarına gönderebilmek için oturum açmanızı gerektirir.

İşleminizi kendi kendinize test etmek için şu adımları uygulayın:

  1. Web tarayıcınızda Test Suite sayfasını açın.
  2. Sağ üst köşedeki düğmeyi kullanarak Google'da oturum açın.

  3. Proje Ayrıntıları'nı yapılandırın:

    1. Proje Kimliği alanına, akıllı ev İşleminizin proje kimliğini girin.
    2. İleri'yi tıklayın.
  4. Test Ayarlarını yapılandırın:

    1. Akıllı ev Action'ınızı doğruluyorsanız varsayılan Report State/Request Sync Zaman Aşımı değerini değiştirmeyin. Ancak test için temsilcinizin Home Graph'e durumu bildirmesi daha uzun sürüyorsa zaman aşımı değerini değiştirebilirsiniz.
    2. Akıllı ev İşleminizi onaylarsanız Test İsteği Senkronizasyonu seçeneğinin etkinleştirildiğinden emin olun. Test sırasında bir cihaz eklemeniz, güncellemeniz veya kaldırmanız istenir. Ardından, Cihaz Listesi'nde cihaz listesinin değişip değişmediğini kontrol edin. Değişiklik işlemleri, test ettiğiniz entegrasyon yoluyla gerçekleştirilir. Test edilen entegrasyonunuzda, temsilci kullanıcıya her zaman en az bir cihaz eklenmelidir.

    3. Sahne özelliğini kullanıyorsanız Sahne özelliğini test et'i seçin.

    4. Test paketini Yerel Ev cihazları için çalıştırıyorsanız Local Home SDK'sını destekler'i seçin.

      1. Yerel Sipariş Karşılama veya Sorunsuz Kurulum'u seçin.
      2. Cihaz, QUERY amacını yerel olarak işleyebiliyorsa Yerel Sorguyu Destekler'i tıklayın.
  5. Bir Test Çalışması gerçekleştirin ve sonuçları görüntüleyin:

    1. Testleri çalıştırmaya başlamak için İleri'yi tıklayın. Arayüz, test edilen cihazları ve özellikleri gösterir.
  6. Sonuçlar ve Gönderim sayfasını görüntüleyin:

    1. Testler tamamlandıktan sonra, sonuçları görüntülemek için İleri'yi tıklayın.

Test sonuçlarında, başarılı ve başarısız olan testlerin sayısı ile başarı yüzdesini belirten bir nihai puan bulunur.

Hesap bağlama doğrulama testi

Hesap bağlama, Google akıllı ev ekosisteminde önemli bir rol oynar. Test Suite hesabındaki hesap bağlama doğrulaması testi, OAuth hizmetinizi olası sorunlar için kontrol eder.

Hesap bağlama doğrulama testi, erişim jetonlarını ve yenileme jetonlarını doğrulamak için testler içerir:

Erişim jetonu doğrulama testi

Jeton takas uç noktanızdan döndürülen erişim jetonları, geçerli bir biçime sahip olup olmadıkları ve geçerli bir yenileme jetonuyla döndürüldükleri için test edilir.

Test Öğeleri Açıklama
Erişim jetonunun JWT biçiminde olup olmadığını kontrol etme Google hesabı bağlama işlemi, JWT biçiminde erişim jetonları önermez. JWT biçimi bulunursa aşağıdaki uyarı gösterilir: The access token seems to be JWT, this is not good. Because it unnecessarily exposes information about partner implementation and we recommend opaque symmetric encrypted access token.
Süresi dolan erişim jetonunun yenileme jetonu olup olmadığını kontrol edin. Erişim jetonunun süresi dolabildiğinde bir yenileme jetonu sağlanmalıdır. Yenileme jetonu bulunamazsa bu test başarısız olur.

Jeton doğrulama testini yenile

Yenileme jetonları, jeton Exchange uç noktanızın yeni erişim jetonları için düzgün bir şekilde takas edildiğinden emin olmak amacıyla test edilir.

Test Öğeleri Açıklama
Jetonu geçersiz yenileme jetonuyla yenileyin, iş ortağı yanıtını kontrol edin. Sunucunuz, geçersiz bir yenileme jetonu isteğine {"error": "invalid_grant"} hatasıyla birlikte bir HTTP 400 Hatalı İstek hatası döndürmelidir. Yanıt, "hata kodu veya mesaj" ile eşleşmezse bu test durumu başarısız olur. Daha fazla bilgi için erişim jetonlarını değiştirme yenileme jetonlarını ziyaret edin.
Jeton yenilendikten sonra erişim jetonunun güncellenip güncellenmediğini test edin. Yenileme jetonları, yenileme jetonu isteklerine yanıt olarak döndürülmelidir. Sunucunuz aynı erişim jetonunu sağlarsa test durumu başarısız olur.
Geçerlilik süresi dolmamış erişim jetonunun hâlâ geçerli olup olmadığını kontrol edin. Erişim jetonunun geçerlilik süresi gösterilir.
Yenileme sırasında yenileme jetonunun döndürülüp döndürülmediğini kontrol edin. Yenileme jetonlarından sonra yenileme jetonlarının değiştirilip değiştirilmediğini kontrol ederiz. Yenileme jetonu değişirse kullanıcının eski bir yenileme jetonunu yalnızca yeni bir yenileme jetonu kullanıldıktan sonra geçersiz kılması gerekir. Aksi takdirde, kullanıcının hesap bağlantısını bozabilecek yarış koşulları önlenir. Yeni yenileme jetonu kullanılmadan önce eski yenileme jetonunu geçersiz kılarsanız test başarısız olur.

Hata mesajları

Karşılaşabileceğiniz bazı yaygın hata mesajları ve bunların çözüm önerileri aşağıda verilmiştir.

Hata Mesajı Çözüm
HomeGraph API, <_id_> projesinde kullanılmadan önce devre dışı bırakıldı HomeGraph API'yi etkinleştirdiğinizden emin olun.
İstenen Varlık bulunamadı agentUserId cihazınızın geçerli olduğundan ve hizmetinize bağlı olduğundan emin olun.

${your project id} projesinde resourcemanager.projects.get izninizin olduğundan ve izin ekranında tüm izinleri verdiğinizden emin olun.

Modül verileri alınırken hata oluştu: getModuleData hatası: https://hometestuitproxyproxy-pa.googleapis.com/v1/module:get: 403 OK 403 için HTTP hatası yanıtı

  1. Hesabınızın proje için resourcemanager.projects.get izinlerine sahip olduğundan emin olmak üzere IAM izinleriyle ilgili sorunları giderme başlıklı makalede verilen talimatları uygulayın.
  2. Hesabınıza erişimi olan uygulamalar sayfasına giderek "Akıllı ev için test paketi" için aşağıdaki izinleri kontrol edin:
    • Temel hesap bilgileri
      1. Birincil Google Hesabı e-posta adresinizi görün
      2. Herkese açık olarak sunduklarınız da dahil olmak üzere kişisel bilgilerinizi görme
    • Ek erişim
      1. Assistant: Google hesabınıza geniş erişim
      2. Home Graph'teki akıllı ev cihazlarını denetleyip kontrol etme
    İzin hatası alırsanız ilk olarak erişimi kaldırın ve tekrar giriş yaptığınızda izin ekranındaki tüm izinleri verin.

Test sonuçlarını gönderme

Sertifika formunu göndermeden önce Test Suite sonuçlarınızın% 100 testi geçmesi gerekir. Manuel test gerektiren özellikleriniz varsa Test Suite aracını çalıştırmanız ve sonucu %100'ü geçmese bile eklemeniz gerekir.

Test sonuçlarınızı göndermek ve akıllı ev İşleminizi onaylamak için aşağıdaki adımları uygulayın:

  1. Test sonuçlarınızı aldıktan ve akıllı ev İşleminizi onaylamaya hazır olduktan sonra Test Suite aracında Gönder'i tıklayın.
  2. Test sonuçlarınızı almak için TEST SONUÇLARINI İNDİR düğmesini tıklayın.
  3. Test sonuçlarını Google'a göndermek için GÖNDERİM FORMUNA GİT'i tıklayın.
  4. Zorunlu tüm alanları doldurun, ardından Gönder'i tıklayın.