תמיכה במאפיינים של Automation API ב-Android

ה-API לאוטומציה ב-Android תומך ברוב התכונות, אבל יכול להיות שהתמיכה בחלק מהמאפיינים, האירועים והפקודות בתכונה מסוימת תהיה מוגבלת.

כדי לוודא שממשק Automation API תומך בתרחיש השימוש שלכם, חפשו בטבלה שלמטה.

ככלל:

  • כל התכונות והסוגים שאתם מתכוונים להשתמש בהם באפליקציה עם Automation API צריכים להיות רשומים בשלב האתחול. איך יוצרים מופע ביתי
  • אפשר להשתמש בכל מאפיין כסימן לתחילת פעולה או כתנאי.
  • אי אפשר להשתמש במכשירי Cloud-to-cloud שלא מדווחים על המצב שלהם כטריגרים באוטומציות, בין אם הן נוצרו באופן ידני או באמצעות גילוי.
  • גם אם מכשיר תומך בתכונות שמפורטות כאן, יכול להיות שהשימוש בו ייחסם כסימן או כפעולה ב-Automation API בגלל סף האיכות של Report State:

    • מכשירים עם שיעור הצלחה של דיווח על מצב נמוך מ-90% נחסמים לשימוש כסימנים לתחילת פעולה.
    • מכשירים עם שיעור הצלחה של ביצוע פקודות שקטן מ-95% נחסמים לשימוש כפעולות.

    ברשימה הזו של דגמי מכשירים מפורטים המתנעים והפעולות הספציפיים שהם תומכים בהם ב-Automations API.

  • אפשר להשתמש בפקודות רק כפעולות.

  • חלק מהמאפיינים, כמו AssistantBroadcast, זמינים לשימוש רק ב-Automation API.

  • הפקודה okGoogle היא פקודה ברמת המבנה, ואפשר להשתמש בה כדי להפוך כל מכשיר במבנה לאוטומטי. עם זאת, יכול להיות שלאפליקציה עם ממשקי API של Home לא תהיה גישה לכל מכשיר. במאמר הרשאות OkGoogle מוסבר איך ההרשאות נאכפות במקרים שונים.

  • לחלק מהתכונות יש דרישות מוקדמות:

    • כדי להשתמש ב-Time.ScheduledTimeEvent, המבנה שבו האוטומציה פועלת צריך לכלול כתובת רחוב שהוגדרה ב-Google Home app (GHA). במאמר שינוי כתובת Google Home מוסבר איך משתמש יכול להזין את כתובת המבנה. אם הכתובת לא מוגדרת ב-GHA, האוטומציה לא מצליחה ליצור את ההודעה ומוצגת שגיאה עם ההודעה 'ה-ScheduledTimeEvent לא נתמך על ידי structure'.
    • כדי להשתמש במאפיינים AreaPresenceState או AreaAttendanceState, המשתמש צריך להגדיר את חיישן הנוכחות ב-GHA.
    • כדי להשתמש בתכונת ObjectDetection, המשתמש צריך מינוי פעיל ל-Nest Aware.

בנוסף, יש גרסאות פשוטות של חלק מהמאפיינים שאפשר להשתמש בהן באוטומציות. מידע נוסף זמין במאמר בנושא תכונות פשוטות ב-Android.

חסימה מציינת שהפקודה לא נתמכת באוטומציות עבור סוג מכשיר אחד או יותר. מידע נוסף זמין במאמר בנושא פעולות חסומות באוטומציות ב-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
Channel matter פקודה ChangeChannelByNumber
Channel 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 פקודה 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 מאפיין תפוסה
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
Thermostat matter פקודה SetpointRaiseLower
Thermostat matter מאפיין activePresetHandle
Thermostat matter מאפיין localTemperature
Thermostat matter מאפיין תפוסה
Thermostat matter מאפיין occupiedCoolingSetpoint
Thermostat matter מאפיין occupiedHeatingSetpoint
Thermostat matter מאפיין outdoorTemperature
Thermostat matter מאפיין setpointChangeSource
Thermostat matter מאפיין systemMode
Thermostat matter מאפיין temperatureSetpointHold
Thermostat matter מאפיין temperatureSetpointHoldDuration
Thermostat matter מאפיין thermostatRunningMode
Thermostat matter מאפיין thermostatRunningState
Thermostat matter מאפיין unoccupiedCoolingSetpoint
Thermostat 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
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 פקודה 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 פקודה GoToOpenPercentageblock
OpenClose google פקודה פתיחה חסימה
OpenClose google פקודה שלב block
OpenClose google מאפיין openPercent
OpenClose google מאפיין openState
OpenClose google מאפיין targetOpenPercent
Toggles google פקודה ChangeToggleSettings block
Toggles 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