Provides the preferred microphone or recording device that the chat control has been configured to use for audio input.
Syntax
PartyError GetAudioInput(
PartyAudioDeviceSelectionType* audioDeviceSelectionType,
PartyString* audioDeviceSelectionContext,
PartyString* deviceId
)
Parameters
audioDeviceSelectionType PartyAudioDeviceSelectionType*
output
An output value indicating the selection type that was used to select the provided deviceId.
audioDeviceSelectionContext PartyString*
library-allocated output
When using PartyAudioDeviceSelectionType::None or PartyAudioDeviceSelectionType::SystemDefault, audioDeviceSelectionContext will be empty. When using PartyAudioDeviceSelectionType::PlatformUserDefault or PartyAudioDeviceSelectionType::Manual, audioDeviceSelectionContext will be the value provided in a previous call to SetAudioInput(). The memory for the string remains valid until the next PartyLocalChatAudioInputChangedStateChange is provided via PartyManager::StartProcessingStateChanges() or the chat control is destroyed.
deviceId PartyString*
library-allocated output
An output value indicating the selected audio input device's identifier. The memory for the string remains valid until the next PartyLocalChatAudioInputChangedStateChange is provided via PartyManager::StartProcessingStateChanges() or the chat control is destroyed.
Return value
PartyError
c_partyErrorSuccess if the call succeeded or an error code otherwise. The human-readable form of the error code can be retrieved via PartyManager::GetErrorMessage().
Remarks
An empty device identifier string indicates that no input has been selected.
Requirements
Header: Party.h
See also
PartyLocalChatControl
PartyLocalChatControl::SetAudioInput
PartyLocalChatControl::GetAudioOutput