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

# PartyLocalDevice::CreateChatControl

> 指定されたユーザーのローカル チャット コントロールを作成する非同期操作をキューに追加します。

指定されたユーザーのローカル チャット コントロールを作成する非同期操作をキューに追加します。

## 構文

```cpp theme={null}
PartyError CreateChatControl(  
    const PartyLocalUser* localUser,  
    PartyString languageCode,  
    void* asyncIdentifier,  
    PartyLocalChatControl** localChatControl  
)  
```

### パラメーター

**`localUser`**   [PartyLocalUser\*](https://docs.xbox.com/ja-jp/services/playfab/multiplayer/networking/reference/classes/PartyLocalUser/partylocaluser.md)

新しいローカル チャット コントロールのローカル ユーザー。

**`languageCode`**   [PartyString](https://docs.xbox.com/ja-jp/services/playfab/multiplayer/networking/reference/typedefs.md)\
*オプション*

使用するオプションの言語。

**`asyncIdentifier`**   void\*\
*オプション*

完了状態の変化をこの呼び出しに関連付けるために使用できる、オプションでアプリ定義のポインター サイズのコンテキスト値。

**`localChatControl`**   [PartyLocalChatControl\*\*](https://docs.xbox.com/ja-jp/services/playfab/multiplayer/networking/reference/classes/PartyLocalChatControl/partylocalchatcontrol.md)\
*オプション、ライブラリ割り当ての出力*

オプションの出力ローカル チャット コントロール。

### 戻り値

PartyError

チャット コントロールを作成する非同期操作が開始された場合は `c_partyErrorSuccess`、それ以外の場合はエラー コード。このメソッドが失敗した場合、関連する状態変化は生成されません。エラー コードの人間が読める形式は、[PartyManager::GetErrorMessage()](https://docs.xbox.com/ja-jp/services/playfab/multiplayer/networking/reference/classes/PartyManager/methods/partymanager_geterrormessage.md) で取得できます。

## 解説

このメソッドが成功を返した場合、非同期操作の結果を提供するために [PartyCreateChatControlCompletedStateChange](https://docs.xbox.com/ja-jp/services/playfab/multiplayer/networking/reference/structs/partycreatechatcontrolcompletedstatechange.md) が生成されます。非同期操作が成功した場合、[PartyChatControlCreatedStateChange](https://docs.xbox.com/ja-jp/services/playfab/multiplayer/networking/reference/structs/partychatcontrolcreatedstatechange.md) が生成されます。操作が失敗した場合、[PartyChatControlDestroyedStateChange](https://docs.xbox.com/ja-jp/services/playfab/multiplayer/networking/reference/structs/partychatcontroldestroyedstatechange.md) が生成されます。このメソッド自体は、チャット コントロールをリモート デバイスに認識させるものではありません。このチャット コントロールをリモート デバイスにアナウンスするには、タイトルは [PartyNetwork::ConnectChatControl()](https://docs.xbox.com/ja-jp/services/playfab/multiplayer/networking/reference/classes/PartyNetwork/methods/partynetwork_connectchatcontrol.md) を呼び出す必要があります。\
\
 正常に戻ると、このメソッドは新しいチャット コントロールを配列に同期的に追加するため、ローカル デバイスに対して以前に [PartyManager::GetChatControls()](https://docs.xbox.com/ja-jp/services/playfab/multiplayer/networking/reference/classes/PartyManager/methods/partymanager_getchatcontrols.md) または [PartyDevice::GetChatControls()](https://docs.xbox.com/ja-jp/services/playfab/multiplayer/networking/reference/classes/PartyDevice/methods/partydevice_getchatcontrols.md) によって返された配列のメモリを無効にします。[PartyManager::StartProcessingStateChanges()](https://docs.xbox.com/ja-jp/services/playfab/multiplayer/networking/reference/classes/PartyManager/methods/partymanager_startprocessingstatechanges.md) もこれらの配列のメモリを無効にします。返された `localChatControl` オブジェクトは、PartyChatControlDestroyedStateChange が生成され、オブジェクトを参照するすべての状態変化が [PartyManager::FinishProcessingStateChanges()](https://docs.xbox.com/ja-jp/services/playfab/multiplayer/networking/reference/classes/PartyManager/methods/partymanager_finishprocessingstatechanges.md) に返されるまで有効です。\
\
 このチャット コントロールに関連付けられた言語は、`languageCode` パラメーターを介してオプションで指定できます。言語が指定されていない場合、プラットフォームによって決定されるユーザーの既定が使用されます。この言語は、文字起こしのためにこのチャット コントロールに関連付けられた話し言葉および受信翻訳のターゲット言語として使用されます。たとえば、指定された言語コードが en-US の場合、このチャット コントロールへの入力音声は英語 (米国) として扱われ、そのように文字起こしされます。[PartyLocalChatControl::SetTranscriptionOptions()](https://docs.xbox.com/ja-jp/services/playfab/multiplayer/networking/reference/classes/PartyLocalChatControl/methods/partylocalchatcontrol_settranscriptionoptions.md) または [PartyLocalChatControl::SetTextChatOptions()](https://docs.xbox.com/ja-jp/services/playfab/multiplayer/networking/reference/classes/PartyLocalChatControl/methods/partylocalchatcontrol_settextchatoptions.md) のいずれかを介して翻訳が有効になっている場合、受信ボイス チャット文字起こしまたはテキスト チャットが英語 (米国) に翻訳されます。\
\
 言語コードは BCP 47 形式である必要があります。サポートされている言語コードは [言語サポート](https://learn.microsoft.com/en-us/azure/ai-services/speech-service/language-support) に列挙されています。サポートされていない、または無効な言語コードを指定してもこのメソッドは失敗しませんが、このチャット コントロールに関連付けられた文字起こしの生成に失敗します。このメソッドで使用された言語コードは [PartyLocalChatControl::GetLanguage()](https://docs.xbox.com/ja-jp/services/playfab/multiplayer/networking/reference/classes/PartyLocalChatControl/methods/partylocalchatcontrol_getlanguage.md) を介して照会できます。

## 要件

**ヘッダー:** Party.h

## 関連項目

[PartyLocalDevice](https://docs.xbox.com/ja-jp/services/playfab/multiplayer/networking/reference/classes/PartyLocalDevice/partylocaldevice.md)\
[PartyCreateChatControlCompletedStateChange](https://docs.xbox.com/ja-jp/services/playfab/multiplayer/networking/reference/structs/partycreatechatcontrolcompletedstatechange.md)\
[PartyChatControlCreatedStateChange](https://docs.xbox.com/ja-jp/services/playfab/multiplayer/networking/reference/structs/partychatcontrolcreatedstatechange.md)\
[PartyChatControlDestroyedStateChange](https://docs.xbox.com/ja-jp/services/playfab/multiplayer/networking/reference/structs/partychatcontroldestroyedstatechange.md)\
[PartyManager::GetChatControls](https://docs.xbox.com/ja-jp/services/playfab/multiplayer/networking/reference/classes/PartyManager/methods/partymanager_getchatcontrols.md)\
[PartyDevice::GetChatControls](https://docs.xbox.com/ja-jp/services/playfab/multiplayer/networking/reference/classes/PartyDevice/methods/partydevice_getchatcontrols.md)\
[PartyNetwork::ConnectChatControl](https://docs.xbox.com/ja-jp/services/playfab/multiplayer/networking/reference/classes/PartyNetwork/methods/partynetwork_connectchatcontrol.md)\
[PartyLocalChatControl::GetLanguage](https://docs.xbox.com/ja-jp/services/playfab/multiplayer/networking/reference/classes/PartyLocalChatControl/methods/partylocalchatcontrol_getlanguage.md)\
[PartyLocalChatControl::SetTranscriptionOptions](https://docs.xbox.com/ja-jp/services/playfab/multiplayer/networking/reference/classes/PartyLocalChatControl/methods/partylocalchatcontrol_settranscriptionoptions.md)\
[PartyLocalChatControl::SetTranscriptionOptions](https://docs.xbox.com/ja-jp/services/playfab/multiplayer/networking/reference/classes/PartyLocalChatControl/methods/partylocalchatcontrol_settranscriptionoptions.md)


## Related topics

- [PartyDevice::GetChatControls](https://docs.xbox.com/ja-jp/services/playfab/multiplayer/networking/reference/classes/PartyDevice/methods/partydevice_getchatcontrols.md)
- [PartyManager::GetChatControls](https://docs.xbox.com/ja-jp/services/playfab/multiplayer/networking/reference/classes/PartyManager/methods/partymanager_getchatcontrols.md)
- [PartyLocalChatControl::GetLanguage](https://docs.xbox.com/ja-jp/services/playfab/multiplayer/networking/reference/classes/PartyLocalChatControl/methods/partylocalchatcontrol_getlanguage.md)
- [PartyCreateChatControlCompletedStateChange](https://docs.xbox.com/ja-jp/services/playfab/multiplayer/networking/reference/structs/partycreatechatcontrolcompletedstatechange.md)
- [PartyChatControlCreatedStateChange](https://docs.xbox.com/ja-jp/services/playfab/multiplayer/networking/reference/structs/partychatcontrolcreatedstatechange.md)