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 Diarmarm

action.devices.traits.ArmDisarm - Sifat ini mendukung pengaktifan dan penonaktifan seperti yang digunakan di, misalnya, sistem keamanan.

Untuk perangkat dengan beberapa level keamanan, tingkat ini harus dilaporkan dengan atribut availableArmLevels.

ATRIBUT Perangkat

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

Atribut Jenis Deskripsi
availableArmLevels Objek

Menjelaskan tingkat keamanan perangkat yang didukung. Jika atribut ini tidak dilaporkan, perangkat hanya mendukung satu level.

levels Array

Wajib.

Daftar tingkat keamanan yang tersedia yang didukung oleh perangkat.

[item, ...] Objek

Tingkat keamanan.

level_name String

Wajib.

Nama internal tingkat keamanan yang digunakan dalam perintah dan status. Nama ini tidak mudah digunakan dan dibagikan dalam semua bahasa.

level_values Array

Wajib.

Berisi level_synonym dan lang.

[item, ...] Objek

Sinonim tingkat untuk bahasa tertentu.

level_synonym Array

Wajib.

Nama yang mudah digunakan untuk level dalam setiap bahasa yang didukung. Item pertama diperlakukan sebagai nama kanonis.

[item, ...] String

Nama sinonim.

lang String

Wajib.

Kode bahasa untuk sinonim level. Lihat Bahasa yang didukung.

ordered Boolean

Wajib.

Jika disetel ke benar (true), tata bahasa tambahan untuk logika penambahan/penurunan akan diterapkan, dalam urutan array level. Misalnya, "Ok Google, tingkatkan tingkat keamanan saya sebesar 1", membuat Asisten menentukan tingkat keamanan saat ini, lalu meningkatkan tingkat keamanan tersebut satu tingkat. Jika nilai ini ditetapkan ke false, tata bahasa tambahan untuk logika penambahan/penurunan tidak didukung.

Contoh

Sistem keamanan dengan dua tingkat lengan yang berbeda

{
  "availableArmLevels": {
    "levels": [
      {
        "level_name": "L1",
        "level_values": [
          {
            "level_synonym": [
              "home and guarding",
              "SL1"
            ],
            "lang": "en"
          },
          {
            "level_synonym": [
              "zuhause und bewachen",
              "SL1"
            ],
            "lang": "de"
          }
        ]
      },
      {
        "level_name": "L2",
        "level_values": [
          {
            "level_synonym": [
              "away and guarding",
              "SL2"
            ],
            "lang": "en"
          },
          {
            "level_synonym": [
              "weg und bewachen",
              "SL2"
            ],
            "lang": "de"
          }
        ]
      }
    ],
    "ordered": true
  }
}

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
isArmed Boolean

Wajib.

Menunjukkan apakah perangkat saat ini diaktifkan.

currentArmLevel String

Wajib.

Wajib jika atribut availableArmLevels ditentukan. Jika ada beberapa tingkat keamanan, ini menunjukkan nama tingkat keamanan saat ini.

exitAllowance Integer

Menunjukkan waktu, dalam detik, pengguna harus keluar sebelum currentArmLevel berlaku.

Contoh

Sistem keamanan yang melaporkan tingkat grup yang berbeda

{
  "isArmed": true,
  "currentArmLevel": "L1"
}

PERMINTAAN Perangkat

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

action.devices.commands.ArmDisarm

Setel tingkat alarm perangkat ini.

Parameter

Payload berisi salah satu dari berikut ini:

Membatalkan operasi pengaktifan atau penonaktifan

Parameter Jenis Deskripsi
followUpToken String

Token yang diberikan Google untuk respons tindak lanjut.

arm Boolean

Wajib.

True jika perintah untuk mengaktifkan. Salah untuk dinonaktifkan.

cancel Boolean

Wajib.

True jika perintahnya adalah membatalkan nilai arm.

Mengaktifkan atau menonaktifkan perangkat, dengan tingkat keamanan opsional.

Parameter Jenis Deskripsi
followUpToken String

Token yang diberikan Google untuk respons tindak lanjut.

arm Boolean

Wajib.

True jika perintah untuk mengaktifkan. Salah untuk dinonaktifkan.

armLevel String

level_name yang akan diaktifkan.

Contoh

Bertahan pada sistem

{
  "command": "action.devices.commands.ArmDisarm",
  "params": {
    "arm": true,
    "followUpToken": "123"
  }
}

Menyetel sistem ke level lengan L1

{
  "command": "action.devices.commands.ArmDisarm",
  "params": {
    "arm": true,
    "armLevel": "L1",
    "followUpToken": "456"
  }
}

Membatalkan operasi pengaktifan

{
  "command": "action.devices.commands.ArmDisarm",
  "params": {
    "arm": true,
    "cancel": true
  }
}

Terjadi error saat mengaktifkan atau menonaktifkan perangkat.

Nilai yang didukung:

alreadyInState
deviceTampered
passphraseIncorrect
pinIncorrect
securityRestriction
tooManyFailedAttempts
userCancelled

KESALAHAN perangkat

Lihat daftar lengkap error dan pengecualian.