---
name: "checkIsMatterHasWhite"
mode: "api"
versionRequirements:
  - { name: "", version: "1.15.0" }
title: "checkIsMatterHasWhite"
summary: "判断 Matter 设备是否具备白光能力（与路数相关）。"
questions:
  - "哪几种路数通常返回 hasWhite 为 true？"
  - "应与哪个工具函数一起理解设备能力？"
---

## checkIsMatterHasWhite

> [VERSION] v1.15.0+

### 描述

判断 Matter 设备是否具备白光能力（与路数相关：1、2、4、5 路为 true，3 路为 false）。

### 参数

`Params`

| 参数 | 类型 | 必填 | 描述 |
| --- | --- | --- | --- |
| `dpSchema` | `any` | 是 | dpSchema 对象 |
| `force` | `any` | 否 | 未接入 matter-kit 推断路数时需传入 true |

### 返回值

无


### 示例代码

#### 示例

```ts
import { createMatterKit, useDpSchema } from '@ray-js/panel-sdk';

const matterKit = createMatterKit();
const dpSchema = useDpSchema();
const hasWhite = matterKit.utils.checkIsMatterHasWhite(dpSchema);
```