> ## 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::GetAudioInput

> 提供聊天控制項已設定用於音訊輸入的慣用麥克風或錄音裝置。

提供聊天控制項已設定用於音訊輸入的慣用麥克風或錄音裝置。

## 語法

```cpp theme={null}
PartyError GetAudioInput(  
    PartyAudioDeviceSelectionType* audioDeviceSelectionType,  
    PartyString* audioDeviceSelectionContext,  
    PartyString* deviceId  
)  
```

### 參數

**`audioDeviceSelectionType`**   [PartyAudioDeviceSelectionType\*](/zh-TW/services/playfab/multiplayer/networking/reference/enums/partyaudiodeviceselectiontype)\
*輸出*

輸出值，表示用來選取所提供之 `deviceId` 的選取類型。

**`audioDeviceSelectionContext`**   [PartyString\*](/zh-TW/services/playfab/multiplayer/networking/reference/typedefs)\
*library-allocated output*

使用 [PartyAudioDeviceSelectionType::None](/zh-TW/services/playfab/multiplayer/networking/reference/enums/partyaudiodeviceselectiontype) 或 [PartyAudioDeviceSelectionType::SystemDefault](/zh-TW/services/playfab/multiplayer/networking/reference/enums/partyaudiodeviceselectiontype) 時，`audioDeviceSelectionContext` 會是空的。使用 [PartyAudioDeviceSelectionType::PlatformUserDefault](/zh-TW/services/playfab/multiplayer/networking/reference/enums/partyaudiodeviceselectiontype) 或 [PartyAudioDeviceSelectionType::Manual](/zh-TW/services/playfab/multiplayer/networking/reference/enums/partyaudiodeviceselectiontype) 時，`audioDeviceSelectionContext` 會是先前呼叫 [SetAudioInput()](/zh-TW/services/playfab/multiplayer/networking/reference/classes/PartyLocalChatControl/methods/partylocalchatcontrol_setaudioinput) 時提供的值。字串的記憶體在 [PartyManager::StartProcessingStateChanges()](/zh-TW/services/playfab/multiplayer/networking/reference/classes/PartyManager/methods/partymanager_startprocessingstatechanges) 提供下一個 [PartyLocalChatAudioInputChangedStateChange](/zh-TW/services/playfab/multiplayer/networking/reference/structs/partylocalchataudioinputchangedstatechange) 或聊天控制項終結之前保持有效。

**`deviceId`**   [PartyString\*](/zh-TW/services/playfab/multiplayer/networking/reference/typedefs)\
*library-allocated output*

輸出值，表示所選取之音訊輸入裝置的識別碼。字串的記憶體在 [PartyManager::StartProcessingStateChanges()](/zh-TW/services/playfab/multiplayer/networking/reference/classes/PartyManager/methods/partymanager_startprocessingstatechanges) 提供下一個 [PartyLocalChatAudioInputChangedStateChange](/zh-TW/services/playfab/multiplayer/networking/reference/structs/partylocalchataudioinputchangedstatechange) 或聊天控制項終結之前保持有效。

### 傳回值

PartyError

`c_partyErrorSuccess` (如果呼叫成功)，否則為錯誤碼。可透過 [PartyManager::GetErrorMessage()](/zh-TW/services/playfab/multiplayer/networking/reference/classes/PartyManager/methods/partymanager_geterrormessage) 擷取錯誤碼的人類可讀形式。

## 備註

空白的裝置識別碼字串表示未選取任何輸入。

## 需求

**標頭：** Party.h

## 另請參閱

[PartyLocalChatControl](/zh-TW/services/playfab/multiplayer/networking/reference/classes/PartyLocalChatControl/partylocalchatcontrol)\
[PartyLocalChatControl::SetAudioInput](/zh-TW/services/playfab/multiplayer/networking/reference/classes/PartyLocalChatControl/methods/partylocalchatcontrol_setaudioinput)\
[PartyLocalChatControl::GetAudioOutput](/zh-TW/services/playfab/multiplayer/networking/reference/classes/PartyLocalChatControl/methods/partylocalchatcontrol_getaudiooutput)


## Related topics

- [PartyLocalChatControl::SetAudioInput](/zh-TW/services/playfab/multiplayer/networking/reference/classes/PartyLocalChatControl/methods/partylocalchatcontrol_setaudioinput.md)
- [PartyLocalChatControl::GetAudioOutput](/zh-TW/services/playfab/multiplayer/networking/reference/classes/PartyLocalChatControl/methods/partylocalchatcontrol_getaudiooutput.md)
- [PartyLocalChatControl::GetAudioInputMuted](/zh-TW/services/playfab/multiplayer/networking/reference/classes/PartyLocalChatControl/methods/partylocalchatcontrol_getaudioinputmuted.md)
- [PartyLocalChatControl](/zh-TW/services/playfab/multiplayer/networking/reference/classes/PartyLocalChatControl/partylocalchatcontrol.md)
- [PartyLocalChatControl::SetAudioOutput](/zh-TW/services/playfab/multiplayer/networking/reference/classes/PartyLocalChatControl/methods/partylocalchatcontrol_setaudiooutput.md)