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

Quy trình tự động hoá hỗ trợ các điều kiện khởi động và hành động sau đây. 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 (điều kiện khởi động)
Điều kiện
Lệnh (hành động)
Các trường được hỗ trợ Mô tả
và Điều kiện phức hợp để biểu thị hàm logic AND của tất cả điều kiện con.
assistant.command.Broadcast message
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 cảnh.
device.command.AppInstall newApplicationName Cài đặt ứng dụng trên thiết bị đã cho.
device.command.AppSearch applicationName Tì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, 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 tương ứng.
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, 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 tương ứng.
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 thái màu được chỉ định. Khi màu được đặt 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 tương ứng.
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ặt hàng.
device.command.Dock Gắn 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 bật
hồ sơ
Bật hoặc tắt hồ sơ mạng. Phải sử dụng bước thứ hai để xác minh người dùng bằng mã PIN. Hệ thống an ninh gia đình của người dùng có thể bị 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ả hết thiết bị.
device.command.FindMyDevice tắt tiếng Xác định vị trí của thiết bị mục tiêu bằng cách tạo 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 đổi thiết bị qua một tập hợp 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 lượng 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 ở mức trung bình (không tính khoảng thời gian chuyển đổi) phải kéo dài ít nhất 500 mili giây.
device.command.LightEffectSleep thời lượng Trong một khoảng thời gian, hãy giảm dần độ sáng của thiết bị và thay đổi nhiệt độ màu (không bắt buộc).
device.command.LightEffectWake thời lượng Trong một khoảng thời gian, hãy tăng dần độ sáng của thiết bị và thay đổi nhiệt độ màu nếu thiết bị hỗ trợ hiệu ứng này.
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 về 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 Phát ngẫu nhiê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 cổng đầ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 lượng tương đối.
device.command.ReturnChannel Quay lại kênh trước đó mà người dùng đã xem.
device.command.ReverseFan Đảo chiều quay của quạt.
device.command.RotateAbsolute rotationDegrees
rotationPercent
Đặt chế độ 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 của một thiết bị nhất định.
device.command.StartStop start Bắt đầu 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ị điều nhiệt.
device.command.ThermostatTemperatureSetpoint thermostatTemperatureSetpoint Đặt nhiệt độ mục tiêu cho thiết bị điều nhiệt.
device.command.ThermostatTemperatureSetRange thermostatTemperatureSetpointHigh
thermostatTemperatureSetpointLow
Đặt phạm vi nhiệt độ mục tiêu cho thiết bị điều nhiệt.
device.command.TimerAdjust thời lượng Điều chỉnh thời lượng 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 đồng hồ hẹn giờ.
device.command.TimerStart thời lượng Bắt đầu hẹn giờ mới.
device.event.AnimalOtherDetection Camera đã phát hiện thấy một chú chó hoặc mèo. Tính năng này 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 một khuôn mặt 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 đến.
device.event.PersonDetection Camera đã phát hiện thấy một người.
device.event.PersonTalking Thiết bị đã phát hiện thấy tiếng 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 các 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 thiết bị.
device.state.Channel Dành cho những thiết bị hỗ trợ kênh trên thiết bị truyền thông.
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
Dành cho những thiết bị có thể nấu thức ăn theo nhiều chế độ nấu ăn và chế độ cài đặt sẵn cho món ăn.
device.state.Dock isDocked Đối với thiết bị tự di chuyển có thể được điều khiển để quay lại 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 cả 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ó đang được cắm điện hay không.
device.state.FanSpeed currentFanSpeedPercent
currentFanSpeedSetting
Dành cho những thiết bị hỗ trợ việc đặt tốc độ quạt.
device.state.Fill currentFillLevel
currentFillPercent
isFilled
Dành cho những thiết bị hỗ trợ việc đổ đầy, chẳng hạn như bồn tắm.
device.state.HumiditySetting humidityAmbientPercent
humiditySetpointPercent
Dành cho những 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 nguồn cấp dữ liệu 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ý. Tính năng 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ư 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ên. 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 phát DVD" hoặc "usb_1" cũng có thể là "Ổ đĩa cứng". Bạn có thể sắp xếp các đầu vào nội dung nghe nhìn để hỗ trợ 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 Dành cho 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 lặp.
device.state.LockUnlock isJammed
isLocked
Dành cho những thiết bị hỗ trợ tính năng 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 các thiết bị có thể phát hiện chuyển động.
device.state.OccupancySensing số người lưu trú Dành cho các thiết bị có thể phát hiện sự hiện diện, thông qua cảm biến PIR, siêu âm hoặc cảm biến tiếp xúc vật lý.
device.state.Online trực tuyến Dành cho các 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 on Chức năng bật/tắt cơ bản dành cho mọi thiết bị có hai trạng thái bật và tắt, bao gồm ổ cắm, công tắc và nhiều thiết bị khác trong tương lai.
device.state.OpenClose openPercent Đối với các thiết bị hỗ trợ mở và đóng, và trong một số trường hợp, mở và đóng một phần hoặc có thể theo nhiều hướng.
device.state.Record isCurrentlyRecording Dành cho những thiết bị hỗ trợ ghi vào nội dung nghe nhìn.
device.state.Rotation rotationDegrees
rotationPercent
Dành cho những thiết bị hỗ trợ xoay, chẳng hạn như rèm cửa có thanh xoay.
device.state.RunCycle currentCycleRemainingTime
currentTotalRemainingTime
Dành cho những thiết bị có thời gian hoạt động liên tục có thể truy vấn được. 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à từng chu kỳ mà thiết bị đang thực hiện trong khi chạy.
device.state.SensorState currentSensorStateData.key
currentSensorStateData.value.currentSensorState
currentSensorStateData.value.rawValue
Kết quả đo lường 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í carbon monoxide mà máy dò khí carbon monoxide đo được, v.v.
device.state.StartStop isPaused
isRunning
Dành cho những thiết bị hỗ trợ thao tác khởi động và dừng. Việc khởi động và dừng thiết bị có chức năng tương tự như bật và tắt thiết bị. Điều này cho biết rằng các 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), bên trong hoặc xung quanh thiết bị.
device.state.TemperatureSetting activeThermostatMode
thermostatHumidityAmbient
thermostatMode
thermostatTemperatureAmbient
thermostatTemperatureSetpoint
thermostatTemperatureSetpointHigh
thermostatTemperatureSetpointLow
Dành cho những thiết bị hỗ trợ các điểm và chế độ nhiệt độ.
device.state.Timer timerPaused Dành cho những thiết bị 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 lệnh này để hỏi thiết bị xem còn bao nhiêu thời gian trên đồng hồ hẹn giờ.
device.state.Volume currentVolume
isMuted
Đối với các 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 đến những thành viên được chỉ định trong nhà bằng địa chỉ email của họ.
home.state.HomePresence homePresenceMode
not Một điều kiện để biểu thị logic NOT của một điều kiện khác.
hoặc Một điều kiện phức hợp để biểu thị logic OR của tất cả các điều kiện con.
time.between Đại diện cho một phạm vi thời gian.
time.delay Thêm một khoảng tạm dừng trong quá trình thực thi quy trình tự động hoá.
time.schedule Biểu thị một sự kiện trong lịch biểu.