> ## 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.

# game_chat_state_change

> game_chat_state_change

# game\_chat\_state\_change

代表事件、狀態變更或傳出資料的一般基底結構。

<a id="syntaxSection" />

## 語法

```cpp theme={null}
typedef struct game_chat_state_change {  
    game_chat_state_change_type state_change_type;  
} game_chat_state_change  
```

<a id="membersSection" />

### 成員

*state\_change\_type*\
類型：[game\_chat\_state\_change\_type](/zh-TW/reference/chat/gamechat2/enums/game_chat_state_change_type)

所代表之狀態變更的特定類型。使用此欄位判斷此 *game\_chat\_state\_change* 結構標頭所代表的是哪個對應的衍生結構。

<a id="remarksSection" />

## 備註

此基底結構代表狀態變更，例如收到文字聊天。`game_chat_state_change` 結構由 [chat\_manager::start\_processing\_state\_changes](/zh-TW/reference/chat/gamechat2/classes/chat_manager/methods/chat_manager_start_processing_state_changes) 方法回報。應用程式會處理所代表的狀態變更，然後藉由呼叫 [chat\_manager::finish\_processing\_state\_changes](/zh-TW/reference/chat/gamechat2/classes/chat_manager/methods/chat_manager_finish_processing_state_changes) 方法立即將其傳回。

*state\_change\_type* 欄位指出發生了哪一種狀態變更。您的應用程式應將此基底結構轉換為所指出的衍生結構，以擷取事件特有的額外資訊。下列結構衍生自此基底結構：

* [game\_chat\_communication\_relationship\_adjuster\_changed\_state\_change](/zh-TW/reference/chat/gamechat2/structs/game_chat_communication_relationship_adjuster_changed_state_change)
* [game\_chat\_text\_chat\_received\_state\_change](/zh-TW/reference/chat/gamechat2/structs/game_chat_text_chat_received_state_change)
* [game\_chat\_text\_conversion\_preference\_changed\_state\_change](/zh-TW/reference/chat/gamechat2/structs/game_chat_text_conversion_preference_changed_state_change)
* [game\_chat\_transcribed\_chat\_received\_state\_change](/zh-TW/reference/chat/gamechat2/structs/game_chat_transcribed_chat_received_state_change)

<a id="array" />

### game\_chat\_state\_change\_array

`game_chat_state_change_array` 類型是 `game_chat_state_change` 指標的常數陣列。提供此類型是為了方便起見，搭配 `chat_manager::start_processing_state_changes` 和 `chat_manager::finish_processing_state_changes` 方法使用。

```cpp theme={null}
typedef const game_chat_state_change * const * game_chat_state_change_array;
```

<a id="requirementsSection" />

## 需求

**標頭：** GameChat2.h

**支援的平台：** Windows、XBOX One 系列主機和 XBOX Series 主機

<a id="seealsoSection" />

## 概念文件

* [Game Chat 2 簡介](/zh-TW/services/xbox-services/multiplayer/chat/game-chat2/game-chat-2-intro)
* [使用 Game Chat 2 C++ API](/zh-TW/services/xbox-services/multiplayer/chat/game-chat2/using-game-chat-2)

## 另請參閱

[Game Chat 2 簡介](/zh-TW/services/xbox-services/multiplayer/chat/game-chat2/game-chat-2-intro)\
[chat\_manager](/zh-TW/reference/chat/gamechat2/classes/chat_manager/chat_manager)\
[GameChat2 成員](/zh-TW/reference/chat/gamechat2/gamechat2_members)


## Related topics

- [game_chat_state_change_type](/zh-TW/reference/chat/gamechat2/enums/game_chat_state_change_type.md)
- [chat_manager::start_processing_state_changes](/zh-TW/reference/chat/gamechat2/classes/chat_manager/methods/chat_manager_start_processing_state_changes.md)
- [chat_manager::finish_processing_state_changes](/zh-TW/reference/chat/gamechat2/classes/chat_manager/methods/chat_manager_finish_processing_state_changes.md)
- [game_chat_text_chat_received_state_change](/zh-TW/reference/chat/gamechat2/structs/game_chat_text_chat_received_state_change.md)
- [game_chat_transcribed_chat_received_state_change](/zh-TW/reference/chat/gamechat2/structs/game_chat_transcribed_chat_received_state_change.md)