Hỗ trợ đặc điểm Automation API trên Android

Automation API cho Android hỗ trợ hầu hết các đặc điểm, nhưng khả năng hỗ trợ một số thuộc tính, sự kiện và lệnh trong một đặc điểm có thể bị hạn chế.

Để xác minh rằng Automation API hỗ trợ trường hợp sử dụng của bạn, hãy tìm kiếm trong bảng bên dưới.

Nói chung:

  • Bạn phải đăng ký mọi đặc điểm và loại mà bạn dự định sử dụng trong ứng dụng của mình bằng Automation API khi khởi chạy. Xem phần Tạo một Home.
  • Bạn có thể dùng mọi thuộc tính trong điều kiện khởi động hoặc điều kiện.
  • Không thể dùng các thiết bị Cloud-to-cloud không báo cáo trạng thái làm điều kiện kích hoạt trong các quy trình tự động hoá, được tạo theo cách thủ công hoặc thông qua tính năng khám phá.
  • Ngay cả khi một thiết bị hỗ trợ các đặc điểm được liệt kê ở đây, thiết bị đó vẫn có thể bị chặn sử dụng làm thiết bị khởi động hoặc hành động trong Automation API do ngưỡng chất lượng Report State:

    • Những thiết bị có tỷ lệ thành công của Report State thấp hơn 90% sẽ không được dùng làm điều kiện khởi động.
    • Những thiết bị có tỷ lệ thực hiện lệnh thành công thấp hơn 95% sẽ không được dùng làm thao tác.

    Hãy tham khảo danh sách các mẫu thiết bị này cũng như các điều kiện kích hoạt và hành động cụ thể mà các mẫu thiết bị này hỗ trợ cho Automations API.

  • Bạn chỉ có thể dùng lệnh làm hành động.

  • Một số đặc điểm, chẳng hạn như AssistantBroadcast, chỉ có thể dùng trong Automation API.

  • Lệnh okGoogle là một lệnh cấp cấu trúc và có thể dùng để tự động hoá mọi thiết bị trong cấu trúc. Tuy nhiên, một ứng dụng Home APIs có thể không có quyền truy cập vào mọi thiết bị. Xem các quyền của Ok Google để biết cách thực thi các quyền trong nhiều trường hợp.

  • Một số đặc điểm có điều kiện tiên quyết:

    • Để sử dụng Time.ScheduledTimeEvent, cấu trúc mà quy trình tự động hoá chạy phải có địa chỉ đường phố được thiết lập trong Google Home app (GHA). Thay đổi địa chỉ nhà trên Google giải thích cách người dùng có thể nhập địa chỉ cấu trúc. Nếu địa chỉ không được thiết lập trong GHA, thì quá trình tự động hoá sẽ không tạo được và một lỗi sẽ xảy ra với thông báo "structure không hỗ trợ ScheduledTimeEvent".
    • Để sử dụng các đặc điểm AreaPresenceState hoặc AreaAttendanceState, người dùng phải thiết lập tính năng nhận biết sự có mặt trong GHA.
    • Để sử dụng đặc điểm ObjectDetection, người dùng phải có gói thuê bao Nest Aware đang hoạt động.

Bạn cũng có thể sử dụng các phiên bản đơn giản của một số đặc điểm trong các quy trình tự động hoá. Để biết thêm thông tin, hãy xem bài viết Các đặc điểm đơn giản trên Android.

Khối cho biết lệnh không được hỗ trợ trong các quy trình tự động hoá đối với một hoặc nhiều loại thiết bị. Để biết thêm thông tin, hãy tham khảo bài viết Các thao tác bị chặn trong quy trình tự động hoá trên Android.

