跳到主要内容

功能代码

概览

functionCode说明
Descriptor描述设备端点组成与能力结构,包括端点列表、设备类型、Server/Client 集群等信息。
BasicInformation提供设备基本信息,包括厂商、产品型号、固件版本、序列号、在线状态等基础属性。
EndpointLabel管理端点的可见性与展示信息,如名称、房间、图标、标签等,用于前端展示与组织。
CameraCoordination处理摄像机复杂业务逻辑,包括 WebRTC 通话、云台控制、识别数据同步及扩展事件。
GeneralConfiguration提供通用设备配置项,如灵敏度、延时、默认参数等设备级设置。
EcosystemInformation描述设备所接入的生态平台信息,如 HomeKit、Matter Fabric 等绑定状态。
EnergyManagement管理设备电量与能耗信息,包括电量百分比、功耗统计及低电告警等。
HubCoordination作为网关核心协同模块,管理子设备入网、配置、心跳、令牌及各类代理服务。
SceneCoordination管理智能场景(自动化规则)生命周期,包括同步、删除、触发执行及一致性校验。
PowerSource描述设备供电来源与电池状态,包括电量、充电状态、电池类型等信息。
WakeupCoordination为支持远程唤醒的低功耗设备获取唤醒服务地址或令牌。
CentralHubCoordination管理中枢网关高级能力,包括中枢启用、Broker 信息及数据透传通道。
SecurityGuardCoordination管理家庭空间安防警戒能力,包括警戒启停、告警确认及本地/云端配置同步。
OTACoordination管理 OTA 固件升级协同流程,包括任务下发、进度上报、结果反馈及版本查询。
LockCoordination处理智能门锁扩展业务,包括专用透传通道、加解密协助及扩展事件上报。
DeviceAnomalyMonitoring持续监测设备运行参数,及时发现并上报异常或故障状态。
GeneralDiagnostics提供通用诊断信息,包括运行时间、重启次数、网络接口及硬件故障等。
RingtoneCoordination管理网关本地铃声/音乐文件,包括下载、删除及与云端库的一致性校验。
ZigbeeNetworkDiagnostics提供 Zigbee 网络诊断能力,包括信道、PAN、邻居及路由等信息。
MatterCoordination集中管理 Matter 协议相关协同操作,包括入网、绑定、数据同步及证书管理。
ScreenCoordination管理智能场景面板交互,包括配置下发、状态查询及云端/面板双向透传。
CommLinkCoordination监测网关与云端通信链路质量,执行耗时探测并上报结果。
IftttCoordination作为自动化规则协同中心,管理 IFTTT/本地自动化规则的同步、订阅与执行。
NetworkManagement作为设备网络连接与访问策略的核心控制模块,管理远程代理及访问地址。
Identify提供设备识别能力,可通过指示灯闪烁、声音等方式帮助用户定位物理设备。
LightBoxCoordination管理智能灯箱设备的配置下发,控制展示内容与效果。
IRCoordination管理网关红外学习与发射,包括码库同步、虚拟遥控器创建及按键控制。
NetworkCommissioning提供网络配网能力,支持 Wi-Fi、Thread 等网络的扫描、连接与配置。
ConfigurationCoordination通过组播或批量方式管理通用功能配置、资源订阅及位置信息同步。
CloudStorageCoordination管理云录像/云存业务资源配置,获取存储配额及上传凭证等信息。
StudioCoordination管理网关与 Aqara Studio 开发环境的集成,包括账号认证、项目备份与设备同步。
Temperature测量并上报环境温度,提供当前温度值及有效量程等属性。
TemperatureControl提供温度设定与调节能力,用于恒温设备的目标温度控制。
PackageRecognition自动识别画面中的包裹,在投递或取走时可发送提醒并记录事件。
FaceRecognition采集人脸特征并与本地库比对,上报人脸识别结果及匹配信息。
HumanPresence检测空间内人体存在,支持人数统计、轨迹及身份关联等高级感知能力。
HumanRecognition利用视觉等算法实时检测画面中的人形目标,区分人体与其他物体并上报事件。
AirQuality监测并上报空气质量指标,如 AQI 或综合空气质量等级。
AttitudeDetection检测设备姿态或倾斜角度变化,上报姿态异常或角度信息。
Lifter提供升降类设备的行程控制,支持设定目标位置、停止及状态查询。
Binding表示端点与一个或多个其他本地或远程 Endpoint 之间的持久绑定关系。
PetFeeder提供宠物喂食控制能力,包括出粮份数、喂食计划及余量状态。
Button描述按钮类输入设备的事件上报,包括单击、长按、多击等动作识别。
Output提供开关输出控制能力,支持读取和控制负载的通断状态。
IRControl提供红外发射控制能力,用于控制空调、电视等传统红外家电。
HeaterCooler提供制冷/制热控制能力,包括目标温度、运行模式、风速等暖通参数。
Vibration检测振动或动静变化,上报移动、倾斜、跌落等事件。
Cube描述魔方控制器的手势识别,包括翻转、旋转、摇一摇等动作及面识别。
Knob描述旋钮类输入设备的旋转角度、按压及组合动作事件。
BinaryOutputObject驱动二元执行器输出,如继电器、接触器、电磁阀或警号。
AnalogInputObject以只读方式采集连续变化的模拟量输入(如电压、温度模拟信号)。
MediaPlayback提供媒体播放控制能力,包括播放、暂停、切歌、音量及播放状态管理。
MediaInput描述媒体输入源管理与切换,支持选择当前播放源及输入列表。
FlameDetection通过图像或传感器算法检测可见火焰,即时上报火情事件以便早期预警。
OperationalState描述设备当前运行状态,如空闲、运行中、暂停、故障等。
RefrigeratorState描述冰箱运行状态,包括空闲、制冷、除霜、故障等。
Mode提供设备特性模式接口,支持在多种预定义模式间切换。
BridgedConfiguration描述被桥接子设备的配置信息,用于 Matter/Zigbee 桥接场景。
MultiStateInputObject采集多状态离散输入,表示 N 种状态之一。
MARSConfiguration提供智能负载(MARS)相关配置,用于负载识别与智能配电管理。
ScreenUserInterface管理屏端用户界面配置,包括页面布局、卡片、主题及展示数据。
CustomizedConfiguration提供厂商或用户自定义扩展配置项的读写能力。
HEPAFilterMonitoring监测 HEPA 滤芯使用情况、剩余寿命及更换提醒。
ActivatedCarbonFilterMonitoring监测活性炭滤芯使用情况、剩余寿命及更换提醒。
FanControl提供风扇转速与模式控制,支持档位调节及运行状态读取。
HeartMonitoring利用传感器持续或周期性测量用户心率,记录并分析心脏健康相关数据。
Pressure测量并上报大气压力或系统压力值。
MultiStateOutputObject输出多状态离散控制命令,如 HVAC 模式或灯光场景切换。
Contact检测接触/门磁类二元状态,上报打开或关闭状态及可选角度信息。
Doorbell提供门铃相关能力,包括呼叫事件上报及与室内铃铛/中继的联动。
WaterFreezeDetector用于检测管道或环境中是否存在结冰风险,并在达到阈值时上报水冻结相关事件。
Speaker描述设备扬声器输出能力,包括音量控制及静音等音频输出属性。
DoorLock提供智能门锁核心能力,包括锁状态、用户/凭证管理、开锁/上锁及告警事件。
CO2测量并上报环境中二氧化碳浓度。
VacuumOperationalState描述扫地机器人当前运行状态,如清扫中、回充中、充电中等。
ValveControl提供阀门自动控制或手动控制能力,用于精确调节水/气流量。
ScreenDisplay管理屏幕显示相关硬件属性,如分辨率、亮度、背光及显示状态。
Illuminance测量并上报环境光照度(lux)。
Camera管理摄像机基础能力,包括设备状态、模式切换、图像加密及云端相关能力。
Gas检测可燃气体或有害气体泄漏并上报告警事件。
GestureRecognition实时分析手势动作,将预定义手势转换为控制指令。
BreathingMonitoring利用传感器持续或周期性测量用户呼吸频率与模式,支持健康监测。
CharacterStringValueObject定义以字符串形式表示的数据对象及其外部可见特性。
Sweeper提供扫地机器人基础控制,包括启动清扫、暂停、回充等操作与状态反馈。
EVSE提供电动汽车供电设备(EVSE)控制能力,包括充电启停、电流限制及充电状态。
CO提供一氧化碳浓度监测与报警相关能力,用于检测环境中的一氧化碳泄漏并及时告警。
Lighting本 Function 提供对灯光动态效果的激活与控制能力。服务端提供可由不同来源驱动的效果列表,客户端可从中选择并触发。 动态灯效既可用于支持 Color Control Function 的灯具,也可用于仅支持 Level Control Function 的灯具(例如可调光灯)。 效果的具体实现属于厂商自定义范围。不同厂商设备即使使用相同 EffectID,也不保证表示同一种效果;同一厂商可在不同设备复用同一 EffectID 以表达一致实现。
LevelControl提供亮度等级调节能力,支持设置/读取当前亮度、步进调光、以及与开关联动或解耦的调光控制。
ColorControl提供颜色控制能力,支持通过 HSV、XY 与色温模式调节灯光颜色,并支持与亮度命令组合下发。 本 Function 提供灯光颜色调节接口。颜色定义遵循 CIE 1931 色彩空间,核心控制方式为 x、y 色度坐标(对应 ColorXY / CurrentX / CurrentY)。 此外,颜色可选通过 ColorTemperature(色温)或 Hue + Saturation 方式控制;Hue 与 Saturation 建议按 HSV(HSB)模型解释。RGB/W 原色点能力可用于扩展颜色表达范围。 本 Function 不负责亮度控制;亮度由 LevelControl Function 提供。联动控制时,LevelControl 中的亮度值应按“当前颜色下可达到最大光强的比例”解释。
PanTilt提供云台(Pan/Tilt/Zoom)控制能力,包括预置位、校准及相对/绝对移动。
WindowCovering本 Function 提供窗帘、卷帘、百叶帘等窗饰设备的开合控制、倾斜控制、目标位置管理与运行状态反馈能力。 除标准开合/倾斜控制外,本 Function 还包含 Aqara 扩展能力:场景管理(内置/自定义场景的启动、读取、预览、增删改)、手动校准、远程配对、电机映射交换与增强模式状态。 客户端应结合 TravelConfigured、MotorControllability、MotorOperationStatus、EnhanceMode 等 Trait 判断设备当前可控性与操作阶段,避免在不满足条件时下发无效命令。
Flow测量并上报液体或气体的流量速率。
OccupancySensing检测空间内是否有人存在,上报占用/空闲状态及保持时间等参数。
RainSensor用于检测降雨状态,上报是否正在下雨及雨量相关信息。
Smoke检测烟雾并上报报警事件,支持灵敏度、自检及静音等相关配置。
FreshAirControl提供新风系统控制能力,支持引入室外空气并进行风量、模式等调节。
AnalogOutputObject提供可写的连续模拟量输出控制信号。
Location提供设备或目标的位置信息上报与查询能力。
PetRecognition识别画面中的猫、狗等宠物个体,上报宠物出现或相关识别事件。
ParticulateMatter监测并上报颗粒物浓度(如 PM2.5、PM10)。
OnOffSensor用于检测二元开关量输入状态,上报开/关或触发/未触发等离散状态。
SoundDetection通过麦克风采集环境声音,识别特定声音类型(如玻璃破碎、婴儿哭声)并告警。
Ringtone提供铃声与音乐播放控制,支持选曲、音量/时长调节及播放状态监测。
BridgeConfiguration管理网关桥接配置,描述子设备接入、桥接能力及网络拓扑相关信息。
MatterBridgeCommissioning管理 Matter Bridge 向第三方 Matter 生态分享桥接设备的能力。
GarageDoorOpener提供车库门控制与状态反馈,包括开/关/停止及位置状态。
RelativeHumidity测量并上报环境相对湿度,提供当前湿度值及有效量程等属性。
Sleep监测睡眠相关状态,上报睡眠阶段、时长或质量等指标。
BinaryInputObject采集二元状态输入,如门磁、开关等 true/false 或 active/inactive 量。
WaterLeak检测水浸事件,在检测到漏水时及时上报告警。
VehicleDetection检测监控区域内的车辆出现,上报车辆存在事件供安防或自动化使用。

