设备支持来自 Google Home 生态系统或 Matter 规范中的一个或多个 trait,可在设备上启用特定功能。如需详细了解设备类型,请参阅 Android 上的数据模型。
表键:
- matter 表示 trait 来自 Matter 标准。
- google 表示 trait 来自 Google 智能家居。
- Kotlin 示例应用表示是否已在相应设备类型的示例应用中实现了设备状态或设备的受限控制(包括读取和写入状态)。 系统会为每种设备类型列出特定的设备控制功能(如果有)。
- 用例表示 Home API 设备类型映射到的 Google Home 生态系统中的设备类型(如 Google Home 应用中显示的,并在用例页面上展示)。
Android 版 Home API 支持以下设备及其关联的 trait:
Home API 设备类型 | trait | Kotlin 示例应用 | 使用场景 |
---|---|---|---|
空气净化器一种用于净化室内空气的设备。 |
必需的特征 matter Identify matter FanControl matter HepaFilterMonitoring matter ActivatedCarbonFilterMonitoring google ExtendedFanControl google ExtendedAirQuality google FilterMonitoring |
空气净化器 | |
空气质量传感器能够监测和测量室内外环境中与空气质量相关的各种参数的设备。 |
必需的特征 matter Identify matter AirQuality matter TemperatureMeasurement matter RelativeHumidityMeasurement matter CarbonMonoxideConcentrationMeasurement matter CarbonDioxideConcentrationMeasurement matter NitrogenDioxideConcentrationMeasurement matter OzoneConcentrationMeasurement matter Pm25ConcentrationMeasurement matter FormaldehydeConcentrationMeasurement matter Pm1ConcentrationMeasurement matter Pm10ConcentrationMeasurement matter TotalVolatileOrganicCompoundsConcentrationMeasurement matter RadonConcentrationMeasurement |
传感器 | |
接触传感器用于检测门窗等对象的开关状态的设备。 |
必需的特征 matter Identify matter BooleanState |
布尔值状态 |
传感器 |
流量传感器用于测量和报告流体流速的设备。 |
必需的特征 matter Identify matter FlowMeasurement |
传感器 | |
湿度传感器用于报告湿度测量结果的设备。 |
必需的特征 matter Identify matter RelativeHumidityMeasurement google ExtendedFanControl google RelativeHumidityControl google ExtendedOperationalState |
传感器 | |
光传感器一种测量和感知设备,能够测量和报告传感器所受光照强度(照度)。 |
必需的特征 matter Identify matter IlluminanceMeasurement |
传感器 | |
在家/外出传感器一种测量和感知设备,能够测量和报告指定区域内的占用状态。 |
必需的特征 matter Identify matter OccupancySensing |
在家/外出感知 |
传感器 |
开/关传感器测量和感知设备,当绑定到照明设备时,可用于开启或关闭设备。 |
必需的特征 重要 识别 |
传感器 | |
压力传感器用于测量和报告流体压力的设备。 |
必需的特征 matter Identify matter PressureMeasurement |
传感器 | |
雨量传感器用于报告是否下雨的设备。 |
必需的特征 matter Identify matter BooleanState |
传感器 | |
温度传感器报告温度测量结果的设备。 |
必需的特征 matter Identify matter TemperatureMeasurement |
传感器 | |
冻结水检测器用于报告可能冻结的水的设备。 |
必需的特征 matter Identify matter BooleanState |
传感器 | |
漏水检测器用于报告是否存在漏水的设备。 |
必需的特征 matter Identify matter BooleanState |
传感器 | |
基本视频播放器能够将媒体播放到实体输出设备或设备的显示屏的设备。它具有用于播放的基本控件(例如播放或暂停)和键盘输入(向上、向下、数字输入)。 |
必需的特征 matter OnOff matter MediaPlayback matter KeypadInput matter Messages matter WakeOnLan matter Channel matter TargetNavigator matter MediaInput matter LowPower matter AudioOutput |
TV | |
投放视频播放器能够将媒体播放到实体输出设备或设备的显示屏,并且能够启动内容的设备。它具有用于播放的基本控件(例如播放或暂停)和键盘输入(向上、向下、数字输入)。 |
必需的特征 matter OnOff matter MediaPlayback matter KeypadInput matter ContentLauncher matter Messages matter WakeOnLan matter Channel matter TargetNavigator matter MediaInput matter LowPower matter AudioOutput matter ApplicationLauncher matter AccountLogin |
TV | |
TV结合了调谐器、显示屏和扬声器的设备,用于观看和收听媒体。 |
可选 trait
google ExtendedApplicationLauncher matter Channel google ExtendedChannel google ExtendedMediaInput matter MediaPlayback google ExtendedMediaPlayback google MediaActivityState matter OnOff matter LevelControl google ExtendedLevelControl |
TV | |
投放视频客户端能够在远程设备上启动内容的设备,例如智能音箱或 content provider 的手机应用。 |
流媒体棒 | ||
流媒体棒此类设备具有小型棒状外形规格,通常由连接到显示设备(如电视)的 USB 或 HDMI 电缆供电,用于访问媒体和音乐的数字在线播放服务。 |
可选 trait
matter OnOff google ExtendedApplicationLauncher matter MediaPlayback google ExtendedMediaPlayback google MediaActivityState matter LevelControl google ExtendedLevelControl |
流媒体棒 | |
彩色调光开关能够通过调整色温和亮度来控制照明设备的设备。 |
必需的特征 重要 识别 |
开关 | |
调光开关能够开启或关闭设备并控制灯光强度的设备。 |
必需的特征 重要 识别 |
开关 | |
通用开关能够通过锁定(例如摇杆开关)或瞬时(例如按钮)开启或关闭的设备。 |
必需的特征 matter Identify matter Switch |
开关 | |
色温灯可开启或关闭、调节光强度和色温的照明设备。 |
必需的特征 matter Identify matter OnOff matter LevelControl matter ColorControl google LightEffects google ExtendedColorControl |
开启和关闭、亮度 |
浅色 |
可调光灯可开启或关闭、调节亮度以及通过绑定的有人/无人传感器进行开关的照明设备。 |
必需的特征 matter Identify matter OnOff matter LevelControl |
开启和关闭、亮度 |
浅色 |
扩展色彩灯可通过绑定的入住传感器开启或关闭、调节亮度和色温,以及切换的照明设备。 |
必需的特征 matter Identify matter OnOff matter LevelControl matter ColorControl google LightEffects google ExtendedColorControl |
开启和关闭、亮度 |
浅色 |
开/关指示灯可开启或关闭的照明设备。 |
必需的特征 matter Identify matter OnOff matter LevelControl google LightEffects |
开启和关闭、亮度 |
浅色 |
炉灶表示烹饪设备或其他类似设备上的加热对象的设备。 |
灶台 | ||
嵌入式灶具表示带有一个或多个加热元件的烹饪表面的设备。 |
必需的特征 matter OnOff matter Identify google Cook google Timer |
灶台 | |
可调光插入式装置可通过绑定的控制器设备(例如调光开关或彩色调光开关)开启或关闭,并调节其亮度。 |
必需的特征 matter Identify matter OnOff matter LevelControl |
插座 | |
开/关插入式装置可通过已绑定的控制器设备(例如开/关型灯具开关或调光开关)开启或关闭的设备。 |
必需的特征 matter Identify matter OnOff |
开启和关闭 |
插座 |
洗碗机用于清洗餐具、餐具和与食物准备和食用相关的其他物品的设备。 |
必需的特征 matter OperationalState matter Identify matter OnOff matter TemperatureControl matter DishwasherMode matter DishwasherAlarm google ExtendedOperationalState google ExtendedTemperatureControl |
洗碗机 | |
门锁用于锁定门的设备,可通过手动或远程方法启动。 |
必需的特征 matter Identify matter DoorLock |
锁定 | |
Energy Evse能够为电动车辆或插电式混合动力车辆充电的设备。 |
必需的特征 matter EnergyEvse matter EnergyEvseMode matter Identify matter TemperatureMeasurement google ExtendedModeSelect google ExtendedPowerSource |
充电器 | |
充电器用于为电力储存电池充电的设备。与充电器的交互可能包括开始和停止充电,以及查看当前充到了多少电量、还剩多少电量和还差多少电量才能充满。 |
充电器 | ||
抽油烟机一种通常安装在炉灶或灶台上方的设备,通过抽出空气来减少异味和烟雾。 |
必需的特征 matter FanControl matter Identify matter HepaFilterMonitoring matter ActivatedCarbonFilterMonitoring google ExtendedFanControl |
油烟机 | |
风扇具有风扇且支持多种模式和可变速度的设备。 |
必需的特征 matter Identify matter FanControl |
风扇 | |
冷风机可实现温度冷却和湿度控制的设备。这类设备通常比空调更轻巧便携,并附有水箱。空冷器可能不支持加热或设置精确温度。与空冷器的交互可能包括改变风扇速度和温度设置。 |
必需的特征 matter OnOff matter FanControl google ExtendedFanControl matter RelativeHumidityMeasurement google RelativeHumidityControl matter TemperatureMeasurement matter Thermostat google ExtendedThermostat matter ThermostatUserInterfaceConfiguration |
空冷器 | |
音频视频接收器
接收音频输入(例如 HDMI、光纤和 RCA)并将声音输出到一个或多个音箱的设备。 |
可选 trait
google ExtendedApplicationLauncher google ExtendedMediaInput matter MediaPlayback google ExtendedMediaPlayback google MediaActivityState matter OnOff matter LevelControl google ExtendedLevelControl |
音频视频接收器 | |
自动
|
可选 trait
google LockUnlock matter OperationalState google ExtendedOperationalState matter PowerSource google ExtendedPowerSource google Toggles google ExtendedModeSelect |
自动 | |
浴缸可注水和排水的设备,如果浴缸支持,可以将水位保持在特定水平。 |
可选 trait
matter TemperatureControl google Fill matter TemperatureMeasurement google ExtendedTemperatureControl matter OperationalState google ExtendedOperationalState |
浴缸 | |
搅拌器一种厨房电器设备,用于搅拌、切碎或混合食物。与搅拌机的交互可能包括开始和停止、设置计时器、设置烹饪模式或食材预设,或者调整其他各种设置。 |
必需的特征 matter OnOff google Cook google Timer matter OperationalState google ExtendedOperationalState |
Blender | |
电水壶一种由密闭容器和热源组成的设备,其中会通过水产生蒸汽或其他蒸气来供热。锅炉可以开启和关闭,可能支持调整温度。 |
可选 trait
matter TemperatureControl matter TemperatureMeasurement google ExtendedTemperatureControl matter OnOff |
锅炉 | |
壁橱一种由用于存放物品的封闭小空间组成的设备。壁橱可以打开和关闭,并且打开和关闭的方向可能不止一个。 |
壁橱 | ||
咖啡机一种用于制作咖啡的厨房电器设备。与咖啡机的交互可能包括开启和关闭、调整烹饪模式和食材预设、调整目标温度以及调整各种非烹饪模式设置。 |
必需的特征 matter OnOff matter TemperatureControl google Cook matter TemperatureMeasurement google ExtendedTemperatureControl |
咖啡机 | |
控制台能够配置和控制其他设备的设备。 |
必需的 trait google ElevatorControl google ParkingLocation |
控制台 | |
脱水器一种厨房电器设备,用于脱干水果和蔬菜等食品。与脱水器的交互可能包括开始和停止、设置计时器、调整烹饪模式或食材预设,或者调整其他各种设置。 |
必需的特征 matter OnOff google Cook google Timer matter OperationalState google ExtendedOperationalState |
脱水器 | |
门一种由坚固的可移动屏障组成的设备,用于控制对入口、壁橱、橱柜等的访问。门可以打开和关闭,并且打开和关闭的方向可能不止一个。 |
门 | ||
门铃一种由门外按钮触发的设备,可发出声音和/或视觉信号,用于吸引门另一侧某个位置的人员的注意。此设备可能能够发送通知和/或流式传输视频。 |
必需的特征 google DoorbellPress google Clip google Record google ObjectDetection |
门铃 | |
抽屉式导航栏一种由无盖滑动式水平隔间组成的设备,可从家具或墙壁中拉出以便使用。抽屉可以打开和关闭,并且打开和关闭的方向可能不止一个。 |
抽屉 | ||
水龙头用于控制液体流动的设备。水龙头出水量大小可调节,也可以有不同的预设。水龙头可能有多种模式,每种模式都有自己的相关设置。这些设置特定于水龙头,并且以通用形式进行解释。 |
可选 trait
matter TemperatureControl matter TemperatureMeasurement google ExtendedTemperatureControl google Dispense matter OperationalState google ExtendedOperationalState |
水龙头 | |
冷柜温度管理设备,可以根据各种模式设置进行调整,可能支持温度监控。 |
必需的特征 matter TemperatureControl matter TemperatureMeasurement google ExtendedTemperatureControl |
冷柜 | |
炸锅一种厨房电器设备,通过油炸来烹饪食物。与炸锅的交互可能包括开始和停止、设置计时器、调整烹饪模式或食材预设,或者调整其他各种设置。 |
必需的特征 matter OnOff google Cook google Timer matter OperationalState google ExtendedOperationalState |
炸锅 | |
游戏机用于管理和玩视频游戏的设备。与游戏机的交互包括玩游戏和操作设备控件。 |
必需的特征 matter OnOff google ExtendedApplicationLauncher google ExtendedMediaInput matter MediaPlayback google ExtendedMediaPlayback google MediaActivityState matter LevelControl google ExtendedLevelControl |
游戏机 | |
车库一种由坚固的可移动屏障组成的设备,用于控制车库的出入。车库门可以打开、关闭,还可以检测打开状态。它们还可以指示在关门时是否有物体挡住了门的路径,或者门是否因为锁定而无法控制。 |
车库 | ||
登机口由坚固的可移动屏障组成的设备,用于控制通过围栏或墙壁进入外部区域的权限。大门可以打开和关闭,并且打开和关闭的方向可能不止一个。 |
门 | ||
烧烤一种通过从下方直接加热来在铁架上烹饪食物的设备。与烧烤炉的交互可能包括开启和关闭、开始和停止、设置计时器、调整烹饪模式和食材预设,以及调整各种非烹饪模式设置。 |
可选 trait
google Cook matter OnOff google Timer matter OperationalState google ExtendedOperationalState |
烧烤机 | |
烧水壶一种设备,用于烧开水以制作茶等热饮料。与烧水壶的交互可能包括开启和关闭、调整目标温度,可能还包括调整各种模式设置。 |
必需的特征 matter OnOff matter TemperatureControl matter TemperatureMeasurement google ExtendedTemperatureControl |
烧水壶 | |
拖把一种通过湿润和擦洗地板来清洁地板的设备。 |
必需的 trait google Dock google Reboot matter OperationalState google ExtendedOperationalState google Locator matter PowerSource google ExtendedPowerSource matter OnOff |
拖地机 | |
割草机一种用于将草坪修剪成统一高度的设备。与割草机的交互可能包括开始、停止和暂停割草、插入基座、检查当前周期、定位割草机以及调整各种模式。 |
可选 trait
google Dock matter OnOff matter OperationalState google ExtendedOperationalState google Locator matter PowerSource google ExtendedPowerSource |
割草机 | |
多功能锅一种用于使用各种方法(包括慢炖、炒、蒸或高压烹饪)烹饪食物的设备,通常无需人工看管。与多功能炊具的交互可能包括开始和停止、设置计时器或调整非烹饪模式。 |
必需的特征 matter OnOff google Cook google Timer matter OperationalState google ExtendedOperationalState |
多功能炊具 | |
网络表示作为一个实体而不是单个设备进行控制的一组路由器节点或网状网络的设备。网络设备可能会重新启动、更新其软件,并具有处理服务质量 (QoS) 控制和家长限制的模式。该设备可以执行诸如启用访客网络和报告网络特定信息(如当前互联网吞吐率)等操作。 |
必需的 trait google NetworkControl google 重新启动 google SoftwareUpdate |
网络 | |
凉棚一种由水平棚架构成的凉亭,支撑在柱子或支柱上,可以打开和关闭,并且打开和关闭的方向可能不止一个。例如,一些带帆布的凉棚可以左右两个方向打开。 |
凉棚 | ||
宠物喂食器一种自动向猫、狗等宠物投放食物的设备。与宠物喂食器的交互可能包括分配各种数量和预设的宠物食物或水。 |
宠物喂食器 | ||
高压锅一种厨房电器设备,可使用高压蒸汽在高温下快速烹饪食物。与高压锅的交互可能包括开始和停止、设置计时器、调整烹饪模式或食材预设,或者调整其他各种设置。 |
必需的特征 matter OnOff google Cook google Timer |
高压锅 | |
路由器用于控制两个或更多不同网络之间的网络流量的网络设备。路由器可以重新启动、更新其软件,具有处理服务质量 (QoS) 控制和家长限制的模式,可以执行网络特定操作(例如启用访客网络和报告当前互联网吞吐率等网络特定信息)。 |
必需的 trait google NetworkControl google 重新启动 google SoftwareUpdate |
路由器 | |
安防系统用于监控建筑物中一个或多个传感器的设备,如果传感器检测到意外活动,可以发出提醒。安防系统的报警器可以开启和关闭。它们的报警器可以设置为多个安全等级(例如,“在家”与“外出”),安防系统还可以报告有关某些传感器的信息,例如用于检测运动或打开的窗户的传感器。 |
必需的特征 google ArmDisarm |
安防系统 | |
机顶盒连接到电视的设备,用于访问数字视频频道。与多频道视频节目分发商 (MVPD) 和机顶盒设备的交互可能包括控制媒体播放。 |
必需的特征 matter Channel matter OnOff google ExtendedApplicationLauncher google ExtendedChannel matter MediaPlayback google ExtendedMediaPlayback google MediaActivityState matter LevelControl google ExtendedLevelControl |
机顶盒 | |
淋浴一种设备,由用于向身体喷水以进行清洗的区域组成。淋浴喷头可以开启和关闭,可能支持调整温度。 |
可选 trait
matter TemperatureControl matter TemperatureMeasurement google ExtendedTemperatureControl matter OperationalState google ExtendedOperationalState |
淋浴 | |
条形音箱一种一体式音频设备,通常与电视结合使用,外形规格为条形。 |
必需的特征 matter OnOff google ExtendedApplicationLauncher google ExtendedMediaInput matter MediaPlayback google ExtendedMediaPlayback google MediaActivityState matter LevelControl google ExtendedLevelControl |
条形音箱 | |
真空低温烹饪一种厨房电器设备,用于在真空环境下以相对较低的温度烹饪食物。与真空低温烹饪机的交互可能包括开始和停止、设置计时器、调整烹饪模式或食材预设,或者调整其他各种设置。 |
必需的特征 matter OnOff google Cook google Timer matter OperationalState google ExtendedOperationalState |
真空低温烹饪机 | |
洒水器一种用于将水均匀分布在花园等区域的设备。洒水器可以开始和停止(或开启和关闭)。它们可能还支持计时器和/或时间表。 |
洒水器 | ||
台式搅拌机一种厨房电器,用于混合干燥和液体成分,以制作面糊或面团。与台式搅拌机的交互可能包括开启和关闭搅拌机、启动和停止搅拌机、调整烹饪模式或食材预设,或者调整各种非烹饪模式设置。 |
必需的特征 matter OnOff google Cook matter OperationalState google ExtendedOperationalState |
台式搅拌机 | |
流媒体盒连接到电视的设备,用于访问媒体和音乐的数字在线播放服务,通常与电视等显示设备结合使用。 |
必需的特征 matter OnOff matter Channel google ExtendedApplicationLauncher google ExtendedChannel google ExtendedMediaInput matter MediaPlayback google ExtendedMediaPlayback google MediaActivityState matter LevelControl google ExtendedLevelControl |
流媒体盒 | |
流媒体条形音箱此类设备结合了音箱和流媒体棒或流媒体盒,除了条形音箱的功能外,还提供流媒体体验。 |
必需的特征 matter OnOff google ExtendedApplicationLauncher google ExtendedMediaInput matter MediaPlayback google ExtendedMediaPlayback google MediaActivityState matter LevelControl google ExtendedLevelControl |
流媒体条形音箱 | |
净水器用于过滤和净化水的设备。 |
净水器 | ||
软水器用于从水中去除矿物质的设备。 |
软水器 | ||
窗口一种透明设备,可让光线进入结构。窗户可以打开和关闭,有可能具有多个向不同方向打开的部分,可能还能锁定和解锁。 |
窗口 | ||
酸奶机一种用于制作酸奶的厨房电器设备。与酸奶机的交互可能包括开始和停止、设置计时器、调整烹饪模式或食材预设,或者调整其他各种设置。 |
必需的特征 matter OnOff google Cook google Timer matter OperationalState google ExtendedOperationalState |
酸奶机 | |
烘干机能够烘干衣物的设备。 |
必需的特征 matter OperationalState matter Identify matter OnOff matter LaundryDryerControls matter LaundryWasherMode matter TemperatureControl google ExtendedOperationalState google Timer google Toggles |
烘干机 | |
洗衣机能够清洗消费类物品的设备。 |
必需的特征 matter OperationalState matter Identify matter OnOff matter LaundryWasherMode matter LaundryWasherControls matter TemperatureControl google ExtendedOperationalState google Toggles google ExtendedTemperatureControl google ExtendedModeSelect |
洗衣机 | |
微波炉一种使用微波加热食物和饮料的设备。 |
必需的特征 matter MicrowaveOvenMode matter MicrowaveOvenControl matter OperationalState matter Identify matter FanControl google ExtendedModeSelect google Cook google Timer |
微波炉 | |
烤箱一种包含一个或多个橱柜(可选配炉灶)且能够加热食物的设备。 |
烤箱 | ||
泵通常用于泵送可能具有可变速度的水等流体的设备。它可能具有可选的内置传感器和调节机制。 |
必需的特征 matter Identify matter OnOff matter PumpConfigurationAndControl matter LevelControl matter TemperatureMeasurement matter PressureMeasurement matter FlowMeasurement |
泵 | |
泵控制器能够配置和控制水泵的设备。 |
必需的特征 重要 识别 |
泵 | |
冰箱包含一个或多个用于冷藏或冷冻食品的柜子的设备。 |
可选 trait
matter Identify matter RefrigeratorAndTemperatureControlledCabinetMode matter RefrigeratorAlarm google ExtendedTemperatureControl |
冰箱 | |
扫地机器人一种设备,可通过吸尘清除地板和地毯上的灰尘和碎屑,实现自动清洁。 |
必需的特征 matter Identify matter RvcRunMode matter RvcOperationalState matter RvcCleanMode google ExtendedPowerSource google Locator google ExtendedOperationalState |
吸尘器 | |
客房空调主要用于控制单个房间空气温度的设备。 |
必需的特征 matter Identify matter OnOff matter Thermostat matter FanControl matter ThermostatUserInterfaceConfiguration matter TemperatureMeasurement matter RelativeHumidityMeasurement google ExtendedFanControl google ExtendedThermostat |
AC | |
音箱音频或视频设备可以控制音量,并且可以静音或取消静音。 |
必需的特征 matter OnOff matter LevelControl google ExtendedApplicationLauncher google ExtendedMediaInput google ExtendedMediaPlayback google MediaActivityState google ExtendedLevelControl |
扬声器 | |
温控器此类设备可以内置或单独配备温度、湿度或占用情况传感器,并且允许设置所需温度。温控器能够向供暖/制冷装置(例如室内空气处理装置)发送供暖和/或制冷需求通知,或者能够包含用于直接控制供暖或制冷装置的机制。 |
必需的特征 matter Identify matter Thermostat |
温控器 | |
视频遥控器可控制视频播放器的设备,例如传统的通用遥控器。 |
可选 trait
google ExtendedLevelControl google ExtendedChannel google ExtendedMediaInput google ExtendedApplicationLauncher google ExtendedMediaPlayback google MediaActivityState |
媒体遥控器 | |
水阀能够配置和控制水流的设备。 |
必需的特征 matter Identify matter ValveConfigurationAndControl |
阀门 | |
窗帘一种遮盖窗户且可升降或倾斜的设备。 |
必需的特征 matter Identify matter WindowCovering |
百叶窗 |