PlayFab 파티 채팅의 작동 방식 이해

아티클
07/11/2023

PlayFab 파티를 사용하면 게임에 음성 및 텍스트 통신을 쉽게 추가할 수 있습니다.

PlayFab 파티 채팅의 장점

유연함: 플레이어가 통신하는 방법을 완전히 제어할 수 있습니다.
강력함: 지원되는 플랫폼에서 하드웨어 코덱 가속을 사용합니다.
접근성: Azure Cognitive Services를 기반으로 하며 음성 텍스트 변환, 텍스트 음성 변환 및 번역 기능이 기본 제공되고 사용하기 쉽습니다.
효율성: 채팅 시스템을 네트워킹 계층과 긴밀하게 통합하여 음성 데이터가 전송되어야 하는 위치에 최대한 효율적인 방식으로 전송되도록 합니다.

채팅 기본 사항

게임에 음성 및 문자 통신을 추가하려면 먼저 PartyLocalChatControl 개체를 생성해야 합니다. 이 PartyLocalChatControl 개체는 특정 로컬 사용자와 관련된 채팅 작업의 관리 개체 역할을 하므로 입력 및 출력 디바이스, 음소거 상태 및 접근성 기본 설정을 선택할 수 있습니다. 각 로컬 사용자는 둘 이상의 채팅 컨트롤을 가질 수 없습니다. 로컬 채팅 컨트롤이 다른 채팅 컨트롤과 통신하려면 다음 요구 사항을 충족해야 합니다.

두 채팅 컨트롤이 동일한 네트워크에 있어야 합니다.
두 채팅 컨트롤 간의 채팅 권한은 오디오 및/또는 문자 통신이 흐를 수 있도록 허용해야 합니다.

로컬 채팅 컨트롤을 사용하면 이제 PartyNetwork::ConnectChatControl()을(를) 호출하여 네트워크에 연결할 준비가 된 것입니다. 연결되면 네트워크의 다른 디바이스는 PartyChatControlJoinedNetworkStateChange 상태 변경과 함께 채팅 컨트롤이 네트워크에 연결되었다는 알림을 받습니다. 또한 이미 네트워크에 있는 다른 모든 채팅 컨트롤에 대해 PartyChatControlJoinedNetworkStateChange를 수신하고 즉시 통신할 수 있습니다.

오디오 입력 및 출력

파티에서는 PartyLocalChatControl::SetAudioInput() 및 PartyLocalChatControl::SetAudioOutput() 메서드를 사용하여 채팅 컨트롤에서 사용할 오디오 디바이스를 선택할 수 있습니다. PartyAudioDeviceSelectionType 열거형을 사용하여 이러한 메서드의 동작을 변경합니다.

`PartyAudioDeviceSelectionType::None`

이 오디오 디바이스 선택 유형을 선택하면 채팅 컨트롤에서 오디오 디바이스를 사용하지 않습니다. 이 오디오 장치 선택 유형은 기본값입니다.

`PartyAudioDeviceSelectionType::SystemDefault`

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

`PartyAudioDeviceSelectionType::PlatformUserDefault`

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

`PartyAudioDeviceSelectionType::Manual`

이 오디오 디바이스 선택 유형을 선택하면 PartyLocalChatControl::SetAudioInput() 및 PartyLocalChatControl::SetAudioOutput()은 audioDeviceSelectionContext 매개 변수를 유효한 오디오 디바이스 식별자로 사용하고 해당 식별자와 일치하는 디바이스를 사용하려고 시도합니다. PlayFab 파티에서 지원하는 식별자 종류를 확인하려면 다음 표를 참조하세요.

플랫폼	사용할 항목
Windows 10	`IMMDevice` 또는 `Windows.Media.Devices`
Xbox	Xbox GDK 설명서 참조

참고 항목

Xbox One에서는 PartyAudioDeviceSelectionType::PlatformUserDefault를 사용하고 Windows 플랫폼에서는 PartyAudioDeviceSelectionType::SystemDefault를 사용하는 것이 좋습니다.

채팅 권한 및 음소거

파티에서는 플레이어가 서로 통신하는 방식을 세밀하게 제어할 수 있습니다. 파티는 팀 또는 채널을 지정하는 대신 각 채팅 컨트롤 쌍 간의 사용 권한을 명시적으로 정의해야 합니다. 채팅 권한, 음소거 및 일반 채팅 시나리오 작성 방법에 대한 자세한 내용은 채팅 권한 개요 페이지를 참조하세요.

문자 채팅, 번역 및 조정

파티는 다른 채팅 컨트롤에서 문자 채팅을 보내고 받을 수도 있습니다. PartyLocalChatControl::SendText() 메서드를 사용하면 임의 개수의 채팅 컨트롤로 문자 메시지를 보낼 수 있지만 적절한 PartyChatPermissionOptions::ReceiveText 채팅 권한이 있는 채팅 컨트롤만 메시지를 받을 수 있습니다.

PartyLocalChatControl::SetTextChatOptions()를 호출하여 문자 채팅 번역을 사용하도록 설정할 수도 있습니다. PartyTextChatOptions::TranslateToLocalLanguage 옵션을 설정하면 파티는 들어오는 문자 메시지를 로컬 채팅 컨트롤의 언어로 번역합니다. 채팅 컨트롤의 언어는 채팅 컨트롤을 만드는 동안 필요에 따라 구성할 수 있으며 PartyLocalChatControl::GetLanguage()를 호출하여 액세스할 수 있습니다. 번역은 들어오는 음성 텍스트 변환 대화 내용 기록에도 적용됩니다.

문자 조정은 문자 채팅에도 사용할 수 있습니다. 이 기능에 대한 자세한 내용은 텍스트 검토 사용 페이지를 참조하세요.

액세스 가능한 채팅

Azure Speech Services를 기반으로 하는 파티는 플레이어 음성 채팅 내용을 기록하고 텍스트에서 음성을 합성할 수 있습니다. 이 기능은 여러 가지 용도로 사용되지만 주로 내게 필요한 도구로 설계되었습니다. 이 기능의 활성화를 접근성 플레이어 설정에 연결하는 것이 좋습니다. Party에서 제공하는 접근성 기능을 사용하는 방법에 대한 자세한 내용은 텍스트 음성 변환 가이드라인 및 텍스트 음성 변환 가이드라인을 참조하세요.

오디오 입력 노이즈 억제

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