Selamat datang di Pusat Developer Google Home, tujuan baru untuk mempelajari cara mengembangkan tindakan smart home. Catatan: Anda akan terus membuat tindakan di konsol Actions.
Tetap teratur dengan koleksi Simpan dan kategorikan konten berdasarkan preferensi Anda.

Skema Trait Smart Home RunCycle

action.devices.traits.RunCycle - Sifat ini mewakili perangkat apa pun yang memiliki durasi operasi yang sedang berlangsung yang dapat dikueri.

Perangkat seperti ini akan melaporkan jumlah total siklusnya pada awal operasi, dan setiap siklus perangkat saat ini sedang berjalan saat berjalan. Hal ini memungkinkan pengguna membuat kueri, seperti berikut:

  • Pengering saya menggunakan siklus apa?
  • Berapa sisa siklus mesin pencuci piring?
  • Apa fungsi pengering?
  • Kapan proses cuci selesai?

Perangkat tertentu menyertakan durasi dalam format non-siklus. Setiap perangkat yang berjalan selama jangka waktu tertentu dapat melaporkan waktu yang tersisa, tanpa siklus. Ini juga menangani kasus saat siklus mungkin tidak konsisten (misalnya, mesin pencuci piring mungkin tidak selalu menggunakan semua siklus). Misalnya, pengguna dapat bertanya, Berapa lama lama penyedot debu saya akan berjalan? yang akan menampilkan jumlah waktu dalam satuan sesuai dengan waktu yang tersisa. Hal ini juga berlaku untuk perangkat yang tercantum di atas; Berapa lama lagi pakaian saya akan kering? akan menampilkan durasi dalam menit.

Perangkat dapat menampilkan apa yang mereka ketahui, dan respons TTS Asisten akan membentuk jawaban terbaik dengan data yang tersedia (misalnya, Mesin pencuci piring sedang berjalan dan akan selesai dalam waktu sekitar 20 menit.)

RunCycle saat ini memiliki sifat hanya baca - tidak memiliki perintah, hanya menyatakan untuk membuat kueri. Di masa mendatang, mungkin ada mekanisme untuk menjalankan ulang atau melewati siklus (cocok untuk sprinkler, buruk untuk mesin cuci).

ATRIBUT Perangkat

Tidak ada.

STATUS Perangkat

Perangkat dengan karakteristik ini dapat melaporkan status berikut sebagai bagian dari operasi QUERY. Untuk mempelajari penanganan intent QUERY lebih lanjut, lihat Penjelasan intent.

Negara bagian Jenis Deskripsi
currentRunCycle Array

Wajib.

Berisi sinonim untuk siklus saat ini dalam setiap bahasa yang didukung.

[item, ...] Objek

Nama sinonim siklus.

currentCycle String

Wajib.

Siklus saat ini sedang dijalankan.

nextCycle String

Opsional. Siklus berikutnya yang akan dijalankan.

lang String

Wajib.

Kode bahasa untuk nama siklus yang diberikan. Lihat Bahasa yang didukung.

currentTotalRemainingTime Integer

Wajib.

Waktu tersisa dalam operasi, dalam detik.

currentCycleRemainingTime Integer

Wajib.

Waktu tersisa pada siklus saat ini, dalam detik.

Contoh

Perangkat sedang berkumur selama 5 menit lagi, dan akan selesai dalam waktu 20 menit.

{
  "currentRunCycle": [
    {
      "currentCycle": "rinse",
      "lang": "en"
    }
  ],
  "currentTotalRemainingTime": 1200,
  "currentCycleRemainingTime": 300
}

Perangkat sedang berkumur selama 5 menit lagi, sebelum bergerak untuk memutar.

{
  "currentRunCycle": [
    {
      "currentCycle": "rinse",
      "nextCycle": "spin",
      "lang": "en"
    }
  ],
  "currentTotalRemainingTime": 600,
  "currentCycleRemainingTime": 300
}

PERMINTAAN Perangkat

Tidak ada.

NOTIFIKASI PERANGKAT

Perangkat dengan karakteristik ini dapat menampilkan payload notifikasi berikut sebagai bagian dari perubahan status perangkat. Untuk mempelajari penerapan notifikasi lebih lanjut, lihat Notifikasi untuk Action smart home.

Kolom Jenis Deskripsi
RunCycle

Wajib.

Payload notifikasi.

Mendukung salah satu dari hal berikut:
0 Objek

Berhasil

priority Integer

Wajib.

Mewakili tingkat notifikasi. Nilai yang saat ini didukung adalah 0, yang menunjukkan bahwa notifikasi harus diucapkan dengan keras.

status String

Wajib.

Hasil operasi.

Nilai yang didukung:

SUCCESS
currentCycleRemainingTime Integer

Wajib.

Waktu tersisa pada siklus saat ini, dalam detik.

1 Objek

Kegagalan

priority Integer

Wajib.

Mewakili tingkat notifikasi. Nilai yang saat ini didukung adalah 0, yang menunjukkan bahwa notifikasi harus diucapkan dengan keras.

status String

Wajib.

Hasil operasi.

Nilai yang didukung:

FAILURE
errorCode String

Wajib.

Nilainya dapat berupa kode error untuk fitur ini, misalnya, deviceStuck.

Contoh

Perangkat telah selesai berjalan.

{
  "RunCycle": {
    "priority": 0,
    "status": "SUCCESS",
    "currentCycleRemainingTime": 0
  }
}

Terjadi error saat menyelesaikan siklus saat ini.

{
  "RunCycle": {
    "priority": 0,
    "status": "FAILURE",
    "errorCode": "deviceStuck"
  }
}

KESALAHAN perangkat

Lihat daftar lengkap error dan pengecualian.