다음을 통해 공유

게임에서 순위표 구현

이 문서에서는 순위표가 게이머가 게임에서 달성할 수 있는 특정 작업에 대해 다른 플레이어와 자신을 평가할 수 있는 방법을 설명합니다. 자세한 내용은 문서 끝에 있는 참고 항목 섹션의 페이지를 검토해야 합니다.

Microsoft Azure PlayFab Services SDK를 사용하여 순위표 기능 구현

PlayFab 순위표 서비스는 순위표를 구현하기 위한 여러 가지 유효한 사용 옵션을 제공합니다.

  1. Azure PlayFab C SDK 다운로드 및 설정: 플랫폼용 C/C++ SDK를 다운로드하고 제공된 헤더 및 라이브러리 파일을 빌드에 통합합니다.

  2. 순위표를 정의합니다.

    • PlayFab 게임 관리자 사용: PlayFab 게임 관리자 내의 순위표 섹션으로 이동합니다. 고유한 순위표 이름을 지정하여 새 순위표를 만듭니다. 순위표의 정렬 메서드(오름차순 또는 내림차순)를 구성합니다. 필요에 따라 순위표 재설정 일정을 설정합니다. 예를 들어 매일, 매주 또는 매월입니다.
    • API 요청 사용: PlayFab SDK API 또는 PlayFab REST API를 사용하여 새 순위표 정의를 만들 수도 있습니다. 여기에는 엔터티 형식, 순위표 열 및 버전 구성과 같은 매개 변수를 지정하는 작업이 포함됩니다.

  3. 플레이어 인증: 게임에서 이러한 서비스를 사용하는 기능을 사용하려면 먼저 Xbox 서비스와 PlayFab을 모두 사용하여 플레이어를 인증해야 합니다.

  4. 플레이어 순위표 통계 업데이트: 순위표 통계를 업데이트하는 두 가지 방법이 있습니다.

    • 게임 클라이언트에서 PFStatisticsUpdateStatisticsAsync API 호출을 사용합니다. 이 API에는 다음 정보가 필요합니다.
      • 순위표 이름입니다.
      • 제출할 플레이어의 점수입니다. 순위표는 다중 열 정의를 지원하므로 플레이어에 여러 점수를 추가할 수 있습니다. 최대 5개의 열을 정의할 수 있습니다.
    • 게임 클라이언트에서 PFLeaderboardsUpdateLeaderboardEntriesAsync API 호출을 사용합니다.

    이러한 호출 중 하나가 지정된 순위표에 항목을 추가하거나 업데이트합니다.

  5. 순위표 데이터 검색: 게임 클라이언트에서 API 호출을 사용합니다 PFLeaderboardsGetLeaderboardAsync . 이 API에는 다음 정보가 필요합니다.

    • 순위표 이름입니다. 선택적 매개 변수:
      • StartPosition: 데이터를 검색할 순위표의 시작 위치입니다.
      • MaxResultsCount: 검색할 최대 순위표 항목 수입니다.

    이 API는 다음을 포함하여 순위표 항목의 배열을 반환합니다.

    • 플레이어 PlayFab ID
    • 플레이어 표시 이름(사용 가능한 경우)
    • 플레이어 점수
    • 플레이어 순위

  6. 플레이어 주변의 순위표 검색(선택 사항): 게임 클라이언트에서 API 호출을 사용합니다 PFLeaderboardsGetLeaderboardAroundEntityAsync . 이 API에는 다음 정보가 필요합니다.

    • 순위표 이름입니다. 선택적 매개 변수:
      • MaxResultsCount: 검색할 최대 순위표 항목 수입니다.

    이 API는 요청 중인 플레이어를 중심으로 순위표 데이터를 반환하여 다른 플레이어를 기준으로 자신의 위치를 표시합니다. 및 를 사용할 때 PFLeaderboardsGetLeaderboardAsync 의 제한 목록은 순위표의 제한을 참조하세요.PFLeaderboardsGetLeaderboardAroundEntityAsync

  7. 게임 UI에 순위표 정보 표시: 또는 PFLeaderboardsGetLeaderboardAroundEntityAsync API 호출에서 반환되는 PFLeaderboardsGetLeaderboardAsync 데이터를 구문 분석합니다. 게임 내에서 사용자 인터페이스를 만들어 순위표 데이터를 표시합니다. 명확하고 체계적인 방식으로 플레이어 순위, 점수 및 플레이어 이름(또는 표시 이름)을 표시합니다.

참고 항목

PlayFab 개발자 설명서는 가장 정확한 기본 정보 원본입니다. 자세한 내용은 다음 문서를 참조하세요.

  • Last updated on