การรองรับลักษณะของ Automation API

Automation API รองรับลักษณะส่วนใหญ่ แต่การรองรับแอตทริบิวต์ เหตุการณ์ และคำสั่งบางอย่างในลักษณะอาจถูกจำกัด

หากต้องการยืนยันว่า Automation API รองรับกรณีการใช้งานของคุณ ให้ค้นหาในตารางด้านล่าง

โดยทั่วไปแล้วหมวดหมู่จะทำงานดังนี้

  • คุณจะต้องลงทะเบียนลักษณะและประเภทที่ต้องการใช้ในแอปกับ Automation API เมื่อเริ่มต้น โปรดดูหัวข้อสร้างอินสแตนซ์ Home
  • คุณใช้แอตทริบิวต์ใดก็ได้ในเงื่อนไขเริ่มต้นหรือเงื่อนไข
  • อุปกรณ์ Cloud-to-cloud เครื่องที่ไม่รายงานสถานะจะใช้เป็นทริกเกอร์ในการทํางานอัตโนมัติที่สร้างขึ้นด้วยตนเองหรือผ่านการค้นพบไม่ได้
  • แม้ว่าอุปกรณ์จะรองรับลักษณะที่ระบุไว้ที่นี่ แต่อุปกรณ์อาจถูกบล็อกไม่ให้ใช้เป็นเงื่อนไขเริ่มต้นหรือการดำเนินการใน Automation API เนื่องจากเกณฑ์คุณภาพของสถานะรายงาน ดังนี้
    • ระบบจะบล็อกอุปกรณ์ที่มีอัตราความสําเร็จของสถานะการรายงานต่ำกว่า 90% ไม่ให้ใช้เป็นเงื่อนไขเริ่มต้น
    • ระบบจะบล็อกอุปกรณ์ที่มีอัตราความสำเร็จในการดำเนินการตามคำสั่งต่ำกว่า 95% ไม่ให้ใช้ดำเนินการ
  • คำสั่งใช้ได้เฉพาะกับการดำเนินการเท่านั้น
  • บางลักษณะ เช่น AssistantBroadcast จะใช้ได้ใน Automation API เท่านั้น
  • คำสั่ง okGoogle เป็นคำสั่งระดับโครงสร้างและสามารถใช้เพื่อทำให้อุปกรณ์ใดก็ได้ในโครงสร้างทำงานอัตโนมัติ อย่างไรก็ตาม แอป Home APIs อาจไม่มีสิทธิ์เข้าถึงอุปกรณ์บางเครื่อง ดูสิทธิ์ OkGoogle เพื่อดูวิธีบังคับใช้สิทธิ์ในหลายๆ กรณี
  • โดยลักษณะบางรายการมีข้อกําหนดเบื้องต้นดังนี้
    • หากต้องการใช้ Time.ScheduledTimeEvent โครงสร้างที่ทำงานอัตโนมัติต้องมีที่อยู่ซึ่งตั้งค่าไว้ใน Google Home app (GHA) เปลี่ยนที่อยู่บ้านใน Google อธิบายวิธีที่ผู้ใช้ป้อนที่อยู่ของโครงสร้างได้ หากไม่ได้ตั้งค่าที่อยู่ใน GHA ระบบจะสร้างการทำงานอัตโนมัติไม่สำเร็จ และระบบจะแสดงข้อผิดพลาดพร้อมข้อความว่า "structure ไม่รองรับ ScheduledTimeEvent"
    • หากต้องการใช้ลักษณะ AreaPresenceState หรือ AreaAttendanceState ผู้ใช้ต้องตั้งค่าการตรวจหาบุคคลในบ้านใน GHA
    • หากต้องการใช้ลักษณะ ObjectDetection ผู้ใช้ต้องสมัครใช้บริการ Nest Aware อยู่

นอกจากนี้ คุณยังใช้ลักษณะบางรายการในเวอร์ชันที่เรียบง่ายในงานอัตโนมัติได้ด้วย ดูข้อมูลเพิ่มเติมได้ที่ลักษณะที่เรียบง่าย

บล็อกบ่งบอกว่าระบบไม่รองรับคำสั่งดังกล่าวในการทํางานอัตโนมัติสําหรับอุปกรณ์อย่างน้อย 1 ประเภท ดูข้อมูลเพิ่มเติมได้ที่การดำเนินการที่ถูกบล็อกในการทำงานอัตโนมัติ

