Google Home Test Suite, akıllı ev işleminizi kendiniz test etmenize olanak tanıyan bir web uygulamasıdır. Test Suite, hesabınızla ilişkili cihazlara ve özelliklere göre otomatik olarak test senaryoları oluşturup çalıştırır. Testleri tamamladığınızda test sonuçlarını görüntüleyebilirsiniz.
Test Suite aracını kullanmak ve test sonuçlarınızı sertifika için Google'a göndermek üzere bilgi edinmek istiyorsanız Akıllı ev işlemlerini test etme ve paylaşma sayfasına bakın. Test Suite'nın bu sürümü özellikle geliştirme ve kalite kontrolü için tasarlanmıştır.
Test Suite tarafından yürütülen testler aşağıdakileri kapsar ancak bunlarla sınırlı değildir:
Cihazlarınız ve özellikleriniz için Rapor Durumu ve İstek Senkronizasyonu'nun uygulandığını kontrol eder.
QUERY amacının cihazınızda uygulandığını ve sonuçlarının Report State sonuçlarıyla eşleştiğini doğrular.
Aşağıdaki düğmeyi tıklayarak Test Suite aracını başlatabilirsiniz:
İşleminizi kendi kendinize test etme
Aşağıdaki bölümde, cihazınızda ve akıllı ev işlemleri projenizde Test Suite nasıl çalıştırılacağı açıklanmaktadır. Test Suite Google Home Graph cihazlarını inceleyebilmesi ve doğrudan Google Assistant komut gönderebilmesi için oturum açmanızı gerektirir.
İşleminizi kendiniz test etmek için aşağıdaki adımları uygulayın:
- Web tarayıcınızda Test Suite platformunu açın.
Sağ üst köşedeki düğmeyi kullanarak Google'da oturum açın.
Proje Ayrıntıları'nı yapılandırın:
- Proje kimliği alanına akıllı ev işleminizin proje tanımlayıcısını girin.
- İleri'yi tıklayın.
Test Ayarları'nı yapılandırın:
- Cloud-to-cloud entegrasyonunuzu onaylıyorsanız varsayılan Rapor Durumu/İstek Senkronizasyonu Zaman Aşımı değerini değiştirmeyin. Ancak test için, aracınızın durumu Home Graph'a bildirmesi daha uzun sürüyorsa zaman aşımı değerini değiştirebilirsiniz.
Cloud-to-cloud entegrasyonunuzu onaylıyorsanız Test İstek Senkronizasyonu seçeneğinin etkinleştirildiğinden emin olun. Test sırasında bir cihaz eklemeniz, güncellemeniz veya kaldırmanız ve cihaz listesinin Home Graph'te değişip değişmediğini kontrol etmeniz istenir. Değişiklik işlemleri, test ettiğiniz entegrasyon aracılığıyla yapılır. Test edilen entegrasyonunuzda her zaman temsilci kullanıcısına bağlı en az bir cihaz olmalıdır.
Scene özelliği kullanıyorsanız Test Scene özelliğini seçin.
Yerel Ev cihazları için test paketini çalıştırıyorsanız Yerel Ev SDK'sını destekler'i seçin.
- Yerel karşılama veya Sorunsuz Kurulum'u seçin.
- Cihaz, QUERY amacını yerel olarak işleyebiliyorsa Yerel Sorguyu Destekler'i tıklayın.
Test çalıştırması gerçekleştirin ve sonuçları görüntüleyin:
- Testleri çalıştırmaya başlamak için Next'i (İleri) tıklayın. Arayüzde, test edilen cihazlar ve özellikler gösterilir.
Sonuçlar ve Gönderim sayfasını görüntüleme:
- Testler tamamlandıktan sonra sonuçları görüntülemek için Sonraki'yi tıklayın.
Test sonuçları, başarılı ve başarısız testlerin sayısını ve başarılı testlerin yüzdesini gösteren nihai bir puanı içerir.
Hesap bağlama doğrulama testi
Hesap bağlama, Google akıllı ev ekosisteminde önemli bir rol oynar. Test Suite içindeki hesap bağlama doğrulama testi, OAuth hizmetinizde olası sorunları kontrol eder.
Hesap bağlama doğrulama testi, erişim jetonlarını ve yenileme jetonlarını doğrulamaya yönelik testler içerir:
Erişim jetonu doğrulama testi
Jeton değişimi uç noktanızdan döndürülen erişim jetonları, geçerli bir biçime sahip olduklarından ve geçerli bir yenileme jetonuyla döndürüldüklerinden emin olmak için test edilir.
| Test Öğeleri | Açıklama |
|---|---|
| Erişim jetonunun JWT biçiminde olup olmadığını kontrol edin. | Google Hesabı bağlama işleminde JWT biçimli erişim jetonları önerilmez. 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.
|
| Geçerlilik süresi dolabilen erişim jetonunun yenileme jetonu olup olmadığını kontrol edin. | Erişim jetonunun süresi dolabiliyorsa yenileme jetonu sağlanmalıdır. Yenileme jetonu bulunamazsa bu test başarısız olur. |
Yenileme jetonu doğrulama testi
Yenileme jetonları, jeton değişimi uç noktanızın bunları yeni erişim jetonlarıyla doğru şekilde değiştirdiğinden emin olmak için test edilir.
| Test Öğeleri | Açıklama |
|---|---|
| Geçersiz yenileme jetonuyla yenileme jetonu. İş ortağı yanıtı kontrol ediliyor. | Sunucunuz, geçersiz bir yenileme jetonu isteğine {"error": "invalid_grant"} ile birlikte bir HTTP 400 Bad Request hatası döndürmelidir.
Yanıtta "hata kodu veya mesajı" ile eşleşme yoksa bu test durumu başarısız olur. Daha fazla bilgi için
erişim jetonları için Exchange yenileme jetonları başlıklı makaleyi inceleyin. |
| Jeton yenileme işleminden sonra erişim jetonunun güncellenip güncellenmediğini test edin. | Yenileme jetonu isteklerine yanıt olarak yeni erişim jetonları döndürülmelidir. Sunucunuz aynı erişim jetonunu sağlıyorsa 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 süre sonu gösterilir. |
| Yenileme sırasında yenileme jetonunun döndürülüp döndürülmediğini kontrol edin. | Yenileme jetonu isteğinden sonra yenileme jetonlarının değiştirilip değiştirilmediğini kontrol ederiz. Yenileme jetonu değişirse sunucunuz, kullanıcının hesap bağlantısını bozabilecek yarış koşullarını önlemek için eski yenileme jetonunu yalnızca yeni bir yenileme jetonu kullanıldıktan sonra geçersiz kılmalıdır. Yeni yenileme jetonu kullanılmadan önce eski yenileme jetonunu geçersiz kılarsanız test başarısız olur. |
Hata mesajları
Aşağıdaki tabloda, karşılaşabileceğiniz bazı yaygın hata mesajları ve bunları çözmek için önerilen yöntemler listelenmiştir.
| Hata Mesajı | Çözüm |
|---|---|
| HomeGraph API, <_id_> projesinde daha önce kullanılmadı veya 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. |
Modül verileri alınırken hata oluştu: getModuleData error: Http failure response for https://hometestsuiteproxy-pa.googleapis.com/v1/module:get: 403 OK 403 |
|
Test sonuçlarını gönderme
Sertifika için göndermeden önce Test Suite sonuçlarınızın testlerin% 100'ünü geçmesi gerekir. Manuel test gerektiren özellikleriniz varsa Test Suite aracını çalıştırmanız ve sonuç %100 geçmemiş olsa bile sonucu eklemeniz gerekir.
Test sonuçlarınızı göndermek ve Cloud-to-cloud entegrasyonunuzu onaylamak için aşağıdaki adımları uygulayın:
- Test sonuçlarınızı aldıktan ve Cloud-to-cloud entegrasyonunuzu sertifikalandırmaya hazır olduğunuzda Test Suite aracında Gönder'i tıklayın.
- Google Home Developer Console > Cloud-to-cloud > Certify'a (Sertifika) gidin.
- Sertifika almak istediğiniz entegrasyonu seçin.
- Belgeler bölümünde Test Suite sonuçları kimliğinizi girin.
Tüm zorunlu alanları doldurun ve Gönder'i tıklayın.