功能代码
概览
| 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 集群等信息。
| functionCode | trait/commandCode | Trait 或 Command? |
|---|---|---|
| Descriptor | SupportedEndpointDynamic | Trait |
| EndpointCount | Trait | |
| EndpointStructure | Trait | |
| EndpointDeviceTypes | Trait | |
| EndpointDynamicCount | Trait | |
| EndpointArrayDynamic | Trait | |
| EndpointArray | Trait | |
| EndpointFunctions | Trait | |
| SelectedEndpointDynamic | Trait |
BasicInformation
提供设备基本信息,包括厂商、产品型号、固件版本、序列号、在线状态等基础属性。
| functionCode | trait/commandCode | Trait 或 Command? |
|---|---|---|
| BasicInformation | ProductName | Trait |
| PartNumber | Trait | |
| BLVersion | Trait | |
| ManufacturerChipID | Trait | |
| SupportedMatterRoles | Trait | |
| HardwareVersionString | Trait | |
| HubConnectionStatus | Trait | |
| DeviceXCode | Trait | |
| MatterSpecificationVersion | Trait | |
| VendorName | Trait | |
| FirmwareRevisionString | Trait | |
| DeviceID | Trait | |
| VendorID | Trait | |
| MCUVersion | Trait | |
| ProductID | Trait | |
| ConfigurationFlag | Trait | |
| ModelValue | Trait | |
| HardwareVersion | Trait | |
| Mac | Trait | |
| RadarVersion | Trait | |
| SerialNumber | Trait | |
| ConfigurationVersion | Trait | |
| Reachable | Trait | |
| FirmwareRevision | Trait | |
| ChipTemperature | Trait | |
| Location | Trait |
EndpointLabel
管理端点的可见性与展示信息,如名称、房间、图标、标签等,用于前端展示与组织。
| functionCode | trait/commandCode | Trait 或 Command? |
|---|---|---|
| EndpointLabel | EndpointTag | Trait |
| EndpointName | Trait | |
| EndpointApplianceType | Trait | |
| EndpointRoom | Trait | |
| EndpointVisibility | Trait | |
| EndpointIcon | Trait | |
| EndpointStatistics | Trait | |
| EndpointRoomName | Trait |
CameraCoordination
处理摄像机复杂业务逻辑,包括 WebRTC 通话、云台控制、识别数据同步及扩展事件。
| functionCode | trait/commandCode | Trait 或 Command? |
|---|---|---|
| CameraCoordination | APIUnbindWiFiSubdevice | Command |
| APICheckCarDataConsistency | Command | |
| APIBindWiFiSubdevice | Command | |
| APIOperateBridgedDevice | Command | |
| APIDeviceCameraCall | Command | |
| APIOperateCameraUp | Command | |
| APIIssueTokenForWebRTCCall | Command | |
| APIOperateCameraDown | Command | |
| APIGetSignallingServerAddress | Command | |
| APIReportCameraExtEvents | Command | |
| APICheckFaceDataConsistency | Command |
GeneralConfiguration
提供通用设备配置项,如灵敏度、延时、默认参数等设备级设置。
| functionCode | trait/commandCode | Trait 或 Command? |
|---|---|---|
| GeneralConfiguration | VoiceLanguage | Trait |
| EnergySavingEnable | Trait | |
| CurrentSensitivityLevel | Trait | |
| TransmissionPowerSetting | Trait | |
| HubArkTechEnable | Trait | |
| BeepEnable | Trait | |
| NightLightMode | Trait | |
| OutputInterlockFlag | Trait | |
| ActivityDetectionModeSetting | Trait | |
| TimeZone | Trait | |
| NumberOfSensitivityLevelIsSupported | Trait | |
| PollingTime | Trait | |
| InstallationOrientationConfiguration | Trait | |
| DetectionModeSetting | Trait | |
| LightingModeSetting | Trait | |
| ResetMode | Trait |
EcosystemInformation
描述设备所接入的生态平台信息,如 HomeKit、Matter Fabric 等绑定状态。
| functionCode | trait/commandCode | Trait 或 Command? |
|---|---|---|
| EcosystemInformation | MagicPairPayload | Trait |
| SupportedEcosystem | Trait | |
| MatterPayload | Trait | |
| HomeKitPayload | Trait | |
| BoundEcosystem | Trait |
EnergyManagement
管理设备电量与能耗信息,包括电量百分比、功耗统计及低电告警等。
| functionCode | trait/commandCode | Trait 或 Command? |
|---|---|---|
| EnergyManagement | CurrentVoltage | Trait |
| CircuitCurrent | Trait | |
| CumulativeEnergyConsumption | Trait | |
| CurrentPower | Trait |
HubCoordination
作为网关核心协同模块,管理子设备入网、配置、心跳、令牌及各类代理服务。
SceneCoordination
管理智能场景(自动化规则)生命周期,包括同步、删除、触发执行及一致性校验。
| functionCode | trait/commandCode | Trait 或 Command? |
|---|---|---|
| SceneCoordination | APICheckLocalSceneSync | Command |
| APIDownloadLocalScene | Command | |
| APIRunScene | Command | |
| APIDeleteLocalScene | Command | |
| APIRunLocalScene | Command | |
| APIDownloadCentralScene | Command |
PowerSource
描述设备供电来源与电池状态,包括电量、充电状态、电池类型等信息。
| functionCode | trait/commandCode | Trait 或 Command? |
|---|---|---|
| PowerSource | CurrentVoltage | Trait |
| BatReplacementDescription | Trait | |
| BatChargeState | Trait | |
| BatReplaceability | Trait | |
| PowerMode | Trait | |
| BatPercentRemaining | Trait | |
| WiredPresent | Trait | |
| Rechargeable | Trait | |
| StateOfLowBat | Trait | |
| BatReplacementNeeded | Trait | |
| BatQuantity | Trait |
WakeupCoordination
为支持远程唤醒的低功耗设备获取唤醒服务地址或令牌。
| functionCode | trait/commandCode | Trait 或 Command? |
|---|---|---|
| WakeupCoordination | APIGetWakeupUrl | Command |
CentralHubCoordination
管理中枢网关高级能力,包括中枢启用、Broker 信息及数据透传通道。
| functionCode | trait/commandCode | Trait 或 Command? |
|---|---|---|
| CentralHubCoordination | APIInquiryCentralBroker | Command |
| APIHubPassthroughDataDown | Command | |
| APIEnableCentralHubFunction | Command | |
| APIHubPassthroughDataUp | Command | |
| APIInquiryCentralEnableState | Command |
SecurityGuardCoordination
管理家庭空间安防警戒能力,包括警戒启停、告警确认及本地/云端配置同步。
| functionCode | trait/commandCode | Trait 或 Command? |
|---|---|---|
| SecurityGuardCoordination | APIDeleteSecurityLocal | Command |
| APISyncSecurityLanInfo | Command | |
| APICheckSecurityEnableConsistency | Command | |
| APIConfirmSecurityAlert | Command | |
| APICheckSecurityConfigConsistency | Command | |
| APIEnableSecurity | Command | |
| APIRepairSecurityEnable | Command |
OTACoordination
管理 OTA 固件升级协同流程,包括任务下发、进度上报、结果反馈及版本查询。
| functionCode | trait/commandCode | Trait 或 Command? |
|---|---|---|
| OTACoordination | APIReportOtaDeviceListState | Command |
| APIReportOtaResult | Command | |
| APIReportOtaProgress | Command | |
| APICancelOtaUpgrade | Command | |
| APIInquiryFirmwareInfo | Command | |
| APIUpgradeDeviceFirmware | Command |
LockCoordination
处理智能门锁扩展业务,包括专用透传通道、加解密协助及扩展事件上报。
| functionCode | trait/commandCode | Trait 或 Command? |
|---|---|---|
| LockCoordination | APILockPassthroughUpstream | Command |
| APILockPassthroughDownstream | Command | |
| APIAssistDeviceCrypto | Command | |
| APIReportLockExtEvents | Command |
DeviceAnomalyMonitoring
持续监测设备运行参数,及时发现并上报异常或故障状态。
| functionCode | trait/commandCode | Trait 或 Command? |
|---|---|---|
| DeviceAnomalyMonitoring | LoadSafetyManagement | Trait |
| VoltageSafetyManagement | Trait | |
| CurrentSafetyManagement | Trait | |
| OverCurrentResponseSetting | Trait | |
| TemperatureSafetyManagement | Trait |
GeneralDiagnostics
提供通用诊断信息,包括运行时间、重启次数、网络接口及硬件故障等。
| functionCode | trait/commandCode | Trait 或 Command? |
|---|---|---|
| GeneralDiagnostics | RebootCount | Trait |
| RebootReason | Trait | |
| UpTime | Trait | |
| NetworkInterfaces | Trait | |
| AntiDeletionSetting | Trait | |
| AntiDeletionLevelSetting | Trait | |
| ActiveHardwareFaults | Trait | |
| DebugInfo | Trait | |
| FreeMemory | Trait | |
| AntiDeletionNotification | Trait | |
| Reboot | Command |
RingtoneCoordination
管理网关本地铃声/音乐文件,包括下载、删除及与云端库的一致性校验。
| functionCode | trait/commandCode | Trait 或 Command? |
|---|---|---|
| RingtoneCoordination | APIDownloadMusic | Command |
| APICheckLocalMusicSync | Command | |
| APIDeleteMusic | Command |
ZigbeeNetworkDiagnostics
提供 Zigbee 网络诊断能力,包括信道、PAN、邻居及路由等信息。
| functionCode | trait/commandCode | Trait 或 Command? |
|---|---|---|
| ZigbeeNetworkDiagnostics | RoutingAgingCountThreshold | Trait |
| PreOperationMode | Trait | |
| NWKRetransmissionCount | Trait | |
| ZigbeeTotalMessageInOneHour | Trait | |
| ZigbeeCoordMac | Trait | |
| APSRetransmissionCount | Trait | |
| ZigbeeResentMessageInOneHour | Trait | |
| PANID | Trait | |
| ZigbeeExtendedPANID | Trait | |
| ZigbeeGeneralDiagnostics | Trait | |
| MessageTransmissionFailureCountThreshold | Trait | |
| EnableNWKACK | Trait | |
| RebootReason | Trait | |
| ZigbeeKeySeqNumber | Trait | |
| LQI | Trait | |
| ZigbeeFrameCounter | Trait | |
| Channel | Trait | |
| CCAMode | Trait | |
| ZigbeeNextHopMac | Trait | |
| EnableAPSACK | Trait | |
| MACRetransmissionCount | Trait | |
| ZigbeeFailedMessageInOneHour | Trait | |
| ZigbeeNeighborTableInfo | Trait | |
| curOperationMode | Trait | |
| ZigbeeAvgSuccessfulResendCount | Trait | |
| ZigbeeCoordNetworkKey | Trait |
MatterCoordination
集中管理 Matter 协议相关协同操作,包括入网、绑定、数据同步及证书管理。
| functionCode | trait/commandCode | Trait 或 Command? |
|---|---|---|
| MatterCoordination | APIPushMatterBindInfo | Command |
| APIUnbindMatterDeviceDown | Command | |
| APIReportDeviceAqaraSpecModel | Command | |
| APISyncAqaraSpecDataToCloud | Command | |
| APIGenNextMatterNodeId | Command | |
| APIGenHomeMatterNoc | Command | |
| APIStartBindMatterDeviceToHub | Command | |
| APIUnbindMatterDeviceUP | Command | |
| APIQueryMatterJoinLimit | Command |
ScreenCoordination
管理智能场景面板交互,包括配置下发、状态查询及云端/面板双向透传。
| functionCode | trait/commandCode | Trait 或 Command? |
|---|---|---|
| ScreenCoordination | APICloudToPanelDownstream | Command |
| APIPanelUpstreamRequest | Command | |
| APICheckPanelConfigConsistency | Command | |
| APISyncPositionDown | Command | |
| APIPushPanelConfig | Command |
CommLinkCoordination
监测网关与云端通信链路质量,执行耗时探测并上报结果。
| functionCode | trait/commandCode | Trait 或 Command? |
|---|---|---|
| CommLinkCoordination | APIReportLinkConsuming | Command |
| APICheckLinkConsuming | Command |
IftttCoordination
作为自动化规则协同中心,管理 IFTTT/本地自动化规则的同步、订阅与执行。
| functionCode | trait/commandCode | Trait 或 Command? |
|---|---|---|
| IftttCoordination | APIUnsubscribeIftttResChange | Command |
| APIEnableAutomation | Command | |
| APIDeleteIftttLocal | Command | |
| APIPushCentralAutomation | Command | |
| APIRunCloudAction | Command | |
| APIGetSunriseSunsetByLatLon | Command | |
| APIEnableCentralAutomation | Command | |
| APIDeleteCentralAutomation | Command | |
| APIQueryIftttRes | Command | |
| APISubscribeIftttResChange | Command | |
| APIEnableIfttt | Command | |
| APIQueryHolidayList | Command | |
| APIPublishResourceChange | Command | |
| APICheckLocalIftttSync | Command | |
| APIDownloadIftttLocal | Command |
NetworkManagement
作为设备网络连接与访问策略的核心控制模块,管理远程代理及访问地址。
| functionCode | trait/commandCode | Trait 或 Command? |
|---|---|---|
| NetworkManagement | LanAccessAddress | Trait |
| RemoteProxyAccessEnable | Trait | |
| InternetAccessAddress | Trait |
Identify
提供设备识别能力,可通过指示灯闪烁、声音等方式帮助用户定位物理设备。
| functionCode | trait/commandCode | Trait 或 Command? |
|---|---|---|
| Identify | IdentifyType | Trait |
| ReverseIdentify | Trait | |
| IdentifyTime | Trait | |
| Identify | Command |
LightBoxCoordination
管理智能灯箱设备的配置下发,控制展示内容与效果。
| functionCode | trait/commandCode | Trait 或 Command? |
|---|---|---|
| LightBoxCoordination | APIPushLightBoxConfig | Command |
IRCoordination
管理网关红外学习与发射,包括码库同步、虚拟遥控器创建及按键控制。
| functionCode | trait/commandCode | Trait 或 Command? |
|---|---|---|
| IRCoordination | APIGetIrCode | Command |
| APISaveLearnedIrKey | Command | |
| APIQueryIrLearningCode | Command | |
| APIStartIrCodeLearning | Command | |
| APIGetIrCodeTarget | Command | |
| APIQueryIrCodeLibrary | Command | |
| APIGetIrCodeDownloadUrl | Command | |
| APIDeleteLearnedIrCode | Command | |
| APISendIrButtonPress | Command | |
| APISyncIrLearningCodes | Command |
NetworkCommissioning
提供网络配网能力,支持 Wi-Fi、Thread 等网络的扫描、连接与配置。
| functionCode | trait/commandCode | Trait 或 Command? |
|---|---|---|
| NetworkCommissioning | AddOrUpdateZigbeeNetwork | Command |
| AddOrUpdateZigbeeNetworkResponse | Command | |
| HomeStationCredentials | Trait | |
| ConfigStaticIPAddr | Command | |
| WiFiChannel | Trait | |
| ChildDeviceProvisioningState | Trait | |
| ZigbeeDiagnostics | Trait | |
| ZigbeeAuthRandcode | Trait | |
| ZigbeeAuthRandcodeResponse | Trait | |
| WiFiDiagnostics | Trait | |
| MagicPairKeychain | Trait | |
| ConnectToHomeStationResponse | Command | |
| SupportedNetwork | Trait | |
| AddOrUpdateThreadNetwork | Command | |
| AddOrUpdateThreadNetworkResponse | Command | |
| TriggerZigbeeNetworkInfoUpload | Command | |
| SlaveAddress | Trait | |
| ThreadDiagnostics | Trait | |
| ScanWiFiNetworks | Command | |
| ScanWiFiNetworksResponse | Command | |
| AddOrUpdateWiFiNetwork | Command | |
| AddOrUpdateWiFiNetworkResponse | Command | |
| ConnectToHomeStation | Command | |
| AuthenticationStatus | Trait | |
| WiFiRSSI | Trait |
ConfigurationCoordination
通过组播或批量方式管理通用功能配置、资源订阅及位置信息同步。
| functionCode | trait/commandCode | Trait 或 Command? |
|---|---|---|
| ConfigurationCoordination | APISyncConfiguration | Command |
| APIWriteFunctionResource | Command | |
| APIPushSubscribedResource | Command | |
| APIReportConfiguration | Command | |
| APIReportThingModelDetail | Command | |
| APIGetConfiguration | Command | |
| APIDeleteConfiguration | Command | |
| APIPushConfiguration | Command |
CloudStorageCoordination
管理云录像/云存业务资源配置,获取存储配额及上传凭证等信息。
| functionCode | trait/commandCode | Trait 或 Command? |
|---|---|---|
| CloudStorageCoordination | APIRequestCloudStorageResource | Command |
StudioCoordination
管理网关与 Aqara Studio 开发环境的集成,包括账号认证、项目备份与设备同步。
| functionCode | trait/commandCode | Trait 或 Command? |
|---|---|---|
| StudioCoordination | APIGetStudioBackupUploadUrl | Command |
| APILoginByAuthCode | Command | |
| APIGetAuthCode | Command | |
| APIDeleteStudioBackup | Command | |
| APIGetPositionByDeviceId | Command | |
| APIGetStudioBackupInfo | Command | |
| APIGetUserDeviceList | Command | |
| APILoginByGuardCode | Command | |
| APIReportStudioInfo | Command | |
| APIConfirmStudioBackupSuccess | Command | |
| APIGetProxyServerInfo | Command |
Temperature
测量并上报环境温度,提供当前温度值及有效量程等属性。
| functionCode | trait/commandCode | Trait 或 Command? |
|---|---|---|
| Temperature | CurrentTemperature | Trait |
TemperatureControl
提供温度设定与调节能力,用于恒温设备的目标温度控制。
| functionCode | trait/commandCode | Trait 或 Command? |
|---|---|---|
| TemperatureControl | SetTemperatureLevel | Trait |
| SetTemperature | Trait | |
| ChangeTemperatureLevel | Command | |
| ChangeTemperature | Command |
PackageRecognition
自动识别画面中的包裹,在投递或取走时可发送提醒并记录事件。
| functionCode | trait/commandCode | Trait 或 Command? |
|---|---|---|
| PackageRecognition | PackageRecognitionReport | Trait |
FaceRecognition
采集人脸特征并与本地库比对,上报人脸识别结果及匹配信息。
| functionCode | trait/commandCode | Trait 或 Command? |
|---|---|---|
| FaceRecognition | FaceIDReport | Trait |
HumanPresence
检测空间内人体存在,支持人数统计、轨迹及身份关联等高级感知能力。
| functionCode | trait/commandCode | Trait 或 Command? |
|---|---|---|
| HumanPresence | HoldTime | Trait |
| ResetPresence | Command | |
| ActivityDetected | Trait | |
| PresenceConfiguration | Trait | |
| Presence | Trait |
HumanRecognition
利用视觉等算法实时检测画面中的人形目标,区分人体与其他物体并上报事件。
| functionCode | trait/commandCode | Trait 或 Command? |
|---|---|---|
| HumanRecognition | HumanRecognitionReport | Trait |
AirQuality
监测并上报空气质量指标,如 AQI 或综合空气质量等级。
| functionCode | trait/commandCode | Trait 或 Command? |
|---|---|---|
| AirQuality | VOCDensity | Trait |
| AirQuality | Trait | |
| VOCQuality | Trait |
AttitudeDetection
检测设备姿态或倾斜角度变化,上报姿态异常或角度信息。
| functionCode | trait/commandCode | Trait 或 Command? |
|---|---|---|
| AttitudeDetection | AttitudeDetected | Trait |
Lifter
提供升降类设备的行程控制,支持设定目标位置、停止及状态查询。
| functionCode | trait/commandCode | Trait 或 Command? |
|---|---|---|
| Lifter | GoToMaxPositionPercentage | Command |
| AutoControl | Command | |
| GoToPositionPercentage | Command | |
| GoToMinPositionPercentage | Command | |
| TripTime | Trait | |
| TargetPositionPercentage | Trait | |
| CurrentPositionPercentage | Trait | |
| StopMotion | Command |
Binding
表示端点与一个或多个其他本地或远程 Endpoint 之间的持久绑定关系。
| functionCode | trait/commandCode | Trait 或 Command? |
|---|---|---|
| Binding | Binding | Trait |
| SupportedBindingDeviceTypes | Trait | |
| SupportedBindingFunctions | Trait |
PetFeeder
提供宠物喂食控制能力,包括出粮份数、喂食计划及余量状态。
| functionCode | trait/commandCode | Trait 或 Command? |
|---|---|---|
| PetFeeder | Feed | Trait |
Button
描述按钮类输入设备的事件上报,包括单击、长按、多击等动作识别。
| functionCode | trait/commandCode | Trait 或 Command? |
|---|---|---|
| Button | LocalControlDisabled | Trait |
| ButtonEvent | Trait |
Output
提供开关输出控制能力,支持读取和控制负载的通断状态。
| functionCode | trait/commandCode | Trait 或 Command? |
|---|---|---|
| Output | Toggle | Command |
| OutputSwitchingType | Trait | |
| OnOff | Trait | |
| OutputInterlockFlag | Trait | |
| OutputNodeMode | Trait | |
| Off | Command | |
| StartUpOnOff | Trait | |
| On | Command |
IRControl
提供红外发射控制能力,用于控制空调、电视等传统红外家电。
| functionCode | trait/commandCode | Trait 或 Command? |
|---|---|---|
| IRControl | SendIRCode | Command |
| IRKey | Trait | |
| IRType | Trait |
HeaterCooler
提供制冷/制热控制能力,包括目标温度、运行模式、风速等暖通参数。
| functionCode | trait/commandCode | Trait 或 Command? |
|---|---|---|
| HeaterCooler | CoolingTemperature | Trait |
| CurrentHumidity | Trait | |
| ClearActivePreset | Command | |
| CurrentTemperature | Trait | |
| Preset | Trait | |
| SetActivePreset | Command | |
| SetBack | Trait | |
| PresetTypes | Trait | |
| HeaterCoolerMode | Trait | |
| ActivePresetHandle | Trait | |
| HeatingTemperature | Trait | |
| NumberOfPresets | Trait | |
| HeaterCoolerButtonEvent | Trait | |
| MinHeatCoolDeadBand | Trait | |
| CurrentTemperatureCalibration | Trait | |
| TemperatureUIDisplayMode | Trait | |
| AntiFreezeTemperature | Trait | |
| HeaterCoolerPolarity | Trait |
Vibration
检测振动或动静变化,上报移动、倾斜、跌落等事件。
| functionCode | trait/commandCode | Trait 或 Command? |
|---|---|---|
| Vibration | TiltAngleDeviation | Trait |
| StationaryState | Trait | |
| InitialTiltAngle | Trait | |
| EventReportInterval | Trait | |
| ObjectOrientationEnable | Trait | |
| StationaryTiltAngle | Trait | |
| PeakTiltAngle | Trait | |
| ObjectMotionDetectionEnable | Trait | |
| ObjectOrientationState | Trait | |
| VibrationEvent | Trait |
Cube
描述魔方控制器的手势识别,包括翻转、旋转、摇一摇等动作及面识别。
| functionCode | trait/commandCode | Trait 或 Command? |
|---|---|---|
| Cube | CubeWorkModeSetting | Trait |
| TopFace | Trait | |
| CubeEvent | Trait | |
| TopFaceChanged | Trait |
Knob
描述旋钮类输入设备的旋转角度、按压及组合动作事件。
| functionCode | trait/commandCode | Trait 或 Command? |
|---|---|---|
| Knob | HoldRotationInterval | Trait |
| RotationEvent | Trait | |
| RotationDirection | Trait | |
| InvertedRotationAngle | Trait | |
| RotationAngle | Trait | |
| RotationInterval | Trait | |
| HoldRotationAngle | Trait |
BinaryOutputObject
驱动二元执行器输出,如继电器、接触器、电磁阀或警号。
| functionCode | trait/commandCode | Trait 或 Command? |
|---|---|---|
| BinaryOutputObject | BinaryOutputPV | Trait |
AnalogInputObject
以只读方式采集连续变化的模拟量输入(如电压、温度模拟信号)。
| functionCode | trait/commandCode | Trait 或 Command? |
|---|---|---|
| AnalogInputObject | AnalogInputPV | Trait |
MediaPlayback
提供媒体播放控制能力,包括播放、暂停、切歌、音量及播放状态管理。
| functionCode | trait/commandCode | Trait 或 Command? |
|---|---|---|
| MediaPlayback | Pause | Command |
| TargetPlaybackState | Trait | |
| Stop | Command | |
| MediaInformation | Trait | |
| PlaybackDuration | Trait | |
| MediaPlaybackCommand | Command | |
| CurrentPlaybackState | Trait | |
| PlaybackMode | Trait | |
| Rewind | Command | |
| SampledPosition | Trait | |
| Play | Command | |
| StartOver | Command | |
| PlaySpecificList | Command | |
| LoginState | Trait | |
| FastForward | Command | |
| Next | Command | |
| Previous | Command | |
| PlaybackSampledPosition | Trait | |
| SelectedMediaOutputSource | Trait | |
| SelectedSource | Trait |
MediaInput
描述媒体输入源管理与切换,支持选择当前播放源及输入列表。
| functionCode | trait/commandCode | Trait 或 Command? |
|---|---|---|
| MediaInput | SelectInput | Command |
| MediaInput | Trait |
FlameDetection
通过图像或传感器算法检测可见火焰,即时上报火情事件以便早期预警。
| functionCode | trait/commandCode | Trait 或 Command? |
|---|---|---|
| FlameDetection | FlameDetected | Trait |
OperationalState
描述设备当前运行状态,如空闲、运行中、暂停、故障等。
| functionCode | trait/commandCode | Trait 或 Command? |
|---|---|---|
| OperationalState | Pause | Command |
| OperationalError | Trait | |
| Start | Command | |
| Stop | Command | |
| OperationalState | Trait | |
| Resume | Command |
RefrigeratorState
描述冰箱运行状态,包括空闲、制冷、除霜、故障等。
| functionCode | trait/commandCode | Trait 或 Command? |
|---|---|---|
| RefrigeratorState | RefrigeratorAlarm | Trait |
Mode
提供设备特性模式接口,支持在多种预定义模式间切换。
| functionCode | trait/commandCode | Trait 或 Command? |
|---|---|---|
| Mode | CurrentMode | Trait |
| ChangeToMode | Command | |
| ChangeToModeResponse | Trait |
BridgedConfiguration
描述被桥接子设备的配置信息,用于 Matter/Zigbee 桥接场景。
| functionCode | trait/commandCode | Trait 或 Command? |
|---|---|---|
| BridgedConfiguration | BridgeDeviceID | Trait |
MultiStateInputObject
采集多状态离散输入,表示 N 种状态之一。
| functionCode | trait/commandCode | Trait 或 Command? |
|---|---|---|
| MultiStateInputObject | MultiStateInputPV | Trait |
MARSConfiguration
提供智能负载(MARS)相关配置,用于负载识别与智能配电管理。
| functionCode | trait/commandCode | Trait 或 Command? |
|---|---|---|
| MARSConfiguration | PulseDuration | Trait |
| LoadType | Trait |
ScreenUserInterface
管理屏端用户界面配置,包括页面布局、卡片、主题及展示数据。
| functionCode | trait/commandCode | Trait 或 Command? |
|---|---|---|
| ScreenUserInterface | ThemeID | Trait |
| Allpages | Trait | |
| MaxPageNum | Trait | |
| ScreenWidth | Trait | |
| DataVersion | Trait | |
| ThemeVersion | Trait | |
| ScreenHeight | Trait |
CustomizedConfiguration
提供厂商或用户自定义扩展配置项的读写能力。
| functionCode | trait/commandCode | Trait 或 Command? |
|---|---|---|
| CustomizedConfiguration | EnableIndicator | Trait |
| StartUpOnOff | Trait |
HEPAFilterMonitoring
监测 HEPA 滤芯使用情况、剩余寿命及更换提醒。
| functionCode | trait/commandCode | Trait 或 Command? |
|---|---|---|
| HEPAFilterMonitoring | Condition | Trait |
| ChangeIndication | Trait | |
| ResetCondition | Command |
ActivatedCarbonFilterMonitoring
监测活性炭滤芯使用情况、剩余寿命及更换提醒。
| functionCode | trait/commandCode | Trait 或 Command? |
|---|---|---|
| ActivatedCarbonFilterMonitoring | Condition | Trait |
| ChangeIndication | Trait | |
| ResetCondition | Command |
FanControl
提供风扇转速与模式控制,支持档位调节及运行状态读取。
| functionCode | trait/commandCode | Trait 或 Command? |
|---|---|---|
| FanControl | WindSetting | Trait |
| AirflowDirection | Trait | |
| FanMode | Trait | |
| FanSpeed | Trait | |
| RockSetting | Trait |
HeartMonitoring
利用传感器持续或周期性测量用户心率,记录并分析心脏健康相关数据。
| functionCode | trait/commandCode | Trait 或 Command? |
|---|---|---|
| HeartMonitoring | HeartRate | Trait |
Pressure
测量并上报大气压力或系统压力值。
| functionCode | trait/commandCode | Trait 或 Command? |
|---|---|---|
| Pressure | CurrentPressure | Trait |
MultiStateOutputObject
输出多状态离散控制命令,如 HVAC 模式或灯光场景切换。
| functionCode | trait/commandCode | Trait 或 Command? |
|---|---|---|
| MultiStateOutputObject | MultiStateOutputPV | Trait |
Contact
检测接触/门磁类二元状态,上报打开或关闭状态及可选角度信息。
| functionCode | trait/commandCode | Trait 或 Command? |
|---|---|---|
| Contact | ContactSensorState | Trait |
| OpenAngle | Trait |
Doorbell
提供门铃相关能力,包括呼叫事件上报及与室内铃铛/中继的联动。
| functionCode | trait/commandCode | Trait 或 Command? |
|---|---|---|
| Doorbell | ButtonEvent | Trait |
| Volume | Trait |
WaterFreezeDetector
用于检测管道或环境中是否存在结冰风险,并在达到阈值时上报水冻结相关事件。
| functionCode | trait/commandCode | Trait 或 Command? |
|---|---|---|
| WaterFreezeDetector | BooleanState | Trait |
Speaker
描述设备扬声器输出能力,包括音量控制及静音等音频输出属性。
| functionCode | trait/commandCode | Trait 或 Command? |
|---|---|---|
| Speaker | StepValue | Trait |
| Volume | Trait | |
| Mute | Trait |
DoorLock
提供智能门锁核心能力,包括锁状态、用户/凭证管理、开锁/上锁及告警事件。
| functionCode | trait/commandCode | Trait 或 Command? |
|---|---|---|
| DoorLock | LockOperation | Trait |
| UnboltDoor | Command | |
| SupportedRemoteFeatures | Trait | |
| SetWeekDaySchedule | Command | |
| QuietUnlockDoor | Command | |
| GetYearDaySchedule | Command | |
| NumberOfCredentialsSupportedPerUser | Trait | |
| LockOperationError | Trait | |
| NumberOfTotalUsersSupported | Trait | |
| DoorState | Trait | |
| NumberOfYearDaySchedulesSupportedPerUser | Trait | |
| LockState | Trait | |
| ClearWeekDaySchedule | Command | |
| GetUser | Command | |
| UnlockDoor | Command | |
| EnableRemoteControl | Trait | |
| NumberOfPINUsersSupported | Trait | |
| SetYearDaySchedule | Command | |
| GetWeekDaySchedule | Command | |
| LockUserChange | Trait | |
| RemoteControlWithAuthCode | Trait | |
| DoorLockAlarm | Trait | |
| RemoteUnlock | Trait | |
| NumberOfRFIDUsersSupported | Trait | |
| LockDoor | Command | |
| ClearYearDaySchedule | Command | |
| QuietLockDoor | Command | |
| NumberOfWeekDaySchedulesSupportedPerUser | Trait |
CO2
测量并上报环境中二氧化碳浓度。
| functionCode | trait/commandCode | Trait 或 Command? |
|---|---|---|
| CO2 | CO2Level | Trait |
| CO2Density | Trait |
VacuumOperationalState
描述扫地机器人当前运行状态,如清扫中、回充中、充电中等。
| functionCode | trait/commandCode | Trait 或 Command? |
|---|---|---|
| VacuumOperationalState | GoHome | Command |
| VacuumOperationalError | Trait | |
| Pause | Command | |
| Start | Command | |
| Stop | Command | |
| VacuumOperationalState | Trait | |
| Resume | Command |
ValveControl
提供阀门自动控制或手动控制能力,用于精确调节水/气流量。
| functionCode | trait/commandCode | Trait 或 Command? |
|---|---|---|
| ValveControl | CurrentValveState | Trait |
| DefaultOpenDuration | Trait | |
| Close | Command | |
| RemainingDuration | Trait | |
| Open | Command |
ScreenDisplay
管理屏幕显示相关硬件属性,如分辨率、亮度、背光及显示状态。
| functionCode | trait/commandCode | Trait 或 Command? |
|---|---|---|
| ScreenDisplay | ScreenBrightness | Trait |
Illuminance
测量并上报环境光照度(lux)。
| functionCode | trait/commandCode | Trait 或 Command? |
|---|---|---|
| Illuminance | SamplingInterval | Trait |
| CurrentIlluminance | Trait |
Camera
管理摄像机基础能力,包括设备状态、模式切换、图像加密及云端相关能力。
| functionCode | trait/commandCode | Trait 或 Command? |
|---|---|---|
| Camera | CameraActiveStatus | Trait |
| CameraRTSPURL | Trait | |
| P2PCaptureStatus | Trait | |
| CameraRTSPEnable | Trait | |
| P2PCaptureEnabled | Trait |
Gas
检测可燃气体或有害气体泄漏并上报告警事件。
| functionCode | trait/commandCode | Trait 或 Command? |
|---|---|---|
| Gas | CurrentSensitivityLevel | Trait |
| GasDensity | Trait | |
| SelfCheck | Trait | |
| Mute | Trait | |
| GasDetected | Trait |
GestureRecognition
实时分析手势动作,将预定义手势转换为控制指令。
| functionCode | trait/commandCode | Trait 或 Command? |
|---|---|---|
| GestureRecognition | GestureRecognitionReport | Trait |
BreathingMonitoring
利用传感器持续或周期性测量用户呼吸频率与模式,支持健康监测。
| functionCode | trait/commandCode | Trait 或 Command? |
|---|---|---|
| BreathingMonitoring | BreathingRate | Trait |
CharacterStringValueObject
定义以字符串形式表示的数据对象及其外部可见特性。
| functionCode | trait/commandCode | Trait 或 Command? |
|---|---|---|
| CharacterStringValueObject | CharStringValuePV | Trait |
Sweeper
提供扫地机器人基础控制,包括启动清扫、暂停、回充等操作与状态反馈。
| functionCode | trait/commandCode | Trait 或 Command? |
|---|---|---|
| Sweeper | ContinueCleaning | Command |
| SweeperState | Trait | |
| PauseCleaning | Command | |
| StartCleaning | Command | |
| StopCleaning | Command |
EVSE
提供电动汽车供电设备(EVSE)控制能力,包括充电启停、电流限制及充电状态。
| functionCode | trait/commandCode | Trait 或 Command? |
|---|---|---|
| EVSE | EvseSupplyState | Trait |
| MinChargeCurrent | Trait | |
| EvseState | Trait | |
| ChargingEnabledUntil | Trait | |
| BatteryCapacity | Trait | |
| VehicleID | Trait | |
| EvseFaultState | Trait | |
| BatPercentRemaining | Trait | |
| EnableCharging | Command | |
| MaxChargeCurrent | Trait | |
| CurrentFlow | Trait | |
| DisableCharging | Command |
CO
提供一氧化碳浓度监测与报警相关能力,用于检测环境中的一氧化碳泄漏并及时告警。
| functionCode | trait/commandCode | Trait 或 Command? |
|---|---|---|
| CO | ExpressedState | Trait |
| CODetected | Trait | |
| SelfTestRequest | Command |
Lighting
本 Function 提供对灯光动态效果的激活与控制能力。服务端提供可由不同来源驱动的效果列表,客户端可从中选择并触发。
动态灯效既可用于支持 Color Control Function 的灯具,也可用于仅支持 Level Control Function 的灯具(例如可调光灯)。
效果的具体实现属于厂商自定义范围。不同厂商设备即使使用相同 EffectID,也不保证表示同一种效果;同一厂商可在不同设备复用同一 EffectID 以表达一致实现。
| functionCode | trait/commandCode | Trait 或 Command? |
|---|---|---|
| Lighting | BuiltInEffects | Trait |
| PreviewEffect | Command | |
| MaxUserDefinedEffects | Trait | |
| CurrentEffectID | Trait | |
| UpdateUserDefinedEffect | Command | |
| RemoveUserDefinedEffect | Command | |
| GetEffectData | Command | |
| StartEffect | Command | |
| EffectInfo | Trait | |
| AddUserDefinedEffect | Command | |
| MaxEffectNameLength | Trait | |
| StopPreview | Command | |
| UserDefinedEffects | Trait | |
| PreviewTransition | Command |
LevelControl
提供亮度等级调节能力,支持设置/读取当前亮度、步进调光、以及与开关联动或解耦的调光控制。
| functionCode | trait/commandCode | Trait 或 Command? |
|---|---|---|
| LevelControl | StepBrightness | Command |
| OnTransitionTime | Trait | |
| SetBrightness | Command | |
| StepBrightnessWithOnOff | Command | |
| SetBrightnessWithOnOff | Command | |
| CurrentLevel | Trait | |
| OffTransitionTime | Trait |
ColorControl
提供颜色控制能力,支持通过 HSV、XY 与色温模式调节灯光颜色,并支持与亮度命令组合下发。
本 Function 提供灯光颜色调节接口。颜色定义遵循 CIE 1931 色彩空间,核心控制方式为 x、y 色度坐标(对应 ColorXY / CurrentX / CurrentY)。 此外,颜色可选通过 ColorTemperature(色温)或 Hue + Saturation 方式控制;Hue 与 Saturation 建议按 HSV(HSB)模型解释。RGB/W 原色点能力可用于扩展颜色表达范围。 本 Function 不负责亮度控制;亮度由 LevelControl Function 提供。联动控制时,LevelControl 中的亮度值应按“当前颜色下可达到最大光强的比例”解释。
| functionCode | trait/commandCode | Trait 或 Command? |
|---|---|---|
| ColorControl | MoveToXYColor | Command |
| CurrentY | Trait | |
| ColorMode | Trait | |
| WhitePointXY | Trait | |
| ColorTemperature | Trait | |
| LEDICQuantity | Trait | |
| ColorRGB | Trait | |
| ColorXY | Trait | |
| Hue | Trait | |
| StartUpXYColor | Trait | |
| MoveToHueSaturationBrightness | Command | |
| LightingMusicSyncMode | Trait | |
| StartUpColorTemperature | Trait | |
| LightingDynamicSceneMode | Trait | |
| Saturation | Trait | |
| CurrentG | Trait | |
| MoveToHueAndSaturation | Command | |
| MoveToColorTemperatureBrightness | Command | |
| CurrentB | Trait | |
| LightingMusicSyncEnable | Trait | |
| MoveToXYColorBrightness | Command | |
| StepColorTemperature | Command | |
| MoveToColorTemperature | Command | |
| CurrentX | Trait | |
| ColorPointRGBXY | Trait | |
| LEDICProtocol | Trait | |
| LEDType | Trait | |
| CurrentR | Trait |
PanTilt
提供云台(Pan/Tilt/Zoom)控制能力,包括预置位、校准及相对/绝对移动。
| functionCode | trait/commandCode | Trait 或 Command? |
|---|---|---|
| PanTilt | PanTiltDirectionControl | Command |
WindowCovering
本 Function 提供窗帘、卷帘、百叶帘等窗饰设备的开合控制、倾斜控制、目标位置管理与运行状态反馈能力。
除标准开合/倾斜控制外,本 Function 还包含 Aqara 扩展能力:场景管理(内置/自定义场景的启动、读取、预览、增删改)、手动校准、远程配对、电机映射交换与增强模式状态。
客户端应结合 TravelConfigured、MotorControllability、MotorOperationStatus、EnhanceMode 等 Trait 判断设备当前可控性与操作阶段,避免在不满足条件时下发无效命令。
Flow
测量并上报液体或气体的流量速率。
| functionCode | trait/commandCode | Trait 或 Command? |
|---|---|---|
| Flow | CurrentFlow | Trait |
OccupancySensing
检测空间内是否有人存在,上报占用/空闲状态及保持时间等参数。
| functionCode | trait/commandCode | Trait 或 Command? |
|---|---|---|
| OccupancySensing | HoldTime | Trait |
| DurationOccupiedWithinOneWeek | Trait | |
| Occupancy | Trait | |
| DurationOccupiedWithinOneDay | Trait | |
| OccupancySensorType | Trait |
RainSensor
用于检测降雨状态,上报是否正在下雨及雨量相关信息。
| functionCode | trait/commandCode | Trait 或 Command? |
|---|---|---|
| RainSensor | BooleanState | Trait |
Smoke
检测烟雾并上报报警事件,支持灵敏度、自检及静音等相关配置。
| functionCode | trait/commandCode | Trait 或 Command? |
|---|---|---|
| Smoke | ExpressedState | Trait |
| FireProductIdentification | Trait | |
| SmokeDensitydB | Trait | |
| SmokeChamberContamination | Trait | |
| AlarmError | Trait | |
| SelfCheck | Trait | |
| SmokeState | Trait | |
| TriggerWarning | Command | |
| SelfTestRequest | Command | |
| AlarmsEnabled | Trait | |
| ContaminationState | Trait | |
| Mute | Trait | |
| SmokeDensity | Trait | |
| SmokeDetected | Trait | |
| EnableHeartbeatIndicator | Trait |
FreshAirControl
提供新风系统控制能力,支持引入室外空气并进行风量、模式等调节。
| functionCode | trait/commandCode | Trait 或 Command? |
|---|---|---|
| FreshAirControl | FreshAirMode | Trait |
AnalogOutputObject
提供可写的连续模拟量输出控制信号。
| functionCode | trait/commandCode | Trait 或 Command? |
|---|---|---|
| AnalogOutputObject | AnalogOutputPV | Trait |
Location
提供设备或目标的位置信息上报与查询能力。
| functionCode | trait/commandCode | Trait 或 Command? |
|---|---|---|
| Location | MotionDetected | Trait |
PetRecognition
识别画面中的猫、狗等宠物个体,上报宠物出现或相关识别事件。
| functionCode | trait/commandCode | Trait 或 Command? |
|---|---|---|
| PetRecognition | PetRecognitionReport | Trait |
ParticulateMatter
监测并上报颗粒物浓度(如 PM2.5、PM10)。
| functionCode | trait/commandCode | Trait 或 Command? |
|---|---|---|
| ParticulateMatter | PM1.0Density | Trait |
| PM2.5Density | Trait | |
| PM2.5Level | Trait | |
| PM10Density | Trait |
OnOffSensor
用于检测二元开关量输入状态,上报开/关或触发/未触发等离散状态。
| functionCode | trait/commandCode | Trait 或 Command? |
|---|---|---|
| OnOffSensor | BooleanState | Trait |
SoundDetection
通过麦克风采集环境声音,识别特定声音类型(如玻璃破碎、婴儿哭声)并告警。
| functionCode | trait/commandCode | Trait 或 Command? |
|---|---|---|
| SoundDetection | AnomalySoundDetected | Trait |
Ringtone
提供铃声与音乐播放控制,支持选曲、音量/时长调节及播放状态监测。
| functionCode | trait/commandCode | Trait 或 Command? |
|---|---|---|
| Ringtone | RingtonePlayVolume | Trait |
| RingtonePlayIndex | Trait | |
| RingtonePlayStatus | Trait | |
| RingtonePlayDuration | Trait |
BridgeConfiguration
管理网关桥接配置,描述子设备接入、桥接能力及网络拓扑相关信息。
| functionCode | trait/commandCode | Trait 或 Command? |
|---|---|---|
| BridgeConfiguration | BridgedNodeList | Trait |
| SupportedHubCapability | Trait |
MatterBridgeCommissioning
管理 Matter Bridge 向第三方 Matter 生态分享桥接设备的能力。
| functionCode | trait/commandCode | Trait 或 Command? |
|---|---|---|
| MatterBridgeCommissioning | MatterBridgeSupported | Trait |
| MatterDACState | Trait | |
| MatterOnboardingPayload | Trait | |
| MatterManufacturerList | Trait | |
| RemoveOneMatterManufacturer | Command | |
| RemoveAllMatterManufacturer | Command | |
| MatterBindState | Trait | |
| MatterPairingState | Trait | |
| MatterPairingSwitch | Trait |
GarageDoorOpener
提供车库门控制与状态反馈,包括开/关/停止及位置状态。
| functionCode | trait/commandCode | Trait 或 Command? |
|---|---|---|
| GarageDoorOpener | TargetGarageDoorState | Trait |
| Toggle | Command | |
| CurrentGarageDoorState | Trait |
RelativeHumidity
测量并上报环境相对湿度,提供当前湿度值及有效量程等属性。
| functionCode | trait/commandCode | Trait 或 Command? |
|---|---|---|
| RelativeHumidity | CurrentHumidity | Trait |
Sleep
监测睡眠相关状态,上报睡眠阶段、时长或质量等指标。
| functionCode | trait/commandCode | Trait 或 Command? |
|---|---|---|
| Sleep | SleepQuality | Trait |
| SleepStage | Trait | |
| SleepState | Trait | |
| OnBed | Trait |
BinaryInputObject
采集二元状态输入,如门磁、开关等 true/false 或 active/inactive 量。
| functionCode | trait/commandCode | Trait 或 Command? |
|---|---|---|
| BinaryInputObject | BinaryInputPV | Trait |
WaterLeak
检测水浸事件,在检测到漏水时及时上报告警。
| functionCode | trait/commandCode | Trait 或 Command? |
|---|---|---|
| WaterLeak | LeakState | Trait |
VehicleDetection
检测监控区域内的车辆出现,上报车辆存在事件供安防或自动化使用。
| functionCode | trait/commandCode | Trait 或 Command? |
|---|---|---|
| VehicleDetection | VehicleDetected | Trait |