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

# PartyLocalDevice::CreateChatControl

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

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

## 構文

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

### パラメーター

**`localUser`**   [PartyLocalUser\*](/services/playfab/multiplayer/networking/reference/classes/PartyLocalUser/partylocaluser)

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

**`languageCode`**   [PartyString](/services/playfab/multiplayer/networking/reference/typedefs)\
*オプション*

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

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

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

**`localChatControl`**   [PartyLocalChatControl\*\*](/services/playfab/multiplayer/networking/reference/classes/PartyLocalChatControl/partylocalchatcontrol)\
*オプション、ライブラリ割り当ての出力*

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

### 戻り値

PartyError

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

## 解説

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

## 要件

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

## 関連項目

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


## Related topics

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