设备支持来自 Google Home 生态系统或 Matter 规范中的一个或多个 trait,可在设备上启用特定功能。如需详细了解设备类型,请参阅数据模型。
表键:
- matter 表示 trait 来自 Matter 标准。
- google 表示 trait 来自 Google 智能家居。
- 示例应用表示是否已在相应设备类型的示例应用中实现了设备状态或设备的受限控制(包括读取和写入状态)。系统会为每种设备类型列出特定的设备控制功能(如果有)。
- 用例表示 Home API 设备类型映射到的 Google Home 生态系统中的设备类型(如 Google Home 应用中显示的,并在用例页面上展示)。
Home API 支持以下设备及其关联的特征:
Home API 设备类型 | trait | 示例应用 | 使用场景 |
---|---|---|---|
空气净化器一种用于净化室内空气的设备。 |
必需的特征 matter Identify matter Fan Control |
空气净化器 | |
空气质量传感器能够监控和测量室内和室外环境中与空气质量相关的各种参数的设备。 |
必需的特征 matter Identify matter Air Quality matter Temperature Measurement matter Relative Humidity Measurement matter Carbon Monoxide Concentration Measurement matter Carbon Dioxide Concentration Measurement matter Nitrogen Dioxide Concentration Measurement matter Ozone Concentration Measurement matter Pm25 Concentration Measurement matter Formaldehyde Concentration Measurement matter Pm1 Concentration Measurement matter Pm10 Concentration Measurement matter Total Volatile Organic Compounds Concentration Measurement matter Radon Concentration Measurement |
传感器 | |
接触传感器用于检测门窗等对象的开关状态的设备。 |
必需的 trait matter Identify matter 布尔值状态 |
布尔值状态 |
传感器 |
流量传感器用于测量和报告流体流速的设备。 |
必需的特征 matter Identify matter 流量衡量 |
传感器 | |
湿度传感器报告湿度测量值的设备。 |
必需的特征 matter Identify matter 相对湿度测量 google 增强型风扇控制 google 相对湿度控制 google 增强型运行状态 |
传感器 | |
光传感器一种测量和感知设备,能够测量和报告传感器所受光照强度(光照度)。 |
必需的特征 matter Identify matter Illuminance Measurement |
传感器 | |
在家/外出传感器一种测量和感知设备,能够测量和报告指定区域内的占用状态。 |
必需的特征 matter Identify matter Occupancy Sensing |
在家/外出感知 |
传感器 |
开/关传感器测量和感知设备,当绑定到照明设备时,可用于开启或关闭设备。 |
必需的特征 matter Identify |
传感器 | |
压力传感器用于测量和报告流体压力的设备。 |
必需的特征 matter Identify matter Pressure Measurement |
传感器 | |
雨量传感器用于报告是否下雨的设备。 |
必需的 trait matter Identify matter 布尔值状态 |
传感器 | |
温度传感器报告温度测量结果的设备。 |
必需的特征 matter Identify matter Temperature Measurement |
传感器 | |
冻结水检测器用于报告可能冻结的水的设备。 |
必需的 trait matter Identify matter 布尔值状态 |
传感器 | |
漏水检测器用于报告是否存在漏水的设备。 |
必需的 trait matter Identify matter 布尔值状态 |
传感器 | |
基本视频播放器能够将媒体播放到实体输出设备或设备的显示屏的设备。它具有用于播放的基本控件(例如播放或暂停)和键盘输入(向上、向下、数字输入)。 |
必需的特征 重要 开启/关闭 重要 媒体播放 重要 键盘输入 matter Messages matter WakeOnLan matter Channel matter Target Navigator matter Media Input matter Low Power matter Audio Output |
TV | |
投放视频播放器能够将媒体播放到实体输出设备或设备的显示屏,并且能够启动内容的设备。它具有播放基本控件(例如播放或暂停)和键盘输入控件(向上、向下、数字输入)。 |
必需的特征 重要 开启/关闭 重要 媒体播放 重要 键盘输入 重要 内容启动器 matter Messages matter WakeOnLan matter Channel matter Target Navigator matter Media Input matter Low Power matter Audio Output matter Application Launcher matter Account Login |
TV | |
TV结合了调谐器、显示屏和扬声器的设备,用于观看和收听媒体。 |
可选 trait
google Extended Application Launcher matter Channel google Extended Channel google Extended Media Input matter Media Playback google Extended Media Playback google Media Activity State matter 开启/关闭 matter Level Control google Extended Level Control |
TV | |
投放视频客户端能够在远程设备上启动内容的设备,例如智能音箱或 content provider 的手机应用。 |
流媒体棒 | ||
流媒体棒此类设备具有小型棒状外形规格,通常由连接到显示设备(如电视)的 USB 或 HDMI 电缆供电,用于访问媒体和音乐的数字在线播放服务。 |
流媒体棒 | ||
彩色调光开关能够通过调整色温和亮度来控制照明设备的设备。 |
必需的特征 重要 识别 |
开关 | |
调光开关能够开启或关闭设备并控制灯光强度的设备。 |
必需的特征 重要 识别 |
开关 | |
通用开关能够通过锁定(例如摇杆开关)或瞬时(例如按钮)开启或关闭的设备。 |
必需的特征 matter Identify matter Switch |
开关 | |
色温灯可开启或关闭、调节光强度和色温的照明设备。 |
必需的特征 matter Identify matter 开/关 matter 亮度控制 matter 颜色控制 |
开启和关闭、亮度 |
浅色 |
可调光灯可开启或关闭、调节亮度以及通过绑定的有人/无人传感器进行开关的照明设备。 |
必需的特征 重要 标识 重要 开/关 重要 音量控制 |
开启和关闭、亮度 |
浅色 |
扩展色彩灯可通过绑定的入住传感器开启或关闭、调节亮度和色温,以及切换的照明设备。 |
必需的特征 重要 标识 重要 开/关 重要 亮度控制 重要 颜色控制 |
开启和关闭、亮度 |
浅色 |
开/关指示灯可开启或关闭的照明设备。 |
必需的特征 matter Identify matter 开启/关闭 |
开启和关闭、亮度 |
浅色 |
炉灶表示烹饪设备或其他类似设备上的加热对象的设备。 |
灶台 | ||
嵌入式灶具表示具有一个或多个加热元件的烹饪表面的设备。 |
必需的特征 matter 开启/关闭 matter Identify google Cook google Timer |
灶台 | |
可调光插入式装置能够通过绑定的控制器设备(例如调光开关或彩色调光开关)开启或关闭,并调节其亮度的设备。 |
必需的特征 重要 标识 重要 开/关 重要 音量控制 |
插座 | |
开/关插入式装置可通过已绑定的控制器设备(例如开/关型灯具开关或调光开关)开启或关闭的设备。 |
必需的特征 matter Identify matter 开启/关闭 |
开启和关闭 |
插座 |
洗碗机用于清洗餐具、刀叉和其他与食物准备和食用相关的物品的设备。 |
必需的特征 matter 操作状态 matter Identify matter On/Off matter Temperature Control matter Dishwasher Mode matter Dishwasher Alarm google Extended Operational State google Extended Temperature Control |
洗碗机 | |
门锁能够控制门锁的设备。 |
必需的特征 matter Identify matter Door Lock |
锁定 | |
Energy Evse能够为电动车辆或插电式混合动力车辆充电的设备。 |
必需的特征 matter Energy Evse matter Energy Evse Mode matter 识别 matter 温度测量 google “Extended Mode”选择 google “Extended Power Source” |
充电器 | |
充电器用于为电力储存电池充电的设备。与充电器的交互可能包括开始和停止充电,以及检查当前充电电量、剩余电量和充满电量值。 |
充电器 | ||
抽油烟机通常安装在炉灶或灶台上方的设备,用于抽取空气以减少异味和烟雾。 |
必需的特征 matter 风扇控制 matter Identify matter Hepa Filter Monitoring matter Activated Carbon Filter Monitoring google Extended Fan Control |
油烟机 | |
风扇具有风扇且支持多种模式和可变速度的设备。 |
必需的特征 matter Identify matter Fan Control |
风扇 | |
空冷器一种可控制温度和湿度的设备。这些设备通常比空调更轻便、更便携,并且带有水箱。空冷器可能不支持加热或设置精确温度。与空冷器的交互可能包括改变风扇速度和温度设置。 |
必需的特征 matter 开启 关闭 |
空冷器 | |
音频视频接收器
接收音频输入(例如 HDMI、光纤和 RCA)并将声音输出到一个或多个音箱的设备。 |
可选 trait
google Extended Application Launcher google Extended Media Input matter Media Playback google Extended Media Playback google Media Activity State matter 开启/关闭 matter Level Control google Extended Level Control |
AV 视频接收器 | |
自动
|
自动 | ||
浴缸可注水和排水的设备,如果浴缸支持,可以将水位保持在特定水平。 |
浴缸 | ||
搅拌器一种厨房电器设备,用于搅拌、切碎或混合食物。与搅拌机的交互可能包括开始和停止、设置计时器、设置烹饪模式或食材预设,或者调整其他各种设置。 |
必需的特征 matter 开启/关闭 google Cook google Timer matter 操作状态 google Extended Operational State |
Blender | |
电水壶一种由密闭容器和热源组成的设备,其中会通过水产生蒸汽或其他蒸气来供热。锅炉可以开启和关闭,可能支持调节温度。 |
可选 trait
matter Temperature Control matter Temperature Measurement google Extended Temperature Control matter On Off |
锅炉 | |
壁橱一种由小型封闭区域组成的设备,用于存放物品。壁橱可以打开和关闭,并且打开和关闭的方向可能不止一个。 |
壁橱 | ||
咖啡机一种用于制作咖啡的厨房电器设备。与咖啡机的交互可能包括开启和关闭、调整烹饪模式和食材预设、调整目标温度以及调整各种非烹饪模式设置。 |
必需的特征 matter 开启 关闭 matter 温度控制 google Cook matter 温度测量 google 增强型温度控制 |
咖啡机 | |
控制台能够配置和控制其他设备的设备。 |
必需的 trait google 电梯控制 google 停车位置 |
控制台 | |
脱水器一种厨房电器设备,用于脱干水果和蔬菜等食品。与脱水器的交互可能包括开始和停止、设置计时器、调整烹饪模式或食材预设,或者调整其他各种设置。 |
必需的特征 matter 开启/关闭 google Cook google Timer matter 操作状态 google Extended Operational State |
脱水器 | |
门一种由门外按钮触发的设备,可发出声音和/或视觉信号,用于吸引门另一侧某个位置的人员的注意。此设备可能能够发送通知和/或流式传输视频。 |
门 | ||
门铃一种由门外按钮触发的设备,可发出声音和/或视觉信号,用于吸引门另一侧某个位置的人员的注意。此设备可能能够发送通知和/或流式传输视频。 |
必需 trait google 门铃按钮 google 剪辑 google 录制 google 物体检测 |
门铃 | |
抽屉式导航栏一种由无盖滑动式水平隔间组成的设备,可从家具或墙壁中拉出以便使用。抽屉可以打开和关闭,并且打开和关闭的方向可能不止一个。 |
抽屉 | ||
水龙头用于控制液体流动的设备。水龙头可以以各种量和预设方式分配液体。水龙头可能具有各种模式,每种模式都有自己的相关设置。这些设置特定于水龙头,并且以通用形式进行解释。 |
Faucet | ||
冷柜温度管理设备,可以根据各种模式设置进行调整,可能支持温度监控。 |
必需的特征 matter 温度控制 matter 温度测量 google 增强型温度控制 |
冷冻柜 | |
炸锅一种厨房电器设备,通过油炸来烹饪食物。与炸锅的交互可能包括开始和停止、设置计时器、调整烹饪模式或食材预设,或者调整其他各种设置。 |
必需的特征 matter 开启/关闭 google Cook google Timer matter 操作状态 google Extended Operational State |
炸锅 | |
游戏机用于管理和玩视频游戏的设备。与游戏机的互动包括玩游戏和操作设备控件。 |
必需的特征 matter 开启 关闭 google 扩展应用启动器 google 扩展媒体输入 matter 媒体播放 google 扩展媒体播放 google 媒体 activity 状态 matter 音量控制 google 扩展音量控制 |
游戏机 | |
车库一种由坚固的可移动屏障组成的设备,用于控制车库的出入。车库门可以打开、关闭,还可以检测打开状态。它们还可以指示门在关闭时是否有物体挡住了门的路径,或者门是否已锁定而无法控制。 |
车库 | ||
登机口一种由坚固的可移动屏障组成的设备,用于控制通过围栏或墙壁进入外部区域的权限。大门可以打开和关闭,并且打开和关闭的方向可能不止一个。 |
Gate | ||
烧烤一种设备,用于通过从下方直接加热来在网格上烹饪食物。与烧烤炉的交互可能包括开启和关闭、开始和停止、设置计时器、调整烹饪模式和食材预设,以及调整各种非烹饪模式设置。 |
烧烤 | ||
烧水壶一种设备,用于烧开水以制作茶等热饮料。与烧水壶的交互可能包括开启和关闭、调整目标温度,可能还包括调整各种模式设置。 |
必需的特征 matter 开启/关闭 matter 温度控制 matter 温度测量 google 增强型温度控制 |
电热水壶 | |
拖把一种通过湿润和擦洗地板来清洁地板的设备。 |
必需的 trait google Dock |
Mop | |
割草机一种用于将草坪修剪成统一高度的设备。与割草机的交互可能包括开始、停止和暂停割草、插入基座、检查当前周期、定位割草机以及调整各种模式。 |
割草机 | ||
多功能锅一种设备,用于使用各种方法(包括慢炖、炒、蒸或高压烹饪)烹饪食物,通常无需人工看管。与多功能炊具的交互可能包括开始和停止、设置计时器或调整非烹饪模式。 |
必需的特征 matter 开启 关闭 google Cook google Timer matter 操作状态 google Extended Operational State |
多功能炊具 | |
网络表示作为一个实体而不是单个设备进行控制的一组路由器节点或网状网络的设备。网络设备可能会重新启动、更新其软件,并具有处理服务质量 (QoS) 控制和家长限制的模式。该设备可以执行诸如启用访客网络和报告网络特定信息(如当前互联网吞吐率)等操作。 |
必需的特征 google 网络控制 google 重新启动 google 软件更新 |
网络 | |
凉棚一种由水平棚架组成的凉亭,支撑在柱子或柱上,可以打开和关闭,并且打开和关闭的方向可能不止一个。例如,一些带帆布的凉棚可以左右两个方向打开。 |
凉棚 | ||
宠物喂食器一种自动向猫、狗等宠物投放食物的设备。与宠物喂食器的交互可能包括分配各种数量和预设的宠物食物或水。 |
宠物喂食器 | ||
高压锅一种厨房电器设备,可使用高压蒸汽在高温下快速烹饪食物。与高压锅的交互可能包括开始和停止、设置计时器、调整烹饪模式或食材预设,或者调整其他各种设置。 |
必需的特征 matter 开启/关闭 google Cook google Timer |
高压锅 | |
路由器用于控制两个或更多不同网络之间的网络流量的网络设备。路由器可以重新启动、更新其软件,具有处理服务质量 (QoS) 控制和家长限制的模式,可以执行网络特定操作(例如启用访客网络和报告当前互联网吞吐率等网络特定信息)。 |
必需的特征 google 网络控制 google 重新启动 google 软件更新 |
路由器 | |
安防系统用于监控建筑物中一个或多个传感器的设备,可在传感器检测到意外活动时发出提醒。安防系统的报警器可以开启和关闭。它们可以设置多种安全级别(例如“在家”和“外出”),并且可以报告特定传感器(例如检测到移动或窗户处于开启状态的传感器)的相关信息。 |
必需的特征 google 上锁/解锁 |
安防系统 | |
机顶盒连接到电视的设备,用于访问数字视频频道。与多渠道视频节目分销商 (MVPD) 和机顶盒设备的互动可能包括控制媒体播放。 |
必需的特征 重要 渠道 重要 开启 google 扩展应用启动器 google 扩展频道 matter 媒体播放 google 扩展媒体播放 google 媒体 activity 状态 matter 音量控制 google 扩展音量控制 |
机顶盒 | |
淋浴一种设备,由用于向身体喷水以进行清洗的区域组成。淋浴可以开启和关闭,可能支持调节温度。 |
淋浴 | ||
条形音箱一种一体化音频设备,通常与电视搭配使用,采用条状外形规格。 |
必需的特征 matter 开启 关闭 google 扩展应用启动器 google 扩展媒体输入 matter 媒体播放 google 扩展媒体播放 google 媒体 activity 状态 matter 音量控制 google 扩展音量控制 |
条形音箱 | |
真空低温烹饪一种厨房电器设备,用于在真空环境下以相对较低的温度烹饪食物。与真空低温烹饪机的交互可能包括开始和停止、设置计时器、调整烹饪模式或食材预设,或者调整其他各种设置。 |
必需的特征 matter 开启 关闭 google Cook google Timer matter 操作状态 google Extended Operational State |
真空低温烹饪机 | |
洒水器一种用于将水均匀分布在花园等区域的设备。洒水器可以开始和停止(或开启和关闭)。它们可能还支持计时器和/或时间表。 |
洒水器 | ||
台式搅拌机一种厨房电器,用于混合干燥和液体成分,以制作面糊或面团。与台式搅拌机的交互可能包括开启和关闭搅拌机、启动和停止搅拌机、调整烹饪模式或食材预设,或者调整各种非烹饪模式设置。 |
必需的特征 matter 开启 关闭 google Cook matter 运营状态 google 扩展的运营状态 |
台式搅拌机 | |
流媒体盒连接到电视的设备,用于访问媒体和音乐的数字在线播放服务,通常与电视等显示设备结合使用。 |
必需的特征 matter 开启/关闭 matter 渠道 google 扩展的应用启动器 google 扩展的渠道 google 扩展的媒体输入 matter 媒体播放 google 扩展的媒体播放 google 媒体 activity 状态 matter 音量控制 google 扩展的音量控制 |
流媒体盒 | |
流媒体条形音箱一种设备,由音箱和流媒体棒或流媒体盒组合而成,除了条形音箱功能外,还提供流媒体体验。 |
必需的特征 matter 开启 关闭 google 扩展应用启动器 google 扩展媒体输入 matter 媒体播放 google 扩展媒体播放 google 媒体 activity 状态 matter 音量控制 google 扩展音量控制 |
在线播放条形音箱 | |
净水器用于过滤和净化水的设备。 |
净水器 | ||
软水器用于从水中去除矿物质的设备。 |
软水器 | ||
窗口一种透明装置,可让光线进入结构。窗户可以打开和关闭,可选择在不同方向上打开各个部分,还可以锁定和解锁。 |
窗口 | ||
酸奶机一种用于制作酸奶的厨房电器设备。与酸奶机的交互可能包括开始和停止、设置计时器、调整烹饪模式或食材预设,或者调整其他各种设置。 |
必需的特征 matter 开启 关闭 google Cook google Timer matter 操作状态 google Extended Operational State |
酸奶机 | |
烘干机能够烘干衣物的设备。 |
必需的特征 matter 操作状态 matter Identify matter 开/关 matter 烘干机控件 matter 洗衣机模式 matter 温度控制 google Extended Operational State google Timer google Toggles |
烘干机 | |
洗衣机能够清洗消费类物品的设备。 |
必需的特征 matter 操作状态 |
洗衣机 | |
微波炉一种使用微波加热食物和饮料的设备。 |
必需的特征 重要 微波炉模式 重要 微波炉控制 重要 运行状态 matter 识别 matter 风扇控制 google “Extended Mode Select”(扩展模式选择) google 烹饪 google 计时器 |
微波炉 | |
烤箱一种包含一个或多个橱柜(可选配炉灶)且能够加热食物的设备。 |
烤箱 | ||
泵能够配置和控制水泵的设备。 |
必需的特征 重要 标识 重要 开/关 重要 泵配置和控制 matter Level Control matter Temperature Measurement matter Pressure Measurement matter Flow Measurement |
泵 | |
泵控制器能够配置和控制水泵的设备。 |
必需的特征 matter Identify |
泵 | |
冰箱包含一个或多个用于冷藏或冷冻食物的柜子的设备。 |
可选 trait
matter Identify matter Refrigerator And Temperature Controlled Cabinet Mode matter Refrigerator Alarm google Extended Temperature Control |
冰箱 | |
扫地机器人一种设备,可通过吸尘来自动清洁地板和地毯。 |
必需的特征 重要 标识 重要 Rvc 运行模式 重要 Rvc 运行状态 matter Rvc Clean Mode google Extended Power Source google Locator google Extended Operational State |
吸尘器 | |
客房空调主要用于控制单个房间的空气温度的设备。 |
必需的特征 matter Identify matter 开/关 matter Thermostat |
AC | |
音箱音频或视频设备能够控制音量,并且可以静音或取消静音。 |
必需的特征 matter 开启/关闭 matter 亮度控制 |
扬声器 | |
温控器此类设备可以内置或单独配备温度、湿度或占用情况传感器,并且允许设置所需温度。温控器能够向供暖/制冷装置(例如室内空气处理装置)发送供暖和/或制冷需求通知,或者能够包含用于直接控制供暖或制冷装置的机制。 |
必需的特征 matter Identify matter Thermostat matter Thermostat 界面配置 google Extended Thermostat |
温控器 | |
视频遥控器可控制视频播放器的设备,例如传统的通用遥控器。 |
媒体遥控器 | ||
水阀能够配置和控制水流的设备。 |
必需的特征 matter Identify matter Valve Configuration And Control |
阀门 | |
窗帘能够控制自动窗帘的设备。 |
必需的特征 matter Identify matter Window Covering |
百叶窗 |