Đặc điểm Loại đặc điểm Loại phần tử Phần tử
AssistantBroadcast google Lệnh Truyền tin
AssistantFulfillment google Lệnh OkGoogle
Thông báo google Lệnh SendNotifications
Thời gian google Sự kiện ScheduledTimeEvent
Thời gian google Thuộc tính currentTime
Thời gian google Thuộc tính missingStructureLocation
Thời gian google Thuộc tính sunriseTime
Thời gian google Thuộc tính sunsetTime
VoiceStarter google Sự kiện OkGoogleEvent
AirQuality matter Thuộc tính airQuality
ApplicationLauncher matter Lệnh LaunchApp
ApplicationLauncher matter Lệnh StopApp
ApplicationLauncher matter Thuộc tính currentApp
AudioOutput matter Thuộc tính currentOutput
BooleanState matter Sự kiện StateChange
BooleanState matter Thuộc tính stateValue
CarbonDioxideConcentrationMeasurement matter Thuộc tính levelValue
CarbonDioxideConcentrationMeasurement matter Thuộc tính measuredValue
CarbonMonoxideConcentrationMeasurement matter Thuộc tính levelValue
CarbonMonoxideConcentrationMeasurement matter Thuộc tính maxMeasuredValue
CarbonMonoxideConcentrationMeasurement matter Thuộc tính measuredValue
CarbonMonoxideConcentrationMeasurement matter Thuộc tính measurementUnit
CarbonMonoxideConcentrationMeasurement matter Thuộc tính minMeasuredValue
CarbonMonoxideConcentrationMeasurement matter Thuộc tính sự không chắc chắn
Kênh matter Lệnh ChangeChannelByNumber
Kênh matter Lệnh SkipChannel
ColorControl matter Lệnh ColorLoopSet
ColorControl matter Lệnh MoveColor
ColorControl matter Lệnh MoveColorTemperature
ColorControl matter Lệnh MoveToColor
ColorControl matter Lệnh MoveToColorTemperature
ColorControl matter Lệnh MoveToHue
ColorControl matter Lệnh MoveToHueAndSaturation
ColorControl matter Lệnh MoveToSaturation
ColorControl matter Lệnh StepColor
ColorControl matter Lệnh StepColorTemperature
ColorControl matter Thuộc tính colorTemperatureMireds
ColorControl matter Thuộc tính currentHue
ColorControl matter Thuộc tính currentX
ColorControl matter Thuộc tính currentY
DishwasherMode matter Lệnh ChangeToMode
DishwasherMode matter Thuộc tính currentMode
DishwasherMode matter Thuộc tính onMode
DoorLock matter Sự kiện DoorLockAlarm
DoorLock matter Sự kiện DoorStateChange
DoorLock matter Lệnh LockDoor
DoorLock matter Sự kiện LockOperation
DoorLock matter Sự kiện LockOperationError
DoorLock matter Lệnh UnlockDoor
DoorLock matter Thuộc tính doorClosedEvents
DoorLock matter Thuộc tính doorOpenEvents
DoorLock matter Thuộc tính doorState
DoorLock matter Thuộc tính lockState
FanControl matter Lệnh Bước
FanControl matter Thuộc tính airflowDirection
FanControl matter Thuộc tính fanMode
FanControl matter Thuộc tính percentCurrent
FanControl matter Thuộc tính percentSetting
FanControl matter Thuộc tính speedCurrent
FanControl matter Thuộc tính speedSetting
FanControl matter Thuộc tính windSetting
FormaldehydeConcentrationMeasurement matter Thuộc tính levelValue
FormaldehydeConcentrationMeasurement matter Thuộc tính measuredValue
IlluminanceMeasurement matter Thuộc tính measuredValue
LaundryWasherMode matter Lệnh ChangeToMode
LaundryWasherMode matter Thuộc tính currentMode
LaundryWasherMode matter Thuộc tính onMode
LevelControl matter Lệnh Di chuyển
LevelControl matter Lệnh MoveToLevel
LevelControl matter Lệnh MoveToLevelWithOnOff
LevelControl matter Lệnh MoveWithOnOff
LevelControl matter Lệnh Bước
LevelControl matter Lệnh StepWithOnOff
LevelControl matter Lệnh Dừng
LevelControl matter Lệnh StopWithOnOff
LevelControl matter Thuộc tính currentLevel
LevelControl matter Thuộc tính maxLevel
LevelControl matter Thuộc tính startUpCurrentLevel
MediaInput matter Lệnh RenameInput
MediaInput matter Lệnh SelectInput
MediaInput matter Thuộc tính currentInput
MediaPlayback matter Lệnh FastForward
MediaPlayback matter Lệnh Tiếp theo
MediaPlayback matter Lệnh Tạm dừng
MediaPlayback matter Lệnh Play
MediaPlayback matter Lệnh Trước
MediaPlayback matter Lệnh Tua lại
MediaPlayback matter Lệnh SkipBackward
MediaPlayback matter Lệnh SkipForward
MediaPlayback matter Sự kiện StateChanged
MediaPlayback matter Lệnh Dừng
MediaPlayback matter Thuộc tính currentState
ModeSelect matter Lệnh ChangeToMode block
ModeSelect matter Thuộc tính currentMode
ModeSelect matter Thuộc tính onMode
NitrogenDioxideConcentrationMeasurement matter Thuộc tính levelValue
NitrogenDioxideConcentrationMeasurement matter Thuộc tính measuredValue
OccupancySensing matter Thuộc tính số người lưu trú
OnOff matter Lệnh Tắt chặn
OnOff matter Lệnh Bật chặn
OnOff matter Thuộc tính onOff
OperationalState matter Sự kiện OperationCompletion
OperationalState matter Lệnh Tạm dừng chặn
OperationalState matter Lệnh Tiếp tục chặn
OperationalState matter Lệnh Bắt đầu
OperationalState matter Lệnh Dừng
OperationalState matter Thuộc tính currentPhase
OperationalState matter Thuộc tính operationalState
OzoneConcentrationMeasurement matter Thuộc tính levelValue
OzoneConcentrationMeasurement matter Thuộc tính measuredValue
Pm10ConcentrationMeasurement matter Thuộc tính levelValue
Pm10ConcentrationMeasurement matter Thuộc tính measuredValue
Pm25ConcentrationMeasurement matter Thuộc tính levelValue
Pm25ConcentrationMeasurement matter Thuộc tính measuredValue
PowerSource matter Thuộc tính batChargeState
PowerSource matter Thuộc tính batChargingCurrent
PowerSource matter Thuộc tính batTimeToFullCharge
RadonConcentrationMeasurement matter Thuộc tính levelValue
RadonConcentrationMeasurement matter Thuộc tính measuredValue
RelativeHumidityMeasurement matter Thuộc tính measuredValue
RvcCleanMode matter Lệnh ChangeToMode
RvcOperationalState matter Lệnh GoHome
RvcOperationalState matter Lệnh Tạm dừng
RvcOperationalState matter Lệnh Kích hoạt lại
RvcOperationalState matter Thuộc tính currentPhase
RvcOperationalState matter Thuộc tính operationalError
RvcOperationalState matter Thuộc tính operationalState
RvcRunMode matter Lệnh ChangeToMode
RvcRunMode matter Thuộc tính currentMode
Switch matter Sự kiện InitialPress
Switch matter Sự kiện LongPress
Switch matter Sự kiện LongRelease
Switch matter Sự kiện MultiPressComplete
Switch matter Sự kiện MultiPressOngoing
Switch matter Sự kiện ShortRelease
Switch matter Sự kiện SwitchLatched
Switch matter Thuộc tính currentPosition
TemperatureControl matter Lệnh SetTemperature block
TemperatureControl matter Thuộc tính maxTemperature
TemperatureControl matter Thuộc tính minTemperature
TemperatureControl matter Thuộc tính selectedTemperatureLevel
TemperatureControl matter Thuộc tính temperatureSetpoint
TemperatureMeasurement matter Thuộc tính measuredValue
Máy điều nhiệt matter Lệnh SetpointRaiseLower
Máy điều nhiệt matter Thuộc tính activePresetHandle
Máy điều nhiệt matter Thuộc tính localTemperature
Máy điều nhiệt matter Thuộc tính số người lưu trú
Máy điều nhiệt matter Thuộc tính occupiedCoolingSetpoint
Máy điều nhiệt matter Thuộc tính occupiedHeatingSetpoint
Máy điều nhiệt matter Thuộc tính outdoorTemperature
Máy điều nhiệt matter Thuộc tính setpointChangeSource
Máy điều nhiệt matter Thuộc tính systemMode
Máy điều nhiệt matter Thuộc tính temperatureSetpointHold
Máy điều nhiệt matter Thuộc tính temperatureSetpointHoldDuration
Máy điều nhiệt matter Thuộc tính thermostatRunningMode
Máy điều nhiệt matter Thuộc tính thermostatRunningState
Máy điều nhiệt matter Thuộc tính unoccupiedCoolingSetpoint
Máy điều nhiệt matter Thuộc tính unoccupiedHeatingSetpoint
TotalVolatileOrganicCompoundsConcentrationMeasurement matter Thuộc tính levelValue
TotalVolatileOrganicCompoundsConcentrationMeasurement matter Thuộc tính measuredValue
WindowCovering matter Lệnh DownOrClose
WindowCovering matter Lệnh GoToLiftPercentage
WindowCovering matter Lệnh GoToLiftValue
WindowCovering matter Lệnh GoToTiltPercentage
WindowCovering matter Lệnh GoToTiltValue
WindowCovering matter Lệnh StopMotion
WindowCovering matter Lệnh UpOrOpen
WindowCovering matter Thuộc tính currentPositionLift
WindowCovering matter Thuộc tính currentPositionLiftPercent100ths
WindowCovering matter Thuộc tính currentPositionLiftPercentage
WindowCovering matter Thuộc tính currentPositionTilt
WindowCovering matter Thuộc tính currentPositionTiltPercent100ths
WindowCovering matter Thuộc tính currentPositionTiltPercentage
WindowCovering matter Thuộc tính targetPositionLiftPercent100ths
WindowCovering matter Thuộc tính targetPositionTiltPercent100ths
ArmDisarm google Lệnh ArmDisarm block
ArmDisarm google Sự kiện ArmDisarmArmState
ArmDisarm google Thuộc tính armState
ArmDisarm google Thuộc tính currentArmLevel
ArmDisarm google Thuộc tính isArmed
Dock google Lệnh Đế sạc
Dock google Thuộc tính isDocked
DoorbellPress google Sự kiện DoorbellPressed
ExtendedAirQuality google Sự kiện AirQuality
ExtendedAirQuality google Thuộc tính indoorAirQuality
ExtendedAirQuality google Thuộc tính indoorMeasuredValue
ExtendedAirQuality google Thuộc tính measuredValue
ExtendedAirQuality google Thuộc tính outdoorAirQuality
ExtendedAirQuality google Thuộc tính outdoorMeasuredValue
ExtendedColorControl google Lệnh MoveToColorHSV
ExtendedColorControl google Lệnh MoveToColorName
ExtendedColorControl google Lệnh MoveToColorRGB
ExtendedColorControl google Thuộc tính currentBlue
ExtendedColorControl google Thuộc tính currentGreen
ExtendedColorControl google Thuộc tính currentHue
ExtendedColorControl google Thuộc tính currentName
ExtendedColorControl google Thuộc tính currentRed
ExtendedColorControl google Thuộc tính currentSaturation
ExtendedColorControl google Thuộc tính currentValue
ExtendedFanControl google Lệnh ToggleAirflowDirection
ExtendedFanControl google Thuộc tính customFanMode
ExtendedFanControl google Thuộc tính customFanModes
ExtendedMediaInput google Lệnh NextInput
ExtendedMediaInput google Lệnh PreviousInput
ExtendedMediaInput google Lệnh SelectCustomInput
ExtendedMediaInput google Thuộc tính currentCustomInput
ExtendedMediaInput google Thuộc tính customInputsList
ExtendedMediaInput google Thuộc tính customInputsOrdered
ExtendedOperationalState google Sự kiện PauseUnpauseFollowUp
ExtendedOperationalState google Sự kiện StartStopFollowUp
ExtendedPowerSource google Lệnh StartCharging
ExtendedPowerSource google Lệnh StopCharging
ExtendedThermostat google Thuộc tính activePresetHandle
ExtendedThermostat google Thuộc tính activeRemoteTemperatureSensorIds
ExtendedThermostat google Thuộc tính averageLocalTemperature
ExtendedThermostat google Thuộc tính extendedRunningMode
ExtendedThermostat google Thuộc tính extendedSystemMode
LightEffects google Lệnh PulseEffectSet
LightEffects google Lệnh SleepEffectSet
LightEffects google Lệnh StopEffect
LightEffects google Lệnh WakeEffectSet
LightEffects google Thuộc tính pulseEffectSet
LightEffects google Thuộc tính sleepEffectSet
LightEffects google Thuộc tính wakeEffectSet
LockUnlock google Lệnh Khoá
LockUnlock google Lệnh Mở khoá quy tắc chặn
LockUnlock google Thuộc tính lockState
MotionDetection google Sự kiện MotionDetected
MotionDetection google Thuộc tính motionDetectionEventInProgress
ObjectDetection google Sự kiện ObjectDetected
OpenClose google Lệnh Đóng khối
OpenClose google Lệnh GoToOpenPercentage block
OpenClose google Lệnh Mở khối
OpenClose google Lệnh Bước block
OpenClose google Thuộc tính openPercent
OpenClose google Thuộc tính openState
OpenClose google Thuộc tính targetOpenPercent
Bật/tắt google Lệnh ChangeToggleSettings block
Bật/tắt google Thuộc tính currentToggleSettings
Độ sáng google Lệnh BrightnessStep
Độ sáng google Lệnh MoveToBrightness
Độ sáng google Thuộc tính currentBrightnessPercent
SimplifiedOnOff google Thuộc tính onOff
SimplifiedThermostat google Lệnh SetSystemMode
SimplifiedThermostat google Thuộc tính systemMode
Số lượng google Lệnh MoveToVolume
Số lượng google Lệnh Tắt tiếng
Số lượng google Lệnh Bật tiếng
Số lượng google Lệnh VolumeStep
Số lượng google Thuộc tính currentVolumePercent
Số lượng google Thuộc tính isMuted
AreaAttendanceState google Thuộc tính attendanceState
AreaPresenceState google Thuộc tính presenceState