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

API Tự động hoá cho Android hỗ trợ hầu hết các đặc điểm, nhưng có thể chỉ hỗ trợ một số thuộc tính, sự kiện và lệnh trong một đặc điểm.

Để 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 bằng API Tự động hoá khi khởi chạy. Xem phần Tạo thực thể Home.
  • Bạn có thể sử dụng bất kỳ thuộc tính nào trong điều kiện khởi động hoặc điều kiện.
  • Không thể sử dụng các thiết bị Cloud-to-cloud không báo cáo trạng thái của chúng làm trình kích hoạt trong các quy trình tự động, đượ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 trình khởi động hoặc hành động trong Automation API do ngưỡng chất lượng Trạng thái báo cáo:

    • Các thiết bị có tỷ lệ thành công của Báo cáo trạng thái thấp hơn 90% sẽ bị chặn sử dụng làm điều kiện khởi động.
    • Những thiết bị có tỷ lệ thực thi lệnh thành công thấp hơn 95% sẽ bị chặn sử dụng làm hành động.

    Hãy tham khảo danh sách các mẫu thiết bị này và các trình khởi động và thao tác cụ thể mà các mẫu thiết bị đó hỗ trợ cho Automations API.

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

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

  • Lệnh okGoogle là lệnh cấp cấu trúc và có thể được dùng để tự động hoá mọi thiết bị trong cấu trúc. Tuy nhiên, ứng dụng Home API có thể không có quyền truy cập vào mọi thiết bị. Hãy xem bài viết Quyền của OkGoogle để biết cách thực thi 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à tính năng tự động hoá chạy trong đó 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 bạn không thiết lập địa chỉ trong GHA, thì quá trình tự động hoá sẽ không tạo được và lỗi sẽ được gửi kèm theo 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 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 được đơn giản hoá trên Android.

Khối cho biết lệnh không được hỗ trợ trong các quy trình tự động hoá cho 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 Thao tác bị chặn trong quy trình tự động hoá trên Android.

