1. Sebelum memulai
Sebagai developer Internet of Things (IoT), Anda dapat membuat Action smart home yang memberi pengguna kemampuan untuk mengontrol perangkatnya melalui kontrol sentuh di aplikasi Google Home dan perintah suara dengan Asisten Google.
Mempelajari alat proses debug untuk Action smart home merupakan langkah penting untuk membangun integrasi kualitas produksi dengan Asisten Google. Untuk memfasilitasi pemantauan dan proses debug yang mudah, Metrik Google Cloud Platform (GCP) dan Logging serta Test Suite untuk smart home tersedia untuk membantu Anda mengidentifikasi dan menyelesaikan masalah pada Action Anda.
Prasyarat
- Baca panduan developer Membuat Action smart home
- Menjalankan codelab Menghubungkan perangkat smart home ke Asisten Google
Yang akan Anda bangun
Dalam codelab ini, Anda akan men-deploy Action smart home dengan 2 kerusakan dan menghubungkannya ke Asisten, lalu men-debug kerusakan Action melalui Test Suite untuk metrik dan Logging smart home & Google Cloud Platform (GCP).
Yang akan Anda pelajari
- Cara menggunakan Metrik dan Logging GCP untuk mengidentifikasi dan menyelesaikan masalah produksi
- Cara menggunakan Test Suite untuk smart home guna mengidentifikasi masalah fungsional dan API
Yang akan Anda butuhkan
- Browser web, seperti Google Chrome
- Perangkat iOS atau Android yang telah menginstal aplikasi Google Home
- Node.js versi 10.16 atau yang lebih baru
- Akun penagihan Google Cloud
2. Menjalankan aplikasi yang rusak
Mendapatkan kode sumber
Klik link berikut untuk mendownload contoh codelab ini di mesin pengembangan Anda:
...atau Anda dapat meng-clone repositori GitHub dari command line:
$ git clone https://github.com/google-home/smarthome-debug.git
Tentang project
Aplikasi mesin cuci berisi subdirektori berikut:
public
: UI frontend untuk mengontrol dan memantau status mesin cuci smart dengan mudah.functions
: Layanan cloud yang diterapkan sepenuhnya yang mengelola mesin cuci smart dengan Cloud Functions for Firebase dan Firebase Realtime Database.
Menghubungkan ke Firebase
Buka terminal di mesin pengembangan Anda. Buka direktori washer-faulty
, lalu siapkan Firebase CLI dengan project Action Anda yang dibuat di Codelab Menghubungkan perangkat smart home ke Asisten Google:
$ cd washer-faulty $ firebase use <project-id>
Men-deploy ke Firebase
Buka folder functions
dan instal semua dependensi yang diperlukan menggunakan npm.
$ cd functions $ npm install
Catatan: Jika melihat pesan di bawah ini, Anda dapat mengabaikan dan melanjutkan. Peringatan ini disebabkan oleh beberapa dependensi yang lebih lama dan Anda dapat menemukan detail selengkapnya di sini.
found 5 high severity vulnerabilities run `npm audit fix` to fix them, or `npm audit` for details
Setelah menginstal dependensi dan mengonfigurasi project, Anda siap men-deploy aplikasi mesin cuci yang rusak.
$ firebase deploy
Ini adalah output konsol yang akan Anda lihat:
... ✔ Deploy complete! Project Console: https://console.firebase.google.com/project/<project-id>/overview Hosting URL: https://<project-id>.firebaseapp.com
Memperbarui HomeGraph
Buka URL Hosting di browser Anda (https://<project-id>.firebaseapp.com
) untuk melihat aplikasi web. Di UI web, klik tombol Refresh untuk mengupdate HomeGraph melalui Request Sync dengan metadata perangkat terbaru dari aplikasi mesin cuci yang rusak:
Buka aplikasi Google Home dan pastikan Anda dapat melihat perangkat mesin cuci bernama Faulty Mesin Cuci.
3. Menguji Action Anda
Setelah men-deploy project, uji apakah Action Anda mengontrol mesin cuci.
Menguji mesin cuci
Periksa perubahan nilai saat Anda mencoba salah satu perintah suara berikut melalui ponsel:
"Ok Google, nyalakan mesin cuci".
"Ok Google, mulai mesin cuci saya".
"Ok Google, jeda mesin cuci saya."
"Ok Google, lanjutkan mesin cuci saya."
"Ok Google, hentikan mesin cuci saya".
Anda akan melihat Asisten merespons bahwa ada yang tidak beres melalui suara saat Anda menjeda / melanjutkan mesin cuci:
"Maaf, saya tidak dapat menjangkau <nama tampilan project>".
Untuk men-debug masalah ini, Anda memerlukan informasi lebih lanjut tentang error tersebut terlebih dahulu untuk mempersempit dan mengidentifikasi akar masalahnya.
Dasbor Analytics Smarthome
Tempat yang tepat untuk memeriksa error adalah dasbor Analisis Smarthome, yang menggabungkan diagram metrik Penggunaan dan Kesehatan untuk fulfillment cloud Anda:
- Metrik Penggunaan mencerminkan tren penggunaan Action smart home Anda, termasuk jumlah pengguna aktif harian dan total jumlah permintaan untuk fulfillment Anda.
- Metrik Kesehatan membantu Anda memantau kemunculan anomali di Action smart home, yang mencakup latensi permintaan, persentase keberhasilan, dan perincian error.
Untuk mempersempit penyebab error, ikuti langkah-langkah di bawah ini untuk mengakses dasbor project.
- Di konsol Actions, buka halaman Project.
- Pilih project smart home Anda.
- Pilih tab Analytics, lalu klik Buka Google Cloud Platform.
- Ini akan mengarahkan Anda ke daftar dasbor untuk project Anda di Google Cloud. Pilih dasbor Google Home Analytics - Integrasi Cloud.
- Scroll ke bawah ke diagram Error Pemenuhan Cloud - Perincian Status untuk melihat kode error pada rentang waktu yang ditandai.
Kode error PARTNER_RESPONSE_MISSING_DEVICE
memberikan petunjuk tentang akar masalahnya. Berikutnya, ambil log aktivitas berdasarkan kode error untuk mengetahui detail selengkapnya.
Mengakses log aktivitas
Untuk mendapatkan detail selengkapnya tentang error, akses log aktivitas untuk Action smart home Anda melalui Cloud Logging.
Buka Navigation Menu di Google Cloud Platform, dan di bagian Operations, pilih Logging > Logs Explorer untuk mengakses log peristiwa untuk project Anda. Atau, Anda dapat menelusuri Logs Explorer di kotak penelusuran.
Di bagian Query, masukkan kueri PARTNER_RESPONSE_MISSING_DEVICE
, lalu klik Run Query. Log yang cocok dengan kueri akan ditampilkan di bagian Query results.
Log error menampilkan peristiwa smart home dengan detail error yang menunjukkan:
- Tindakan pengguna yang diambil adalah "melanjutkan mesin cuci" (
actionType:
"STARTSTOP_UNPAUSE
"), sesuai dengan perintah suara yang gagal baru-baru ini. - Pesan proses debug yang terkait adalah "
JSON response does not include device.
"
Berdasarkan pesan proses debug, Anda harus memeriksa alasan aplikasi mesin cuci tidak menyertakan perangkat yang benar dalam respons EXECUTE
.
Mengidentifikasi akar penyebab error
Di functions/index.js
, temukan pengendali EXECUTE
(dalam array onExecute
) yang menampilkan status setiap perintah dan status perangkat baru. Penyisipan ID perangkat ke dalam respons EXECUTE
bergantung pada penyelesaian fungsi updateDevice
:
index.js
app.onExecute(async (body) => {
...
for (const command of intent.payload.commands) {
for (const device of command.devices) {
for (const execution of command.execution) {
executePromises.push(
updateDevice(execution, device.id)
.then((data) => {
result.ids.push(device.id);
Object.assign(result.states, data);
})
.catch((e) =>
functions.logger.error('EXECUTE',
device.id, e.message)));
}
}
}
Periksa lebih lanjut cara fungsi updateDevice
menangani jeda / lanjutkan pada mesin cuci, dan Anda akan menemukan string yang cocok dengan perintah jeda / lanjutkan salah:
index.js
const updateDevice = async (execution, deviceId) => {
const {params, command} = execution;
let state; let ref;
switch (command) {
...
case 'action.devices.commands.PauseUnpausePause':
state = {isPaused: params.pause};
if (params.pause) state.isRunning = false;
ref = firebaseRef.child(deviceId).child('StartStop');
break;
}
return ref.update(state)
.then(() => state);
};
Memperbaiki error
Sekarang setelah mengidentifikasi akar penyebab error, Anda dapat memperbaiki string untuk perintah jeda / lanjutkan:
index.js
const updateDevice = async (execution, deviceId) => {
const {params, command} = execution;
let state; let ref;
switch (command) {
...
case 'action.devices.commands.PauseUnpause':
state = {isPaused: params.pause};
if (params.pause) state.isRunning = false;
ref = firebaseRef.child(deviceId).child('StartStop');
break;
}
return ref.update(state)
.then(() => state);
};
Menguji perbaikan
Deploy kode yang telah diperbarui menggunakan Firebase CLI:
firebase deploy --only functions
Coba lagi perintah suara berikut, dan kini Anda akan melihat Asisten merespons dengan benar saat Anda menjeda / melanjutkan mesin cuci.
"Ok Google, jeda mesin cuci saya".
=>
"Tentu, jeda mesin cuci."
"Ok Google, lanjutkan mesin cuci saya".
=>
"Oke, melanjutkan mesin cuci."
Anda juga dapat menguji kondisi mesin cuci saat ini dengan mengajukan pertanyaan.
"Ok Google, apa mesin cuci saya menyala?"
"Ok Google, apa mesin cuci saya sedang bekerja?"
"Ok Google, mesin cuci saya sedang berada di siklus apa?"
4. Menguji Action Anda dengan Test Suite
Selain menguji secara manual, Anda dapat menggunakan Test Suite untuk smart home otomatis untuk memvalidasi kasus penggunaan berdasarkan jenis dan karakteristik perangkat yang terkait dengan Action Anda. Test Suite menjalankan serangkaian pengujian untuk mendeteksi masalah dalam Action Anda, dan menampilkan pesan informatif untuk kasus pengujian yang gagal guna mempercepat proses debug sebelum mendalami log aktivitas.
Menjalankan Test Suite untuk smart home
Ikuti petunjuk berikut untuk menguji Action smart home Anda dari Test Suite:
- Di browser web, buka Test Suite untuk smart home.
- Login ke Google menggunakan tombol di pojok kanan atas. Hal ini memungkinkan Test Suite mengirimkan perintah langsung ke Asisten Google.
- Di kolom ID project, masukkan ID project Action smart home Anda. Lalu klik BERIKUTNYA untuk melanjutkan.
- Pada langkah Setelan Pengujian, Anda akan melihat Test Suite mencantumkan jenis perangkat dan karakteristik mesin cuci.
- Nonaktifkan opsi Sinkronisasi Permintaan Pengujian karena aplikasi contoh mesin cuci tidak memiliki UI untuk menambahkan / menghapus / mengganti nama mesin cuci. Dalam sistem produksi, Anda harus memicu Minta Sinkronisasi setiap kali pengguna menambahkan / menghapus / mengganti nama perangkat.
- Klik BERIKUTNYA untuk mulai menjalankan pengujian.
Setelah Test Suite selesai dijalankan, lihat hasil kasus pengujian. Anda akan melihat dua kasus pengujian gagal yang tertangkap dengan pesan error masing-masing:
Untuk men-debug Action smart home atas kegagalan, Anda harus mengidentifikasi akar penyebab error dengan menganalisis pesan error terlebih dahulu.
Menganalisis pesan error
Untuk membantu developer mengidentifikasi akar masalah, Test Suite menampilkan pesan error untuk setiap kasus pengujian yang gagal yang menunjukkan alasan kegagalan.
Untuk kasus pengujian pertama yang gagal di atas,
pesan error-nya menunjukkan bahwa Test Suite mengharapkan "isPause": true
dalam status yang dilaporkan dari Action smart home Anda, tetapi status sebenarnya hanya mencakup "isPause": false
.
Selain itu, pesan error kasus pengujian kedua yang gagal menunjukkan status dalam respons QUERY
dari Action smart home Anda mencakup "isPause": true
, yang berbeda dari "isPause": false
dalam status yang dilaporkan dari Action smart home Anda:
Berdasarkan kedua pesan error tersebut, Anda harus memeriksa apakah laporan Action menyatakan isPaused
dengan nilai yang benar.
Mengidentifikasi akar penyebab error
Buka functions/index.js
, yang berisi fungsi reportstate
yang memposting perubahan status ke Home Graph melalui Status Laporan. Periksa payload Report State, dan Anda akan menemukan bahwa payload tidak memiliki status isPaused
, yang persis seperti yang diperiksa Test Suite dalam kasus pengujian yang gagal.
index.js
exports.reportstate = functions.database.ref('{deviceId}').onWrite(
async (change, context) => {
...
const requestBody = {
requestId: 'ff36a3cc', /* Any unique ID */
agentUserId: USER_ID,
payload: {
devices: {
states: {
/* Report the current state of our washer */
[context.params.deviceId]: {
online: true,
on: snapshot.OnOff.on,
isRunning: snapshot.StartStop.isRunning,
currentRunCycle: [{
currentCycle: 'rinse',
nextCycle: 'spin',
lang: 'en',
}],
currentTotalRemainingTime: 1212,
currentCycleRemainingTime: 301,
},
},
},
},
};
const res = await homegraph.devices.reportStateAndNotification({
requestBody,
});
...
});
Memperbaiki error
Setelah Anda mengidentifikasi akar masalah error, revisi functions/index.js
dengan menambahkan status isPaused
ke payload Status Laporan:
index.js
exports.reportstate = functions.database.ref('{deviceId}').onWrite(
async (change, context) => {
...
const requestBody = {
requestId: 'ff36a3cc', /* Any unique ID */
agentUserId: USER_ID,
payload: {
devices: {
states: {
/* Report the current state of our washer */
[context.params.deviceId]: {
online: true,
on: snapshot.OnOff.on,
isPaused: snapshot.StartStop.isPaused,
isRunning: snapshot.StartStop.isRunning,
currentRunCycle: [{
currentCycle: 'rinse',
nextCycle: 'spin',
lang: 'en',
}],
currentTotalRemainingTime: 1212,
currentCycleRemainingTime: 301,
},
},
},
},
};
...
});
Menguji perbaikan
Deploy kode yang telah diperbarui menggunakan Firebase CLI:
$ firebase deploy --only functions
Jalankan kembali Test Suite untuk smart home, dan Anda akan mendapati bahwa semua kasus pengujian telah lulus.
5. Selamat
Selamat! Anda berhasil mempelajari cara memecahkan masalah Action smart home melalui Test Suite untuk Metrik dan Logging GCP & smart home.
Pelajari lebih lanjut
Dari Codelab ini, coba latihan berikut dan jelajahi resource tambahan:
- Tambahkan karakteristik yang didukung lainnya ke perangkat dan uji dengan Test Suite.
- Buat dasbor, siapkan pemberitahuan, dan akses data metrik secara terprogram untuk mendapatkan metrik penggunaan yang berguna tentang Action Anda.
- Jelajahi fulfillment lokal untuk smart home.
- Lihat contoh GitHub kami untuk mempelajari lebih lanjut.
Anda juga dapat mempelajari lebih lanjut cara menguji dan mengirimkan Action untuk ditinjau, termasuk proses sertifikasi untuk memublikasikan Action kepada pengguna.