Descriptor

描述设备端点组成与能力结构,包括端点列表、设备类型、Server/Client 集群等信息。

functionCodetrait/commandCodeTrait 或 Command?
DescriptorSupportedEndpointDynamicTrait
EndpointCountTrait
EndpointStructureTrait
EndpointDeviceTypesTrait
EndpointDynamicCountTrait
EndpointArrayDynamicTrait
EndpointArrayTrait
EndpointFunctionsTrait
SelectedEndpointDynamicTrait

BasicInformation

提供设备基本信息,包括厂商、产品型号、固件版本、序列号、在线状态等基础属性。

functionCodetrait/commandCodeTrait 或 Command?
BasicInformationProductNameTrait
PartNumberTrait
BLVersionTrait
ManufacturerChipIDTrait
SupportedMatterRolesTrait
HardwareVersionStringTrait
HubConnectionStatusTrait
DeviceXCodeTrait
MatterSpecificationVersionTrait
VendorNameTrait
FirmwareRevisionStringTrait
DeviceIDTrait
VendorIDTrait
MCUVersionTrait
ProductIDTrait
ConfigurationFlagTrait
ModelValueTrait
HardwareVersionTrait
MacTrait
RadarVersionTrait
SerialNumberTrait
ConfigurationVersionTrait
ReachableTrait
FirmwareRevisionTrait
ChipTemperatureTrait
LocationTrait

EndpointLabel

管理端点的可见性与展示信息,如名称、房间、图标、标签等,用于前端展示与组织。

