Skip to main content
이 튜토리얼에서는 CloudScript, 특히 Azure Functions를 통해 리더보드를 구현하는 방법을 배웁니다. 이 접근 방식은 클라이언트 업데이트 없이 사용자 지정 서버 측 로직을 만들 수 있기 때문에 강력합니다. Azure Function 내에 리더보드 관련 로직을 정의하면 클라이언트는 해당 함수를 호출하여 코드를 실행할 수 있습니다. 나중에 변경이 필요할 경우, 업데이트의 복잡도에 따라 대부분 클라이언트를 수정하지 않고도 Azure Function을 독립적으로 업데이트할 수 있습니다.

필수 구성 요소

이 튜토리얼을 따라하려면 다음이 필요합니다.
  • PlayFab 계정. 계정이 없는 경우 여기에서 만들 수 있습니다.
  • Azure 구독. 구독이 없는 경우 여기에서 만들 수 있습니다.
Azure Function을 만드는 방법에 대한 자세한 내용은 이 가이드를 확인하세요. Visual Studio를 사용해 Azure에서 첫 번째 함수 만들기

Azure Functions를 사용해 리더보드 만들기

이 섹션에서는 점수를 제출하고 상위 점수를 검색할 수 있는 리더보드를 만들어 보겠습니다.
  • 함수 특성 [Function("LeaderboardExample")]는 함수의 이름을 정의합니다. 이 경우 LeaderboardExample입니다.
  • 이 함수는 [HttpTrigger(AuthorizationLevel.Anonymous, "get", "post")] 특성에서 알 수 있듯이 HTTP 요청에 의해 트리거됩니다. 즉, 이 함수는 인증 없이 HTTP GET 및 POST 메서드를 통해 액세스할 수 있습니다.
  • 함수 내에서 PlayFab Title ID와 Developer Secret Key를 설정하여 PlayFab 서비스에 대한 요청을 인증합니다. 특정 상황과 보안 요구 사항에 가장 적합한 방식으로 이러한 값에 액세스하는 방법을 변경할 수 있습니다.
  • 이 함수는 요청에 “leaderboardName” 쿼리 매개 변수가 제공되었는지 확인합니다.
  • 그런 다음 LoginAsTitleEntity 메서드를 호출하여 리더보드 정의 생성에 필요한 title 엔티티로 인증합니다.
  • 마지막으로 CreateLeaderboardDefinitionAsync 메서드를 호출하여 제공된 이름으로 리더보드 정의를 만듭니다. 리더보드 생성에 대한 자세한 내용은 기본 리더보드 만들기리더보드 더 활용하기를 확인하세요.
RunAsync 메서드는 Azure Function의 진입점 역할을 합니다. 여기서 추가 메서드를 정의하고 호출하여 사용자 지정 게임 로직을 구축할 수 있습니다. 오류를 처리하거나 여러 PlayFab 서비스와 상호작용하는 방식은 전적으로 여러분의 선택이며, 구현에 완전한 유연성을 제공합니다. 또한, 특정 이벤트를 기반으로 이 Azure Function을 트리거하도록 자동화 규칙을 구성할 수 있습니다. 자세한 내용은 여기를 참조하세요.

함께 보기

마지막 수정일 2026년 8월 13일