PartyLocalChatControl::SetAudioOutput

채팅 컨트롤이 오디오 출력에 사용할 기본 스피커 또는 헤드셋 디바이스를 구성합니다.

구문

PartyError SetAudioOutput(  
    PartyAudioDeviceSelectionType audioDeviceSelectionType,  
    PartyString audioDeviceSelectionContext,  
    void* asyncIdentifier  
)  

매개 변수

audioDeviceSelectionTypePartyAudioDeviceSelectionType

PartyAudioDeviceSelectionType::None을 지정하면 오디오 출력이 지워집니다. PartyAudioDeviceSelectionType::SystemDefault를 지정하면 파티 라이브러리에서 시스템의 기본 통신 디바이스를 사용하려고 합니다. PartyAudioDeviceSelectionType::PlatformUserDefault를 지정하면 파티 라이브러리에서 audioDeviceSelectionContext와 연결된 기본 통신 디바이스를 사용하려고 합니다. PartyAudioDeviceSelectionType::Manual을 지정하면 파티 라이브러리에서 디바이스 식별자가 audioDeviceSelectionContext와 일치하는 통신 디바이스를 사용하려고 합니다.

audioDeviceSelectionContextPartyString
선택 사항

PartyAudioDeviceSelectionType::None 또는 PartyAudioDeviceSelectionType::SystemDefault를 사용할 경우 audioDeviceSelectionContext는 무시됩니다. PartyAudioDeviceSelectionType::PlatformUserDefault를 사용할 경우 audioDeviceSelectionContext는 채팅 컨트롤에서 오디오 디바이스를 선택할 때 사용할 null이 아니고 비어 있지 않은 플랫폼별 사용자 컨텍스트여야 합니다. PartyAudioDeviceSelectionType::Manual을 사용할 경우 audioDeviceSelectionContext는 채팅 컨트롤에서 사용할 오디오 디바이스의 null이 아니고 비어 있지 않은 식별자여야 합니다.

asyncIdentifier void*
선택 사항

완료 상태 변경을 이 호출과 연결하는 데 사용할 수 있는 선택적 앱 정의 포인터 크기의 컨텍스트 값입니다.

반환 값

PartyError

c_partyErrorSuccess(오디오 출력을 설정하는 비동기 작업이 시작되는 경우), 그러지 않으면 오류 코드입니다. 이 메서드가 실패하면 관련 상태 변경 내용이 생성되지 않습니다. 사용자가 읽을 수 있는 형식의 오류 코드는 PartyManager::GetErrorMessage()를 통해 검색할 수 있습니다.

비고

이 메서드는 이 로컬 채팅 컨트롤과 연결된 기본 스피커 또는 헤드셋 디바이스를 구성하는 비동기 작업을 큐에 넣습니다. 메서드가 성공하면 PartyLocalChatAudioOutputChangedStateChange가 출력 디바이스 상태에 대한 세부 정보가 포함된 PartyManager::StartProcessingStateChanges()에서 제공되고 작업 완료 시 성공 또는 실패를 나타내는 PartySetChatAudioOutputCompletedStateChange가 제공됩니다. 완료 후 디바이스 제거와 같이 오디오 디바이스 상태가 변경될 때마다 PartyLocalChatAudioOutputChangedStateChange가 추가로 제공됩니다.

지정된 디바이스가 없으면 채팅 컨트롤에서 오디오 디바이스 변경을 구독하고 표시되는 디바이스를 사용합니다.

Xbox 플랫폼에서 PlatformUserDefault 옵션을 사용하는 경우 XUID(Xbox 사용자 식별자)를 audioDeviceSelectionContext 값으로 전달해야 합니다.

요건

헤더: Party.h

참고 항목

PartyLocalChatControl
PartyLocalChatControl::GetAudioOutput
PartyLocalChatControl::SetAudioInput