functionCodetrait/commandCodeTrait 或 Command?
EndpointLabelEndpointTagTrait
EndpointNameTrait
EndpointApplianceTypeTrait
EndpointRoomTrait
EndpointVisibilityTrait
EndpointIconTrait
EndpointStatisticsTrait
EndpointRoomNameTrait

CameraCoordination

处理摄像机复杂业务逻辑,包括 WebRTC 通话、云台控制、识别数据同步及扩展事件。

functionCodetrait/commandCodeTrait 或 Command?
CameraCoordinationAPIUnbindWiFiSubdeviceCommand
APICheckCarDataConsistencyCommand
APIBindWiFiSubdeviceCommand
APIOperateBridgedDeviceCommand
APIDeviceCameraCallCommand
APIOperateCameraUpCommand
APIIssueTokenForWebRTCCallCommand
APIOperateCameraDownCommand
APIGetSignallingServerAddressCommand
APIReportCameraExtEventsCommand
APICheckFaceDataConsistencyCommand

GeneralConfiguration

提供通用设备配置项,如灵敏度、延时、默认参数等设备级设置。

functionCodetrait/commandCodeTrait 或 Command?
GeneralConfigurationVoiceLanguageTrait
EnergySavingEnableTrait
CurrentSensitivityLevelTrait
TransmissionPowerSettingTrait
HubArkTechEnableTrait
BeepEnableTrait
NightLightModeTrait
OutputInterlockFlagTrait
ActivityDetectionModeSettingTrait
TimeZoneTrait
NumberOfSensitivityLevelIsSupportedTrait
PollingTimeTrait
InstallationOrientationConfigurationTrait
DetectionModeSettingTrait
LightingModeSettingTrait
ResetModeTrait

EcosystemInformation

描述设备所接入的生态平台信息,如 HomeKit、Matter Fabric 等绑定状态。

functionCodetrait/commandCodeTrait 或 Command?
EcosystemInformationMagicPairPayloadTrait
SupportedEcosystemTrait
MatterPayloadTrait
HomeKitPayloadTrait
BoundEcosystemTrait

EnergyManagement

管理设备电量与能耗信息,包括电量百分比、功耗统计及低电告警等。

functionCodetrait/commandCodeTrait 或 Command?
EnergyManagementCurrentVoltageTrait
CircuitCurrentTrait
CumulativeEnergyConsumptionTrait
CurrentPowerTrait

HubCoordination

作为网关核心协同模块,管理子设备入网、配置、心跳、令牌及各类代理服务。

functionCodetrait/commandCodeTrait 或 Command?
HubCoordinationAPIUnbindHubDownCommand
APIUploadDeviceInfoCommand
APIReportDeviceResponseCommand
APIGetSubdeviceConfigCommand
APICheckHubDataConsistencyCommand
APICheckHubLocalSyncCommand
APIGetLoginRandomCodeCommand
APIGetRandomJoinCodeCommand
APIClearHubConfigCommand
APISyncDataCloudToHubCommand
APIReportSubdeviceModelCommand
APIClearLocalDataCommand
APINotifyConfigChangeCommand
APIGetVoiceFileUrlCommand
APIDisableSubdeviceJoiningCommand
APIAskOtherHubTokenCommand
APISubdeviceKeepAliveCommand
APIBindBleDeviceToHubCommand
APIReportHeartbeatCommand
APIGetInstallCodeCommand
APIReportPropertyExaminationCommand
APIBindSubdeviceWithSecurityCodeCommand
APIStartHubProvisioningCommand
APIReportHubLocalInfoCommand
APIUnsubscribeDeviceResourceCommand
APIReportHubLocalConfigCommand
APICheckHubConfigCommand
APIPushHubConfigCommand
APIQueryDeviceResMultiExtGbkCommand
APIReportExceptionLogCommand
APINotifySubdeviceReadResultCommand
APISubscribeDeviceResourceCommand
APIReportCommandExecResultCommand
APIGetWeatherDataCommand
APIConnectHubCommand
APIUnbindHubUpCommand
APISyncTokenDownCommand
APIRefreshHubTokenCommand
APIRpcDebugCommandCommand
APISyncSubdeviceListCommand
APIRegisterDirectDeviceCommand
APINotifyNoSubdeviceCommand
APIExecuteSubstituteCommandCommand
APIRunFunctionInstructionCommand
APIUnbindSubdeviceDownCommand
APIUnbindSubdeviceUpCommand
APIEnableSubdeviceJoiningCommand
APIUploadLogFileEventCommand
APIGetSubdeviceServiceConfigCommand
APIQueryDeviceResMultiExtCommand
APITriggerSubdeviceReadCommand
APIBindSubdeviceNoAuthCommand
APISetSubdeviceMixingCommand

SceneCoordination

管理智能场景(自动化规则)生命周期,包括同步、删除、触发执行及一致性校验。

functionCodetrait/commandCodeTrait 或 Command?
SceneCoordinationAPICheckLocalSceneSyncCommand
APIDownloadLocalSceneCommand
APIRunSceneCommand
APIDeleteLocalSceneCommand
APIRunLocalSceneCommand
APIDownloadCentralSceneCommand

PowerSource

描述设备供电来源与电池状态,包括电量、充电状态、电池类型等信息。

functionCodetrait/commandCodeTrait 或 Command?
PowerSourceCurrentVoltageTrait
BatReplacementDescriptionTrait
BatChargeStateTrait
BatReplaceabilityTrait
PowerModeTrait
BatPercentRemainingTrait
WiredPresentTrait
RechargeableTrait
StateOfLowBatTrait
BatReplacementNeededTrait
BatQuantityTrait

WakeupCoordination

为支持远程唤醒的低功耗设备获取唤醒服务地址或令牌。

functionCodetrait/commandCodeTrait 或 Command?
WakeupCoordinationAPIGetWakeupUrlCommand

CentralHubCoordination

管理中枢网关高级能力,包括中枢启用、Broker 信息及数据透传通道。

functionCodetrait/commandCodeTrait 或 Command?
CentralHubCoordinationAPIInquiryCentralBrokerCommand
APIHubPassthroughDataDownCommand
APIEnableCentralHubFunctionCommand
APIHubPassthroughDataUpCommand
APIInquiryCentralEnableStateCommand

SecurityGuardCoordination

管理家庭空间安防警戒能力,包括警戒启停、告警确认及本地/云端配置同步。

functionCodetrait/commandCodeTrait 或 Command?
SecurityGuardCoordinationAPIDeleteSecurityLocalCommand
APISyncSecurityLanInfoCommand
APICheckSecurityEnableConsistencyCommand
APIConfirmSecurityAlertCommand
APICheckSecurityConfigConsistencyCommand
APIEnableSecurityCommand
APIRepairSecurityEnableCommand

OTACoordination

管理 OTA 固件升级协同流程,包括任务下发、进度上报、结果反馈及版本查询。

functionCodetrait/commandCodeTrait 或 Command?
OTACoordinationAPIReportOtaDeviceListStateCommand
APIReportOtaResultCommand
APIReportOtaProgressCommand
APICancelOtaUpgradeCommand
APIInquiryFirmwareInfoCommand
APIUpgradeDeviceFirmwareCommand

LockCoordination

