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

# PartyLocalChatControl::SetAudioInput

> チャット コントロールが音声入力に使用する推奨のマイクまたは録音デバイスを構成します。

チャット コントロールが音声入力に使用する推奨のマイクまたは録音デバイスを構成します。

## 構文

```cpp theme={null}
PartyError SetAudioInput(  
    PartyAudioDeviceSelectionType audioDeviceSelectionType,  
    PartyString audioDeviceSelectionContext,  
    void* asyncIdentifier  
)  
```

### パラメーター

**`audioDeviceSelectionType`**   [PartyAudioDeviceSelectionType](/services/playfab/multiplayer/networking/reference/enums/partyaudiodeviceselectiontype)

[PartyAudioDeviceSelectionType::None](/services/playfab/multiplayer/networking/reference/enums/partyaudiodeviceselectiontype) が指定されている場合、音声入力がクリアされます。[PartyAudioDeviceSelectionType::SystemDefault](/services/playfab/multiplayer/networking/reference/enums/partyaudiodeviceselectiontype) が指定されている場合、Party ライブラリはシステムの既定の通信デバイスを使用しようとします。[PartyAudioDeviceSelectionType::PlatformUserDefault](/services/playfab/multiplayer/networking/reference/enums/partyaudiodeviceselectiontype) が指定されている場合、Party ライブラリは `audioDeviceSelectionContext` に関連付けられた既定の通信デバイスを使用しようとします。[PartyAudioDeviceSelectionType::Manual](/services/playfab/multiplayer/networking/reference/enums/partyaudiodeviceselectiontype) が指定されている場合、Party ライブラリはデバイス識別子が一致する通信デバイスを使用しようとします。`PartyAudioDeviceSelectionType::Manual` は Android、iOS、macOS ではサポートされていないことに注意してください。

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

[PartyAudioDeviceSelectionType::None](/services/playfab/multiplayer/networking/reference/enums/partyaudiodeviceselectiontype) または [PartyAudioDeviceSelectionType::SystemDefault](/services/playfab/multiplayer/networking/reference/enums/partyaudiodeviceselectiontype) を使用する場合、`audioDeviceSelectionContext` は無視されます。[PartyAudioDeviceSelectionType::PlatformUserDefault](/services/playfab/multiplayer/networking/reference/enums/partyaudiodeviceselectiontype) を使用する場合、`audioDeviceSelectionContext` は、チャット コントロールが音声デバイスを選択するときに使用する必要のある、非 null で空でないプラットフォーム固有のユーザー コンテキストである必要があります。[PartyAudioDeviceSelectionType::Manual](/services/playfab/multiplayer/networking/reference/enums/partyaudiodeviceselectiontype) を使用する場合、`audioDeviceSelectionContext` は、チャット コントロールが使用する必要のある音声デバイスの、非 null で空でない識別子である必要があります。

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

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

### 戻り値

PartyError

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

## 解説

このメソッドは、このローカル チャット コントロールに関連付けられた優先録音デバイスを構成する非同期操作をキューに追加します。メソッドが成功した場合、入力デバイスのステータスに関する詳細を含む [PartyLocalChatAudioInputChangedStateChange](/services/playfab/multiplayer/networking/reference/structs/partylocalchataudioinputchangedstatechange) が [PartyManager::StartProcessingStateChanges()](/services/playfab/multiplayer/networking/reference/classes/PartyManager/methods/partymanager_startprocessingstatechanges) によって提供され、操作の完了時には成功または失敗を示す [PartySetChatAudioInputCompletedStateChange](/services/playfab/multiplayer/networking/reference/structs/partysetchataudioinputcompletedstatechange) が提供されます。完了後、デバイスの削除など、音声デバイスのステータスが変わるたびに追加の [PartyLocalChatAudioInputChangedStateChange](/services/playfab/multiplayer/networking/reference/structs/partylocalchataudioinputchangedstatechange) が提供されます。<br /><br /> 指定されたデバイスが存在しない場合、チャット コントロールは音声デバイスの変更をサブスクライブし、デバイスが現れたときにそれを使用します。<br /><br /> XBOX プラットフォームで `PlatformUserDefault` オプションを使用する場合、XBOX User Identifier (XUID) を `audioDeviceSelectionContext` の値として渡す必要があります。

## 要件

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

## 関連項目

[PartyLocalChatControl](/services/playfab/multiplayer/networking/reference/classes/PartyLocalChatControl/partylocalchatcontrol)\
[PartyLocalChatControl::GetAudioInput](/services/playfab/multiplayer/networking/reference/classes/PartyLocalChatControl/methods/partylocalchatcontrol_getaudioinput)\
[PartyLocalChatControl::SetAudioOutput](/services/playfab/multiplayer/networking/reference/classes/PartyLocalChatControl/methods/partylocalchatcontrol_setaudiooutput)


## Related topics

- [PartyLocalChatControl::GetAudioInput](/ja-jp/services/playfab/multiplayer/networking/reference/classes/PartyLocalChatControl/methods/partylocalchatcontrol_getaudioinput.md)
- [PartyLocalChatControl::SetAudioOutput](/ja-jp/services/playfab/multiplayer/networking/reference/classes/PartyLocalChatControl/methods/partylocalchatcontrol_setaudiooutput.md)
- [PartyLocalChatAudioInputChangedStateChange](/ja-jp/services/playfab/multiplayer/networking/reference/structs/partylocalchataudioinputchangedstatechange.md)
- [PartySetChatAudioInputCompletedStateChange](/ja-jp/services/playfab/multiplayer/networking/reference/structs/partysetchataudioinputcompletedstatechange.md)
- [PartyAudioDeviceSelectionType](/ja-jp/services/playfab/multiplayer/networking/reference/enums/partyaudiodeviceselectiontype.md)