欢迎使用 Google Home 开发者中心,这是一个学习如何开发智能家居 Action 的新平台。注意:构建 Action 的工作仍需在 Actions 控制台中完成。

智能家居设备特征

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

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

名称 设备特征 说明 推荐的设备类型
AppSelector action.devices.traits.AppSelector 此特征属于支持媒体应用的设备(通常来自第三方)。 支持启动、安装和搜索在设备上运行的应用的媒体设备。
ArmDisarm action.devices.traits.ArmDisarm 此特征支持安防系统(例如安全系统)中的报警器和报警器。 安防系统或任何支持开启和关闭报警器的设备。
Brightness action.devices.traits.Brightness 绝对亮度设置为 0 到 100 之间的标准化范围(根据光源的配置,单个灯可能不支持范围内的每个点)。
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 灯条可能只有频谱,而一些阅读灯泡只有温度。基本灯泡或智能插座上的哑光灯也没有。
ColorTemperature(色温) action.devices.traits.ColorTemperature 这适用于以开尔文为颜色点的“温暖”灯泡。这通常与 ColorSpectrum 是一个单独的模态,并且可能具有 Spectrum 无法到达的通过温度可用的白色点。Google 可能会根据可用的特征,根据请求和灯类型选择合适的模式(例如,把客厅的灯设为白色)。
烹饪 action.devices.traits.Cook 此特征属于可以根据各种食材预设和支持的烹饪模式烹饪食物的设备。 支持烹饪各种食品的设备。
拒绝 action.devices.traits.Dispense 此特征属于支持分配指定数量的一个或多个实体设备的设备。例如,狗粮分配器可能会分配多种零食,水龙头可能会分配杯水,而宠物喂食器可能会同时分配水和宠物食品。 支持分配一定数量的物理物品的设备。
Dock action.devices.traits.Dock 此特征专为可指示返回充电的移动设备而设计。 吸尘器
EnergyStorage action.devices.traits.EnergyStorage 此特征属于可将电池存储在电池中且可能充电的设备,或可以为其他设备充电的设备。该特征支持开始和停止充电,并检查当前电量、剩余容量和容量,直到充满电为止。 可给电池充电的设备。
FanSpeed action.devices.traits.FanSpeed 此特征属于支持设置风扇转速(即从各层吹出设备风扇,可能属于空调、供暖装置或汽车)的设备,并且具有“低”、“中”和“高”等设置。
Fill action.devices.traits.Fill 此特征适用于支持加水的设备,例如浴缸。 任何支持加水的设备,例如浴缸。
HumiditySetting action.devices.traits.HumiditySetting 此特征属于支持湿度设置的设备,例如加湿器和除湿器。 任何支持湿度设置的设备,例如加湿器或除湿器。
输入选择器 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 此特征属于具有任意数量“N-Way”模式的设备,其中每种模式的模式和设置对于各种设备或设备类型而言都是任意的。每种模式都可能有多个设置,但一次只能选择一项设置;烘干机不能同时处于“柔软”“普通”和“重”模式。只需开启或关闭开关的设置就属于切换开关特征。 不限
NetworkControl action.devices.traits.NetworkControl 此特征属于支持报告网络数据和执行网络特定操作的设备。 可以报告网络数据并执行网络特定操作的设备。
ObjectDetection action.devices.traits.ObjectDetection 此特征属于可检测对象或人物并向用户发送通知的设备。例如,门铃可用于检测门铃是否表明有人拨打了(无论是否未命名)门铃,以及用于检测附近物体或人移动的摄像头和传感器。 可检测对象或用户并向用户发送通知的设备。
在家/外出感知 action.devices.traits.OccupancySensing 此特征属于可检测在家/外出情况的设备(无论是通过 PIR、超声波传感器还是物理接触感应功能)。 可通过 PIR、超声波或物理接触感应功能检测在家/外出情况的设备。
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)