支持的启动方式、条件和操作

自动化操作支持以下启动方式和操作。所有州也 支持用作条件。

状态/事件(启动器)
条件
命令(操作)
支持的字段 说明
一个复合条件,用于表示所有子条件之间的逻辑与。
assistant.command.Broadcast 消息
assistant.command.OkGoogle okGoogle
assistant.event.OkGoogle 查询
device.command.ActivateScene 启用 启用或停用场景。
device.command.AppInstall newApplicationName 在给定设备上安装应用。
device.command.AppSearch applicationName 搜索给定应用。
device.command.AppSelect applicationName 选择给定应用。
device.command.ArmDisarm arm
armLevel
cancel
设置设备的闹钟等级。
device.command.BrightnessAbsolute 亮度 调整设备绝对亮度。当亮度设置为大于 0 的任何值时,如果设备处于关闭状态,则会开机,并且 [`OnOffState.state`](./on_off_state) 会更改为反映设备处于开启状态。同样,当亮度设置为 0 时,设备会关机,[`OnOffState.state`](./on_off_state) 也会相应地发生变化。
device.command.BrightnessRelative BrightRelativePercent
brightnessRelativeWeight
调整设备的相对亮度。当亮度设置为大于 0 的任何值时,如果设备处于关闭状态,则会开机,并且 [`OnOffState.state`](./on_off_state) 会更改为反映设备处于开机状态。同样,当亮度设置为 0 时,设备会关机,[`OnOffState.state`](./on_off_state) 也会相应地发生变化。
device.command.Charge 充电 开始或停止充电。
device.command.ColorAbsolute color.name
color.spectrumHSV.hue
color.spectrumHSV.saturation
color.spectrumHSV.value
color.spectrumRGB
color.temperature
将颜色设为指定的色调。在关机的设备上设置颜色后,设备开机,[`OnOffState.state`](./on_off_state) 会发生变化以反映这一点。同样,当亮度设置为 0 时,设备会关机,[`OnOffState.state`](./on_off_state) 也会相应地发生变化。
device.command.Cook cookingMode
foodPreset
quantity
start
unit
开始或停止烹饪。
device.command.Dispense amount
item
presetName
unit
分配物品。
device.command.Dock 将设备放入基座。
device.command.EnableDisableGuestNetwork 启用 启用或停用访客网络。
device.command.EnableDisableNetworkProfile enable
profile
启用或停用网络配置文件。必须使用 PIN 码进行第二层用户身份验证。如果通过这些命令停用其他安全设备,用户的住宅安全可能会被视为受影响。
device.command.Fill fill
fillLevel
将设备加水或排空。
device.command.FindMyDevice 静音 通过生成本地提醒找到目标设备。
device.command.HumidityRelative relativeHumidityPercent
relativeHumidityWeight
根据当前值调整湿度水平。
device.command.LightEffectColorLoop 时长 让设备循环显示一组颜色。
device.command.LightEffectPulse 时长 光强度从中等亮度增加到最大亮度,然后降至中等亮度,总周期时间为每秒一次。在每个周期内,最大亮度应持续 200 毫秒,中等亮度(不包括过渡期)应至少持续 500 毫秒。
device.command.LightEffectSleep 时长 在一段时间内,逐渐降低设备的亮度,还可以视需要改变色温。
device.command.LightEffectWake 时长 在一段时间内,逐步提高设备的亮度,并视需要改变色温。
device.command.LockUnlock 锁定或解锁设备。
device.command.MediaNext 跳至下一个媒体项。
device.command.MediaPause 暂停媒体播放。
device.command.MediaPrevious 跳至上一个媒体项。
device.command.MediaResume 继续播放媒体。
device.command.MediaShuffle 随机播放当前播放列表。
device.command.MediaStop 停止播放媒体。
device.command.Mute 静音 将指定设备静音或取消静音。
device.command.NextInput 切换到下一个输入源。
device.command.OnOff 开启 开启或关闭设备。
device.command.OpenClose openDirection
openPercent
设置设备的开合状态
device.command.PauseUnpause 暂停 暂停或取消暂停设备操作。
device.command.PreviousInput 切换到上一个输入源。
device.command.Reboot 重新启动设备。
device.command.RelativeChannel channelCount 将当前渠道调整一定的金额。
device.command.ReturnChannel 返回到用户之前所在的频道。
device.command.ReverseFan 调换风扇的方向。
device.command.RotateAbsolute rotationDegrees
rotationPercent
设置设备的绝对旋转角度。
device.command.SelectChannel channelCode
channelName
channelNumber
将当前渠道设置为特定值。
device.command.SetFanSpeed fanSpeed 设置风扇转速。
device.command.SetFanSpeedRelative fanSpeedRelativePercent
fanSpeedRelativeWeight
设置风扇的相对速度。
device.command.SetHumidity humidity 将湿度级别设置为绝对值。
device.command.SetInput newInput 设置媒体输入。
device.command.SetVolume volumeLevel 设置指定设备的音量。
device.command.StartStop start 启动或停止设备。
device.command.StopLightEffect 停止当前的灯光效果。
device.command.ThermostatSetMode thermostatMode 为温控器设备设置目标操作模式。
device.command.ThermostatTemperatureSetpoint thermostatTemperatureSetpoint 为温控器设备设置目标温度。
device.command.ThermostatTemperatureSetRange 温控器 TemperatureSetpointHigh
thermostatTemperatureSetpointLow
为温控器设备设置目标温度范围。
device.command.TimerAdjust 时长 调整定时器时长。
device.command.TimerCancel 取消计时器。
device.command.TimerPause 暂停计时器。
device.command.TimerResume 恢复计时器。
device.command.TimerStart 时长 启动一个新计时器。
device.event.AnimalCatDetection 摄像头检测到猫。
device.event.AnimalDogDetection 摄像头检测到狗。
device.event.AnimalOtherDetection 摄像头检测到动物。
device.event.DoorbellPress 有人按了门铃。
device.event.FaceFamiliarDetection 摄像头检测到熟面孔。
device.event.FaceUnfamiliarDetection 摄像头检测到生面孔。
device.event.MotionDetection 设备检测到移动。
device.event.MovingVehicleDetection 摄像头检测到有车辆正在行驶中。
device.event.PackageDelivered 摄像头检测到已提交的包裹。
device.event.PersonDetection 摄像头检测到有人。
device.event.PersonTalking 设备检测到人说话的声音。
device.event.Sound 设备检测到声音。
device.state.AppSelector currentApplication 适用于能够在应用之间切换的设备。
device.state.ArmDisarm currentArmLevel
isArmed
对于支持开启和关闭报警器的安防系统等设备,此属性表示设备处于开启还是关闭状态。
device.state.Brightness 亮度 设备的亮度设置。
device.state.Channel 适用于支持媒体设备上频道的设备。
device.state.ColorSetting color.colorTemperature
color.spectrumHsv.hue
color.spectrumHsv.saturation
color.spectrumHsv.value
color.spectrumRgb
颜色设置的状态。
device.state.Cook currentCookingMode
currentFoodPreset
适用于可根据各种食材预设和支持的烹饪模式烹饪食物的设备。
device.state.Dock isDocked 对于可接收指令返回充电的自主移动设备。
device.state.EnergyStorage descriptiveCapacityRemaining
isCharging
isPluggedIn
能量存储设备(如电池)的状态,包括它存储的能量量、它是否在充电以及是否已插入。
device.state.FanSpeed currentFanSpeedPercent
currentFanSpeedSetting
适用于支持设置风扇速度的设备。
device.state.Fill currentFillLevel
currentFillPercent
isFilled
适用于支持加油功能的设备,例如浴缸。
device.state.HumiditySetting humidityAmbientPercent
humiditySetpointPercent
适用于支持湿度设置的设备,例如加湿器和除湿器。
device.state.InputSelector currentInput 允许查询能够切换输入的设备。 每个设备的媒体输入都可以具有表示音频或视频 Feed 的动态名称。这些 Feed 可以有固定的或联网的,但它们应具有一定的命名,并且具有一定的持久性。这不支持任意的临时 Feed,例如可搜索的网络库。支持已配对的已命名蓝牙来源。来源可以有多个名称,因此支持用户创建的名称和发现的名称,以及默认名称;例如,“hdmi_1”也可能是“DVD 播放器”,或“usb_1”也可能是“硬盘”。 媒体输入可排序以支持“下一步”和“previous”命令。 注意:InputSelector 不支持查询语法。
device.state.LightEffects activeLightEffect 对于可以支持复杂照明命令来更改状态的设备,例如循环展示不同颜色的灯光。
device.state.LockUnlock isJammed
isLocked
适用于支持锁定和解锁和/或报告锁定状态的设备。
device.state.MediaState playbackState 对于播放媒体的设备,媒体的状态,例如是否正在播放。
device.state.MotionDetection motionDetectionEventInProgress 适用于可侦测移动的设备。
device.state.OccupancySensing 入住人数 对于可以检测有人在场(无论是通过 PIR、超声波还是物理接触感知)的设备。
device.state.Online 在线 适用于支持在线和离线状态和/或报告在线和离线状态的设备。
device.state.OnOff 开启 适用于具有二进制开启和关闭功能的任何设备(包括插头和开关,以及许多未来的设备)的基本开启和关闭功能。
device.state.OpenClose openPercent 适用于支持打开和关闭(在某些情况下支持部分打开和关闭)或可能沿多个方向打开和关闭的设备。
device.state. 记录 isCurrentlyRecording 适用于支持录制到媒体内容的设备。
device.state.Rotation rotationDegrees
rotationPercent
适用于支持旋转的设备,例如带有可旋转窗叶的百叶窗。
device.state.RunCycle currentCycleRemainingTime
currentTotalRemainingTime
适用于具有持续操作时长(可以查询)的设备。 此类设备会在操作开始时报告其总周期数,以及设备当前正在运行的每个周期。
device.state.SensorState currentSensorStateData.key
currentSensorStateData.value.currentSensorState
传感器生成的测量结果。例如,烟雾检测器测量到的烟雾量,或一氧化碳检测器测量的一氧化碳量等等。
device.state.StartStop isPaused
isRunning
适用于支持开始和停止操作的设备。 启动和停止设备的功能与开启和关闭设备类似。这表示设备在开启和启动后会以不同的方式运行。例如,有些洗衣机在实际开始运行之前可以打开并修改其设置。
device.state.TemperatureControl 温度环境
温度设置值
控制温控器以外的设备(例如烤箱)在设备内或设备周围的温度。
device.state.TemperatureSetting ActiveThermostatMode
thermostatHumidityAmbient
thermostatMode
thermostatTemperatureAmbient
thermostatTemperatureSetpoint
thermostatTemperatureSetpointHigh
thermostatTemperatureSetpointLow
适用于支持温度点和模式的设备。
device.state.Timer timerPaused 适用于支持计时器功能的设备。例如,智能洒水器控制器或智能灯开关可能具有内置计时器。此字段可用于查询设备计时器还剩多长时间。
device.state.Volume currentVolume
isMuted
适用于可调节音量(例如,将音量设置为特定级别、静音或取消静音)的设备。
home.command.Notification body
members
title
向指定的住宅成员发������知。
home.state.HomePresence homePresenceMode
用于表示另一个条件的逻辑 NOT 的条件。
一个复合条件,表示所有子条件的逻辑 OR。
time.between 表示时间范围。
time.delay 在自动化操作执行期间添加暂停。
time.schedule 表示时间表事件。