支援自動化 API 特徵

Automation API 支援大多數特徵,但可能無法支援某些屬性、事件和特徵中的指令。

如要確認 Automation API 支援您的用途,請在下表中搜尋。

一般而言:

  • 您要在應用程式中使用 Automation API 的任何特徵和類型,都必須在初始化時註冊。請參閱建立 Google Home 執行個體
  • 任何屬性都可以用於啟動條件或限制條件。
  • Cloud-to-cloud 裝置如果未回報狀態,就無法用於自動化動作的觸發事件,無論是手動建立或透過探索功能建立的自動化動作皆是如此。
  • 即使裝置支援此處列出的特性,由於回報狀態品質門檻,裝置可能仍會遭到封鎖,無法在 Automation API 中做為啟動條件或動作使用:
    • 回報狀態成功率低於 90% 的裝置將無法做為啟動條件。
    • 指令執行成功率低於 95% 的裝置將無法用於執行動作。
  • 指令只能用於動作。
  • 部分特徵 (例如 AssistantBroadcast) 僅適用於 Automation API。
  • okGoogle 指令是結構層級指令,可用於自動執行結構中的任何裝置。不過,Home API 應用程式可能無法存取所有裝置。請參閱「Ok Google 權限」,瞭解權限在各種情況下如何強制執行。
  • 部分特徵有前置條件:
    • 如要使用 Time.ScheduledTimeEvent,自動化動作執行的結構體必須包含在 Google Home app (GHA) 中設定的街道地址。變更 Google 住家地址一文說明使用者如何輸入結構化地址。如果未在 GHA 中設定地址,自動化動作就無法建立,並會擲回錯誤,顯示「structure 不支援 ScheduledTimeEvent」。
    • 如要使用 AreaPresenceStateAreaAttendanceState 特徵,使用者必須在 GHA 中設定在家狀態感應。
    • 如要使用 ObjectDetection 特徵,使用者必須訂閱有效的 Nest Aware 方案。

部分特徵的簡易版也可用於自動化動作。詳情請參閱「簡化特徵」。

阻斷表示一或多種裝置類型的自動化動作不支援該指令。詳情請參閱「自動化動作中遭封鎖的動作」。