处理智能门锁扩展业务,包括专用透传通道、加解密协助及扩展事件上报。

functionCodetrait/commandCodeTrait 或 Command?
LockCoordinationAPILockPassthroughUpstreamCommand
APILockPassthroughDownstreamCommand
APIAssistDeviceCryptoCommand
APIReportLockExtEventsCommand

DeviceAnomalyMonitoring

持续监测设备运行参数,及时发现并上报异常或故障状态。

functionCodetrait/commandCodeTrait 或 Command?
DeviceAnomalyMonitoringLoadSafetyManagementTrait
VoltageSafetyManagementTrait
CurrentSafetyManagementTrait
OverCurrentResponseSettingTrait
TemperatureSafetyManagementTrait

GeneralDiagnostics

提供通用诊断信息,包括运行时间、重启次数、网络接口及硬件故障等。

functionCodetrait/commandCodeTrait 或 Command?
GeneralDiagnosticsRebootCountTrait
RebootReasonTrait
UpTimeTrait
NetworkInterfacesTrait
AntiDeletionSettingTrait
AntiDeletionLevelSettingTrait
ActiveHardwareFaultsTrait
DebugInfoTrait
FreeMemoryTrait
AntiDeletionNotificationTrait
RebootCommand

RingtoneCoordination

管理网关本地铃声/音乐文件,包括下载、删除及与云端库的一致性校验。

functionCodetrait/commandCodeTrait 或 Command?
RingtoneCoordinationAPIDownloadMusicCommand
APICheckLocalMusicSyncCommand
APIDeleteMusicCommand

ZigbeeNetworkDiagnostics

提供 Zigbee 网络诊断能力,包括信道、PAN、邻居及路由等信息。

functionCodetrait/commandCodeTrait 或 Command?
ZigbeeNetworkDiagnosticsRoutingAgingCountThresholdTrait
PreOperationModeTrait
NWKRetransmissionCountTrait
ZigbeeTotalMessageInOneHourTrait
ZigbeeCoordMacTrait
APSRetransmissionCountTrait
ZigbeeResentMessageInOneHourTrait
PANIDTrait
ZigbeeExtendedPANIDTrait
ZigbeeGeneralDiagnosticsTrait
MessageTransmissionFailureCountThresholdTrait
EnableNWKACKTrait
RebootReasonTrait
ZigbeeKeySeqNumberTrait
LQITrait
ZigbeeFrameCounterTrait
ChannelTrait
CCAModeTrait
ZigbeeNextHopMacTrait
EnableAPSACKTrait
MACRetransmissionCountTrait
ZigbeeFailedMessageInOneHourTrait
ZigbeeNeighborTableInfoTrait
curOperationModeTrait
ZigbeeAvgSuccessfulResendCountTrait
ZigbeeCoordNetworkKeyTrait

MatterCoordination

集中管理 Matter 协议相关协同操作,包括入网、绑定、数据同步及证书管理。

functionCodetrait/commandCodeTrait 或 Command?
MatterCoordinationAPIPushMatterBindInfoCommand
APIUnbindMatterDeviceDownCommand
APIReportDeviceAqaraSpecModelCommand
APISyncAqaraSpecDataToCloudCommand
APIGenNextMatterNodeIdCommand
APIGenHomeMatterNocCommand
APIStartBindMatterDeviceToHubCommand
APIUnbindMatterDeviceUPCommand
APIQueryMatterJoinLimitCommand

ScreenCoordination

管理智能场景面板交互,包括配置下发、状态查询及云端/面板双向透传。

functionCodetrait/commandCodeTrait 或 Command?
ScreenCoordinationAPICloudToPanelDownstreamCommand
APIPanelUpstreamRequestCommand
APICheckPanelConfigConsistencyCommand
APISyncPositionDownCommand
APIPushPanelConfigCommand

CommLinkCoordination

监测网关与云端通信链路质量,执行耗时探测并上报结果。

functionCodetrait/commandCodeTrait 或 Command?
CommLinkCoordinationAPIReportLinkConsumingCommand
APICheckLinkConsumingCommand

IftttCoordination

作为自动化规则协同中心,管理 IFTTT/本地自动化规则的同步、订阅与执行。

functionCodetrait/commandCodeTrait 或 Command?
IftttCoordinationAPIUnsubscribeIftttResChangeCommand
APIEnableAutomationCommand
APIDeleteIftttLocalCommand
APIPushCentralAutomationCommand
APIRunCloudActionCommand
APIGetSunriseSunsetByLatLonCommand
APIEnableCentralAutomationCommand
APIDeleteCentralAutomationCommand
APIQueryIftttResCommand
APISubscribeIftttResChangeCommand
APIEnableIftttCommand
APIQueryHolidayListCommand
APIPublishResourceChangeCommand
APICheckLocalIftttSyncCommand
APIDownloadIftttLocalCommand

NetworkManagement

作为设备网络连接与访问策略的核心控制模块,管理远程代理及访问地址。

functionCodetrait/commandCodeTrait 或 Command?
NetworkManagementLanAccessAddressTrait
RemoteProxyAccessEnableTrait
InternetAccessAddressTrait

Identify

提供设备识别能力,可通过指示灯闪烁、声音等方式帮助用户定位物理设备。

functionCodetrait/commandCodeTrait 或 Command?
IdentifyIdentifyTypeTrait
ReverseIdentifyTrait
IdentifyTimeTrait
IdentifyCommand

LightBoxCoordination

管理智能灯箱设备的配置下发,控制展示内容与效果。

functionCodetrait/commandCodeTrait 或 Command?
LightBoxCoordinationAPIPushLightBoxConfigCommand

IRCoordination

管理网关红外学习与发射,包括码库同步、虚拟遥控器创建及按键控制。

functionCodetrait/commandCodeTrait 或 Command?
IRCoordinationAPIGetIrCodeCommand
APISaveLearnedIrKeyCommand
APIQueryIrLearningCodeCommand
APIStartIrCodeLearningCommand
APIGetIrCodeTargetCommand
APIQueryIrCodeLibraryCommand
APIGetIrCodeDownloadUrlCommand
APIDeleteLearnedIrCodeCommand
APISendIrButtonPressCommand
APISyncIrLearningCodesCommand

NetworkCommissioning

提供网络配网能力,支持 Wi-Fi、Thread 等网络的扫描、连接与配置。

functionCodetrait/commandCodeTrait 或 Command?
NetworkCommissioningAddOrUpdateZigbeeNetworkCommand
AddOrUpdateZigbeeNetworkResponseCommand
HomeStationCredentialsTrait
ConfigStaticIPAddrCommand
WiFiChannelTrait
ChildDeviceProvisioningStateTrait
ZigbeeDiagnosticsTrait
ZigbeeAuthRandcodeTrait
ZigbeeAuthRandcodeResponseTrait
WiFiDiagnosticsTrait
MagicPairKeychainTrait
ConnectToHomeStationResponseCommand
SupportedNetworkTrait
AddOrUpdateThreadNetworkCommand
AddOrUpdateThreadNetworkResponseCommand
TriggerZigbeeNetworkInfoUploadCommand
SlaveAddressTrait
ThreadDiagnosticsTrait
ScanWiFiNetworksCommand
ScanWiFiNetworksResponseCommand
AddOrUpdateWiFiNetworkCommand
AddOrUpdateWiFiNetworkResponseCommand
ConnectToHomeStationCommand
AuthenticationStatusTrait
WiFiRSSITrait

