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 Atribut Smart Home Toggle

action.devices.traits.Toggles - Sifat ini dimiliki perangkat apa pun dengan setelan yang hanya dapat ada di salah satu dari dua status.

Setelan ini dapat merepresentasikan tombol fisik dengan status aktif/nonaktif atau aktif/tidak aktif, kotak centang pada HTML, atau jenis elemen lain yang diaktifkan/dinonaktifkan secara khusus. Jika setelan memiliki lebih dari dua status, atau memiliki status saat tidak ada opsi biner yang dipilih, setelan tersebut akan lebih baik ditampilkan sebagai fitur Modes, yang sama dengan panggilan multi-status, tombol pilihan (fisik atau HTML), atau status biner yang tidak secara eksplisit aktif/nonaktif (misalnya, "AM/FM" atau "hot/cold").

Sifat ini mencakup satu atau beberapa tombol yang dapat disetel oleh pengguna. Secara umum, tombol beralih ini harus digunakan untuk fungsi yang dibatalkan tautannya dari perilaku perangkat lain. Perilaku tertaut, seperti mengaktifkan atau menonaktifkan perangkat itu sendiri, harus menggunakan fitur yang lebih spesifik (misalnya, thermostatMode dalam fitur TemperatureSetting).

ATRIBUT Perangkat

Perangkat dengan karakteristik ini dapat melaporkan atribut berikut sebagai bagian dari operasi SYNC. Untuk mempelajari penanganan intent SYNC lebih lanjut, lihat fulfillment intent.

Atribut Jenis Deskripsi
availableToggles Array

Wajib.

Daftar tombol beralih yang tersedia.

[item, ...] Objek

Tombol yang tersedia.

name String

Wajib.

Nama internal tombol beralih, yang akan digunakan dalam perintah dan status. Link ini dapat tidak mudah digunakan dan akan dibagikan dalam semua bahasa.

name_values Array

Wajib.

Sinonim dari tombol dalam setiap bahasa yang didukung.

[item, ...] Objek

Sinonim tombol dalam bahasa tertentu.

name_synonym Array

Wajib.

Sinonim dari tombol. String pertama dalam daftar ini digunakan sebagai nama kanonis level dalam bahasa tersebut.

[item, ...] String

Nama sinonim.

lang String

Wajib.

Kode bahasa (ISO 639-1). Lihat bahasa yang didukung.

commandOnlyToggles Boolean

(Default: false)

Menunjukkan apakah perangkat mendukung penggunaan komunikasi satu arah (benar) atau dua arah (salah). Tetapkan atribut ini ke true jika perangkat tidak dapat merespons intent QUERY atau Status Laporan untuk fitur ini.

queryOnlyToggles Boolean

(Default: false)

Diperlukan jika perangkat mendukung eksekusi khusus kueri. Atribut ini menunjukkan apakah perangkat hanya dapat dikueri untuk mengetahui informasi status, dan tidak dapat dikontrol.

Contoh

Perangkat dengan beberapa tombol beralih.

{
  "availableToggles": [
    {
      "name": "sterilization_toggle",
      "name_values": [
        {
          "name_synonym": [
            "clean",
            "bio clean"
          ],
          "lang": "en"
        }
      ]
    },
    {
      "name": "energysaving_toggle",
      "name_values": [
        {
          "name_synonym": [
            "energy saving",
            "eco"
          ],
          "lang": "en"
        }
      ]
    }
  ]
}

Perangkat dengan tombol alih khusus perintah.

{
  "availableToggles": [
    {
      "name": "filter_toggle",
      "name_values": [
        {
          "name_synonym": [
            "filtered",
            "filter"
          ],
          "lang": "en"
        }
      ]
    }
  ],
  "commandOnlyToggles": true
}

Perangkat dengan tombol khusus kueri.

{
  "availableToggles": [
    {
      "name": "filter_toggle",
      "name_values": [
        {
          "name_synonym": [
            "filtered",
            "filter"
          ],
          "lang": "en"
        }
      ]
    }
  ],
  "queryOnlyToggles": true
}

STATUS Perangkat

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

Negara bagian Jenis Deskripsi
currentToggleSettings Objek

Wajib.

Pasangan kunci/nilai dengan tombol name perangkat sebagai kunci, dan status saat ini sebagai nilai.

<string> Boolean

Status tombol saat ini.

Contoh

Apakah sterilisasi aktif?

{
  "currentToggleSettings": {
    "sterilization_toggle": true,
    "energysaving_toggle": false
  }
}

COMMAND Perangkat

Perangkat dengan karakteristik ini dapat merespons perintah berikut sebagai bagian dari operasi EXECUTE. Untuk mempelajari penanganan intent EXECUTE lebih lanjut, lihat fulfillment intent.

action.devices.commands.SetToggles

Menetapkan status beralih tertentu.

Parameter

Parameter Jenis Deskripsi
updateToggleSettings Objek

Wajib.

Pasangan kunci/nilai dengan tombol name perangkat sebagai kunci, dan status baru sebagai nilai.

<string> Boolean

Status beralih baru

Contoh

Aktifkan mode hemat energi.

{
  "command": "action.devices.commands.SetToggles",
  "params": {
    "updateToggleSettings": {
      "energysaving_toggle": true
    }
  }
}

Nonaktifkan filter.

{
  "command": "action.devices.commands.SetToggles",
  "params": {
    "updateToggleSettings": {
      "filter_toggle": false
    }
  }
}

Contoh ucapan

de-DE

  • Bitte schalte Power Cool am Kühlschrank aus
  • stelle den Kühlschrank auf Power Cool

en-US

  • aktifkan pembekuan daya untuk freezer
  • batal daya dingin untuk kulkas dapur

es-ES

  • pon el enfriamiento rápido en la Nevera
  • quita el enfriamiento rápido

fr-FR

  • meets le mode power cool sur le réfrigérateur
  • Éteins le mode power freeze du réfrigérateur .

Perangkat ERRORS

Lihat daftar lengkap error dan pengecualian.