PlayFab Party Chat Permissions and Muting - XBOX Game Development Documentation

개요

PlayFab Party는 플레이어들이 서로 어떻게 소통할 수 있는지에 대한 세밀한 제어 기능을 제공합니다. 팀이나 채널을 지정하는 대신, PlayFab Party는 각 채팅 컨트롤 쌍 사이의 명시적인 권한을 정의하도록 요구합니다. 채팅 권한 시스템을 사용하면 임의의 두 채팅 컨트롤 쌍 간의 인바운드 및 아웃바운드 음성 통신과 인바운드 텍스트 통신을 제어할 수 있습니다.

채팅 권한

채팅 컨트롤 간의 통신은 기본적으로 비활성화되어 있으며, 각 채팅 컨트롤 쌍 사이에 올바른 PartyChatPermissionOptions를 설정하는 것은 게임의 몫입니다. 채팅 권한은 여러분이 구현하려는 시나리오에 따라 결정되는 각 채팅 컨트롤 간의 관계를 반영해야 합니다. 예를 들어 팀 대 팀 시나리오에서는 같은 팀 멤버 간의 모든 유형의 통신을 허용하고, 상대 팀 멤버 간의 오디오 통신을 차단하며, 세션의 모든 사람 간에 텍스트 수신을 허용하도록 채팅 권한을 설정할 수 있습니다. 다음 예는 로컬 채팅 컨트롤과 원격 채팅 컨트롤 간의 모든 통신을 활성화하는 방법을 보여줍니다. localChatControlA 변수는 유효한 PartyLocalChatControl 개체를 가리키고, remoteChatControlB는 원격 장치의 채팅 컨트롤을 나타내는 유효한 PartyChatControl 개체를 가리킵니다.

PartyChatPermissionOptions allOptions = PartyChatPermissionOptions::SendAudio | PartyChatPermissionOptions::ReceiveAudio | PartyChatPermissionOptions::ReceiveText;
localChatControlA->SetPermissions(remoteChatControlB, allOptions);

채팅 권한은 로컬에만 적용된다는 점을 유의하세요. 이전 예시에서 완전한 양방향 통신이 이루어지려면 remoteChatControlB도 원격에서 localChatControlA와의 모든 통신을 허용하도록 구성되어 있어야 합니다.

음소거

게임은 아웃바운드 오디오를 음소거하거나(PartyLocalChatControl::SetAudioInputMuted()) 원격 채팅 컨트롤로부터 들어오는 오디오를 음소거할 수도 있습니다(PartyLocalChatControl::SetIncomingAudioInputMuted()). 이러한 음소거의 상태는 각 getter를 통해 액세스할 수 있으며, PartyLocalChatControl::GetChatIndicator()와 PartyLocalChatControl::GetLocalChatIndicator()가 반환하는 채팅 표시기에도 반영됩니다. 음소거는 게임 세션 시작 시 설정한 채팅 권한을 변경하지 않고도 플레이어에게 일시적인 제어권을 제공할 때 특히 유용합니다.

인기 시나리오 구성 방법

Push-to-talk

Push-to-talk는 로컬 음소거를 사용하여 구현해야 합니다. PartyLocalChatControl::SetAudioInputMuted(false)를 호출하여 발화를 허용하고, PartyLocalChatControl::SetAudioInputMuted(true)를 호출하여 제한합니다.

팀

각각 별도의 장치를 사용하는 4명의 사용자 A, B, C, D가 있다고 가정하겠습니다. 사용자 A와 B는 Blue 팀에 있고, 사용자 C와 D는 Red 팀에 있습니다. 사용자 A의 장치에서:

// Enable all communication with teammate B
localChatControlA->SetPermissions(chatControlB, PartyChatPermissionOptions::SendAudio | PartyChatPermissionOptions::ReceiveAudio | PartyChatPermissionOptions::ReceiveText);

// Disable all communication with opponents
localChatControlA->SetPermissions(chatControlC, PartyChatPermissionOptions::None);
localChatControlA->SetPermissions(chatControlD, PartyChatPermissionOptions::None);

방송(Broadcast)

사용자 A가 명령을 내리는 리더이고 사용자 B, C, D는 듣기만 한다고 가정하겠습니다. 사용자 A의 장치에서:

localChatControlA->SetPermissions(chatControlB, PartyChatPermissionOptions::SendAudio);
localChatControlA->SetPermissions(chatControlC, PartyChatPermissionOptions::SendAudio);
localChatControlA->SetPermissions(chatControlD, PartyChatPermissionOptions::SendAudio);

사용자 B의 장치에서:

localChatControlB->SetPermissions(chatControlA, PartyChatPermissionOptions::ReceiveAudio | PartyChatPermissionOptions::ReceiveText);
localChatControlB->SetPermissions(chatControlC, PartyChatPermissionOptions::None);
localChatControlB->SetPermissions(chatControlD, PartyChatPermissionOptions::None);

사용자 C의 장치에서:

localChatControlC->SetPermissions(chatControlA, PartyChatPermissionOptions::ReceiveAudio | PartyChatPermissionOptions::ReceiveText);
localChatControlC->SetPermissions(chatControlB, PartyChatPermissionOptions::None);
localChatControlC->SetPermissions(chatControlD, PartyChatPermissionOptions::None);

사용자 D의 장치에서:

localChatControlD->SetPermissions(chatControlA, PartyChatPermissionOptions::ReceiveAudio | PartyChatPermissionOptions::ReceiveText);
localChatControlD->SetPermissions(chatControlB, PartyChatPermissionOptions::None);
localChatControlD->SetPermissions(chatControlC, PartyChatPermissionOptions::None);

​개요

​채팅 권한

​음소거

​인기 시나리오 구성 방법

​Push-to-talk

​팀

​방송(Broadcast)

개요

채팅 권한

음소거

인기 시나리오 구성 방법

Push-to-talk

팀

방송(Broadcast)