ลักษณะ ประเภทลักษณะ ประเภทองค์ประกอบ องค์ประกอบ
AssistantBroadcast google คำสั่ง ออกอากาศ
AssistantFulfillment google คำสั่ง OkGoogle
การแจ้งเตือน google คำสั่ง SendNotifications
เวลา google กิจกรรม ScheduledTimeEvent
เวลา google แอตทริบิวต์ currentTime
เวลา google แอตทริบิวต์ missingStructureLocation
เวลา google แอตทริบิวต์ sunriseTime
เวลา google แอตทริบิวต์ sunsetTime
VoiceStarter google กิจกรรม OkGoogleEvent
AirQuality matter แอตทริบิวต์ airQuality
ApplicationLauncher matter คำสั่ง LaunchApp
ApplicationLauncher matter คำสั่ง StopApp
ApplicationLauncher matter แอตทริบิวต์ currentApp
AudioOutput matter แอตทริบิวต์ currentOutput
CarbonDioxideConcentrationMeasurement matter แอตทริบิวต์ levelValue
CarbonDioxideConcentrationMeasurement matter แอตทริบิวต์ measuredValue
CarbonMonoxideConcentrationMeasurement matter แอตทริบิวต์ levelValue
CarbonMonoxideConcentrationMeasurement matter แอตทริบิวต์ maxMeasuredValue
CarbonMonoxideConcentrationMeasurement matter แอตทริบิวต์ measuredValue
CarbonMonoxideConcentrationMeasurement matter แอตทริบิวต์ measurementUnit
CarbonMonoxideConcentrationMeasurement matter แอตทริบิวต์ minMeasuredValue
CarbonMonoxideConcentrationMeasurement matter แอตทริบิวต์ ความไม่แน่นอน
ช่อง matter คำสั่ง ChangeChannelByNumber
ช่อง matter คำสั่ง SkipChannel
ColorControl matter คำสั่ง ColorLoopSet
ColorControl matter คำสั่ง MoveColor
ColorControl matter คำสั่ง MoveColorTemperature
ColorControl matter คำสั่ง MoveToColor
ColorControl matter คำสั่ง MoveToColorTemperature
ColorControl matter คำสั่ง MoveToHue
ColorControl matter คำสั่ง MoveToHueAndSaturation
ColorControl matter คำสั่ง MoveToSaturation
ColorControl matter คำสั่ง StepColor
ColorControl matter คำสั่ง StepColorTemperature
ColorControl matter แอตทริบิวต์ colorTemperatureMireds
ColorControl matter แอตทริบิวต์ currentHue
ColorControl matter แอตทริบิวต์ currentX
ColorControl matter แอตทริบิวต์ currentY
DishwasherMode matter คำสั่ง ChangeToMode
DishwasherMode matter แอตทริบิวต์ currentMode
DishwasherMode matter แอตทริบิวต์ onMode
DoorLock matter กิจกรรม DoorLockAlarm
DoorLock matter กิจกรรม DoorStateChange
DoorLock matter คำสั่ง LockDoor
DoorLock matter กิจกรรม LockOperation
DoorLock matter กิจกรรม LockOperationError
DoorLock matter คำสั่ง UnlockDoor
DoorLock matter แอตทริบิวต์ doorClosedEvents
DoorLock matter แอตทริบิวต์ doorOpenEvents
DoorLock matter แอตทริบิวต์ doorState
DoorLock matter แอตทริบิวต์ lockState
FanControl matter คำสั่ง ขั้นตอน
FanControl matter แอตทริบิวต์ airflowDirection
FanControl matter แอตทริบิวต์ fanMode
FanControl matter แอตทริบิวต์ percentCurrent
FanControl matter แอตทริบิวต์ percentSetting
FanControl matter แอตทริบิวต์ speedCurrent
FanControl matter แอตทริบิวต์ speedSetting
FanControl matter แอตทริบิวต์ windSetting
FormaldehydeConcentrationMeasurement matter แอตทริบิวต์ levelValue
FormaldehydeConcentrationMeasurement matter แอตทริบิวต์ measuredValue
IlluminanceMeasurement matter แอตทริบิวต์ measuredValue
LaundryWasherMode matter คำสั่ง ChangeToMode
LaundryWasherMode matter แอตทริบิวต์ currentMode
LaundryWasherMode matter แอตทริบิวต์ onMode
LevelControl matter คำสั่ง ย้าย
LevelControl matter คำสั่ง MoveToLevel
LevelControl matter คำสั่ง MoveToLevelWithOnOff
LevelControl matter คำสั่ง MoveWithOnOff
LevelControl matter คำสั่ง ขั้นตอน
LevelControl matter คำสั่ง StepWithOnOff
LevelControl matter คำสั่ง หยุด
LevelControl matter คำสั่ง StopWithOnOff
LevelControl matter แอตทริบิวต์ currentLevel
LevelControl matter แอตทริบิวต์ maxLevel
LevelControl matter แอตทริบิวต์ startUpCurrentLevel
MediaInput matter คำสั่ง RenameInput
MediaInput matter คำสั่ง SelectInput
MediaInput matter แอตทริบิวต์ currentInput
MediaPlayback matter คำสั่ง FastForward
MediaPlayback matter คำสั่ง ถัดไป
MediaPlayback matter คำสั่ง หยุดชั่วคราว
MediaPlayback matter คำสั่ง เล่น
MediaPlayback matter คำสั่ง ก่อนหน้า
MediaPlayback matter คำสั่ง กรอกลับ
MediaPlayback matter คำสั่ง SkipBackward
MediaPlayback matter คำสั่ง SkipForward
MediaPlayback matter กิจกรรม StateChanged
MediaPlayback matter คำสั่ง หยุด
MediaPlayback matter แอตทริบิวต์ currentState
ModeSelect matter คำสั่ง ChangeToMode block
ModeSelect matter แอตทริบิวต์ currentMode
ModeSelect matter แอตทริบิวต์ onMode
NitrogenDioxideConcentrationMeasurement matter แอตทริบิวต์ levelValue
NitrogenDioxideConcentrationMeasurement matter แอตทริบิวต์ measuredValue
OccupancySensing matter แอตทริบิวต์ อัตราการเข้าพัก
OnOff matter คำสั่ง ปิด บล็อก
OnOff matter คำสั่ง เปิด บล็อก
OnOff matter แอตทริบิวต์ onOff
OperationalState matter กิจกรรม OperationCompletion
OperationalState matter คำสั่ง หยุดชั่วคราว บล็อก
OperationalState matter คำสั่ง เล่นต่อ บล็อก
OperationalState matter คำสั่ง เริ่ม
OperationalState matter คำสั่ง หยุด
OperationalState matter แอตทริบิวต์ currentPhase
OperationalState matter แอตทริบิวต์ operationalState
OzoneConcentrationMeasurement matter แอตทริบิวต์ levelValue
OzoneConcentrationMeasurement matter แอตทริบิวต์ measuredValue
Pm10ConcentrationMeasurement matter แอตทริบิวต์ levelValue
Pm10ConcentrationMeasurement matter แอตทริบิวต์ measuredValue
Pm25ConcentrationMeasurement matter แอตทริบิวต์ levelValue
Pm25ConcentrationMeasurement matter แอตทริบิวต์ measuredValue
PowerSource matter แอตทริบิวต์ batChargeState
PowerSource matter แอตทริบิวต์ batChargingCurrent
PowerSource matter แอตทริบิวต์ batTimeToFullCharge
RadonConcentrationMeasurement matter แอตทริบิวต์ levelValue
RadonConcentrationMeasurement matter แอตทริบิวต์ measuredValue
RelativeHumidityMeasurement matter แอตทริบิวต์ measuredValue
RvcCleanMode matter คำสั่ง ChangeToMode
RvcOperationalState matter คำสั่ง GoHome
RvcOperationalState matter คำสั่ง หยุดชั่วคราว
RvcOperationalState matter คำสั่ง ดำเนินการต่อ
RvcOperationalState matter แอตทริบิวต์ currentPhase
RvcOperationalState matter แอตทริบิวต์ operationalError
RvcOperationalState matter แอตทริบิวต์ operationalState
RvcRunMode matter คำสั่ง ChangeToMode
RvcRunMode matter แอตทริบิวต์ currentMode
เปลี่ยน matter กิจกรรม InitialPress
เปลี่ยน matter กิจกรรม LongPress
เปลี่ยน matter กิจกรรม LongRelease
เปลี่ยน matter กิจกรรม MultiPressComplete
เปลี่ยน matter กิจกรรม MultiPressOngoing
เปลี่ยน matter กิจกรรม ShortRelease
เปลี่ยน matter กิจกรรม SwitchLatched
เปลี่ยน matter แอตทริบิวต์ currentPosition
TemperatureControl matter คำสั่ง SetTemperature block
TemperatureControl matter แอตทริบิวต์ maxTemperature
TemperatureControl matter แอตทริบิวต์ minTemperature
TemperatureControl matter แอตทริบิวต์ selectedTemperatureLevel
TemperatureControl matter แอตทริบิวต์ temperatureSetpoint
TemperatureMeasurement matter แอตทริบิวต์ measuredValue
ตัวควบคุมอุณหภูมิ matter คำสั่ง SetpointRaiseLower
ตัวควบคุมอุณหภูมิ matter แอตทริบิวต์ activePresetHandle
ตัวควบคุมอุณหภูมิ matter แอตทริบิวต์ localTemperature
ตัวควบคุมอุณหภูมิ matter แอตทริบิวต์ อัตราการเข้าพัก
ตัวควบคุมอุณหภูมิ matter แอตทริบิวต์ occupiedCoolingSetpoint
ตัวควบคุมอุณหภูมิ matter แอตทริบิวต์ occupiedHeatingSetpoint
ตัวควบคุมอุณหภูมิ matter แอตทริบิวต์ outdoorTemperature
ตัวควบคุมอุณหภูมิ matter แอตทริบิวต์ setpointChangeSource
ตัวควบคุมอุณหภูมิ matter แอตทริบิวต์ systemMode
ตัวควบคุมอุณหภูมิ matter แอตทริบิวต์ temperatureSetpointHold
ตัวควบคุมอุณหภูมิ matter แอตทริบิวต์ temperatureSetpointHoldDuration
ตัวควบคุมอุณหภูมิ matter แอตทริบิวต์ thermostatRunningMode
ตัวควบคุมอุณหภูมิ matter แอตทริบิวต์ thermostatRunningState
ตัวควบคุมอุณหภูมิ matter แอตทริบิวต์ unoccupiedCoolingSetpoint
ตัวควบคุมอุณหภูมิ matter แอตทริบิวต์ unoccupiedHeatingSetpoint
TotalVolatileOrganicCompoundsConcentrationMeasurement matter แอตทริบิวต์ levelValue
TotalVolatileOrganicCompoundsConcentrationMeasurement matter แอตทริบิวต์ measuredValue
WindowCovering matter คำสั่ง DownOrClose
WindowCovering matter คำสั่ง GoToLiftPercentage
WindowCovering matter คำสั่ง GoToLiftValue
WindowCovering matter คำสั่ง GoToTiltPercentage
WindowCovering matter คำสั่ง GoToTiltValue
WindowCovering matter คำสั่ง StopMotion
WindowCovering matter คำสั่ง UpOrOpen
WindowCovering matter แอตทริบิวต์ currentPositionLift
WindowCovering matter แอตทริบิวต์ currentPositionLiftPercent100ths
WindowCovering matter แอตทริบิวต์ currentPositionLiftPercentage
WindowCovering matter แอตทริบิวต์ currentPositionTilt
WindowCovering matter แอตทริบิวต์ currentPositionTiltPercent100ths
WindowCovering matter แอตทริบิวต์ currentPositionTiltPercentage
WindowCovering matter แอตทริบิวต์ targetPositionLiftPercent100ths
WindowCovering matter แอตทริบิวต์ targetPositionTiltPercent100ths
ArmDisarm google คำสั่ง ArmDisarm block
ArmDisarm google กิจกรรม ArmDisarmArmState
ArmDisarm google แอตทริบิวต์ armState
ArmDisarm google แอตทริบิวต์ currentArmLevel
ArmDisarm google แอตทริบิวต์ isArmed
แท่นชาร์จ google คำสั่ง แท่นชาร์จ
แท่นชาร์จ google แอตทริบิวต์ isDocked
DoorbellPress google กิจกรรม DoorbellPressed
ExtendedAirQuality google กิจกรรม AirQuality
ExtendedAirQuality google แอตทริบิวต์ indoorAirQuality
ExtendedAirQuality google แอตทริบิวต์ indoorMeasuredValue
ExtendedAirQuality google แอตทริบิวต์ measuredValue
ExtendedAirQuality google แอตทริบิวต์ outdoorAirQuality
ExtendedAirQuality google แอตทริบิวต์ outdoorMeasuredValue
ExtendedColorControl google คำสั่ง MoveToColorHSV
ExtendedColorControl google คำสั่ง MoveToColorName
ExtendedColorControl google คำสั่ง MoveToColorRGB
ExtendedColorControl google แอตทริบิวต์ currentBlue
ExtendedColorControl google แอตทริบิวต์ currentGreen
ExtendedColorControl google แอตทริบิวต์ currentHue
ExtendedColorControl google แอตทริบิวต์ currentName
ExtendedColorControl google แอตทริบิวต์ currentRed
ExtendedColorControl google แอตทริบิวต์ currentSaturation
ExtendedColorControl google แอตทริบิวต์ currentValue
ExtendedFanControl google คำสั่ง ToggleAirflowDirection
ExtendedFanControl google แอตทริบิวต์ customFanMode
ExtendedFanControl google แอตทริบิวต์ customFanModes
ExtendedMediaInput google คำสั่ง NextInput
ExtendedMediaInput google คำสั่ง PreviousInput
ExtendedMediaInput google คำสั่ง SelectCustomInput
ExtendedMediaInput google แอตทริบิวต์ currentCustomInput
ExtendedMediaInput google แอตทริบิวต์ customInputsList
ExtendedMediaInput google แอตทริบิวต์ customInputsOrdered
ExtendedOperationalState google กิจกรรม PauseUnpauseFollowUp
ExtendedOperationalState google กิจกรรม StartStopFollowUp
ExtendedPowerSource google คำสั่ง StartCharging
ExtendedPowerSource google คำสั่ง StopCharging
ExtendedThermostat google แอตทริบิวต์ activePresetHandle
ExtendedThermostat google แอตทริบิวต์ activeRemoteTemperatureSensorIds
ExtendedThermostat google แอตทริบิวต์ averageLocalTemperature
ExtendedThermostat google แอตทริบิวต์ extendedRunningMode
ExtendedThermostat google แอตทริบิวต์ extendedSystemMode
LightEffects google คำสั่ง PulseEffectSet
LightEffects google คำสั่ง SleepEffectSet
LightEffects google คำสั่ง StopEffect
LightEffects google คำสั่ง WakeEffectSet
LightEffects google แอตทริบิวต์ pulseEffectSet
LightEffects google แอตทริบิวต์ sleepEffectSet
LightEffects google แอตทริบิวต์ wakeEffectSet
LockUnlock google คำสั่ง ล็อก
LockUnlock google คำสั่ง ปลดล็อก บล็อก
LockUnlock google แอตทริบิวต์ lockState
MotionDetection google กิจกรรม MotionDetected
MotionDetection google แอตทริบิวต์ motionDetectionEventInProgress
ObjectDetection google กิจกรรม ObjectDetected
OpenClose google คำสั่ง ปิด บล็อก
OpenClose google คำสั่ง GoToOpenPercentage block
OpenClose google คำสั่ง เปิด บล็อก
OpenClose google คำสั่ง ขั้นตอน บล็อก
OpenClose google แอตทริบิวต์ openPercent
OpenClose google แอตทริบิวต์ openState
OpenClose google แอตทริบิวต์ targetOpenPercent
บันทึก google คำสั่ง StartRecording
บันทึก google คำสั่ง StopRecording
บันทึก google แอตทริบิวต์ isCurrentlyRecording
ปุ่มเปิด/ปิด google คำสั่ง ChangeToggleSettings block
ปุ่มเปิด/ปิด google แอตทริบิวต์ currentToggleSettings
ความสว่าง google คำสั่ง BrightnessStep
ความสว่าง google คำสั่ง MoveToBrightness
ความสว่าง google แอตทริบิวต์ currentBrightnessPercent
SimplifiedOnOff google แอตทริบิวต์ onOff
SimplifiedThermostat google คำสั่ง SetSystemMode
SimplifiedThermostat google แอตทริบิวต์ systemMode
ปริมาณ google คำสั่ง MoveToVolume
ปริมาณ google คำสั่ง ปิดเสียง
ปริมาณ google คำสั่ง เปิดเสียง
ระดับเสียง google คำสั่ง VolumeStep
ระดับเสียง google แอตทริบิวต์ currentVolumePercent
ระดับเสียง google แอตทริบิวต์ isMuted
AreaAttendanceState google แอตทริบิวต์ attendanceState
AreaPresenceState google แอตทริบิวต์ presenceState