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

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

状态 / 事件(启动方式)
条件
命令(操作)
支持的字段 说明
和 表示所有子条件的逻辑“与”的复合条件。
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 brightnessRelativePercent
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 设置媒体输入。
设备.命令.设置音量 volumeLevel 设置指定设备的音量。
device.command.StartStop start 启动或停止设备。
device.command.StopLightEffect 停止当前的灯光效果。
device.command.ThermostatSetMode thermostatMode 为温控器设备设置目标运行模式。
device.command.ThermostatTemperatureSetpoint thermostatTemperatureSetpoint 设置温控器设备的目标温度。
device.command.ThermostatTemperatureSetRange thermostatTemperatureSetpointHigh
thermostatTemperatureSetpointLow
为温控器设备设置目标温度范围。
device.command.TimerAdjust 时长 调整定时器时长。
device.command.TimerCancel 取消定时器。
device.command.TimerPause 暂停定时器。
device.command.TimerResume 恢复定时器。
device.command.TimerStart 时长 启动新定时器。
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”也可能是“硬盘”。 可以对媒体输入进行排序,以支持“下一个”和“上一个”命令。 注意: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.Record isCurrentlyRecording 适用于支持录制到媒体的设备。
device.state.Rotation rotationDegrees
rotationPercent
用于支持旋转的设备,例如带有可旋转板条的百叶窗。
device.state.RunCycle currentCycleRemainingTime
currentTotalRemainingTime
适用于操作持续时间可查询的设备。 此类设备会在开始运行时报告其总周期数,并在运行期间报告设备当前所处的每个周期。
device.state.SensorState currentSensorStateData.key
currentSensorStateData.value.currentSensorState
currentSensorStateData.value.rawValue
传感器生成的测量值。例如,烟雾检测器测量的烟雾量,或一氧化碳检测器测量的一氧化碳量等。
device.state.StartStop isPaused
isRunning
适用于支持启动和停止操作的设备。 启动和停止设备的功能与开启和关闭设备的功能类似。它表示设备在开启和启动时的功能不同。例如,某些洗衣机可以在实际开始运行之前开机并修改设置。
device.state.TemperatureControl temperatureAmbient
temperatureSetpoint
控制温控器以外的设备(例如烤箱)内部或周围的温度。
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 表示另一个条件的逻辑 NOT 的条件。
或 一个复合条件,表示所有子条件的逻辑 OR。
time.between 表示时间范围。
time.delay 在自动化操作执行过程中添加暂停。
time.schedule 表示时间表事件。