ยินดีต้อนรับสู่ศูนย์นักพัฒนาซอฟต์แวร์ Google Home ซึ่งเป็นจุดหมายใหม่เกี่ยวกับวิธีพัฒนาการดําเนินการสําหรับบ้านอัจฉริยะ หมายเหตุ: คุณจะสร้างการดําเนินการต่างๆ ต่อไปในคอนโซลการดําเนินการ

แบบแผน SmartDisrmrma

action.devices.traits.ArmDisarm - ลักษณะนี้รองรับการป้องกันและปิดการใช้งาน เช่น ระบบรักษาความปลอดภัย เป็นต้น

สําหรับอุปกรณ์ที่มีระดับการรักษาความปลอดภัยหลายระดับ ควรรายงานระดับเหล่านี้ด้วยแอตทริบิวต์ availableArmLevels

แอตทริบิวต์ของอุปกรณ์

อุปกรณ์ที่มีลักษณะเฉพาะนี้อาจรายงานแอตทริบิวต์ต่อไปนี้เป็นส่วนหนึ่งของการดําเนินการ SYNC หากต้องการดูข้อมูลเพิ่มเติมเกี่ยวกับการจัดการ Intent ของ SYNC โปรดดูการดําเนินการ Intent

แอตทริบิวต์ Type คำอธิบาย
availableArmLevels ออบเจ็กต์

อธิบายระดับการรักษาความปลอดภัยที่รองรับของอุปกรณ์ หากไม่มีการรายงานแอตทริบิวต์นี้ แสดงว่าอุปกรณ์รองรับเพียงระดับเดียวเท่านั้น

levels อาร์เรย์

ต้องระบุ

รายการระดับการรักษาความปลอดภัยที่อุปกรณ์รองรับ

[item, ...] ออบเจ็กต์

ระดับความปลอดภัย

level_name สตริง

ต้องระบุ

ชื่อภายในของระดับความปลอดภัยที่ใช้ในคําสั่งและสถานะ ชื่อนี้อาจใช้งานยากและแชร์ได้ในทุกภาษา

level_values อาร์เรย์

ต้องระบุ

มี level_synonym และ lang

[item, ...] ออบเจ็กต์

ระดับคําที่มีความหมายเหมือนกันสําหรับภาษาที่ระบุ

level_synonym อาร์เรย์

ต้องระบุ

ชื่อที่ใช้ง่ายในระดับต่างๆ ในแต่ละภาษาที่รองรับ รายการแรกจะถือเป็นชื่อมาตรฐาน

[item, ...] สตริง

ชื่อคําพ้องความหมาย

lang สตริง

ต้องระบุ

รหัสภาษาสําหรับคําพ้องความหมายของระดับ ดูภาษาที่รองรับ

ordered บูลีน

ต้องระบุ

หากตั้งค่าเป็น "จริง" ระบบจะใช้ไวยากรณ์เพิ่มเติมสําหรับตรรกะการเพิ่มขึ้น/ลดลงตามลําดับของอาร์เรย์ระดับ ตัวอย่างเช่น "Ok Google เพิ่มระดับความปลอดภัยขึ้น 1" ทําให้ Assistant กําหนดระดับการรักษาความปลอดภัยปัจจุบันแล้วเพิ่มระดับการรักษาความปลอดภัยขึ้นอีก 1 หากตั้งค่าเป็น "เท็จ" ระบบจะไม่รองรับไวยากรณ์เพิ่มเติมสําหรับตรรกะการเพิ่ม/ลด

ตัวอย่าง

ระบบรักษาความปลอดภัย 2 ระดับ

{
  "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
  }
}

อุปกรณ์ STATES

เอนทิตีที่มีลักษณะนี้อาจรายงานสถานะต่อไปนี้เป็นส่วนหนึ่งของการดําเนินการ QUERY หากต้องการดูข้อมูลเพิ่มเติมเกี่ยวกับการจัดการ Intent ของ QUERY โปรดดูการดําเนินการ Intent

รัฐ Type คำอธิบาย
isArmed บูลีน

ต้องระบุ

ระบุว่าอุปกรณ์เปิดอยู่ไหม

currentArmLevel สตริง

ต้องระบุ

ต้องระบุหากมีการระบุแอตทริบิวต์ availableArmLevels ถ้ามีระดับความปลอดภัยหลายระดับ ให้ระบุชื่อของระดับความปลอดภัยปัจจุบัน

exitAllowance จำนวนเต็ม

ระบุเวลาที่ผู้ใช้ต้องออกจากไม่กี่วินาทีก่อนที่ currentArmLevel จะมีผล

ตัวอย่าง

ระบบรักษาความปลอดภัยที่รายงานระดับแขนที่แตกต่างกัน

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

อุปกรณ์ COMMANDS

อุปกรณ์ที่มีลักษณะเฉพาะนี้อาจตอบสนองต่อคําสั่งต่อไปนี้ในฐานะส่วนหนึ่งของการดําเนินการ EXECUTE หากต้องการดูข้อมูลเพิ่มเติมเกี่ยวกับการจัดการ Intent ของ EXECUTE โปรดดูการดําเนินการ Intent

action.devices.commands.ArmDisarm

ตั้งระดับการปลุกของอุปกรณ์นี้

พารามิเตอร์

เพย์โหลดมีดังต่อไปนี้

ยกเลิกการใช้งานแขนหรืออาวุธ

พารามิเตอร์ Type คำอธิบาย
followUpToken สตริง

โทเค็นที่ Google ให้ไว้เพื่อตอบกลับติดตามผล

arm บูลีน

ต้องระบุ

เป็นจริงเมื่อคําสั่งเริ่มทํางาน เท็จที่จะปิดใช้งาน

cancel บูลีน

ต้องระบุ

เป็นจริงเมื่อคําสั่งคือการยกเลิกค่า arm

เปิดหรือปิดระบบป้องกันอุปกรณ์ด้วยระดับการรักษาความปลอดภัยที่ไม่บังคับ

พารามิเตอร์ Type คำอธิบาย
followUpToken สตริง

โทเค็นที่ Google ให้ไว้เพื่อตอบกลับติดตามผล

arm บูลีน

ต้องระบุ

เป็นจริงเมื่อคําสั่งเริ่มทํางาน เท็จที่จะปิดใช้งาน

armLevel สตริง

level_name ได้แล้ว

ตัวอย่าง

ปิดระบบ

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

ตั้งค่าระบบเป็นระดับ L1

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

ยกเลิกการดําเนินการเปิดใช้งาน

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

เกิดข้อผิดพลาดขณะเปิดหรือปิดระบบ

ค่าที่รองรับ:

alreadyInState
deviceTampered
passphraseIncorrect
pinIncorrect
securityRestriction
tooManyFailedAttempts
userCancelled

อุปกรณ์ ERRORS

ดูรายการข้อผิดพลาดและข้อยกเว้นทั้งหมด