ConfigurationCoordination

通过组播或批量方式管理通用功能配置、资源订阅及位置信息同步。

functionCodetrait/commandCodeTrait 或 Command?
ConfigurationCoordinationAPISyncConfigurationCommand
APIWriteFunctionResourceCommand
APIPushSubscribedResourceCommand
APIReportConfigurationCommand
APIReportThingModelDetailCommand
APIGetConfigurationCommand
APIDeleteConfigurationCommand
APIPushConfigurationCommand

CloudStorageCoordination

管理云录像/云存业务资源配置,获取存储配额及上传凭证等信息。

functionCodetrait/commandCodeTrait 或 Command?
CloudStorageCoordinationAPIRequestCloudStorageResourceCommand

StudioCoordination

管理网关与 Aqara Studio 开发环境的集成,包括账号认证、项目备份与设备同步。

functionCodetrait/commandCodeTrait 或 Command?
StudioCoordinationAPIGetStudioBackupUploadUrlCommand
APILoginByAuthCodeCommand
APIGetAuthCodeCommand
APIDeleteStudioBackupCommand
APIGetPositionByDeviceIdCommand
APIGetStudioBackupInfoCommand
APIGetUserDeviceListCommand
APILoginByGuardCodeCommand
APIReportStudioInfoCommand
APIConfirmStudioBackupSuccessCommand
APIGetProxyServerInfoCommand

Temperature

测量并上报环境温度,提供当前温度值及有效量程等属性。

functionCodetrait/commandCodeTrait 或 Command?
TemperatureCurrentTemperatureTrait

TemperatureControl

提供温度设定与调节能力,用于恒温设备的目标温度控制。

functionCodetrait/commandCodeTrait 或 Command?
TemperatureControlSetTemperatureLevelTrait
SetTemperatureTrait
ChangeTemperatureLevelCommand
ChangeTemperatureCommand

PackageRecognition

自动识别画面中的包裹,在投递或取走时可发送提醒并记录事件。

functionCodetrait/commandCodeTrait 或 Command?
PackageRecognitionPackageRecognitionReportTrait

FaceRecognition

采集人脸特征并与本地库比对,上报人脸识别结果及匹配信息。

functionCodetrait/commandCodeTrait 或 Command?
FaceRecognitionFaceIDReportTrait

HumanPresence

检测空间内人体存在,支持人数统计、轨迹及身份关联等高级感知能力。

functionCodetrait/commandCodeTrait 或 Command?
HumanPresenceHoldTimeTrait
ResetPresenceCommand
ActivityDetectedTrait
PresenceConfigurationTrait
PresenceTrait

HumanRecognition

利用视觉等算法实时检测画面中的人形目标,区分人体与其他物体并上报事件。

functionCodetrait/commandCodeTrait 或 Command?
HumanRecognitionHumanRecognitionReportTrait

AirQuality

监测并上报空气质量指标,如 AQI 或综合空气质量等级。

functionCodetrait/commandCodeTrait 或 Command?
AirQualityVOCDensityTrait
AirQualityTrait
VOCQualityTrait

AttitudeDetection

检测设备姿态或倾斜角度变化,上报姿态异常或角度信息。

functionCodetrait/commandCodeTrait 或 Command?
AttitudeDetectionAttitudeDetectedTrait

Lifter

提供升降类设备的行程控制,支持设定目标位置、停止及状态查询。

functionCodetrait/commandCodeTrait 或 Command?
LifterGoToMaxPositionPercentageCommand
AutoControlCommand
GoToPositionPercentageCommand
GoToMinPositionPercentageCommand
TripTimeTrait
TargetPositionPercentageTrait
CurrentPositionPercentageTrait
StopMotionCommand

Binding

表示端点与一个或多个其他本地或远程 Endpoint 之间的持久绑定关系。

functionCodetrait/commandCodeTrait 或 Command?
BindingBindingTrait
SupportedBindingDeviceTypesTrait
SupportedBindingFunctionsTrait

PetFeeder

提供宠物喂食控制能力,包括出粮份数、喂食计划及余量状态。

functionCodetrait/commandCodeTrait 或 Command?
PetFeederFeedTrait

Button

描述按钮类输入设备的事件上报,包括单击、长按、多击等动作识别。

functionCodetrait/commandCodeTrait 或 Command?
ButtonLocalControlDisabledTrait
ButtonEventTrait

Output

提供开关输出控制能力,支持读取和控制负载的通断状态。

functionCodetrait/commandCodeTrait 或 Command?
OutputToggleCommand
OutputSwitchingTypeTrait
OnOffTrait
OutputInterlockFlagTrait
OutputNodeModeTrait
OffCommand
StartUpOnOffTrait
OnCommand

IRControl

提供红外发射控制能力,用于控制空调、电视等传统红外家电。

functionCodetrait/commandCodeTrait 或 Command?
IRControlSendIRCodeCommand
IRKeyTrait
IRTypeTrait

HeaterCooler

提供制冷/制热控制能力,包括目标温度、运行模式、风速等暖通参数。

functionCodetrait/commandCodeTrait 或 Command?
HeaterCoolerCoolingTemperatureTrait
CurrentHumidityTrait
ClearActivePresetCommand
CurrentTemperatureTrait
PresetTrait
SetActivePresetCommand
SetBackTrait
PresetTypesTrait
HeaterCoolerModeTrait
ActivePresetHandleTrait
HeatingTemperatureTrait
NumberOfPresetsTrait
HeaterCoolerButtonEventTrait
MinHeatCoolDeadBandTrait
CurrentTemperatureCalibrationTrait
TemperatureUIDisplayModeTrait
AntiFreezeTemperatureTrait
HeaterCoolerPolarityTrait

Vibration

检测振动或动静变化,上报移动、倾斜、跌落等事件。

functionCodetrait/commandCodeTrait 或 Command?
VibrationTiltAngleDeviationTrait
StationaryStateTrait
InitialTiltAngleTrait
EventReportIntervalTrait
ObjectOrientationEnableTrait
StationaryTiltAngleTrait
PeakTiltAngleTrait
ObjectMotionDetectionEnableTrait
ObjectOrientationStateTrait
VibrationEventTrait

Cube

描述魔方控制器的手势识别,包括翻转、旋转、摇一摇等动作及面识别。

functionCodetrait/commandCodeTrait 或 Command?
CubeCubeWorkModeSettingTrait
TopFaceTrait
CubeEventTrait
TopFaceChangedTrait

Knob

描述旋钮类输入设备的旋转角度、按压及组合动作事件。

functionCodetrait/commandCodeTrait 或 Command?
KnobHoldRotationIntervalTrait
RotationEventTrait
RotationDirectionTrait
InvertedRotationAngleTrait
RotationAngleTrait
RotationIntervalTrait
HoldRotationAngleTrait

