다음을 통해 공유

빠른 시작 순위표

  • 아티클

이 가이드에서는 순위표 서비스에 대한 개발 환경을 설정하는 방법을 살펴보겠습니다. 웹 사이트 게임 관리자에서 빠른 순위표를 만드는 방법도 알아봅니다.

필수 구성 요소

PlayFab 순위표 서비스를 사용하려면 PlayFab 계정이 필요합니다. 계정을 만드는 지침은 인증을 참조 하세요.

순위표 만들기

왼쪽 메뉴에서 진행을 선택합니다.

PlayFab 순위표 주 메뉴

이제 위쪽 메뉴에서 순위표 탭을 선택합니다.

PlayFab 순위표 게임 관리자

그런 다음"새 순위표" 단추로 이동하여 순위표 정의를 만듭니다.

PlayFab 순위표 정의

여기서는 순위표의 모든 측면을 구성할 수 있습니다. 사용 가능한 매개 변수 및 순위표를 만드는 방법에 대해 자세히 알아보세요.

최종 결과는 다음과 같아야 합니다.

PlayFab 순위표 사용

환경 설정

여기서는 C# SDK를 사용하도록 개발자 환경을 설정하는 방법을 알아보겠지만 여기에 제시된 개념은 다른 SDK 또는 일반 HTTP 요청에서도 작동할 수 있습니다.

TitleId 및 DeveloperSecretKey 설정

DeveloperSecretKey는 타이틀 엔터티로 인증할 때 필요합니다.

PlayFabSettings.staticSettings.TitleId = ""; // Change this value to your own titleId from PlayFab Game Manager
PlayFabSettings.staticSettings.DeveloperSecretKey = ""; // Change this to your title's secret key from Game Manager

타이틀 만들기 및 비밀 키 가져오기

  • 에 로그인 https://playfab.com/
  • 제목 만들기
    • 설정 아래의 API 기능 섹션에서 타이틀 ID를 찾습니다.
  • 비밀 키 생성:
    • 제목 보기의 왼쪽 위에 있는 제목 이름 옆에 있는 코그
    • 타이틀 설정
    • 비밀 키
    • 새 비밀 키

게임 관리자 내에서 비밀 키 섹션을 찾을 때 UI의 모양은 다음과 같습니다.

PlayFab 순위표 키

타이틀로 로그인

게임 서버에서 TitleEntity를 사용하는 것이 좋습니다 쓰기 작업의 경우 이 메서드는 모든 요청에서 사용할 를 반환 AuthenticationContext 합니다.

public static async Task<PlayFabAuthenticationContext> LoginAsTitleEntity()
{
    GetEntityTokenRequest request = new GetEntityTokenRequest()
    {
        Entity = new PlayFab.AuthenticationModels.EntityKey()
        {
            Id = PlayFabSettings.staticSettings.TitleId,
            Type = "title",
        },                
    };

    PlayFabResult<GetEntityTokenResponse> entityTokenResult = await PlayFabAuthenticationAPI.GetEntityTokenAsync(request);

    PlayFabAuthenticationContext authContext = new PlayFabAuthenticationContext
    {
        EntityToken = entityTokenResult.Result.EntityToken
    };
    
    return authContext;
}

플레이어로 로그인(플레이어 만들기)

이 메서드는 형식 title_player_account의 엔터티를 반환하는 식별자를 기반으로 플레이어를 만듭니다. 자세한 내용은 빠른 시작 엔터티

private static async Task<PlayFabAuthenticationContext> LoginAsPlayer(string customId = "GettingStartedGuide")
{
    LoginWithCustomIDRequest request = new LoginWithCustomIDRequest { CustomId = customId, CreateAccount = true };

    PlayFabResult<LoginResult> loginResult = await PlayFabClientAPI.LoginWithCustomIDAsync(request);

    return loginResult.Result.AuthenticationContext;
}

엔터티의 표시 이름 속성 설정

DisplayName 속성을 "순위표 가져오기 API"의 응답의 일부로 사용할 수 있도록 하려면 엔터티를 게임의 사용자 지정 표시 이름에 매핑하기 위해 만든 각 엔터티당 다음 코드를 실행해야 합니다.

private static async Task UpdateEntityDisplayName(PlayFabAuthenticationContext context, string customId)
{
    SetDisplayNameRequest request = new SetDisplayNameRequest()
    {
        AuthenticationContext = context,
        DisplayName = customId,
        Entity = new PlayFab.ProfilesModels.EntityKey()
        {
            Id = context.EntityId,
            Type = context.EntityType,
        },
    };

    PlayFabResult<SetDisplayNameResponse> updateNameResult = await PlayFabProfilesAPI.SetDisplayNameAsync(request);
}

참고 항목