> ## 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](/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](/reference/chat/gamechat2/classes/chat_manager/methods/chat_manager_start_processing_state_changes) 方法报告。应用处理所表示的状态更改后,应立即通过调用 [chat\_manager::finish\_processing\_state\_changes](/reference/chat/gamechat2/classes/chat_manager/methods/chat_manager_finish_processing_state_changes) 方法将其归还。

*state\_change\_type* 字段指示发生了何种状态更改。应用应将此基础结构转换为所指示的派生结构,以获取额外的、特定于该事件的信息。以下结构派生自此基础结构:

* [game\_chat\_communication\_relationship\_adjuster\_changed\_state\_change](/reference/chat/gamechat2/structs/game_chat_communication_relationship_adjuster_changed_state_change)
* [game\_chat\_text\_chat\_received\_state\_change](/reference/chat/gamechat2/structs/game_chat_text_chat_received_state_change)
* [game\_chat\_text\_conversion\_preference\_changed\_state\_change](/reference/chat/gamechat2/structs/game_chat_text_conversion_preference_changed_state_change)
* [game\_chat\_transcribed\_chat\_received\_state\_change](/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 简介](/services/xbox-services/multiplayer/chat/game-chat2/game-chat-2-intro)
* [使用 Game Chat 2 C++ API](/services/xbox-services/multiplayer/chat/game-chat2/using-game-chat-2)

## 另请参阅

[Game Chat 2 简介](/services/xbox-services/multiplayer/chat/game-chat2/game-chat-2-intro)\
[chat\_manager](/reference/chat/gamechat2/classes/chat_manager/chat_manager)\
[GameChat2 members](/reference/chat/gamechat2/gamechat2_members)


## Related topics

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