特徵 特徵類型 元素類型 元素
AssistantBroadcast google 指令 廣播
AssistantFulfillment google 指令 OkGoogle
通知 google 指令 SendNotifications
Time google 活動 ScheduledTimeEvent
Time google 屬性 currentTime
Time google 屬性 missingStructureLocation
Time google 屬性 sunriseTime
Time google 屬性 sunsetTime
VoiceStarter google 活動 OkGoogleEvent
AirQuality 重要事項 屬性 airQuality
ApplicationLauncher 重要事項 指令 LaunchApp
ApplicationLauncher 重要事項 指令 StopApp
ApplicationLauncher 重要事項 屬性 currentApp
AudioOutput 重要事項 屬性 currentOutput
CarbonDioxideConcentrationMeasurement 重要事項 屬性 levelValue
CarbonDioxideConcentrationMeasurement 重要事項 屬性 measuredValue
CarbonMonoxideConcentrationMeasurement 重要事項 屬性 levelValue
CarbonMonoxideConcentrationMeasurement 重要事項 屬性 maxMeasuredValue
CarbonMonoxideConcentrationMeasurement 重要事項 屬性 measuredValue
CarbonMonoxideConcentrationMeasurement 重要事項 屬性 measurementUnit
CarbonMonoxideConcentrationMeasurement 重要事項 屬性 minMeasuredValue
CarbonMonoxideConcentrationMeasurement 重要事項 屬性 不確定性
管道 重要事項 指令 ChangeChannelByNumber
管道 重要事項 指令 SkipChannel
ColorControl 重要事項 指令 ColorLoopSet
ColorControl 重要事項 指令 MoveColor
ColorControl 重要事項 指令 移動色溫
ColorControl 重要事項 指令 MoveToColor
ColorControl 重要事項 指令 MoveToColorTemperature
ColorControl 重要事項 指令 MoveToHue
ColorControl 重要事項 指令 MoveToHueAndSaturation
ColorControl 重要事項 指令 MoveToSaturation
ColorControl 重要事項 指令 StepColor
ColorControl 重要事項 指令 StepColorTemperature
ColorControl 重要事項 屬性 colorTemperatureMireds
ColorControl 重要事項 屬性 currentHue
ColorControl 重要事項 屬性 currentX
ColorControl 重要事項 屬性 currentY
DishwasherMode 重要事項 指令 ChangeToMode
DishwasherMode 重要事項 屬性 currentMode
DishwasherMode 重要事項 屬性 onMode
DoorLock 重要事項 活動 DoorLockAlarm
DoorLock 重要事項 活動 DoorStateChange
DoorLock 重要事項 指令 LockDoor
DoorLock 重要事項 活動 LockOperation
DoorLock 重要事項 活動 LockOperationError
DoorLock 重要事項 指令 UnlockDoor
DoorLock 重要事項 屬性 doorClosedEvents
DoorLock 重要事項 屬性 doorOpenEvents
DoorLock 重要事項 屬性 doorState
DoorLock 重要事項 屬性 lockState
FanControl 重要事項 指令 步驟
FanControl 重要事項 屬性 airflowDirection
FanControl 重要事項 屬性 fanMode
FanControl 重要事項 屬性 percentCurrent
FanControl 重要事項 屬性 percentSetting
FanControl 重要事項 屬性 speedCurrent
FanControl 重要事項 屬性 speedSetting
FanControl 重要事項 屬性 windSetting
FormaldehydeConcentrationMeasurement 重要事項 屬性 levelValue
FormaldehydeConcentrationMeasurement 重要事項 屬性 measuredValue
IlluminanceMeasurement 重要事項 屬性 measuredValue
LaundryWasherMode 重要事項 指令 ChangeToMode
LaundryWasherMode 重要事項 屬性 currentMode
LaundryWasherMode 重要事項 屬性 onMode
LevelControl 重要事項 指令 移動
LevelControl 重要事項 指令 MoveToLevel
LevelControl 重要事項 指令 MoveToLevelWithOnOff
LevelControl 重要事項 指令 MoveWithOnOff
LevelControl 重要事項 指令 步驟
LevelControl 重要事項 指令 StepWithOnOff
LevelControl 重要事項 指令 Stop
LevelControl 重要事項 指令 StopWithOnOff
LevelControl 重要事項 屬性 currentLevel
LevelControl 重要事項 屬性 maxLevel
LevelControl 重要事項 屬性 startUpCurrentLevel
MediaInput 重要事項 指令 RenameInput
MediaInput 重要事項 指令 選取輸入來源
MediaInput 重要事項 屬性 currentInput
MediaPlayback 重要事項 指令 FastForward
MediaPlayback 重要事項 指令 繼續
MediaPlayback 重要事項 指令 暫停
MediaPlayback 重要事項 指令 播放
MediaPlayback 重要事項 指令 返回
MediaPlayback 重要事項 指令 倒轉
MediaPlayback 重要事項 指令 向後跳過
MediaPlayback 重要事項 指令 SkipForward
MediaPlayback 重要事項 活動 StateChanged
MediaPlayback 重要事項 指令 Stop
MediaPlayback 重要事項 屬性 currentState
ModeSelect 重要事項 指令 ChangeToMode block
ModeSelect 重要事項 屬性 currentMode
ModeSelect 重要事項 屬性 onMode
NitrogenDioxideConcentrationMeasurement 重要事項 屬性 levelValue
NitrogenDioxideConcentrationMeasurement 重要事項 屬性 measuredValue
OccupancySensing 重要事項 屬性 住房人數
OnOff 重要事項 指令 Off block
OnOff 重要事項 指令 開啟 封鎖
OnOff 重要事項 屬性 onOff
OperationalState 重要事項 活動 OperationCompletion
OperationalState 重要事項 指令 暫停 區塊
OperationalState 重要事項 指令 繼續 區塊
OperationalState 重要事項 指令 開始
OperationalState 重要事項 指令 Stop
OperationalState 重要事項 屬性 currentPhase
OperationalState 重要事項 屬性 operationalState
OzoneConcentrationMeasurement 重要事項 屬性 levelValue
OzoneConcentrationMeasurement 重要事項 屬性 measuredValue
Pm10ConcentrationMeasurement 重要事項 屬性 levelValue
Pm10ConcentrationMeasurement 重要事項 屬性 measuredValue
Pm25ConcentrationMeasurement 重要事項 屬性 levelValue
Pm25ConcentrationMeasurement 重要事項 屬性 measuredValue
PowerSource 重要事項 屬性 batChargeState
PowerSource 重要事項 屬性 batChargingCurrent
PowerSource 重要事項 屬性 batTimeToFullCharge
RadonConcentrationMeasurement 重要事項 屬性 levelValue
RadonConcentrationMeasurement 重要事項 屬性 measuredValue
RelativeHumidityMeasurement 重要事項 屬性 measuredValue
RvcCleanMode 重要事項 指令 ChangeToMode
RvcOperationalState 重要事項 指令 GoHome
RvcOperationalState 重要事項 指令 暫停
RvcOperationalState 重要事項 指令 繼續
RvcOperationalState 重要事項 屬性 currentPhase
RvcOperationalState 重要事項 屬性 operationalError
RvcOperationalState 重要事項 屬性 operationalState
RvcRunMode 重要事項 指令 ChangeToMode
RvcRunMode 重要事項 屬性 currentMode
切換鈕 重要事項 活動 初始按壓
切換鈕 重要事項 活動 LongPress
切換鈕 重要事項 活動 LongRelease
切換鈕 重要事項 活動 MultiPressComplete
切換鈕 重要事項 活動 MultiPressOngoing
切換鈕 重要事項 活動 ShortRelease
切換 重要事項 活動 SwitchLatched
切換鈕 重要事項 屬性 currentPosition
TemperatureControl 重要事項 指令 SetTemperature 區塊
TemperatureControl 重要事項 屬性 maxTemperature
TemperatureControl 重要事項 屬性 minTemperature
TemperatureControl 重要事項 屬性 selectedTemperatureLevel
TemperatureControl 重要事項 屬性 temperatureSetpoint
TemperatureMeasurement 重要事項 屬性 measuredValue
溫度控制器 重要事項 指令 SetpointRaiseLower
溫度控制器 重要事項 屬性 activePresetHandle
溫度控制器 重要事項 屬性 localTemperature
溫度控制器 重要事項 屬性 住房率
溫度控制器 重要事項 屬性 occupiedCoolingSetpoint
溫度控制器 重要事項 屬性 occupiedHeatingSetpoint
溫度控制器 重要事項 屬性 outdoorTemperature
溫度控制器 重要事項 屬性 setpointChangeSource
溫度控制器 重要事項 屬性 systemMode
溫度控制器 重要事項 屬性 temperatureSetpointHold
溫度控制器 重要事項 屬性 temperatureSetpointHoldDuration
溫度控制器 重要事項 屬性 thermostatRunningMode
溫度控制器 重要事項 屬性 thermostatRunningState
溫度控制器 重要事項 屬性 unoccupiedCoolingSetpoint
溫度控制器 重要事項 屬性 unoccupiedHeatingSetpoint
揮發性有機化合物濃度測量值 重要事項 屬性 levelValue
TotalVolatileOrganicCompoundsConcentrationMeasurement 重要事項 屬性 measuredValue
WindowCovering 重要事項 指令 DownOrClose
WindowCovering 重要事項 指令 GoToLiftPercentage
WindowCovering 重要事項 指令 GoToLiftValue
WindowCovering 重要事項 指令 GoToTiltPercentage
WindowCovering 重要事項 指令 GoToTiltValue
WindowCovering 重要事項 指令 StopMotion
WindowCovering 重要事項 指令 UpOrOpen
WindowCovering 重要事項 屬性 currentPositionLift
WindowCovering 重要事項 屬性 currentPositionLiftPercent100ths
WindowCovering 重要事項 屬性 currentPositionLiftPercentage
WindowCovering 重要事項 屬性 currentPositionTilt
WindowCovering 重要事項 屬性 currentPositionTiltPercent100ths
WindowCovering 重要事項 屬性 currentPositionTiltPercentage
WindowCovering 重要事項 屬性 targetPositionLiftPercent100ths
WindowCovering 重要事項 屬性 targetPositionTiltPercent100ths
ArmDisarm google 指令 ArmDisarm block
ArmDisarm google 活動 ArmDisarmArmState
ArmDisarm google 屬性 armState
ArmDisarm google 屬性 currentArmLevel
ArmDisarm google 屬性 isArmed
Dock google 指令 Dock
Dock 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 指令 選取自訂輸入項
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 指令 Open block
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
Volume google 指令 MoveToVolume
Volume google 指令 Mute
Volume google 指令 取消靜音
Volume google 指令 VolumeStep
Volume google 屬性 currentVolumePercent
Volume google 屬性 isMuted
AreaAttendanceState google 屬性 attendanceState
AreaPresenceState google 屬性 presenceState