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

สคีมาของฟีเจอร์ Home Home SensorState

action.devices.traits.SensorState - ลักษณะเฉพาะนี้ครอบคลุมทั้งการวัดผลเชิงปริมาณและสถานะเชิงคุณภาพ

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

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

แอตทริบิวต์ ประเภท คำอธิบาย
sensorStatesSupported อาร์เรย์

ต้องระบุ

ออบเจ็กต์แต่ละรายการแสดงถึงความสามารถของสถานะเซ็นเซอร์ที่อุปกรณ์เครื่องนี้รองรับ เซ็นเซอร์แต่ละตัวต้องมีฟังก์ชันที่สื่อความหมายหรือตัวเลขเป็นอย่างน้อย เซ็นเซอร์ยังสามารถรายงานทั้ง 2 กรณีนี้ได้ด้วย ซึ่งอาจเป็นค่าตัวเลข

[item, ...] วัตถุ

ความสามารถของเซ็นเซอร์ที่รองรับ

ต้องมีอย่างน้อย 1 รายการ

name สตริง

ต้องระบุ

ประเภทเซ็นเซอร์ที่รองรับ ดูตารางเซ็นเซอร์ที่รองรับ

descriptiveCapabilities วัตถุ

คําอธิบายความสามารถของเซ็นเซอร์

availableStates อาร์เรย์

ต้องระบุ

รายการสถานะที่พร้อมใช้งานสําหรับอุปกรณ์ สถานะ "ไม่ทราบ" จะรองรับโดยปริยายเมื่อเซ็นเซอร์ไม่แสดงผลค่า

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

ค่าสถานะที่สื่อความหมายที่รองรับ

ต้องมีอย่างน้อย 1 รายการ

numericCapabilities วัตถุ

อธิบายค่าตัวเลขที่เป็นไปได้ที่เซ็นเซอร์รายงานได้

rawValueUnit สตริง

ต้องระบุ

หน่วยตัวเลขที่รองรับ

ดูเซ็นเซอร์ที่รองรับเพื่อดูรายละเอียดเพิ่มเติมเกี่ยวกับความสามารถและประเภทเซ็นเซอร์ต่างๆ ที่ฟีเจอร์นี้รองรับ

ตัวอย่าง

อุปกรณ์เซ็นเซอร์ที่รายงานค่าสถานะที่สื่อความหมาย

{
  "sensorStatesSupported": [
    {
      "name": "AirQuality",
      "descriptiveCapabilities": {
        "availableStates": [
          "healthy",
          "moderate",
          "unhealthy",
          "very unhealthy"
        ]
      }
    }
  ]
}

อุปกรณ์เซ็นเซอร์ที่รายงานค่าสถานะที่เป็นตัวเลข

{
  "sensorStatesSupported": [
    {
      "name": "CarbonMonoxideLevel",
      "numericCapabilities": {
        "rawValueUnit": "PARTS_PER_MILLION"
      }
    }
  ]
}

อุปกรณ์เซ็นเซอร์ที่รายงานค่าสถานะที่สื่อความหมายและเป็นตัวเลข

{
  "sensorStatesSupported": [
    {
      "name": "SmokeLevel",
      "numericCapabilities": {
        "rawValueUnit": "PARTS_PER_MILLION"
      },
      "descriptiveCapabilities": {
        "availableStates": [
          "smoke detected",
          "high",
          "no smoke detected"
        ]
      }
    }
  ]
}

เซ็นเซอร์ที่รองรับ

ตารางต่อไปนี้แสดงประเภทเซ็นเซอร์ที่รองรับและความสามารถของอุปกรณ์ที่เกี่ยวข้อง

คุณภาพอากาศ

ชื่อ ความสามารถที่มีคําอธิบาย ความสามารถตัวเลข

ค่าที่รองรับมีดังต่อไปนี้

AirQuality

ค่าที่รองรับมีดังต่อไปนี้

healthy
moderate
unhealthy
unhealthy for sensitive groups
very unhealthy
hazardous
good
fair
poor
very poor
severe
unknown

ค่าที่รองรับมีดังต่อไปนี้

AQI

คาร์บอนมอนอกไซด์

ชื่อ ความสามารถที่มีคําอธิบาย ความสามารถตัวเลข

ค่าที่รองรับมีดังต่อไปนี้

CarbonMonoxideLevel

ค่าที่รองรับมีดังต่อไปนี้

carbon monoxide detected
high
no carbon monoxide detected
unknown

ค่าที่รองรับมีดังต่อไปนี้

PARTS_PER_MILLION

ระดับควัน

ชื่อ ความสามารถที่มีคําอธิบาย ความสามารถตัวเลข

ค่าที่รองรับมีดังต่อไปนี้

SmokeLevel

ค่าที่รองรับมีดังต่อไปนี้

smoke detected
high
no smoke detected
unknown

ค่าที่รองรับมีดังต่อไปนี้

PARTS_PER_MILLION

กรองความสะอาด

ชื่อ ความสามารถที่มีคําอธิบาย ความสามารถตัวเลข

ค่าที่รองรับมีดังต่อไปนี้

FilterCleanliness

ค่าที่รองรับมีดังต่อไปนี้

clean
dirty
needs replacement
unknown
ไม่รองรับ

น้ํารั่ว

ชื่อ ความสามารถที่มีคําอธิบาย ความสามารถตัวเลข

ค่าที่รองรับมีดังต่อไปนี้

WaterLeak

ค่าที่รองรับมีดังต่อไปนี้

leak
no leak
unknown
ไม่รองรับ

การตรวจหาฝนตก