256 kết quả
Đặc điểm Loại đặc điểm Loại phần tử Phần tử
AirQuality vấn đề Thuộc tính airQuality
ApplicationLauncher vấn đề Lệnh LaunchApp
ApplicationLauncher vấn đề Lệnh StopApp
ApplicationLauncher vấn đề Thuộc tính currentApp
AreaAttendanceState google Thuộc tính attendanceState
AreaPresenceState google Thuộc tính presenceState
ArmDisarm google Lệnh ArmDisarm
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
AssistantBroadcast google Lệnh Truyền tin
AssistantFulfillment google Lệnh OkGoogle
AudioOutput vấn đề Thuộc tính currentOutput
Bản ghi google Lệnh StartRecording
Bản ghi google Lệnh StopRecording
Bản ghi google Thuộc tính isCurrentlyRecording
Bật/tắt google Lệnh ChangeToggleSettings khối
Bật/tắt google Thuộc tính currentToggleSettings
BooleanState vấn đề Sự kiện StateChange
BooleanState vấn đề Thuộc tính stateValue
CarbonDioxideConcentrationMeasurement vấn đề Thuộc tính levelValue
CarbonDioxideConcentrationMeasurement vấn đề Thuộc tính measuredValue
CarbonMonoxideConcentrationMeasurement vấn đề Thuộc tính levelValue
CarbonMonoxideConcentrationMeasurement vấn đề Thuộc tính maxMeasuredValue
CarbonMonoxideConcentrationMeasurement vấn đề Thuộc tính measuredValue
CarbonMonoxideConcentrationMeasurement vấn đề Thuộc tính measurementUnit
CarbonMonoxideConcentrationMeasurement vấn đề Thuộc tính minMeasuredValue
CarbonMonoxideConcentrationMeasurement vấn đề Thuộc tính không chắc chắn
ColorControl vấn đề Lệnh ColorLoopSet
ColorControl vấn đề Lệnh MoveColor
ColorControl vấn đề Lệnh MoveColorTemperature
ColorControl vấn đề Lệnh MoveToColor
ColorControl vấn đề Lệnh MoveToColorTemperature
ColorControl vấn đề Lệnh MoveToHue
ColorControl vấn đề Lệnh MoveToHueAndSaturation
ColorControl vấn đề Lệnh MoveToSaturation
ColorControl vấn đề Lệnh StepColor
ColorControl vấn đề Lệnh StepColorTemperature
ColorControl vấn đề Thuộc tính colorTemperatureMireds
ColorControl vấn đề Thuộc tính currentHue
ColorControl vấn đề Thuộc tính currentX
ColorControl vấn đề Thuộc tính currentY
Công tắc vấn đề Sự kiện InitialPress
Công tắc vấn đề Sự kiện LongPress
Công tắc vấn đề Sự kiện LongRelease
Công tắc vấn đề Sự kiện MultiPressComplete
Công tắc vấn đề Sự kiện MultiPressOngoing
Công tắc vấn đề Sự kiện ShortRelease
Công tắc vấn đề Sự kiện SwitchLatched
Công tắc vấn đề Thuộc tính currentPosition
Đế sạc google Lệnh Chân đế
Đế sạc google Thuộc tính isDocked
DishwasherMode vấn đề Lệnh ChangeToMode
DishwasherMode vấn đề Thuộc tính currentMode
DishwasherMode vấn đề Thuộc tính onMode
Độ sáng google Lệnh BrightnessStep
Độ sáng google Lệnh MoveToBrightness
Độ sáng google Thuộc tính currentBrightnessPercent
DoorbellPress google Sự kiện DoorbellPressed
DoorLock vấn đề Sự kiện DoorLockAlarm
DoorLock vấn đề Sự kiện DoorStateChange
DoorLock vấn đề Lệnh LockDoor
DoorLock vấn đề Sự kiện LockOperation
DoorLock vấn đề Sự kiện LockOperationError
DoorLock vấn đề Lệnh UnlockDoor
DoorLock vấn đề Thuộc tính doorClosedEvents
DoorLock vấn đề Thuộc tính doorOpenEvents
DoorLock vấn đề Thuộc tính doorState
DoorLock vấn đề Thuộc tính lockState
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
FanControl vấn đề Lệnh Bước
FanControl vấn đề Thuộc tính airflowDirection
FanControl vấn đề Thuộc tính fanMode
FanControl vấn đề Thuộc tính percentCurrent
FanControl vấn đề Thuộc tính percentSetting
FanControl vấn đề Thuộc tính speedCurrent
FanControl vấn đề Thuộc tính speedSetting
FanControl vấn đề Thuộc tính windSetting
FormaldehydeConcentrationMeasurement vấn đề Thuộc tính levelValue
FormaldehydeConcentrationMeasurement vấn đề Thuộc tính measuredValue
IlluminanceMeasurement vấn đề Thuộc tính measuredValue
Kênh vấn đề Lệnh ChangeChannelByNumber
Kênh vấn đề Lệnh SkipChannel
LaundryWasherMode vấn đề Lệnh ChangeToMode
LaundryWasherMode vấn đề Thuộc tính currentMode
LaundryWasherMode vấn đề Thuộc tính onMode
LevelControl vấn đề Lệnh Di chuyển
LevelControl vấn đề Lệnh MoveToLevel
LevelControl vấn đề Lệnh MoveToLevelWithOnOff
LevelControl vấn đề Lệnh MoveWithOnOff
LevelControl vấn đề Lệnh Bước
LevelControl vấn đề Lệnh StepWithOnOff
LevelControl vấn đề Lệnh Dừng
LevelControl vấn đề Lệnh StopWithOnOff
LevelControl vấn đề Thuộc tính currentLevel
LevelControl vấn đề Thuộc tính maxLevel
LevelControl vấn đề Thuộc tính startUpCurrentLevel
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á khối
LockUnlock google Thuộc tính lockState
Máy điều nhiệt vấn đề Lệnh SetpointRaiseLower
Máy điều nhiệt vấn đề Thuộc tính activePresetHandle
Máy điều nhiệt vấn đề Thuộc tính localTemperature
Máy điều nhiệt vấn đề Thuộc tính số người lưu trú
Máy điều nhiệt vấn đề Thuộc tính occupiedCoolingSetpoint
Máy điều nhiệt vấn đề Thuộc tính occupiedHeatingSetpoint
Máy điều nhiệt vấn đề Thuộc tính outdoorTemperature
Máy điều nhiệt vấn đề Thuộc tính setpointChangeSource
Máy điều nhiệt vấn đề Thuộc tính systemMode
Máy điều nhiệt vấn đề Thuộc tính temperatureSetpointHold
Máy điều nhiệt vấn đề Thuộc tính temperatureSetpointHoldDuration
Máy điều nhiệt vấn đề Thuộc tính thermostatRunningMode
Máy điều nhiệt vấn đề Thuộc tính thermostatRunningState
Máy điều nhiệt vấn đề Thuộc tính unoccupiedCoolingSetpoint
Máy điều nhiệt vấn đề Thuộc tính unoccupiedHeatingSetpoint
MediaInput vấn đề Lệnh RenameInput
MediaInput vấn đề Lệnh SelectInput
MediaInput vấn đề Thuộc tính currentInput
MediaPlayback vấn đề Lệnh FastForward
MediaPlayback vấn đề Lệnh Tiếp theo
MediaPlayback vấn đề Lệnh Tạm dừng
MediaPlayback vấn đề Lệnh Phát
MediaPlayback vấn đề Lệnh Trước
MediaPlayback vấn đề Lệnh Tua lại
MediaPlayback vấn đề Lệnh SkipBackward
MediaPlayback vấn đề Lệnh SkipForward
MediaPlayback vấn đề Sự kiện StateChanged
MediaPlayback vấn đề Lệnh Dừng
MediaPlayback vấn đề Thuộc tính currentState
ModeSelect vấn đề Lệnh ChangeToMode khối
ModeSelect vấn đề Thuộc tính currentMode
ModeSelect vấn đề Thuộc tính onMode
MotionDetection google Sự kiện MotionDetected
MotionDetection google Thuộc tính motionDetectionEventInProgress
NitrogenDioxideConcentrationMeasurement vấn đề Thuộc tính levelValue
NitrogenDioxideConcentrationMeasurement vấn đề Thuộc tính measuredValue
ObjectDetection google Sự kiện ObjectDetected
OccupancySensing vấn đề Thuộc tính số người lưu trú
OnOff vấn đề Lệnh Tắt khối
OnOff vấn đề Lệnh Bật chặn
OnOff vấn đề Thuộc tính onOff
OpenClose google Lệnh Đóng khối
OpenClose google Lệnh GoToOpenPercentage khối
OpenClose google Lệnh Mở khối
OpenClose google Lệnh Bước khối
OpenClose google Thuộc tính openPercent
OpenClose google Thuộc tính openState
OpenClose google Thuộc tính targetOpenPercent
OperationalState vấn đề Sự kiện OperationCompletion
OperationalState vấn đề Lệnh Tạm dừng khối
OperationalState vấn đề Lệnh Tiếp tục khối
OperationalState vấn đề Lệnh Bắt đầu
OperationalState vấn đề Lệnh Dừng
OperationalState vấn đề Thuộc tính currentPhase
OperationalState vấn đề Thuộc tính operationalState
OzoneConcentrationMeasurement vấn đề Thuộc tính levelValue
OzoneConcentrationMeasurement vấn đề Thuộc tính measuredValue
Pm10ConcentrationMeasurement vấn đề Thuộc tính levelValue
Pm10ConcentrationMeasurement vấn đề Thuộc tính measuredValue
Pm25ConcentrationMeasurement vấn đề Thuộc tính levelValue
Pm25ConcentrationMeasurement vấn đề Thuộc tính measuredValue
PowerSource vấn đề Thuộc tính batChargeState
PowerSource vấn đề Thuộc tính batChargingCurrent
PowerSource vấn đề Thuộc tính batTimeToFullCharge
RadonConcentrationMeasurement vấn đề Thuộc tính levelValue
RadonConcentrationMeasurement vấn đề Thuộc tính measuredValue
RelativeHumidityMeasurement vấn đề Thuộc tính measuredValue
RvcCleanMode vấn đề Lệnh ChangeToMode
RvcOperationalState vấn đề Lệnh GoHome
RvcOperationalState vấn đề Lệnh Tạm dừng
RvcOperationalState vấn đề Lệnh Kích hoạt lại
RvcOperationalState vấn đề Thuộc tính currentPhase
RvcOperationalState vấn đề Thuộc tính operationalError
RvcOperationalState vấn đề Thuộc tính operationalState
RvcRunMode vấn đề Lệnh ChangeToMode
RvcRunMode vấn đề Thuộc tính currentMode
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
TemperatureControl vấn đề Lệnh SetTemperature
TemperatureControl vấn đề Thuộc tính maxTemperature
TemperatureControl vấn đề Thuộc tính minTemperature
TemperatureControl vấn đề Thuộc tính selectedTemperatureLevel
TemperatureControl vấn đề Thuộc tính temperatureSetpoint
TemperatureMeasurement vấn đề Thuộc tính measuredValue
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
Thông báo google Lệnh SendNotifications
TotalVolatileOrganicCompoundsConcentrationMeasurement vấn đề Thuộc tính levelValue
TotalVolatileOrganicCompoundsConcentrationMeasurement vấn đề Thuộc tính measuredValue
VoiceStarter google Sự kiện OkGoogleEvent
WindowCovering vấn đề Lệnh DownOrClose
WindowCovering vấn đề Lệnh GoToLiftPercentage
WindowCovering vấn đề Lệnh GoToLiftValue
WindowCovering vấn đề Lệnh GoToTiltPercentage
WindowCovering vấn đề Lệnh GoToTiltValue
WindowCovering vấn đề Lệnh StopMotion
WindowCovering vấn đề Lệnh UpOrOpen
WindowCovering vấn đề Thuộc tính currentPositionLift
WindowCovering vấn đề Thuộc tính currentPositionLiftPercent100ths
WindowCovering vấn đề Thuộc tính currentPositionLiftPercentage
WindowCovering vấn đề Thuộc tính currentPositionTilt
WindowCovering vấn đề Thuộc tính currentPositionTiltPercent100ths
WindowCovering vấn đề Thuộc tính currentPositionTiltPercentage
WindowCovering vấn đề Thuộc tính targetPositionLiftPercent100ths
WindowCovering vấn đề Thuộc tính targetPositionTiltPercent100ths