Skip to main content
PlayFab Party를 사용하면 게임에 음성 및 텍스트 통신을 쉽게 추가할 수 있습니다. PlayFab Party 채팅은:
  • 유연함: 플레이어가 소통하는 방식을 완전히 제어할 수 있습니다.
  • 강력함: 지원되는 플랫폼에서 하드웨어 코덱 가속을 사용합니다.
  • 접근성: Azure Cognitive Services로 구동되며 음성-텍스트 변환, 텍스트-음성 변환 및 번역 기능이 기본 제공되며 쉽게 활성화할 수 있습니다.
  • 효율적: 채팅 시스템이 네트워킹 계층과 긴밀히 통합되어 있어 음성 데이터가 가능한 가장 효율적인 방식으로 필요한 곳으로 전송됩니다.

채팅 기본 사항

게임에 음성 및 텍스트 통신을 추가하려면 먼저 PartyLocalChatControl 개체를 만들어야 합니다. 이 PartyLocalChatControl 개체는 특정 로컬 사용자와 관련된 채팅 작업의 관리 개체 역할을 하며, 입력 및 출력 장치, 음소거 상태, 접근성 기본 설정을 선택할 수 있게 해줍니다. 각 로컬 사용자는 최대 하나의 채팅 컨트롤을 가질 수 있습니다. 로컬 채팅 컨트롤이 다른 채팅 컨트롤과 통신하려면 다음 요구 사항을 충족해야 합니다.
  1. 두 채팅 컨트롤은 동일한 네트워크에 있어야 합니다.
  2. 두 채팅 컨트롤 간의 채팅 권한이 오디오 및/또는 텍스트 통신이 흐르도록 허용해야 합니다.
로컬 채팅 컨트롤이 준비되면, PartyNetwork::ConnectChatControl()을 호출하여 네트워크에 연결할 준비가 된 것입니다. 연결되면 네트워크의 다른 장치들은 PartyChatControlJoinedNetworkStateChange 상태 변경을 통해 채팅 컨트롤이 네트워크에 참여했음을 알게 됩니다. 또한 네트워크에 이미 있는 다른 모든 채팅 컨트롤에 대해 PartyChatControlJoinedNetworkStateChange를 받게 되며 즉시 그들과 통신할 수 있습니다.

오디오 입력 및 출력

Party는 PartyLocalChatControl::SetAudioInput()PartyLocalChatControl::SetAudioOutput() 메서드를 사용하여 채팅 컨트롤에서 사용할 오디오 장치를 선택할 수 있게 해줍니다. PartyAudioDeviceSelectionType 열거형을 사용하여 이러한 메서드의 동작을 변경하세요.

PartyAudioDeviceSelectionType::None

이 오디오 장치 선택 유형을 선택하면 채팅 컨트롤이 어떤 오디오 장치도 사용하지 않습니다. 이 오디오 장치 선택 유형은 기본값입니다.

PartyAudioDeviceSelectionType::SystemDefault

이 오디오 장치 선택 유형을 선택하면 채팅 컨트롤이 시스템의 기본 통신 장치를 사용하려고 시도합니다. Windows에서는 플레이어가 Windows Sound Control Panel을 통해 언제든지 이 장치를 변경할 수 있으며, Party는 이러한 변경에 자동으로 응답합니다. 이 선택 유형은 XBOX One에서 지원되지 않으며, 여러 로컬 사용자가 동시에 채팅에 참여하는 경우 일반적으로 권장되지 않습니다.

PartyAudioDeviceSelectionType::PlatformUserDefault

이 오디오 장치 선택 유형을 선택하면 PartyLocalChatControl::SetAudioInput()PartyLocalChatControl::SetAudioOutput()audioDeviceSelectionContext 매개 변수가 플랫폼 사용자 ID로 설정되어야 합니다. 그러면 Party는 해당 사용자와 연결된 플랫폼 기본 통신 장치를 사용하려고 시도합니다. XBOX One에서 audioDeviceSelectionContext는 현재 채팅 컨트롤에 연결된 사용자와 연관된 XBOX User ID여야 합니다.

