Điều kiện khởi động, điều kiện và hành động được hỗ trợ

Tính năng tự động hoá hỗ trợ các điều kiện kích hoạt và hành động sau. Tất cả các trạng thái cũng được hỗ trợ dưới dạng điều kiện.

Trạng thái / Sự kiện (trình kích hoạt)
Điều kiện
Lệnh (hành động)
Các trường được hỗ trợ Mô tả
Một điều kiện kết hợp để biểu thị hàm logic AND của tất cả các điều kiện con.
assistant.command.Broadcast tin nhắn
assistant.command.OkGoogle okGoogle
assistant.event.OkGoogle truy vấn
device.command.ActivateScene kích hoạt Kích hoạt hoặc huỷ kích hoạt một cảnh.
device.command.AppInstall newApplicationName Cài đặt một ứng dụng trên thiết bị đã cho.
device.command.AppSearch applicationName Tìm kiếm ứng dụng đã cho.
device.command.AppSelect applicationName Chọn ứng dụng đã cho.
device.command.ArmDisarm arm
armLevel
cancel
Đặt mức báo động của thiết bị.
device.command.BrightnessAbsolute độ sáng Điều chỉnh độ sáng tuyệt đối của thiết bị. Khi độ sáng được đặt thành bất kỳ giá trị nào lớn hơn 0, nếu thiết bị đang tắt, thì thiết bị sẽ bật và [`OnOffState.state`](./on_off_state) sẽ thay đổi để phản ánh rằng thiết bị đang bật. Tương tự, khi độ sáng được đặt thành 0, thiết bị sẽ tắt nguồn và [`OnOffState.state`](./on_off_state) sẽ thay đổi theo.
device.command.BrightnessRelative brightnessRelativePercent
brightnessRelativeWeight
Điều chỉnh độ sáng tương đối của thiết bị. Khi độ sáng được đặt thành bất kỳ giá trị nào lớn hơn 0, nếu thiết bị đang tắt, thì thiết bị sẽ bật và [`OnOffState.state`](./on_off_state) sẽ thay đổi để phản ánh rằng thiết bị đang bật. Tương tự, khi độ sáng được đặt thành 0, thiết bị sẽ tắt nguồn và [`OnOffState.state`](./on_off_state) sẽ thay đổi theo.
device.command.Charge điện tích Bắt đầu hoặc dừng sạc.
device.command.ColorAbsolute color.name
color.spectrumHSV.hue
color.spectrumHSV.saturation
color.spectrumHSV.value
color.spectrumRGB
color.temperature
Đặt màu thành sắc độ được chỉ định. Khi bạn đặt màu trên một thiết bị đang tắt, thiết bị sẽ bật nguồn và [`OnOffState.state`](./on_off_state) sẽ thay đổi để phản ánh điều này. Tương tự, khi độ sáng được đặt thành 0, thiết bị sẽ tắt nguồn và [`OnOffState.state`](./on_off_state) sẽ thay đổi theo.
device.command.Cook cookingMode
foodPreset
quantity
start
unit
Bắt đầu hoặc dừng nấu ăn.
device.command.Dispense amount
item
presetName
unit
Phân phát các mục.
device.command.Dock Cắm thiết bị vào đế sạc.
device.command.EnableDisableGuestNetwork bật Bật hoặc tắt mạng khách.
device.command.EnableDisableNetworkProfile enable
profile
Bật hoặc tắt một hồ sơ mạng. Bạn phải sử dụng phương thức xác minh người dùng phụ bằng mã PIN. Hệ thống an ninh gia đình của người dùng có thể được coi là bị ảnh hưởng nếu các thiết bị an ninh khác bị vô hiệu hoá thông qua các lệnh này.
device.command.Fill fill
fillLevel
Đổ đầy hoặc xả nước trong thiết bị.
device.command.FindMyDevice tắt tiếng Tìm thiết bị mục tiêu bằng cách tạo một cảnh báo cục bộ.
device.command.HumidityRelative relativeHumidityPercent
relativeHumidityWeight
Điều chỉnh độ ẩm so với giá trị hiện tại.
device.command.LightEffectColorLoop thời lượng Chuyển thiết bị qua một bộ màu.
device.command.LightEffectPulse thời lượng Cường độ ánh sáng tăng từ độ sáng trung bình lên độ sáng tối đa, sau đó giảm xuống độ sáng trung bình với tổng thời gian chu kỳ là một xung mỗi giây. Trong mỗi chu kỳ, độ sáng tối đa phải kéo dài 200 mili giây và độ sáng trung bình (không bao gồm giai đoạn chuyển đổi) phải kéo dài ít nhất 500 mili giây.
device.command.LightEffectSleep thời lượng Giảm dần độ sáng của thiết bị theo thời gian và tuỳ ý thay đổi nhiệt độ màu.
device.command.LightEffectWake thời lượng Tăng dần độ sáng của thiết bị theo thời gian và tuỳ ý thay đổi nhiệt độ màu.
device.command.LockUnlock khóa Khoá hoặc mở khoá thiết bị.
device.command.MediaNext Chuyển sang mục nội dung nghe nhìn tiếp theo.
device.command.MediaPause Tạm dừng phát nội dung nghe nhìn.
device.command.MediaPrevious Chuyển đến mục nội dung nghe nhìn trước đó.
device.command.MediaResume Tiếp tục phát nội dung nghe nhìn.
device.command.MediaShuffle Trộn danh sách phát hiện tại.
device.command.MediaStop Dừng phát nội dung nghe nhìn.
device.command.Mute tắt tiếng Tắt hoặc bật tiếng thiết bị đã cho.
device.command.NextInput Chuyển sang đầu vào tiếp theo.
device.command.OnOff bật Bật hoặc tắt thiết bị.
device.command.OpenClose openDirection
openPercent
Đặt trạng thái mở/đóng của thiết bị
device.command.PauseUnpause tạm dừng Tạm dừng hoặc tiếp tục hoạt động của thiết bị.
device.command.PreviousInput Chuyển sang đầu vào trước.
device.command.Reboot Khởi động lại thiết bị.
device.command.RelativeChannel channelCount Điều chỉnh kênh hiện tại theo một mức tương đối.
device.command.ReturnChannel Quay lại kênh trước đó mà người dùng đang xem.
device.command.ReverseFan Đảo ngược hướng quạt.
device.command.RotateAbsolute rotationDegrees
rotationPercent
Đặt độ xoay tuyệt đối của thiết bị.
device.command.SelectChannel channelCode
channelName
channelNumber
Đặt kênh hiện tại thành một giá trị cụ thể.
device.command.SetFanSpeed fanSpeed Đặt tốc độ quạt.
device.command.SetFanSpeedRelative fanSpeedRelativePercent
fanSpeedRelativeWeight
Đặt tốc độ tương đối cho quạt.
device.command.SetHumidity độ ẩm Đặt độ ẩm ở một giá trị tuyệt đối.
device.command.SetInput newInput Đặt đầu vào nội dung nghe nhìn.
device.command.SetVolume volumeLevel Đặt âm lượng cho một thiết bị nhất định.
device.command.StartStop bắt đầu Khởi động hoặc dừng thiết bị.
device.command.StopLightEffect Dừng hiệu ứng ánh sáng hiện tại.
device.command.ThermostatSetMode thermostatMode Đặt chế độ hoạt động mục tiêu cho thiết bị máy điều nhiệt.
device.command.ThermostatTemperatureSetpoint thermostatTemperatureSetpoint Đặt nhiệt độ mục tiêu cho thiết bị máy điều nhiệt.
device.command.ThermostatTemperatureSetRange thermostatTemperatureSetpointHigh
thermostatTemperatureSetpointLow
Đặt một dải nhiệt độ mục tiêu cho thiết bị máy điều nhiệt.
device.command.TimerAdjust thời lượng Điều chỉnh thời lượng của đồng hồ hẹn giờ.
device.command.TimerCancel Huỷ đồng hồ hẹn giờ.
device.command.TimerPause Tạm dừng đồng hồ hẹn giờ.
device.command.TimerResume Tiếp tục chạy đồng hồ hẹn giờ.
device.command.TimerStart thời lượng Bắt đầu một đồng hồ hẹn giờ mới.
device.event.AnimalOtherDetection Camera phát hiện thấy một chú chó hoặc một chú mèo. Không hỗ trợ phát hiện các loại động vật khác.
device.event.DoorbellPress Có người nhấn chuông cửa.
device.event.FaceFamiliarDetection Camera đã phát hiện thấy một khuôn mặt quen thuộc.
device.event.FaceUnfamiliarDetection Camera phát hiện thấy khuôn mặt người lạ.
device.event.MotionDetection Thiết bị đã phát hiện thấy chuyển động.
device.event.MovingVehicleDetection Camera phát hiện thấy một chiếc xe đang di chuyển.
device.event.PackageDelivered Camera phát hiện thấy một gói hàng đã được giao.
device.event.PersonDetection Camera phát hiện thấy có người.
device.event.PersonTalking Thiết bị đã phát hiện thấy âm thanh của người nói.
device.event.Sound Thiết bị đã phát hiện thấy âm thanh.
device.state.AppSelector currentApplication Đối với những thiết bị có thể chuyển đổi giữa các ứng dụng.
device.state.ArmDisarm currentArmLevel
isArmed
Đối với các thiết bị như hệ thống an ninh có hỗ trợ bật và tắt, trạng thái này cho biết thiết bị đang bật hay tắt.
device.state.Brightness độ sáng Chế độ cài đặt độ sáng cho một thiết bị.
device.state.Channel Đối với những thiết bị hỗ trợ kênh trên thiết bị nghe nhìn.
device.state.ColorSetting color.colorTemperature
color.spectrumHsv.hue
color.spectrumHsv.saturation
color.spectrumHsv.value
color.spectrumRgb
Trạng thái của chế độ cài đặt màu.
device.state.Cook currentCookingMode
currentFoodPreset
Đối với những thiết bị có thể nấu ăn theo nhiều chế độ cài đặt sẵn về thực phẩm và chế độ nấu được hỗ trợ.
device.state.Dock isDocked Đối với các thiết bị di động tự hành có thể được điều khiển để quay về sạc.
device.state.EnergyStorage descriptiveCapacityRemaining
isCharging
isPluggedIn
Trạng thái của thiết bị lưu trữ năng lượng, chẳng hạn như pin, bao gồm lượng năng lượng mà thiết bị đang lưu trữ, thiết bị có đang sạc hay không và thiết bị có được cắm điện hay không.
device.state.FanSpeed currentFanSpeedPercent
currentFanSpeedSetting
Đối với những thiết bị hỗ trợ việc đặt tốc độ quạt.
device.state.Fill currentFillLevel
currentFillPercent
isFilled
Đối với các thiết bị hỗ trợ việc đổ đầy, chẳng hạn như bồn tắm.
device.state.HumiditySetting humidityAmbientPercent
humiditySetpointPercent
Đối với các thiết bị hỗ trợ chế độ cài đặt độ ẩm, chẳng hạn như máy tạo ẩm và máy hút ẩm.
device.state.InputSelector currentInput Cho phép truy vấn các thiết bị có thể chuyển đổi đầu vào. Đầu vào nội dung nghe nhìn có thể có tên động cho mỗi thiết bị, đại diện cho nguồn cấp dữ liệu âm thanh hoặc video. Các nguồn cấp dữ liệu này có thể được kết nối trực tiếp hoặc kết nối mạng, nhưng phải được đặt tên và có tính ổn định hợp lý. Điều này không hỗ trợ các nguồn cấp dữ liệu tạm thời tuỳ ý, chẳng hạn như một thư viện mạng có thể tìm kiếm. Hỗ trợ các nguồn Bluetooth đã ghép nối và được đặt tên. Các nguồn có thể có nhiều tên, vì vậy, tên do người dùng tạo và tên được phát hiện đều được hỗ trợ, cũng như tên mặc định; ví dụ: "hdmi_1" cũng có thể là "Đầu đĩa DVD" hoặc "usb_1" cũng có thể là "Ổ cứng". Bạn có thể sắp xếp các nguồn đầu vào nội dung nghe nhìn để hỗ trợ các lệnh "tiếp theo" và "trước đó". Lưu ý: InputSelector không hỗ trợ ngữ pháp truy vấn.
device.state.LightEffects activeLightEffect Đối với những thiết bị có thể hỗ trợ các lệnh chiếu sáng phức tạp để thay đổi trạng thái, chẳng hạn như đổi từ màu này sang màu khác theo vòng.
device.state.LockUnlock isJammed
isLocked
Đối với những thiết bị hỗ trợ khoá và mở khoá, và/hoặc báo cáo trạng thái khoá.
device.state.MediaState playbackState Đối với các thiết bị phát nội dung nghe nhìn, trạng thái của nội dung nghe nhìn, chẳng hạn như nội dung đó có đang phát hay không.
device.state.MotionDetection motionDetectionEventInProgress Đối với những thiết bị có thể phát hiện chuyển động.
device.state.OccupancySensing số người lưu trú Đối với những thiết bị có thể phát hiện sự hiện diện của người dùng, cho dù là thông qua cảm biến hồng ngoại thụ động, sóng siêu âm hay cảm biến tiếp xúc vật lý.
device.state.Online trực tuyến Đối với những thiết bị hỗ trợ trạng thái trực tuyến và ngoại tuyến, và/hoặc báo cáo trạng thái trực tuyến và ngoại tuyến.
device.state.OnOff bật Chức năng bật và tắt cơ bản cho mọi thiết bị có trạng thái bật và tắt nhị phân, bao gồm cả phích cắm và công tắc cũng như nhiều thiết bị trong tương lai.
device.state.OpenClose openPercent Đối với những thiết bị hỗ trợ mở và đóng, trong một số trường hợp, thiết bị có thể mở và đóng một phần hoặc có thể mở và đóng theo nhiều hướng.
device.state.Record isCurrentlyRecording Đối với những thiết bị hỗ trợ ghi vào nội dung nghe nhìn.
device.state.Rotation rotationDegrees
rotationPercent
Đối với các thiết bị hỗ trợ xoay, chẳng hạn như rèm có các thanh có thể xoay.
device.state.RunCycle currentCycleRemainingTime
currentTotalRemainingTime
Đối với những thiết bị có thời gian hoạt động liên tục mà bạn có thể truy vấn. Những thiết bị như vậy sẽ báo cáo tổng số chu kỳ khi bắt đầu hoạt động và mỗi chu kỳ mà thiết bị hiện đang chạy.
device.state.SensorState currentSensorStateData.key
currentSensorStateData.value.currentSensorState
currentSensorStateData.value.rawValue
Một chỉ số do cảm biến tạo ra. Ví dụ: lượng khói mà máy dò khói đo được, hoặc lượng khí cacbon monoxit mà máy dò khí cacbon monoxit đo được, v.v.
device.state.StartStop isPaused
isRunning
Đối với những thiết bị hỗ trợ các thao tác bắt đầu và dừng. Việc khởi động và dừng thiết bị có chức năng tương tự như việc bật và tắt thiết bị. Điều này cho thấy thiết bị hoạt động khác nhau khi bật và khi khởi động. Ví dụ: một số máy giặt có thể bật và sửa đổi chế độ cài đặt trước khi thực sự bắt đầu hoạt động.
device.state.TemperatureControl temperatureAmbient
temperatureSetpoint
Kiểm soát nhiệt độ cho một thiết bị không phải là máy điều nhiệt (ví dụ: lò nướng), trong hoặc xung quanh thiết bị.
device.state.TemperatureSetting activeThermostatMode
thermostatHumidityAmbient
thermostatMode
thermostatTemperatureAmbient
thermostatTemperatureSetpoint
thermostatTemperatureSetpointHigh
thermostatTemperatureSetpointLow
Đối với những thiết bị hỗ trợ các điểm và chế độ nhiệt độ.
device.state.Timer timerPaused Đối với những thiết bị có hỗ trợ tính năng hẹn giờ. Ví dụ: bộ điều khiển vòi phun nước thông minh hoặc công tắc đèn thông minh có thể có bộ hẹn giờ tích hợp. Bạn có thể dùng phương thức này để truy vấn thiết bị về thời gian còn lại của đồng hồ hẹn giờ.
device.state.Volume currentVolume
isMuted
Đối với những thiết bị có thể thay đổi âm lượng (ví dụ: đặt âm lượng ở một mức nhất định, tắt tiếng hoặc bật tiếng).
home.command.Notification body
members
title
Gửi thông báo cho các thành viên được chỉ định trong nhà.
home.state.HomePresence homePresenceMode
not Một điều kiện biểu thị phép loại trừ logic của một điều kiện khác.
hoặc Một điều kiện kết hợp để biểu thị hàm logic OR của tất cả các điều kiện con.
time.between Biểu thị một phạm vi thời gian.
time.delay Thêm một khoảng tạm dừng vào quá trình thực thi tự động.
time.schedule Biểu thị một sự kiện theo lịch trình thời gian.