BinaryOutputObject

驱动二元执行器输出,如继电器、接触器、电磁阀或警号。

functionCodetrait/commandCodeTrait 或 Command?
BinaryOutputObjectBinaryOutputPVTrait

AnalogInputObject

以只读方式采集连续变化的模拟量输入(如电压、温度模拟信号)。

functionCodetrait/commandCodeTrait 或 Command?
AnalogInputObjectAnalogInputPVTrait

MediaPlayback

提供媒体播放控制能力,包括播放、暂停、切歌、音量及播放状态管理。

functionCodetrait/commandCodeTrait 或 Command?
MediaPlaybackPauseCommand
TargetPlaybackStateTrait
StopCommand
MediaInformationTrait
PlaybackDurationTrait
MediaPlaybackCommandCommand
CurrentPlaybackStateTrait
PlaybackModeTrait
RewindCommand
SampledPositionTrait
PlayCommand
StartOverCommand
PlaySpecificListCommand
LoginStateTrait
FastForwardCommand
NextCommand
PreviousCommand
PlaybackSampledPositionTrait
SelectedMediaOutputSourceTrait
SelectedSourceTrait

MediaInput

描述媒体输入源管理与切换,支持选择当前播放源及输入列表。

functionCodetrait/commandCodeTrait 或 Command?
MediaInputSelectInputCommand
MediaInputTrait

FlameDetection

通过图像或传感器算法检测可见火焰,即时上报火情事件以便早期预警。

functionCodetrait/commandCodeTrait 或 Command?
FlameDetectionFlameDetectedTrait

OperationalState

描述设备当前运行状态,如空闲、运行中、暂停、故障等。

functionCodetrait/commandCodeTrait 或 Command?
OperationalStatePauseCommand
OperationalErrorTrait
StartCommand
StopCommand
OperationalStateTrait
ResumeCommand

RefrigeratorState

描述冰箱运行状态,包括空闲、制冷、除霜、故障等。

functionCodetrait/commandCodeTrait 或 Command?
RefrigeratorStateRefrigeratorAlarmTrait

Mode

提供设备特性模式接口,支持在多种预定义模式间切换。

functionCodetrait/commandCodeTrait 或 Command?
ModeCurrentModeTrait
ChangeToModeCommand
ChangeToModeResponseTrait

BridgedConfiguration

描述被桥接子设备的配置信息,用于 Matter/Zigbee 桥接场景。

functionCodetrait/commandCodeTrait 或 Command?
BridgedConfigurationBridgeDeviceIDTrait

MultiStateInputObject

采集多状态离散输入,表示 N 种状态之一。

functionCodetrait/commandCodeTrait 或 Command?
MultiStateInputObjectMultiStateInputPVTrait

MARSConfiguration

提供智能负载(MARS)相关配置,用于负载识别与智能配电管理。

functionCodetrait/commandCodeTrait 或 Command?
MARSConfigurationPulseDurationTrait
LoadTypeTrait

ScreenUserInterface

管理屏端用户界面配置,包括页面布局、卡片、主题及展示数据。

functionCodetrait/commandCodeTrait 或 Command?
ScreenUserInterfaceThemeIDTrait
AllpagesTrait
MaxPageNumTrait
ScreenWidthTrait
DataVersionTrait
ThemeVersionTrait
ScreenHeightTrait

CustomizedConfiguration

提供厂商或用户自定义扩展配置项的读写能力。

functionCodetrait/commandCodeTrait 或 Command?
CustomizedConfigurationEnableIndicatorTrait
StartUpOnOffTrait

HEPAFilterMonitoring

监测 HEPA 滤芯使用情况、剩余寿命及更换提醒。

functionCodetrait/commandCodeTrait 或 Command?
HEPAFilterMonitoringConditionTrait
ChangeIndicationTrait
ResetConditionCommand

ActivatedCarbonFilterMonitoring

监测活性炭滤芯使用情况、剩余寿命及更换提醒。

functionCodetrait/commandCodeTrait 或 Command?
ActivatedCarbonFilterMonitoringConditionTrait
ChangeIndicationTrait
ResetConditionCommand

FanControl

提供风扇转速与模式控制,支持档位调节及运行状态读取。

functionCodetrait/commandCodeTrait 或 Command?
FanControlWindSettingTrait
AirflowDirectionTrait
FanModeTrait
FanSpeedTrait
RockSettingTrait

HeartMonitoring

利用传感器持续或周期性测量用户心率,记录并分析心脏健康相关数据。

functionCodetrait/commandCodeTrait 或 Command?
HeartMonitoringHeartRateTrait

Pressure

测量并上报大气压力或系统压力值。

functionCodetrait/commandCodeTrait 或 Command?
PressureCurrentPressureTrait

MultiStateOutputObject

输出多状态离散控制命令,如 HVAC 模式或灯光场景切换。

functionCodetrait/commandCodeTrait 或 Command?
MultiStateOutputObjectMultiStateOutputPVTrait

Contact

检测接触/门磁类二元状态,上报打开或关闭状态及可选角度信息。

functionCodetrait/commandCodeTrait 或 Command?
ContactContactSensorStateTrait
OpenAngleTrait

Doorbell

提供门铃相关能力,包括呼叫事件上报及与室内铃铛/中继的联动。

functionCodetrait/commandCodeTrait 或 Command?
DoorbellButtonEventTrait
VolumeTrait

WaterFreezeDetector

用于检测管道或环境中是否存在结冰风险,并在达到阈值时上报水冻结相关事件。

functionCodetrait/commandCodeTrait 或 Command?
WaterFreezeDetectorBooleanStateTrait

Speaker

描述设备扬声器输出能力,包括音量控制及静音等音频输出属性。

functionCodetrait/commandCodeTrait 或 Command?
SpeakerStepValueTrait
VolumeTrait
MuteTrait

DoorLock

提供智能门锁核心能力,包括锁状态、用户/凭证管理、开锁/上锁及告警事件。

functionCodetrait/commandCodeTrait 或 Command?
DoorLockLockOperationTrait
UnboltDoorCommand
SupportedRemoteFeaturesTrait
SetWeekDayScheduleCommand
QuietUnlockDoorCommand
GetYearDayScheduleCommand
NumberOfCredentialsSupportedPerUserTrait
LockOperationErrorTrait
NumberOfTotalUsersSupportedTrait
DoorStateTrait
NumberOfYearDaySchedulesSupportedPerUserTrait
LockStateTrait
ClearWeekDayScheduleCommand
GetUserCommand
UnlockDoorCommand
EnableRemoteControlTrait
NumberOfPINUsersSupportedTrait
SetYearDayScheduleCommand
GetWeekDayScheduleCommand
LockUserChangeTrait
RemoteControlWithAuthCodeTrait
DoorLockAlarmTrait
RemoteUnlockTrait
NumberOfRFIDUsersSupportedTrait
LockDoorCommand
ClearYearDayScheduleCommand
QuietLockDoorCommand
NumberOfWeekDaySchedulesSupportedPerUserTrait