ชื่อ ความสามารถที่มีคําอธิบาย ความสามารถตัวเลข

ค่าที่รองรับมีดังต่อไปนี้

RainDetection

ค่าที่รองรับมีดังต่อไปนี้

rain detected
no rain detected
unknown
ไม่รองรับ

อายุการใช้งานตัวกรอง

ชื่อ ความสามารถที่มีคําอธิบาย ความสามารถตัวเลข

ค่าที่รองรับมีดังต่อไปนี้

FilterLifeTime

ค่าที่รองรับมีดังต่อไปนี้

new
good
replace soon
replace now
unknown

ค่าที่รองรับมีดังต่อไปนี้

PERCENTAGE

อายุการใช้งานของตัวกรองที่คํานวณแล้ว

ชื่อ ความสามารถที่มีคําอธิบาย ความสามารถตัวเลข

ค่าที่รองรับมีดังต่อไปนี้

PreFilterLifeTime
HEPAFilterLifeTime
Max2FilterLifeTime
ไม่รองรับ

ค่าที่รองรับมีดังต่อไปนี้

PERCENTAGE

ระดับคาร์บอนไดออกไซด์

ชื่อ ความสามารถที่มีคําอธิบาย ความสามารถตัวเลข

ค่าที่รองรับมีดังต่อไปนี้

CarbonDioxideLevel
ไม่รองรับ

ค่าที่รองรับมีดังต่อไปนี้

PARTS_PER_MILLION

ฝุ่นละออง

ชื่อ ความสามารถที่มีคําอธิบาย ความสามารถตัวเลข

ค่าที่รองรับมีดังต่อไปนี้

PM2.5
PM10
ไม่รองรับ

ค่าที่รองรับมีดังต่อไปนี้

MICROGRAMS_PER_CUBIC_METER

สารอินทรีย์ระเหยง่าย

ชื่อ ความสามารถที่มีคําอธิบาย ความสามารถตัวเลข

ค่าที่รองรับมีดังต่อไปนี้

VolatileOrganicCompounds
ไม่รองรับ

ค่าที่รองรับมีดังต่อไปนี้

PARTS_PER_MILLION

สถานะอุปกรณ์

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

รัฐ ประเภท คำอธิบาย
currentSensorStateData อาร์เรย์

ต้องระบุ

รายการสถานะเซ็นเซอร์ปัจจุบัน

[item, ...] วัตถุ

สถานะเซ็นเซอร์ปัจจุบัน

name สตริง

ต้องระบุ

ชื่อสถานะเซ็นเซอร์ จับคู่ค่าจาก sensorStatesSupported

currentSensorState สตริง

ค่าสถานะที่สื่อความหมายในปัจจุบัน จับคู่ค่าจาก sensorStatesSupported

rawValue Number

ค่าเซ็นเซอร์ตัวเลขปัจจุบัน

ดูเซ็นเซอร์ที่รองรับเพื่อดูรายละเอียดเพิ่มเติมเกี่ยวกับความสามารถและประเภทเซ็นเซอร์ต่างๆ ที่ฟีเจอร์นี้รองรับ

ตัวอย่าง

อุปกรณ์เซ็นเซอร์ที่รายงานค่าสถานะที่สื่อความหมาย

{
  "currentSensorStateData": [
    {
      "name": "AirQuality",
      "currentSensorState": "healthy"
    }
  ]
}

อุปกรณ์เซ็นเซอร์ที่รายงานค่าสถานะที่เป็นตัวเลข

{
  "currentSensorStateData": [
    {
      "name": "CarbonMonoxideLevel",
      "rawValue": 200
    }
  ]
}

อุปกรณ์เซ็นเซอร์ที่รายงานค่าสถานะที่สื่อความหมายและเป็นตัวเลข

{
  "currentSensorStateData": [
    {
      "name": "SmokeLevel",
      "currentSensorState": "smoke detected",
      "rawValue": 200
    }
  ]
}

คําสั่งของอุปกรณ์

ไม่มี

การแจ้งเตือนของอุปกรณ์

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

ช่อง ประเภท คำอธิบาย
SensorState วัตถุ

ต้องระบุ

เพย์โหลดการแจ้งเตือน

priority จำนวนเต็ม

ต้องระบุ

แสดงถึงระดับการแจ้งเตือน ค่าที่รองรับปัจจุบันคือ 0 ซึ่งบ่งชี้ว่าควรพูดการแจ้งเตือนดังกล่าว

name สตริง

ต้องระบุ

ชื่อสถานะเซ็นเซอร์ ดูรายการประเภทเซ็นเซอร์ที่รองรับสําหรับการแจ้งเตือน

currentSensorState สตริง

ต้องระบุ

ค่าสถานะที่สื่อความหมายในปัจจุบัน ดูรายการประเภทเซ็นเซอร์ที่รองรับสําหรับการแจ้งเตือน

เพย์โหลดการแจ้งเตือนอาจมีประเภทเซ็นเซอร์ต่อไปนี้

  • AirQuality
  • CarbonMonoxideLevel
  • SmokeLevel
  • FilterCleanliness
  • WaterLeak
  • RainDetection
  • FilterLifeTime

ดูรายละเอียดเพิ่มเติมเกี่ยวกับความสามารถต่างๆ ที่เซ็นเซอร์แต่ละประเภทรองรับได้ในเซ็นเซอร์ที่รองรับ

ตัวอย่าง

ตรวจพบควัน

{
  "SensorState": {
    "priority": 0,
    "name": "SmokeLevel",
    "currentSensorState": "high"
  }
}

อุปกรณ์ ERRORS

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