PartyAudioDeviceSelectionType::Manual

이 오디오 장치 선택 유형을 선택하면 PartyLocalChatControl::SetAudioInput()PartyLocalChatControl::SetAudioOutput()audioDeviceSelectionContext 매개 변수를 유효한 오디오 장치 식별자로 사용하며, 해당 식별자와 일치하는 장치를 사용하려고 시도합니다. PlayFab Party가 지원하는 식별자 종류는 다음 표를 참조하세요.
XBOX One에서는 PartyAudioDeviceSelectionType::PlatformUserDefault를, Windows 플랫폼에서는 PartyAudioDeviceSelectionType::SystemDefault를 사용하는 것을 강력히 권장합니다.

채팅 권한 및 음소거

Party는 플레이어들이 서로 어떻게 소통할 수 있는지에 대한 세밀한 제어 기능을 제공합니다. 팀이나 채널을 지정하는 대신, Party는 각 채팅 컨트롤 쌍 사이의 권한을 명시적으로 정의하도록 요구합니다. 채팅 권한, 음소거, 일반적인 채팅 시나리오 구성 방법에 대해 자세히 알아보려면 채팅 권한 개요 페이지를 참조하세요.

텍스트 채팅, 번역 및 조정

Party를 사용하면 다른 채팅 컨트롤에 텍스트 채팅을 보내고 받을 수도 있습니다. PartyLocalChatControl::SendText() 메서드는 임의의 수의 채팅 컨트롤에 텍스트 메시지를 보낼 수 있게 해주지만, 적절한 PartyChatPermissionOptions::ReceiveText 채팅 권한을 가진 채팅 컨트롤만 메시지를 수신하게 됩니다. PartyLocalChatControl::SetTextChatOptions()를 호출하여 텍스트 채팅 번역을 활성화할 수도 있습니다. PartyTextChatOptions::TranslateToLocalLanguage 옵션을 설정하면 Party가 수신되는 텍스트 메시지를 로컬 채팅 컨트롤의 언어로 번역합니다. 채팅 컨트롤의 언어는 채팅 컨트롤 생성 시 선택적으로 구성할 수 있으며, PartyLocalChatControl::GetLanguage()를 호출하여 액세스할 수 있습니다. 번역은 수신되는 음성-텍스트 변환 결과에도 적용됩니다. 텍스트 채팅에 대한 텍스트 조정도 사용할 수 있습니다. 이 기능에 대해 자세히 알아보려면 텍스트 조정 사용 페이지를 참조하세요.

접근성 채팅

Azure Speech Services로 구동되는 Party는 플레이어의 음성 채팅을 전사하고 텍스트로부터 음성을 합성할 수 있습니다. 이 기능은 여러 용도로 사용할 수 있지만, 주로 접근성 보조 수단으로 설계되었습니다. 이 기능의 활성화를 easy-of-access 플레이어 설정에 연결하는 것이 좋습니다. Party가 제공하는 접근성 기능을 사용하는 방법에 대한 자세한 내용은 text-to-speech 가이드라인speech-to-text 가이드라인을 참조하세요.

오디오 입력 노이즈 억제

Party를 사용하면 원격 채팅 컨트롤로 전송되기 전에 캡처된 마이크 오디오의 배경 소음을 억제할 수 있습니다. 이를 통해 플레이어의 음성 오디오 품질을 크게 향상시킬 수 있습니다. 노이즈 억제를 활성화하는 방법에 대한 자세한 내용은 노이즈 억제 사용 페이지를 참조하세요.
노이즈 억제는 현재 iOS와 Android에서만 사용할 수 있습니다.

다음 단계

마지막 수정일 2026년 8월 24일