> ## Documentation Index
> Fetch the complete documentation index at: https://devdocs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# LampArrayKind 列舉

> 此列舉識別 LampArray 的實體裝置類型，包括鍵盤、滑鼠、遊戲控制器、耳機、機殼、穿戴式裝置等。

# LampArrayKind 列舉

描述此 `ILampArray` 所屬實體裝置的一般類型。

## 語法

```cpp theme={null}
enum class LampArrayKind : uint32_t
{
    Undefined       = 0,
    Keyboard        = 1,
    Mouse           = 2,
    GameController  = 3,
    Peripheral      = 4,
    Scene           = 5,
    Notification    = 6,
    Chassis         = 7,
    Wearable        = 8,
    Furniture       = 9,
    Art             = 10,
    Headset         = 11,
    Microphone      = 12,
    Speaker         = 13
};  
```

## 常數

| 常數 | 描述 |
| - | - |
| `Undefined` | 未針對此裝置指定 `LampArrayKind`。 |
| `Keyboard` | 屬於鍵盤或鍵台的一部分。 |
| `Mouse` | 屬於滑鼠的一部分。 |
| `GameController` | 屬於遊戲控制器的一部分 (例如遊戲台、飛行搖桿、航海模擬裝置)。 |
| `Peripheral` | 屬於較一般性的周邊裝置/配件的一部分 (例如喇叭、滑鼠墊、麥克風、網路攝影機)。 |
| `Scene` | 照亮房間/表演舞台/區域 (例如房間燈泡、聚光燈、泛光燈、閃光燈、展位燈條、看板/招牌、相機閃光燈)。 |
| `Notification` | 屬於通知裝置的一部分。 |
| `Chassis` | 屬於 PC 機殼內部元件的一部分 (例如 RAM 記憶體條、主機板、風扇)。 |
| `Wearable` | 內嵌於穿戴式配件中 (例如音訊耳機、腕帶、手錶、鞋子)。 |
| `Furniture` | 內嵌於家具中 (例如椅子、書桌、書櫃)。 |
| `Art` | 內嵌於藝術品中 (例如畫作、雕塑)。 |
| `Headset` | 內嵌於專為頭部設計的穿戴式配件中 (例如頭戴式耳機)。這是 `Wearable` 的特殊化類型。 |
| `Microphone` | `LampArray` 屬於獨立麥克風的一部分。這是 `LampArrayKindPeripheral` 的特殊化類型。 |
| `Speaker` | `LampArray` 屬於獨立喇叭的一部分。這是 `LampArrayKindPeripheral` 的特殊化類型。 |

## 備註

此清單未來可能會擴充。請避免放置驗證 LampArrayKind 是否在目前範圍內的錯誤檢查。建議的做法是與應用程式支援的 LampArrayKind 子集進行比較。

## 需求

**標頭：** 在 LampArray.h 中宣告。

## 另請參閱

[照明 API 概觀](/zh-TW/build/core-features/common/lighting/gc-lighting-toc)\
[ILampArray::GetLampArrayKind](/zh-TW/reference/lighting/lamparray/interfaces/ilamparray/methods/ilamparray_getlamparraykind)


## Related topics

- [LampArray API 成員](/zh-TW/reference/lighting/lamparray/lamparray_members.md)
- [LampArrayEnumerationKind 列舉](/zh-TW/reference/lighting/lamparray/enums/lamparrayenumerationkind.md)
- [GetLampArrayKind](/zh-TW/reference/lighting/lamparray/interfaces/ilamparray/methods/ilamparray_getlamparraykind.md)
- [LampArrayStatus 列舉](/zh-TW/reference/lighting/lamparray/enums/lamparraystatus.md)
- [照明 API 參考 (API 內容)](/zh-TW/reference/lighting/gc-reference-lighting-toc.md)