다음을 통해 공유

Azure PlayFab 파티

  • 아티클

이 항목을 사용하여 Microsoft GDK(게임 개발 키트)에서 PlayFab 파티를 사용하는 방법을 이해할 수 있습니다. PlayFab 파티는 유연하고 포괄적이며 안전한 방식으로 대기 시간이 짧은 채팅 및 데이터 통신을 게임에 간단하게 추가할 수 있습니다. 파티는 클라우드 호스트 전용 서버가 적합하지 않은 멀티 플레이어 구현(피어 투 피어 게임 또는 P2P 게임이라고도 함)에 이상적입니다. 파티는 클라우드 서버를 게임 호스트로 사용하는 경우에도 앱 내 소셜 환경(예: 게임 내 스쿼드 또는 게임 후 로비 등)에 대한 음성 및 텍스트 통신을 지원합니다. 파티는 Xbox One ERA 보안 소켓 API에 대한 Microsoft GDK(게임 개발 키트) 후속 제품입니다.

파티는 사용자 음성 채팅을 기록하고 텍스트를 음성으로 합성하기 위해 주로 접근성 보조 목적으로 설계된 Azure Cognitive Services를 사용합니다. PlayFab 파티 음성 채팅에 대한 일반적인 사용량은 기본적으로 분 단위로 청구됩니다. 음성 분 중 10퍼센트까지 무료로 전사와 합성을 사용할 수 있다. 해당 기능의 활성화를 접근이 용이한 사용자 설정에 연결하는 것이 좋습니다.

참고 항목

파티는 채팅을 실시간으로 번역합니다. 익명의 매치 메이킹 및 국제 경쟁 게임에서 해당 기록 및 번역 기능을 사용하면 보다 몰입도 높은 멀티 플레이어 환경을 경험할 수 있습니다.

PlayFab 파티(및 다른 멀티 플레이어 서비스)의 주요 목표는 상호 운용 가능한 멀티 플레이어 인프라와 네트워크 간 게임 플레이를 촉진하는 것입니다. 사용자의 멀티 플레이어 환경에서 멀티 플레이어 및 네트워크 간 사용자 활동에 관한 플랫폼 정책 준수 여부를 확인하세요.

PlayFab 파티 기능

  • 암호화 및 인증: 파티는 PlayFab 사용자 ID를 사용하여 사용자 장치를 인증하고 DTLS와 유사한 프로토콜로 데이터를 암호화합니다.
  • 장치 간 데이터그램 네트워킹: 파티의 핵심에는 Azure 클라우드 전반에 걸쳐 호스팅되는 릴레이가 있습니다. 사용자 장치는 이러한 릴레이를 사용하여 파티 네트워크를 만들고 게임 데이터를 서로 보냅니다. 파티 네트워킹 시스템에는 패킷 손실 발생 시 자동 재시도 같은 구성 가능한 전송 기능이 포함되어 있습니다.
  • 음성 및 텍스트 채팅: 사용자 장치는 실시간 음성 채팅을 위해 오디오 장치를 파티 네트워크에 바인딩할 수 있습니다. 파티는 사용자 간의 문자 채팅 메시지도 지원합니다.
  • 음성 대 텍스트 및 음성 합성: 파티는 사용자 음성 채팅을 기록하고 문자 메시지의 음성을 합성할 수 있습니다. 이 기능은 몇 가지 용도로 사용되지만 주로 접근성 보조 장치로 설계되었습니다.
  • 실시간 변환: 당사자는 사용자 음성 및 텍스트 채팅의 실시간 번역을 이해하고 합성할 수 있습니다.

Microsoft GDK(게임 개발 키트) 고려 사항

Xbox 서비스 요구 사항

Xbox 서비스 타이틀에 대한 사용자 통신은 사용자 안전을 위한 몇 가지 요구 사항을 충족해야 합니다. PlayFab 파티 Xbox 서비스 플러그 인과 함께 PlayFab 파티를 사용하면 타이틀이 모든 Xbox 서비스 통신 및 보안 요구 사항을 충족하는지 확인할 수 있습니다.

참고 항목

Xbox 요구 사항(XR)은 Xbox 플랫폼에 게시되기 전에 충족해야 하는 게임의 요구 사항입니다.

  • XR-015: 플레이어 통신 관리 중입니다.
  • XR-045: Xbox 서비스 및 계정 권한. Xbox 서비스 플러그인은 XPRIVILEGE_COMMUNICATIONS 부분만 적용합니다. 타이틀이 다른 Xbox 서비스 기능을 사용하는 경우 필요한 권한 확인을 수행해야 합니다.
  • XR-072: 음성 지원
  • XR-007: 네트워크 간 플레이, 데이터 사용량 및 컴패니언 앱 상호 작용 PlayFab 파티는 서버가 필요한 네트워크 간 게임 플레이 부분만 적용합니다. 귀하의 타이틀은 필요한 권한 확인 및 Xbox 서비스 상호 작용에 대한 책임이 있습니다.
  • XR-064: 조인 가능한 게임 세션 및 온라인 재생
  • XR-067: 멀티플레이어 세션 상태 유지
  • XR-124: 게임 초대