CO2

测量并上报环境中二氧化碳浓度。

functionCodetrait/commandCodeTrait 或 Command?
CO2CO2LevelTrait
CO2DensityTrait

VacuumOperationalState

描述扫地机器人当前运行状态,如清扫中、回充中、充电中等。

functionCodetrait/commandCodeTrait 或 Command?
VacuumOperationalStateGoHomeCommand
VacuumOperationalErrorTrait
PauseCommand
StartCommand
StopCommand
VacuumOperationalStateTrait
ResumeCommand

ValveControl

提供阀门自动控制或手动控制能力,用于精确调节水/气流量。

functionCodetrait/commandCodeTrait 或 Command?
ValveControlCurrentValveStateTrait
DefaultOpenDurationTrait
CloseCommand
RemainingDurationTrait
OpenCommand

ScreenDisplay

管理屏幕显示相关硬件属性,如分辨率、亮度、背光及显示状态。

functionCodetrait/commandCodeTrait 或 Command?
ScreenDisplayScreenBrightnessTrait

Illuminance

测量并上报环境光照度(lux)。

functionCodetrait/commandCodeTrait 或 Command?
IlluminanceSamplingIntervalTrait
CurrentIlluminanceTrait

Camera

管理摄像机基础能力,包括设备状态、模式切换、图像加密及云端相关能力。

functionCodetrait/commandCodeTrait 或 Command?
CameraCameraActiveStatusTrait
CameraRTSPURLTrait
P2PCaptureStatusTrait
CameraRTSPEnableTrait
P2PCaptureEnabledTrait

Gas

检测可燃气体或有害气体泄漏并上报告警事件。

functionCodetrait/commandCodeTrait 或 Command?
GasCurrentSensitivityLevelTrait
GasDensityTrait
SelfCheckTrait
MuteTrait
GasDetectedTrait

GestureRecognition

实时分析手势动作,将预定义手势转换为控制指令。

functionCodetrait/commandCodeTrait 或 Command?
GestureRecognitionGestureRecognitionReportTrait

BreathingMonitoring

利用传感器持续或周期性测量用户呼吸频率与模式,支持健康监测。

functionCodetrait/commandCodeTrait 或 Command?
BreathingMonitoringBreathingRateTrait

CharacterStringValueObject

定义以字符串形式表示的数据对象及其外部可见特性。

functionCodetrait/commandCodeTrait 或 Command?
CharacterStringValueObjectCharStringValuePVTrait

Sweeper

提供扫地机器人基础控制,包括启动清扫、暂停、回充等操作与状态反馈。

functionCodetrait/commandCodeTrait 或 Command?
SweeperContinueCleaningCommand
SweeperStateTrait
PauseCleaningCommand
StartCleaningCommand
StopCleaningCommand

EVSE

提供电动汽车供电设备(EVSE)控制能力,包括充电启停、电流限制及充电状态。

functionCodetrait/commandCodeTrait 或 Command?
EVSEEvseSupplyStateTrait
MinChargeCurrentTrait
EvseStateTrait
ChargingEnabledUntilTrait
BatteryCapacityTrait
VehicleIDTrait
EvseFaultStateTrait
BatPercentRemainingTrait
EnableChargingCommand
MaxChargeCurrentTrait
CurrentFlowTrait
DisableChargingCommand

CO

提供一氧化碳浓度监测与报警相关能力,用于检测环境中的一氧化碳泄漏并及时告警。

functionCodetrait/commandCodeTrait 或 Command?
COExpressedStateTrait
CODetectedTrait
SelfTestRequestCommand

Lighting

本 Function 提供对灯光动态效果的激活与控制能力。服务端提供可由不同来源驱动的效果列表,客户端可从中选择并触发。

动态灯效既可用于支持 Color Control Function 的灯具,也可用于仅支持 Level Control Function 的灯具(例如可调光灯)。

效果的具体实现属于厂商自定义范围。不同厂商设备即使使用相同 EffectID,也不保证表示同一种效果;同一厂商可在不同设备复用同一 EffectID 以表达一致实现。

functionCodetrait/commandCodeTrait 或 Command?
LightingBuiltInEffectsTrait
PreviewEffectCommand
MaxUserDefinedEffectsTrait
CurrentEffectIDTrait
UpdateUserDefinedEffectCommand
RemoveUserDefinedEffectCommand
GetEffectDataCommand
StartEffectCommand
EffectInfoTrait
AddUserDefinedEffectCommand
MaxEffectNameLengthTrait
StopPreviewCommand
UserDefinedEffectsTrait
PreviewTransitionCommand

LevelControl

提供亮度等级调节能力,支持设置/读取当前亮度、步进调光、以及与开关联动或解耦的调光控制。

functionCodetrait/commandCodeTrait 或 Command?
LevelControlStepBrightnessCommand
OnTransitionTimeTrait
SetBrightnessCommand
StepBrightnessWithOnOffCommand
SetBrightnessWithOnOffCommand
CurrentLevelTrait
OffTransitionTimeTrait

ColorControl

提供颜色控制能力,支持通过 HSV、XY 与色温模式调节灯光颜色,并支持与亮度命令组合下发。

本 Function 提供灯光颜色调节接口。颜色定义遵循 CIE 1931 色彩空间,核心控制方式为 x、y 色度坐标(对应 ColorXY / CurrentX / CurrentY)。 此外,颜色可选通过 ColorTemperature(色温)或 Hue + Saturation 方式控制;Hue 与 Saturation 建议按 HSV(HSB)模型解释。RGB/W 原色点能力可用于扩展颜色表达范围。 本 Function 不负责亮度控制;亮度由 LevelControl Function 提供。联动控制时,LevelControl 中的亮度值应按“当前颜色下可达到最大光强的比例”解释。

functionCodetrait/commandCodeTrait 或 Command?
ColorControlMoveToXYColorCommand
CurrentYTrait
ColorModeTrait
WhitePointXYTrait
ColorTemperatureTrait
LEDICQuantityTrait
ColorRGBTrait
ColorXYTrait
HueTrait
StartUpXYColorTrait
MoveToHueSaturationBrightnessCommand
LightingMusicSyncModeTrait
StartUpColorTemperatureTrait
LightingDynamicSceneModeTrait
SaturationTrait
CurrentGTrait
MoveToHueAndSaturationCommand
MoveToColorTemperatureBrightnessCommand
CurrentBTrait
LightingMusicSyncEnableTrait
MoveToXYColorBrightnessCommand
StepColorTemperatureCommand
MoveToColorTemperatureCommand
CurrentXTrait
ColorPointRGBXYTrait
LEDICProtocolTrait
LEDTypeTrait
CurrentRTrait

PanTilt

提供云台(Pan/Tilt/Zoom)控制能力,包括预置位、校准及相对/绝对移动。

functionCodetrait/commandCodeTrait 或 Command?
PanTiltPanTiltDirectionControlCommand

WindowCovering

本 Function 提供窗帘、卷帘、百叶帘等窗饰设备的开合控制、倾斜控制、目标位置管理与运行状态反馈能力。

