设备支持来自 Google Home 生态系统或 Matter 规范中的一个或多个特征,并可在设备上启用特定功能。如需详细了解设备类型,请参阅 Android 数据模型。
表键:
- matter 表示该特征来自 Matter 标准。
- google 表示该特征来自 Google 智能家居。
- Kotlin 示例应用表示示例应用中是否已针对设备类型实现设备状态或对设备的有限控制(包括读取和写入状态)。 如果可用,则会针对每种设备类型列出具体的设备控制功能。
- 用例表示 Google Home 生态系统中的设备类型(如 Google Home 应用中显示和用例页面上显示的设备类型),Home API 设备类型会映射到该设备类型。
- 设备类型 ID 是唯一的,包含一个四位数字字符串(
0000
或6006
),对应于 Matter 供应商 ID (VID)。通常,日志消息可能仅包含设备类型 ID,例如在类型未注册时。例如,home.matter.0000.types.002d
是 Matter 设备类型AirPurifierDevice
,而home.matter.6006.types.0100
是 Google 设备类型GoogleAirCoolerDevice
。
Android 版 Home API 支持以下设备及其关联的特征:
Home API 设备类型 | 特征 | 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 识别 |
传感器 | |
压力传感器
一种用于测量和报告流体压力的设备。 |
必需的特征 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 WakeOnLan matter Channel matter TargetNavigator matter MediaInput matter LowPower matter AudioOutput |
TV | |
投放视频播放器
能够将媒体播放到物理输出或设备自带的显示屏,并且能够启动内容。它具有基本的播放控制功能(例如播放或暂停)和键盘输入功能(向上、向下、数字输入)。 |
必需的特征 matter OnOff matter MediaPlayback matter KeypadInput matter ContentLauncher matter WakeOnLan matter Channel matter TargetNavigator matter MediaInput matter LowPower matter AudioOutput matter ApplicationLauncher matter AccountLogin |
TV | |
电视
一种结合了调谐器、显示器和扬声器的设备,用于观看和收听媒体。 |
可选特征
google ExtendedApplicationLauncher matter Channel google ExtendedChannel google ExtendedMediaInput matter MediaPlayback google ExtendedMediaPlayback google MediaActivityState matter OnOff matter LevelControl google ExtendedLevelControl |
TV | |
彩色调光开关
能够通过调整照明设备的色温和强度来控制照明设备的设备。 |
必需的特征 matter 识别 |
开关 | |
调光开关
能够开启或关闭设备并控制光照强度的设备。 |
必需的特征 matter 识别 |
开关 | |
通用开关
能够通过锁定(例如跷板开关)或瞬时(例如按钮)方式开启或关闭的设备。 |
必需的特征 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 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)并将声音输出到一个或多个音箱的设备。 |
可选特征
google ExtendedApplicationLauncher google ExtendedMediaInput matter MediaPlayback google ExtendedMediaPlayback google MediaActivityState matter OnOff matter LevelControl google ExtendedLevelControl |
音频视频接收器 | |
自动
|
可选特征
google LockUnlock matter OperationalState google ExtendedOperationalState matter PowerSource google ExtendedPowerSource google Toggles google ExtendedModeSelect |
自动 | |
浴缸
可以注水和排水的设备,如果浴缸支持,可以将水位保持在特定水平。 |
可选特征
matter TemperatureControl google Fill matter TemperatureMeasurement google ExtendedTemperatureControl matter OperationalState google ExtendedOperationalState |
浴缸 | |
搅拌器
一种用于搅拌、切碎或混合食物的厨房电器设备。与搅拌机的交互可能包括开始和停止、设置计时器、设置烹饪模式或食材预设,或者调整其他各种设置。 |
必需的特征 Matter OnOff google Cook google Timer matter OperationalState google ExtendedOperationalState |
Blender | |
电水壶
一种由密闭容器和热源组成的设备,可利用水产生蒸汽或其他蒸汽来提供热量。锅炉可以开启和关闭,可能支持调整温度。 |
可选特征
matter TemperatureControl matter TemperatureMeasurement google ExtendedTemperatureControl matter OnOff |
锅炉 | |
壁橱
一种由用于存放物品的小型封闭区域组成的设备。壁橱可以打开和关闭,并且打开和关闭的方向可能不止一个。 |
壁橱 | ||
咖啡机
一种用于制作咖啡的厨房电器设备。与咖啡机的交互可能包括开启和关闭、调整烹饪模式和食材预设、调整目标温度以及调整各种非烹饪模式设置。 |
必需的特征 Matter OnOff matter TemperatureControl google Cook matter TemperatureMeasurement google ExtendedTemperatureControl |
咖啡机 | |
控制台
能够配置和控制其他设备的设备。 |
必需的特征 google ElevatorControl google ParkingLocation |
控制面板 | |
脱水器
一种用于脱水水果和蔬菜等食品的厨房设备。与脱水器的交互可能包括开始和停止、设置计时器、调整烹饪模式或食材预设,或者调整其他各种设置。 |
必需的特征 Matter OnOff google Cook google Timer matter OperationalState google ExtendedOperationalState |
脱水器 | |
门
一种由坚固的可移动屏障组成的装置,用于控制对入口、壁橱、橱柜等的访问权限。门可以打开和关闭,并且打开和关闭的方向可能不止一个。 |
门 | ||
门铃
一种通过门外的按钮启动的设备,可发出声音和/或视觉信号,用于引起门另一侧的人的注意。此设备可能能够发送通知和/或流式传输视频。 |
必需的特征 google DoorbellPress google Clip google Record google ObjectDetection |
门铃 | |
抽屉式导航栏
一种设备,由一个可从家具或墙壁中拉出的滑动式无盖水平隔间组成,以便访问其中存放的物品。抽屉可以打开和关闭,并且打开和关闭的方向可能不止一个。 |
抽屉 | ||
水龙头
控制液体流动的装置。水龙头出水量大小可调节,也可以有不同的预设。水龙头可能有多种模式,每种模式都有自己的相关设置。这些设置特定于水龙头,并且以通用形式进行解释。 |
可选特征
matter TemperatureControl matter TemperatureMeasurement google ExtendedTemperatureControl google Dispense matter OperationalState google ExtendedOperationalState |
Faucet | |
冷柜
一种温度管理设备,可以根据各种模式设置进行调整,可能支持温度监控。 |
必需的特征 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 |
游戏机 | |
车库
一种由坚固的可移动屏障组成的设备,用于控制车库的进出。车库门可以打开、关闭,还可以检测打开状态。它们还可以指示在关门时是否有物体挡住了门的路径,或者门是否因为锁定而无法控制。 |
车库 | ||
登机口
一种设备,由坚固的可移动屏障组成,可通过围栏或墙壁控制对外部区域的访问。大门可以打开和关闭,并且打开和关闭的方向可能不止一个。 |
门 | ||
烧烤
一种用于在烤架上烹饪食物的设备,通过从下方直接加热来烹饪食物。与烧烤机的交互可能包括开启和关闭、开始和停止、设置计时器、调整烹饪模式和食材预设,以及调整各种非烹饪模式设置。 |
烧烤 | ||
烧水壶
一种用于烧开水以制作茶等热饮的设备。与烧水壶的交互可能包括开启和关闭、调整目标温度,可能还包括调整各种模式设置。 |
必需的特征 Matter OnOff matter TemperatureControl matter TemperatureMeasurement google ExtendedTemperatureControl |
Kettle | |
拖把
一种通过弄湿和擦洗地板来清洁地板的设备。 |
必需的特征 google Dock google 重新启动 matter OperationalState google ExtendedOperationalState google 定位器 matter PowerSource google ExtendedPowerSource matter OnOff |
Mop | |
割草机
用于将草坪修剪到统一高度的设备。与割草机的交互可能包括开始、停止和暂停割草、插入基座、检查当前周期、定位割草机以及调整各种模式。 |
可选特征
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) 控制和家长限制的模式。该设备可以执行诸如启用访客网络和报告网络特定信息(如当前互联网吞吐率)等操作。 |
必需的特征 google NetworkControl google 重新启动 google SoftwareUpdate |
网络 | |
凉棚
一种由水平格子架组成的凉亭,支撑在立柱或柱子上,可以打开和关闭,并且打开和关闭的方向可能不止一个。例如,一些带帆布的凉棚可以左右两个方向打开。 |
Pergola | ||
宠物喂食器
一种可自动向猫和狗等家养宠物喂食的设备。与宠物喂食器的交互可能包括分配各种数量和预设的宠物食物或水。 |
宠物喂食器 | ||
高压锅
一种厨房电器设备,可利用压力下的蒸汽在高温下快速烹饪食物。与高压锅的交互可能包括开始和停止、设置计时器、调整烹饪模式或食材预设,或者调整其他各种设置。 |
必需的特征 Matter OnOff |
高压锅 | |
路由器
一种网络设备,用于控制两个或多个不同网络之间的网络流量。路由器可以重新启动、更新其软件,具有处理服务质量 (QoS) 控制和家长限制的模式,可以执行网络特定操作(例如启用访客网络和报告当前互联网吞吐率等网络特定信息)。 |
必需的特征 google NetworkControl google 重新启动 google SoftwareUpdate |
路由器 | |
安防系统
一种设备,用于监控建筑物中的一个或多个传感器,如果传感器检测到意外活动,则可以发出警报。安防系统的报警器可以开启和关闭。它们的报警器可以设置为多个安全等级(例如,“在家”与“外出”),安防系统还可以报告有关某些传感器的信息,例如用于检测运动或打开的窗户的传感器。 |
必需的特征 google ArmDisarm |
安防系统 | |
机顶盒
连接到电视并用于访问数字视频频道的设备。与多频道视频节目分发商 (MVPD) 和机顶盒设备的交互可能包括控制媒体播放。 |
必需的特征 matter 频道 matter OnOff google ExtendedApplicationLauncher google ExtendedChannel matter MediaPlayback google ExtendedMediaPlayback google MediaActivityState matter LevelControl google ExtendedLevelControl |
机顶盒 | |
淋浴
一种设备,包含一个向身体喷水的区域,用于清洗身体。淋浴喷头可以开启和关闭,可能支持调整温度。 |
可选特征
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 |
Standmixer | |
流媒体盒
一种连接到电视的设备,用于访问媒体和音乐的数字流媒体服务,通常与电视等显示设备结合使用。 |
必需的特征 Matter OnOff matter 渠道 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 |
流媒体条形音箱 | |
流媒体棒
一种具有小型棒状外形规格的设备,通常由 USB 或 HDMI 线缆供电,连接到电视等显示设备,用于访问媒体和音乐的数字流媒体服务。 |
可选特征
matter OnOff google ExtendedApplicationLauncher 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 |
泵 | |
水泵控制器
能够配置和控制泵的设备。 |
必需的特征 matter 识别 |
泵 | |
冰箱
包含一个或多个能够冷藏或冷冻食品的柜体的设备。 |
可选特征
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 matter ThermostatUserInterfaceConfiguration google ExtendedThermostat |
温控器 | |
视频遥控器
可控制视频播放器的设备,例如传统通用遥控器。 |
可选特征
google ExtendedLevelControl google ExtendedChannel google ExtendedMediaInput google ExtendedApplicationLauncher google ExtendedMediaPlayback google MediaActivityState |
媒体遥控器 | |
水阀
能够配置和控制水流的设备。 |
必需的特征 matter Identify matter ValveConfigurationAndControl |
Valve | |
窗帘
一种可遮盖窗户并可升起或倾斜的装置。 |
必需的特征 matter Identify matter WindowCovering |
百叶窗 |