Suite Uji Smart Home

Suite pengujian untuk smart home adalah aplikasi web yang memungkinkan Anda menguji sendiri Action smart home. Suite pengujian secara otomatis menghasilkan dan menjalankan kasus pengujian berdasarkan perangkat dan fitur yang terkait dengan akun Anda. Setelah menyelesaikan pengujian, Anda dapat melihat hasil pengujian atau mengisi formulir pengiriman untuk mengirimkan hasil pengujian ke Google.

Pengujian yang dijalankan oleh rangkaian pengujian mencakup, tetapi tidak terbatas pada, hal-hal berikut:

  • Memeriksa apakah Report State dan Request Sync diimplementasikan untuk perangkat dan fitur Anda.

  • Memverifikasi bahwa intent QUERY diterapkan untuk perangkat Anda dan hasilnya cocok dengan hasil Report State.

Anda dapat meluncurkan alat rangkaian pengujian dengan mengklik tombol di bawah:

Meluncurkan rangkaian pengujian

Uji sendiri Action Anda

Bagian berikut menjelaskan cara menjalankan rangkaian pengujian di perangkat dan project Action smart home. Suite pengujian mengharuskan Anda login agar dapat memeriksa perangkat di Home Graph dan mengirimkan perintah langsung ke Asisten Google.

Untuk menguji sendiri Action Anda, ikuti langkah-langkah berikut:

  1. Di browser web Anda, buka suite pengujian untuk smart home.
  2. Login ke Google menggunakan tombol pojok kanan atas.

  3. Konfigurasikan Project Details:

    1. Di kolom Project ID, masukkan ID project untuk Action smart home Anda.
    2. Klik Selanjutnya.
  4. Konfigurasikan Setelan Pengujian:

    1. Jika menjamin Action smart home, biarkan nilai Report State/Request Sync Timeout default tidak berubah. Namun, untuk pengujian, Anda dapat mengubah nilai waktu tunggu jika agen membutuhkan lebih banyak waktu untuk melaporkan status ke Home Graph.
    2. Jika menyatakan Action smart home, pastikan opsi Test Request Sync diaktifkan—selama pengujian, Anda akan diminta untuk menambahkan, memperbarui, atau menghapus perangkat, dan memeriksa apakah daftar perangkat telah berubah di Home Graph. Tindakan perubahan dilakukan melalui integrasi yang Anda uji. Integrasi Anda yang sedang diuji harus selalu memiliki setidaknya satu perangkat yang terpasang ke pengguna agen.

    3. Jika Anda menggunakan fitur Scene, pilih Test Scene tra.

  5. Lakukan Test Run dan lihat hasilnya:

    1. Klik Berikutnya untuk mulai menjalankan pengujian. Antarmuka menampilkan perangkat dan ciri yang sedang diuji.
  6. Lihat halaman Hasil & Pengiriman:

    1. Setelah pengujian selesai, klik Berikutnya untuk melihat hasilnya.

Hasil pengujian mencakup jumlah pengujian yang lulus dan yang gagal, serta skor akhir yang menunjukkan persentase kelulusan.

Pengujian validasi penautan akun

Penautan akun memainkan peran penting dalam ekosistem smart home Google. Pengujian validasi penautan akun di Test Suite memeriksa layanan OAuth Anda untuk menemukan potensi masalah.

Pengujian validasi penautan akun berisi pengujian untuk memvalidasi token akses dan token refresh:

Uji validasi token akses

Token akses yang ditampilkan dari endpoint pertukaran token akan diuji untuk memastikan formatnya valid, dan ditampilkan dengan token refresh yang valid.

Uji Item Penjelasan
Memeriksa apakah token akses berformat JWT Penautan akun Google tidak merekomendasikan token akses format JWT. Jika format JWT ditemukan, peringatan berikut akan ditampilkan: 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.
Periksa apakah token akses yang dapat diperpanjang memiliki token refresh. Token refresh harus diberikan saat token akses akan habis masa berlakunya. Pengujian ini akan gagal jika token refresh tidak ditemukan.

Segarkan pengujian validasi token

Token refresh diuji untuk memastikan endpoint pertukaran token Anda menukarnya dengan benar dengan token akses baru.

Uji Item Penjelasan
Token refresh dengan token refresh tidak valid, memeriksa respons partner. Server Anda harus menampilkan error Permintaan Permintaan HTTP 400 dengan {"error": "invalid_grant"} ke permintaan token refresh yang tidak valid. Jika respons tidak cocok dengan "kode error atau pesan", kasus pengujian ini akan gagal. Buka token refresh pertukaran untuk token akses untuk informasi selengkapnya.
Uji apakah token akses telah diperbarui setelah token diperbarui. Token akses baru harus ditampilkan sebagai respons terhadap permintaan refresh token. Jika server Anda menyediakan token akses yang sama, kasus uji akan gagal.
Periksa apakah token akses masih berlaku masih valid. Waktu habis masa berlaku token akses akan ditampilkan.
Periksa apakah token refresh telah diputar selama pemuatan ulang. Kami memeriksa apakah token refresh diubah setelah permintaan token refresh. Jika token refresh berubah, server Anda hanya boleh membatalkan token refresh lama setelah token refresh baru digunakan untuk mencegah kondisi race yang dapat merusak penautan akun pengguna. Pengujian akan gagal jika Anda membatalkan token refresh lama sebelum digunakan.

Pesan error

Tabel berikut mencantumkan beberapa pesan error umum yang mungkin Anda temui dan cara yang disarankan untuk mengatasinya.

Pesan Error Cara Menyelesaikan
HomeGraph API belum digunakan dalam project <_id_> sebelum atau dinonaktifkan Pastikan Anda telah mengaktifkan HomeGraph API.
Entitas yang diminta tidak ditemukan Pastikan agentUserId valid dan ditautkan ke layanan Anda.

Kirim hasil tes

Hasil pengujian Anda harus lulus 100% dari pengujian sebelum mengirimkan formulir sertifikasi. Jika memiliki karakteristik yang memerlukan pengujian manual, Anda harus tetap menjalankan alat rangkaian pengujian dan melampirkan hasilnya meskipun belum lulus 100%.

Untuk mengirimkan hasil pengujian dan menjamin Action smart home Anda, ikuti langkah-langkah berikut:

  1. Setelah menerima hasil pengujian dan siap menentukan Action smart home, klik Submit di alat test suite.
  2. Klik tombol DOWNLOAD HASIL UJI untuk mengambil hasil pengujian.
  3. Klik BUKA FORMULIR KIRIMAN untuk mengirimkan hasil tes ke Google.
  4. Isi semua kolom yang wajib diisi, lalu klik Kirim.