除标准开合/倾斜控制外,本 Function 还包含 Aqara 扩展能力:场景管理(内置/自定义场景的启动、读取、预览、增删改)、手动校准、远程配对、电机映射交换与增强模式状态。

客户端应结合 TravelConfigured、MotorControllability、MotorOperationStatus、EnhanceMode 等 Trait 判断设备当前可控性与操作阶段,避免在不满足条件时下发无效命令。

functionCodetrait/commandCodeTrait 或 Command?
WindowCoveringMotorSpeedPercentageTrait
WindowCoveringCategoryTrait
WindowCoveringMotorsBindingTrait
UnconfiguredTravelControlPermissionTrait
LimitPointSettingTrait
ObstacleLimitMarkingBlockTimeTrait
MotorSpeedSettingTrait
ManualPullStartStopEnabledTrait
CurrentRotationAngleTrait
ObstacleLimitSensitivityTrait
TripTimeTrait
TravelConfiguredTrait
CurrentPositionPercentageTrait
StopMotionCommand
MotorControllabilityTrait
RotationControlCommand
MotorDirectionReversedTrait
GoToPositionRotationPercentageCommand
StepPositionCommand
WindowCoveringTypeTrait
ObstacleLimitAutoReboundEnableTrait
GoToPositionPercentageCommand
GoToMinPositionPercentageCommand
ManualPullEventTrait
TargetPositionPercentageTrait
TargetRotationAngleTrait
GoToMaxPositionPercentageCommand
WindowCoveringOpenOrientationTrait
MotorOperationStatusTrait
AutoControlCommand
ManualPullStartEnabledTrait
LimitPointCountTrait
TargetPositionRotationPercentageTrait
CurrentPositionRotationPercentageTrait
ManualPullStopEnabledTrait
ObstacleLimitMarkingEnableTrait
ManualPullAdaptiveSpeedEnabledTrait

Flow

测量并上报液体或气体的流量速率。

functionCodetrait/commandCodeTrait 或 Command?
FlowCurrentFlowTrait

OccupancySensing

检测空间内是否有人存在,上报占用/空闲状态及保持时间等参数。

functionCodetrait/commandCodeTrait 或 Command?
OccupancySensingHoldTimeTrait
DurationOccupiedWithinOneWeekTrait
OccupancyTrait
DurationOccupiedWithinOneDayTrait
OccupancySensorTypeTrait

RainSensor

用于检测降雨状态,上报是否正在下雨及雨量相关信息。

functionCodetrait/commandCodeTrait 或 Command?
RainSensorBooleanStateTrait

Smoke

检测烟雾并上报报警事件,支持灵敏度、自检及静音等相关配置。

functionCodetrait/commandCodeTrait 或 Command?
SmokeExpressedStateTrait
FireProductIdentificationTrait
SmokeDensitydBTrait
SmokeChamberContaminationTrait
AlarmErrorTrait
SelfCheckTrait
SmokeStateTrait
TriggerWarningCommand
SelfTestRequestCommand
AlarmsEnabledTrait
ContaminationStateTrait
MuteTrait
SmokeDensityTrait
SmokeDetectedTrait
EnableHeartbeatIndicatorTrait

FreshAirControl

提供新风系统控制能力,支持引入室外空气并进行风量、模式等调节。

functionCodetrait/commandCodeTrait 或 Command?
FreshAirControlFreshAirModeTrait

AnalogOutputObject

提供可写的连续模拟量输出控制信号。

functionCodetrait/commandCodeTrait 或 Command?
AnalogOutputObjectAnalogOutputPVTrait

Location

提供设备或目标的位置信息上报与查询能力。

functionCodetrait/commandCodeTrait 或 Command?
LocationMotionDetectedTrait

PetRecognition

识别画面中的猫、狗等宠物个体,上报宠物出现或相关识别事件。

functionCodetrait/commandCodeTrait 或 Command?
PetRecognitionPetRecognitionReportTrait

ParticulateMatter

监测并上报颗粒物浓度(如 PM2.5、PM10)。

functionCodetrait/commandCodeTrait 或 Command?
ParticulateMatterPM1.0DensityTrait
PM2.5DensityTrait
PM2.5LevelTrait
PM10DensityTrait

OnOffSensor

用于检测二元开关量输入状态,上报开/关或触发/未触发等离散状态。

functionCodetrait/commandCodeTrait 或 Command?
OnOffSensorBooleanStateTrait

SoundDetection

通过麦克风采集环境声音,识别特定声音类型(如玻璃破碎、婴儿哭声)并告警。

functionCodetrait/commandCodeTrait 或 Command?
SoundDetectionAnomalySoundDetectedTrait

Ringtone

提供铃声与音乐播放控制,支持选曲、音量/时长调节及播放状态监测。

functionCodetrait/commandCodeTrait 或 Command?
RingtoneRingtonePlayVolumeTrait
RingtonePlayIndexTrait
RingtonePlayStatusTrait
RingtonePlayDurationTrait

BridgeConfiguration

管理网关桥接配置,描述子设备接入、桥接能力及网络拓扑相关信息。

functionCodetrait/commandCodeTrait 或 Command?
BridgeConfigurationBridgedNodeListTrait
SupportedHubCapabilityTrait

MatterBridgeCommissioning

管理 Matter Bridge 向第三方 Matter 生态分享桥接设备的能力。

functionCodetrait/commandCodeTrait 或 Command?
MatterBridgeCommissioningMatterBridgeSupportedTrait
MatterDACStateTrait
MatterOnboardingPayloadTrait
MatterManufacturerListTrait
RemoveOneMatterManufacturerCommand
RemoveAllMatterManufacturerCommand
MatterBindStateTrait
MatterPairingStateTrait
MatterPairingSwitchTrait

GarageDoorOpener

提供车库门控制与状态反馈,包括开/关/停止及位置状态。

functionCodetrait/commandCodeTrait 或 Command?
GarageDoorOpenerTargetGarageDoorStateTrait
ToggleCommand
CurrentGarageDoorStateTrait

RelativeHumidity

测量并上报环境相对湿度,提供当前湿度值及有效量程等属性。

functionCodetrait/commandCodeTrait 或 Command?
RelativeHumidityCurrentHumidityTrait

Sleep

监测睡眠相关状态,上报睡眠阶段、时长或质量等指标。

functionCodetrait/commandCodeTrait 或 Command?
SleepSleepQualityTrait
SleepStageTrait
SleepStateTrait
OnBedTrait

BinaryInputObject

采集二元状态输入,如门磁、开关等 true/false 或 active/inactive 量。

functionCodetrait/commandCodeTrait 或 Command?
BinaryInputObjectBinaryInputPVTrait

WaterLeak

检测水浸事件,在检测到漏水时及时上报告警。

functionCodetrait/commandCodeTrait 或 Command?
WaterLeakLeakStateTrait

VehicleDetection

检测监控区域内的车辆出现,上报车辆存在事件供安防或自动化使用。

functionCodetrait/commandCodeTrait 或 Command?
VehicleDetectionVehicleDetectedTrait