Azure PlayFab Party
이 항목을 사용하여 Microsoft Game Development Kit (GDK)에서 PlayFab Party를 사용하는 방법을 이해합니다. PlayFab Party를 사용하면 유연하고 포용적이며 안전한 방식으로 게임에 지연 시간이 짧은 채팅 및 데이터 통신을 간편하게 추가할 수 있습니다. Party는 클라우드 호스팅 전용 서버를 원하지 않는 멀티플레이어 구현(P2P(peer-to-peer) 게임이라고도 함)에 이상적입니다. 클라우드 서버를 게임 호스트로 사용하는 경우에도 Party는 앱 내 소셜 환경(예: 게임 내 분대 또는 게임 후 로비)을 위한 음성 및 텍스트 통신을 지원합니다. Party는 XBOX One ERA Secure Sockets API의 Microsoft Game Development Kit (GDK) 후속 기능입니다. Party는 Azure Cognitive Services를 사용하여 사용자 음성 채팅을 텍스트로 변환하고 텍스트를 음성으로 합성하며, 이 기능은 주로 접근성 지원을 위해 설계되었습니다. PlayFab Party 음성 채팅의 일반적인 사용량은 분 단위로 청구됩니다. 이러한 음성 사용 시간의 최대 10%까지는 텍스트 변환 및 음성 합성을 무료로 사용할 수 있습니다. 이 기능의 활성화를 접근성 사용자 설정에 연결하는 것이 좋습니다.[!NOTE] Party는 채팅을 실시간으로 번역하기도 합니다. 익명 매치메이킹 및 국제 경쟁 게임에서 이러한 텍스트 변환 및 번역 기능은 더 몰입감 있는 멀티플레이어 환경을 제공합니다.PlayFab Party(및 기타 멀티플레이어 서비스)의 핵심 목표는 상호 운용 가능한 멀티플레이어 인프라와 크로스 네트워크 게임플레이를 지원하는 것입니다. 멀티플레이어 환경이 멀티플레이어 및 크로스 네트워크 사용자 활동에 대한 관련 플랫폼 정책을 준수하는지 확인하세요.
PlayFab Party 기능
- 암호화 및 인증: Party는 PlayFab 사용자 ID를 사용하여 사용자 디바이스를 인증하고 DTLS와 유사한 프로토콜로 데이터를 암호화합니다.
- 디바이스 간 데이터그램 네트워킹: Party의 핵심은 Azure 클라우드 전반에 걸쳐 전 세계적으로 호스팅되는 릴레이입니다. 사용자 디바이스는 이러한 릴레이를 사용하여 Party 네트워크를 만들고 서로 게임 데이터를 보냅니다. Party 네트워킹 시스템에는 패킷 손실 발생 시 자동 재시도와 같은 구성 가능한 전송 기능이 포함되어 있습니다.
- 음성 및 텍스트 채팅: 사용자 디바이스는 실시간 음성 채팅을 위해 오디오 디바이스를 Party 네트워크에 바인딩할 수 있습니다. Party는 사용자 간 텍스트 채팅 메시지도 지원합니다.
- 음성 텍스트 변환 및 음성 합성: Party는 사용자 음성 채팅을 텍스트로 변환하고 텍스트 메시지의 발화를 합성할 수 있습니다. 이 기능은 여러 용도로 사용되지만 주로 접근성 지원을 위해 설계되었습니다.
- 실시간 번역: Party는 사용자 음성 및 텍스트 채팅의 실시간 번역을 이해하고 합성할 수 있습니다.
Microsoft Game Development Kit (GDK) 고려 사항
XBOX services 요구 사항
XBOX services 타이틀의 사용자 통신은 사용자 안전을 위한 여러 요구 사항을 충족해야 합니다. PlayFab Party XBOX services 플러그 인과 함께 PlayFab Party를 사용하면 타이틀이 모든 XBOX services 통신 및 보안 요구 사항을 충족할 수 있습니다.[!NOTE] XBOX 요구 사항(XR)은 게임을 XBOX 플랫폼에 게시하기 전에 충족해야 하는 요구 사항입니다.
- XR-015: 플레이어 통신 관리.
- XR-045: XBOX services 및 계정 권한. XBOX services 플러그 인은 XPRIVILEGE_COMMUNICATIONS 부분만 적용합니다. 타이틀에서 다른 XBOX services 기능을 사용하는 경우 필요한 권한 확인을 수행해야 합니다.
- XR-072: 음성 지원.
- 크로스 네트워크 플레이: PlayFab Party는 서버가 필요한 크로스 네트워크 게임플레이 부분만 적용합니다. 필요한 권한 확인 및 XBOX services 상호 작용은 타이틀에서 담당해야 합니다.
- XR-064: 참가 가능한 게임 세션 및 온라인 플레이
- XR-067: 최근 함께 플레이한 상호 작용 유지 관리
네트워크 초기화
PlayFab Party는 Microsoft Game Development Kit (GDK) 타이틀의 네트워크 초기화를 자동으로 처리하지 않습니다. PlayFab Party를 호출하기 전에 네트워크가 초기화될 때까지 기다리세요. 네트워크가 초기화될 때까지 Party API는 실패합니다.일시 중단 및 다시 시작
RegisterAppStateChangeNotification을 통해 일시 중단 및 다시 시작 이벤트를 등록해야 합니다. 일시 중단 시 PartyManager::Cleanup()으로 Party를 정리합니다. 다시 시작 시에는 PartyManager::Initialize()를 호출하기 전에 다시 네트워크 초기화를 기다려야 합니다. 일시 중단/다시 시작 주기에 걸쳐 Party API를 사용하려고 하면 실패합니다.
PartyManager::Cleanup()이 완료되는 데 수백 밀리초가 걸릴 수 있습니다. 일시 중단 시간 초과를 방지하려면 다른 일시 중단 작업과 병렬로 Party를 정리하는 것이 좋습니다. Partymanager::Cleanup()을 비동기적으로 호출하는 경우 Party의 정리가 반환될 때까지 일시 중단 알림을 차단해야 합니다.
가격 정보
PlayFab Party는 XBOX services ID를 사용하는 Microsoft Game Development Kit (GDK)에서 무료입니다. 가격 및 청구에 대한 자세한 내용은 XBOX services 무료 프로그램 FAQ를 참조하세요.PlayFab 포털에서 타이틀 구성
- https://developer.playfab.com/으로 이동한 다음 계정을 만듭니다.
- 새 계정을 사용하여 PlayFab 스튜디오와 타이틀 ID를 만듭니다.
- 새로 만든 타이틀로 이동하여 Multiplayer 섹션을 선택한 다음 Party (Preview) 탭을 선택합니다.
- Enable을 선택한 다음 액세스 코드 XBOX Live를 입력합니다. 잠시 후 Party가 활성화됩니다.
- API Features 탭에서 PlayFab 타이틀 ID와 엔터티 ICD를 복사합니다.
- 타이틀 ID와 엔터티 ICD를 클라이언트 PlayFab Party API 초기화 함수에 추가합니다. 이제 Microsoft Game Development Kit (GDK) 타이틀에서 PlayFab Party를 사용할 수 있습니다.
Visual Studio를 사용하여 Microsoft Game Development Kit (GDK) 프로젝트에 PlayFab Party 라이브러리 추가
- Visual Studio 솔루션 탐색기에서 프로젝트를 마우스 오른쪽 단추로 클릭한 다음 Properties를 선택합니다.
- Configuration Properties에서 XBOX One 섹션으로 이동합니다.
- Gaming Extension Libraries 드롭다운 목록을 선택한 다음 PlayFab Party 및 XBOX Live Helper에 대한 참조를 추가합니다.
[!NOTE] 라이브러리는 기본 위치인 Program Files (x86)\Microsoft GDK[Version]\GRDK\ExtensionLibraries\PlayFab.Party.Cpp\Redist\x64(2024년 10월 이후) 또는 Program Files (x86)\Microsoft GDK[Version]\GRDK\ExtensionLibraries\PlayFab.Party.Cpp\Redist\CommonConfiguration\neutral(2024년 6월 이전)에 설치됩니다.