네트워크 초기화

Azure PlayFab 파티는 Microsoft GDK(게임 개발 키트) 타이틀에 대한 네트워크 초기화를 자동으로 처리하지 않습니다. PlayFab 파티로 호출하기 전에 네트워크가 초기화될 때까지 기다립니다. 네트워크가 초기화될 때까지 파티 API가 실패합니다.

일시 중단 및 재개

RegisterAppStateChangeNotification을(를) 통해 일시 중단 및 다시 시작 이벤트를 등록해야 합니다. 일시 중단 시 PartyManager::Cleanup()을(를) 사용하여 파티를 정리합니다. 재개 시 PartyManager::Initialize()을(를) 호출하기 전에 네트워크 초기화를 다시 기다려야 합니다. 사용자가 일시 중단/다시 시작 주기 동안 제품을 사용하려고 하면 파티 API가 실패합니다.

PartyManager::Cleanup()을(를) 완료하는 데 200밀리초가 걸릴 수 있습니다. 일시 중단 시간 초과를 방지하기 위해 다른 일시 중단 작업과 함께 파티를 정리하는 것이 좋습니다. 비동기식으로 Partymanager::Cleanup()을(를) 호출할 경우 파티의 정리가 반환될 때까지 일시 중단 알림을 차단해야 합니다.

가격 정보

PlayFab 파티는 Xbox 서비스 ID를 사용하여 Microsoft GDK(게임 개발 키트)에 대해 무료입니다. 가격 책정 및 청구에 대한 자세한 내용은 Xbox 서비스 무료 프로그램 FAQ를 참조하세요.

PlayFab 포털에서 타이틀 구성

  1. https://developer.playfab.com/으로 이동하여 계정을 만드세요.
  2. 새 계정을 사용하여 PlayFab 스튜디오 및 타이틀 ID를 만듭니다.
  3. 새로 만든 타이틀로 이동하여 멀티플레이어 섹션을 선택한 다음 파티(미리 보기) 탭을 선택합니다.
  4. 사용 설정을 선택한 다음 Xbox Live 액세스 코드를 입력하세요. 잠시 후 파티가 활성화됩니다.
  5. API 기능 탭에서 PlayFab 타이틀 ID 및 엔터티 ICD를 복사합니다.
  6. 클라이언트 PlayFab 파티 API 초기화 함수에 타이틀 ID 및 엔터티 ICD를 추가합니다. 이제 Microsoft GDK(게임 개발 키트) 타이틀에서 PlayFab 파티를 사용할 수 있습니다.

자세한 내용은 빠른 시작: 게임 관리자를 참조하세요.

Visual Studio를 사용하여 Microsoft GDK(게임 개발 키트) 프로젝트에 PlayFab 파티 라이브러리 추가

  1. Visual Studio 솔루션 탐색기에서 프로젝트를 마우스 오른쪽 단추로 클릭한 다음 속성을 선택하세요.
  2. 구성 속성에서 Xbox One 섹션으로 이동합니다.
  3. 게임 확장 라이브러리 드롭다운 목록을 선택한 다음 PlayFab 파티 및 Xbox Live 도우미에 대한 참조를 추가합니다.

참고 항목

라이브러리는 프로그램 파일(x86)\Microsoft GDK[버전]\GRDK\ExtensionLibraries\PlayFab.Party.Cpp\Redist\x64 (2024년 10월 이상) 아래의 기본 위치에 설치됩니다. - 프로그램 파일 (x86)\Microsoft GDK[버전]\GRDK\ExtensionLibraries\PlayFab.Party.Cpp\Redist\CommonConfiguration\neutral (2024년 6월 또는 이전 버전).

PlayFab 파티 및 샌드박스

샌드박스에 대한 PlayFab 파티 구성은 필요하지 않습니다. 모든 네트워크 세션은 배포되는 샌드박스에 관계없이 소매 환경에 할당됩니다. 테스트를 위해 사용자를 구분해야 하는 경우 테스트 및 소매 환경에 대해 별도의 PlayFab 타이틀 ID를 만듭니다. PlayFab 타이틀 ID는 Xbox 서비스 타이틀 ID와 별개입니다. 하나의 Xbox 서비스 타이틀 ID는 여러 다른 PlayFab 타이틀 ID를 사용할 수 있습니다.

참고 항목

PlayFab 파티 개요PlayFab 파티 개요