Android 上的自動化 API 特徵支援

Android 的 Automation API 支援大多數特徵,但在某些屬性、事件和指令方面可能有所限制。

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

一般而言:

  • 您要在應用程式中使用 Automation API 的任何特徵和類型,都必須在初始化時註冊。請參閱建立 Google Home 裝置
  • 任何屬性都可以用於啟動條件或限制條件。
  • Cloud-to-cloud 裝置如果未回報狀態,就無法用於自動化動作的觸發事件,無論是手動建立或透過探索功能建立的自動化動作皆是如此。
  • 即使裝置支援此處列出的特徵,由於回報狀態品質門檻,裝置可能仍會遭到封鎖,無法在 Automation API 中做為啟動條件或動作使用:

    • 回報狀態成功率低於 90% 的裝置將無法用於啟動。
    • 指令執行成功率低於 95% 的裝置將無法用於執行動作。

    請參閱這份裝置型號清單,以及自動化 API 支援的特定啟動條件和動作。

  • 指令只能用於執行動作。

  • 部分特徵 (例如 AssistantBroadcast) 僅適用於 Automation API。

  • okGoogle 指令是結構層級指令,可用於自動執行結構中的任何裝置。不過,Home API 應用程式可能無法存取所有裝置。請參閱「Ok Google 權限」,瞭解權限在各種情況下如何強制執行。

  • 部分特徵有前置條件:

    • 如要使用 Time.ScheduledTimeEvent,自動化動作執行的結構體必須包含在 Google Home app (GHA) 中設定的街道地址。變更 Google 住家地址一文說明使用者如何輸入結構化地址。如果未在 GHA 中設定地址,自動化動作就無法建立,並會擲回錯誤,顯示「structure 不支援 ScheduledTimeEvent」。
    • 如要使用 AreaPresenceStateAreaAttendanceState 特徵,使用者必須在 GHA 中設定在家狀態感應。
    • 如要使用 ObjectDetection 特徵,使用者必須訂閱有效的 Nest Aware 方案。

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

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

256 項結果
特徵 特徵類型 元素類型 元素
AirQuality matter 屬性 airQuality
ApplicationLauncher matter 指令 LaunchApp
ApplicationLauncher matter 指令 StopApp
ApplicationLauncher matter 屬性 currentApp
AreaAttendanceState google 屬性 attendanceState
AreaPresenceState google 屬性 presenceState
ArmDisarm google 指令 ArmDisarm block
ArmDisarm google 活動 ArmDisarmArmState
ArmDisarm google 屬性 armState
ArmDisarm google 屬性 currentArmLevel
ArmDisarm google 屬性 isArmed
AudioOutput matter 屬性 currentOutput
BooleanState matter 活動 StateChange
BooleanState matter 屬性 stateValue
CarbonDioxideConcentrationMeasurement matter 屬性 levelValue
CarbonDioxideConcentrationMeasurement matter 屬性 measuredValue
CarbonMonoxideConcentrationMeasurement matter 屬性 levelValue
CarbonMonoxideConcentrationMeasurement matter 屬性 maxMeasuredValue
CarbonMonoxideConcentrationMeasurement matter 屬性 measuredValue
CarbonMonoxideConcentrationMeasurement matter 屬性 measurementUnit
CarbonMonoxideConcentrationMeasurement matter 屬性 minMeasuredValue
CarbonMonoxideConcentrationMeasurement matter 屬性 不確定性
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
Dock google 指令 Dock
Dock google 屬性 isDocked
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
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
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
Google 助理執行結果 google 指令 OkGoogle
Google 助理廣播 google 指令 廣播
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
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
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
MotionDetection google 活動 MotionDetected
MotionDetection google 屬性 motionDetectionEventInProgress
NitrogenDioxideConcentrationMeasurement matter 屬性 levelValue
NitrogenDioxideConcentrationMeasurement matter 屬性 measuredValue
ObjectDetection google 活動 ObjectDetected
OccupancySensing matter 屬性 入住率
OnOff matter 指令 關閉 封鎖
OnOff matter 指令 開啟 封鎖
OnOff matter 屬性 onOff
Open/Close google 指令 關閉 區塊
Open/Close google 指令 GoToOpenPercentage block
Open/Close google 指令 開啟 區塊
Open/Close google 指令 步驟 區塊
Open/Close google 屬性 openPercent
Open/Close google 屬性 openState
Open/Close google 屬性 targetOpenPercent
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
SimplifiedOnOff google 屬性 onOff
SimplifiedThermostat google 指令 SetSystemMode
SimplifiedThermostat google 屬性 systemMode
Switch matter 活動 InitialPress
Switch matter 活動 LongPress
Switch matter 活動 LongRelease
Switch matter 活動 MultiPressComplete
Switch matter 活動 MultiPressOngoing
Switch matter 活動 ShortRelease
Switch matter 活動 SwitchLatched
Switch matter 屬性 currentPosition
TemperatureControl matter 指令 SetTemperature 區塊
TemperatureControl matter 屬性 maxTemperature
TemperatureControl matter 屬性 minTemperature
TemperatureControl matter 屬性 selectedTemperatureLevel
TemperatureControl matter 屬性 temperatureSetpoint
TemperatureMeasurement matter 屬性 measuredValue
TotalVolatileOrganicCompoundsConcentrationMeasurement matter 屬性 levelValue
TotalVolatileOrganicCompoundsConcentrationMeasurement matter 屬性 measuredValue
VoiceStarter google 活動 OkGoogleEvent
Volume google 指令 MoveToVolume
Volume google 指令 靜音
Volume google 指令 取消靜音
Volume google 指令 VolumeStep
Volume google 屬性 currentVolumePercent
Volume google 屬性 isMuted
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
亮度 google 指令 BrightnessStep
亮度 google 指令 MoveToBrightness
亮度 google 屬性 currentBrightnessPercent
切換鈕 google 指令 ChangeToggleSettings block
切換鈕 google 屬性 currentToggleSettings
時間 google 活動 ScheduledTimeEvent
時間 google 屬性 currentTime
時間 google 屬性 missingStructureLocation
時間 google 屬性 sunriseTime
時間 google 屬性 sunsetTime
溫度控制器 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
管道 matter 指令 ChangeChannelByNumber
管道 matter 指令 SkipChannel
通知 google 指令 SendNotifications
錄製 google 指令 StartRecording
錄製 google 指令 StopRecording
錄製 google 屬性 isCurrentlyRecording
門鈴按下 google 活動 DoorbellPressed