Android での Automation API トレイトのサポート

Android 用 Automation API はほとんどのトレイトをサポートしていますが、トレイト内の属性、イベント、コマンドのサポートは一部制限される場合があります。

Automation API がユースケースをサポートしていることを確認するには、下の表で検索します。

一般的には次のようになります。

  • Automation API でアプリで使用するトレイトと型は、初期化時に登録する必要があります。Home インスタンスを作成するをご覧ください。
  • 開始条件または条件では、任意の属性を使用できます。
  • 状態をレポートしない Cloud-to-cloud デバイスは、手動または検出によって作成された自動化のトリガーとして使用できません。
  • デバイスがここに記載されているトレイトをサポートしていても、状態のレポートの品質しきい値により、Automation API でスターターまたはアクションとして使用できない場合があります。

    • Report State の成功率が 90% を下回るデバイスは、スターターとして使用できません。
    • コマンド実行の成功率が 95% 未満のデバイスは、アクションとして使用できません。

    Automations API でサポートされているデバイスモデルのリストと、それらがサポートする特定の開始条件とアクションを参照してください。

  • コマンドはアクションとしてのみ使用できます。

  • AssistantBroadcast などの一部の特性は、Automation API でのみ使用できます。

  • okGoogle コマンドは構造レベルのコマンドであり、構造内の任意のデバイスを自動化するために使用できます。ただし、Home APIs アプリはすべてのデバイスにアクセスできるとは限りません。さまざまなケースで権限がどのように適用されるかについては、OkGoogle 権限をご覧ください。

  • 一部の特性には前提条件があります。

    • Time.ScheduledTimeEvent を使用するには、自動化が実行される構造に、Google Home app (GHA) で設定された番地が必要です。Google の自宅住所を変更するでは、ユーザーが構造物の住所を入力する方法について説明しています。アドレスが GHA で設定されていない場合、自動化の作成は失敗し、「ScheduledTimeEvent is not supported by the structure.」というメッセージとともにエラーがスローされます。
    • AreaPresenceState または AreaAttendanceState トレイトを使用するには、ユーザーが GHA で在宅確認を設定する必要があります。
    • ObjectDetection トレイトを使用するには、有効な Google Nest Aware の定期購入が必要です。

一部の特性の簡略版は、自動化で使用することもできます。詳しくは、Android の簡略化されたトレイトをご覧ください。

ブロックは、1 つ以上のデバイスタイプの自動化でコマンドがサポートされていないことを示します。詳しくは、Android の自動化でブロックされるアクションをご覧ください。

トレイト 特性のタイプ 要素の種類 要素
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
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 属性 uncertainty
チャネル 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 コマンド Step
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 コマンド Step
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 コマンド Play
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 属性 occupancy
OnOff matter コマンド オフ ブロック
OnOff matter コマンド オン ブロック
OnOff matter 属性 onOff
OperationalState matter イベント OperationCompletion
OperationalState matter コマンド 一時停止 ブロック
OperationalState matter コマンド Resume block
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 属性 occupancy
サーモスタット 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 コマンド Step block
OpenClose Google 属性 openPercent
OpenClose Google 属性 openState
OpenClose Google 属性 targetOpenPercent
切り替え 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