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

# game_chat_transcribed_chat_received_state_change

> game_chat_transcribed_chat_received_state_change

# game\_chat\_transcribed\_chat\_received\_state\_change

代表 [game\_chat\_state\_change\_type::transcribed\_chat\_received](https://docs.xbox.com/zh-TW/reference/chat/gamechat2/enums/game_chat_state_change_type.md) 狀態變更的特定資訊。

## 語法

```cpp theme={null}
typedef struct game_chat_transcribed_chat_received_state_change {  
    chat_user* speaker;  
    uint32_t receiver_count;  
    chat_user_array receivers;  
    PCWSTR message;  
} game_chat_transcribed_chat_received_state_change  
```

### 成員

*speaker*  \
類型：[chat\_user](https://docs.xbox.com/zh-TW/reference/chat/gamechat2/classes/chat_user/chat_user.md)\*

指向發出文字訊息之 `chat_user` 物件的指標。

`chat_user` 物件的指標會保持有效，直到透過 [chat\_manager::remove\_user](https://docs.xbox.com/zh-TW/reference/chat/gamechat2/classes/chat_manager/methods/chat_manager_remove_user.md) 方法將使用者從本機 [chat\_manager](https://docs.xbox.com/zh-TW/reference/chat/gamechat2/classes/chat_manager/chat_manager.md) 執行個體中移除為止。

*receiver\_count*  \
類型：uint32\_t

*receivers* 中的陣列元素數目。

*receivers*  \_Field\_size\_(receiver\_count)\
類型：[chat\_user\_array](https://docs.xbox.com/zh-TW/reference/chat/gamechat2/classes/chat_user/chat_user.md#array)

`chat_user` 指標的陣列，指向文字訊息所傳送給的一或多個本機目的地玩家。

`chat_user_array` 物件的記憶體會保持有效，直到呼叫 [chat\_manager::finish\_processing\_state\_changes](https://docs.xbox.com/zh-TW/reference/chat/gamechat2/classes/chat_manager/methods/chat_manager_finish_processing_state_changes.md) 傳回此物件為止。個別 `chat_user` 物件指標會保持有效，直到透過 `chat_manager::remove_user` 方法將使用者從本機 `chat_manager` 執行個體中移除為止。

*message*  \
類型：PCWSTR

指向文字字串的指標，該字串是轉譯與 *speaker* 物件相關聯之使用者的音訊所產生。字串長度最多可達 `c_maxChatTextMessageLength` 個字元，不包括 null 結束字元。

> [!NOTE]
>
> `c_maxChatTextMessageLength` 是值為 1023 的 `constexpr uint16_t`。

字串會保持有效，直到呼叫 `chat_manager::finish_processing_state_changes` 傳回此物件為止。應用程式應複製文字，並依照 Game Chat 通訊原則指南文件中所述的方式和持續時間顯示。

## 備註

此結構會為 Game Chat 2 中的 [game\_chat\_state\_change\_type::transcribed\_chat\_received](https://docs.xbox.com/zh-TW/reference/chat/gamechat2/enums/game_chat_state_change_type.md) 狀態變更提供其他資訊。當遠端玩家的語音通訊已轉譯為文字，且應向一或多個本機使用者顯示時，就會發生此狀態變更。

如果發生此狀態變更，此結構會以 [game\_chat\_state\_change](https://docs.xbox.com/zh-TW/reference/chat/gamechat2/structs/game_chat_state_change.md) 元素的形式，在您的應用程式呼叫 [chat\_manager::start\_processing\_state\_changes](https://docs.xbox.com/zh-TW/reference/chat/gamechat2/classes/chat_manager/methods/chat_manager_start_processing_state_changes.md) 時所擷取的 [game\_chat\_state\_change\_array](https://docs.xbox.com/zh-TW/reference/chat/gamechat2/structs/game_chat_state_change.md#array) 陣列中傳回。藉由檢查該 `game_chat_state_change` 元素的 `state_change_type` 成員值來確認狀態變更類型後，即可將該元素轉換成此結構。接著，在您的應用程式呼叫 [chat\_manager::finish\_processing\_state\_changes](https://docs.xbox.com/zh-TW/reference/chat/gamechat2/classes/chat_manager/methods/chat_manager_finish_processing_state_changes.md) 將陣列傳回給 Game Chat 2 之前，您可以使用此結構取得狀態變更的詳細資訊並加以處理。

如需處理狀態變更的詳細資訊，請參閱[使用 Game Chat 2 C++ API](https://docs.xbox.com/zh-TW/services/xbox-services/multiplayer/chat/game-chat2/using-game-chat-2.md)。

## 需求

**標頭：** GameChat2.h

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

## 概念文件

* [使用 Game Chat 2 C++ API](https://docs.xbox.com/zh-TW/services/xbox-services/multiplayer/chat/game-chat2/using-game-chat-2.md)

## 另請參閱

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


## Related topics

- [使用 Game Chat 2 C++ API](https://docs.xbox.com/zh-TW/services/xbox-services/multiplayer/chat/game-chat2/using-game-chat-2.md)
- [chat_user](https://docs.xbox.com/zh-TW/reference/chat/gamechat2/classes/chat_user/chat_user.md)
- [game_chat_state_change_type](https://docs.xbox.com/zh-TW/reference/chat/gamechat2/enums/game_chat_state_change_type.md)
- [game_chat_state_change](https://docs.xbox.com/zh-TW/reference/chat/gamechat2/structs/game_chat_state_change.md)
- [GameChat2 成員 (API 內容)](https://docs.xbox.com/zh-TW/reference/chat/gamechat2/gamechat2_members.md)