欢迎使用 Google Home 开发者中心,您可以在这里学习有关如何开发智能家居 Action 的新平台。注意:你将继续在 Actions 控制台中构建操作。

智能家居设备特征

使用集合让一切井井有条 根据您的偏好保存内容并对其进行分类。

设备类型的功能取决于您为每种设备类型添加的特征。每种设备类型都有许多推荐的特征,但您可以根据需要添加任意特征。所有设备特征都支持第二层用户身份验证

请参阅所有特征的支持的语言列表。

名称 设备特征 说明 推荐的设备类型
AppSelector action.devices.traits.AppSelector 此特征属于支持媒体应用的设备(通常来自第三方)。 媒体设备,支持启动、安装和搜索设备上运行的应用。
ArmDisarm action.devices.traits.ArmDisarm 此特征支持在安防系统等环境中开启报警器/关闭报警器。 安防系统或任何支持开启和关闭报警器的设备。
Brightness action.devices.traits.Brightness 绝对亮度设置在 0 到 100 的标准化范围内(单个灯可能不支持其 LED 配置范围内的每个点)。
CameraStream action.devices.traits.CameraStream 此特征属于能够将视频画面流式传输到第三方屏幕、连接到 Chromecast 的屏幕或智能手机的设备。大体而言,这些是监控摄像头或婴儿摄像头。但此特征也适用于带有摄像头的更复杂的设备(例如视频会议设备或带有摄像头的真空机器人)。 相机
Channel action.devices.traits.Channel 此特征属于在媒体设备上支持电视频道的设备。 TV 设备
ColorSetting action.devices.traits.ColorSetting 此特征适用于可以更改颜色或色温的设备(如智能灯)。
ColorSpectrum action.devices.traits.ColorSpectrum 这适用于采用 RGB 颜色范围的“完整”灯泡。灯可能具有 ColorSpectrum 和 ColorTemperature 的任意组合;强调色灯和 LED 灯条可能只有 Spectrum 版本,而一些阅读灯泡只有 Temperature 标签。基本灯泡或智能插头上的哑光灯也没有。
色温 action.devices.traits.ColorTemperature 这适用于以开尔文为单位采用颜色点的“暖”灯泡。这通常与 ColorSpectrum 是不同的模态,而且温度可能有一些白点无法通过 Spectrum 覆盖。Google 会根据可用的特征,根据要求和灯具类型使用合适的模式(例如,“把客厅灯设为白色”可能会向一些灯泡发送温度指令,向 LED 灯条发出光谱命令)。
烹饪 action.devices.traits.Cook 此特征属于可以根据各种食物预设和受支持的烹饪模式烹饪食物的设备。 支持烹饪各种食物的设备。
配送 action.devices.traits.Dispense 此特征属于支持分配指定数量的一个或多个实体物品的设备。例如,狗粮分配器可能会分配多种零食,水龙头可能会分配水杯,而宠物喂食器可能会同时分配水和宠物食品。 支持分发指定数量的一个或多个实体商品的设备。
Dock action.devices.traits.Dock 此特征专为可发出返回充电命令的自移动设备而设计。 真空吸尘器
能源存储 action.devices.traits.EnergyStorage 此特征属于可将电池存储在电池中且可能会充电的设备,或可为其他设备充电的设备。此特征支持开始和停止充电,以及检查当前电量、剩余容量和容量,直到充满电为止。 可充电的设备。
FanSpeed action.devices.traits.FanSpeed 此特征属于支持设置风扇转速(即从不同级别吹出设备空气,可能属于空调或供暖装置,或位于汽车内)的设备,采用“低”、“中”和“高”等设置。
Fill action.devices.traits.Fill 此特征适用于支持灌溉设备,例如浴缸。 任何支持饮水的设备,例如浴缸。
湿度设置 action.devices.traits.HumiditySetting 此特征属于支持湿度设置的设备,例如加湿器和除湿器。 任何支持湿度设置的设备,例如加湿器或除湿器。
InputSelector action.devices.traits.InputSelector 可更改媒体输入的设备的特征。这些输入设备可以为每个设备动态名称,并且可以表示音频或视频 Feed,有线或网络。 任何支持切换输入的媒体设备。
LightEffects action.devices.traits.LightEffects 此特征属于可支持复杂光照命令以更改状态(例如循环播放各种颜色)的设备。
定位工具 action.devices.traits.Locator 此特征用于可“找到”的设备。包括手机、机器人(包括吸尘器和割草机)、无人机以及附加到其他设备的标签专用产品。 任何需要定位的设备,例如机器人真空吸尘器
LockUnlock action.devices.traits.LockUnlock 此特征属于支持锁定和解锁和/或报告锁定状态的所有设备。 任何支持锁定和解锁和/或报告锁定状态的设备。
MediaState action.devices.traits.MediaState 此特征用于能够报告媒体状态的设备。 能够报告媒体状态的任何媒体设备
Modes action.devices.traits.Modes 此特征属于具有任意数量“双向”模式的任何设备,其中每种模式的模式和设置对每种设备或设备类型来说都是任意且唯一的。每种模式都有多种可能的设置,但一次只能选择一种;烘干机无法同时处于“精致”、“正常”和“重型”模式。简单地开启或关闭某项设置属于切换开关特征。 不限
NetworkControl action.devices.traits.NetworkControl 此特征属于支持报告网络数据和执行网络特定操作的设备。 可以报告网络数据并执行网络特定操作的设备。
对象检测 action.devices.traits.ObjectDetection 此特征属于可以检测对象或人物并向用户发送通知的设备。例如,门铃可用于指示门铃是否有人(无论是否命名)响铃,以及摄像头和传感器可以检测物件或来访者的移动。 可检测对象或用户并向用户发送通知的设备。
OnOff action.devices.traits.OnOff 具有开/关二进制文件的所有设备的基本开启和关闭功能,包括插头和开关,以及许多日后推出的设备。
OpenClose action.devices.traits.OpenClose 此特征属于支持打开和关闭,以及部分打开和关闭(可能有多个方向)的设备。例如,有些百叶窗可能会向左或向右打开。在某些情况下,打开某些设备可能是一项安全敏感性操作,可能需要双重身份验证。请参阅双重身份验证 任何支持打开和关闭的设备。
重新启动 action.devices.traits.Reboot 此特征属于支持重新启动的设备,例如路由器。设备需要支持作为一项操作重新启动。 任何支持重新启动的设备。
轮播 action.devices.traits.Rotation 此特征属于支持旋转的设备,例如具有可旋转的板条的百叶窗。 支持旋转的设备,例如带可旋转的板条的百叶窗。
RunCycle action.devices.traits.RunCycle 此特征表示可以持续查询且可以查询的任何设备。这包括但不限于按周期运作的设备,例如洗衣机、烘干机和洗碗机。 任意 - 大多为运行状态的设备和其他设备
传感器状态 action.devices.traits.SensorState 此特征涵盖定量测量(例如空气质量指数或烟雾浓度)和定性状态(例如,空气质量是否良好,或者烟雾浓度是低还是高)。 提供定量测量(例如烟雾浓度)和定性状态(空气质量是否良好)的传感器
场景 action.devices.traits.Scene 对于场景,该类型会映射到特征 1:1,因为场景不会与其他特征组合以形成复合设备。 仅限场景
软件更新 action.devices.traits.SoftwareUpdate 此特征属于支持软件更新的设备,例如路由器。(可选)这些设备可能会报告上次成功更新的时间。 任何支持软件更新的设备。
StartStop action.devices.traits.StartStop 启动和停止设备提供与开启和关闭设备类似的功能。继承此特征功能的设备在开启和启动时的行为有所不同。与仅具有开启和关闭状态的设备不同,某些可以启动和停止的设备也可以在执行操作时暂停。 任何设备 - 大多为电器、吸尘器,以及有特定行为行为的电动设备等
状态报告 action.devices.traits.StatusReport 此特征会报告特定设备或已连接设备组的当前状态。 用于报告特定设备或已连接的设备组(如安全系统)的当前状态的通用特征
温度控制 action.devices.traits.TemperatureControl 设备内(温控器除外)的特征,设备支持在设备内部或周围控制温度。这包括烤箱和冰箱等设备。
TemperatureSetting action.devices.traits.TemperatureSetting 此特征涵盖处理温度点和模式。
定时器 action.devices.traits.Timer 计时器特征表示设备上的计时器,主要是烤箱和微波炉等厨房设备。但不限于这些计时器。 任何带有计时器的设备,例如微波炉或烤箱等厨房设备。
Toggles action.devices.traits.Toggles 此特征属于设置只能处于两种状态之一的任何设备。这些设置可以表示具有开启/关闭或有效/无效状态的物理按钮、HTML 中的复选框或任何其他类型的专门启用/停用的元素。 不限
TransportControl action.devices.traits.TransportControl 此特征支持能够控制媒体播放的媒体设备(例如,恢复已暂停的音乐)。 设备支持与第三方设备进行双向音频通信。
Volume action.devices.traits.Volume 此特征属于能够更改音量的设备(例如,将音量设置为特定级别、静音或取消静音)。 能够调节音量的媒体设备。

支持的语言

上述所有特征均支持以下语言:

  • 丹麦语 (da)
  • 荷兰语 (nl)
  • 英语 (en)
  • 法语 (fr)
  • 德语 (de)
  • 印地语 (hi)
  • 印度尼西亚语 (id)
  • 意大利语 (it)
  • 日语 (ja)
  • 韩语(ko
  • 挪威语 (no)
  • 葡萄牙语 (pt-BR)
  • 西班牙语 (es)
  • 瑞典语 (sv)
  • 泰语 (th)
  • 中文(zh-TW