다음을 통해 공유


Python 빠른 시작

이 빠른 시작은 Python 3에서 첫 번째 API 호출을 수행할 수 있도록 설계되었습니다.

네이티브 Python 프로젝트는 몇 가지 방법으로 사용될 수 있습니다.

  • 게임 유지 관리를 위한 독립형 콘솔 관리 도구입니다.
  • 기존 Python 기반 게임 엔진에 통합됩니다.
    • Python 게임 엔진 목록은 python.org 웹 사이트에서 PythonGameLibraries를 참조하세요.

필수 구성 요소

참고 항목

이 Python SDK 베타 릴리스는 동기 API 호출만 지원하며 귀하의 게임 루프에서 PlayFab API 호출을 수행하지 못하도록 차단될 수 있습니다. 이 문제를 방지하려면 직접 비동기/스레드 모델을 만들어야 할 수 있습니다.

문제를 디버깅하는 데 문제가 있는 경우 제공된 오류 정보로는 충분하지 않습니다. PlayFab 포럼에서 문의해 주시기 바랍니다.

Python 프로젝트 설정

  1. 명령 프롬프트에서 다음 명령을 사용하여 PlayFab 패키지를 설치합니다.
pip install playfab

pip이(가) 경로에 없는 경우 대신 다음 명령을 사용합니다.

python -m pip install playfab
  1. 프로젝트 디렉터리에서 playfab_test.py라는 python 스크립트를 만듭니다.

첫 번째 API 호출 설정

이 빠른 시작에서는 GUI 또는 화면 피드백 없이 첫 번째 PlayFab API 호출을 수행하는 최소 단계를 제공합니다. 확인은 콘솔 인쇄 문을 사용하여 수행됩니다.

playfab_test.py 파일의 내용을 아래 표시된 내용으로 바꿉니다.

from playfab import PlayFabClientAPI, PlayFabSettings

PlayFabSettings.TitleId = "144"

request = {
    "CustomId": "GettingStartedGuide",
    "CreateAccount": True
}

def callback(success, failure):
    if success:
        print("Congratulations, you made your first successful API call!")
    else:
        print("Something went wrong with your first API call.  :(")
        if failure:
            print("Here's some debug information:")
            print(failure.GenerateErrorReport())
PlayFabClientAPI.LoginWithCustomID(request, callback)

완료 및 실행

아래와 같은 명령을 사용하여 Python 스크립트를 실행합니다.

python playfab_test.py

완료되면 "축하합니다. 첫 번째 API 호출을 성공적으로 만들었습니다."가 표시됩니다.

이 시점에서 다른 API 호출을 만들고 게임 빌드를 시작할 수 있습니다. 사용 가능한 모든 클라이언트 API 호출 목록을 보려면 PlayFab API 참조 설명서를 참조하세요.

즐거운 코딩이 되시길 바랍니다.

코드 분해

선택 사항인 이 마지막 섹션은 playfab_test.py의 각 부분을 자세히 설명합니다.

  • 가져오기

    • PlayFab imports는 API에 액세스할 수 있게 해줍니다.
  • PlayFabSettings.TitleId = "144"

    • 모든 PlayFab 개발자가 게임 관리자에서 타이들을 만듭니다. 게임을 게시할 때 게임에 해당 titleId를 코딩해야 합니다. 이렇게 하면 클라이언트가 PlayFab 내에서 올바른 데이터에 액세스하는 방법을 알 수 있습니다. 대부분의 사용자는 이를 PlayFab을 작동시키기 위한 필수 단계로 생각하면 됩니다.
  • request

    • 대부분의 PlayFab API 메서드에는 입력 매개 변수가 필요하고 이러한 입력 매개 변수는 사전 개체로 압축됩니다.
      • LoginWithCustomIDRequest은(는) 플레이어를 고유하게 식별하고 관련 엔터티 토큰을 반환하는 CustomId과(와) 이러한 호출로 새 계정을 만들 수 있는 CreateAccount의 필수 매개 변수를 가집니다.
      • 대부분의 개발자들은 보다 적절한 로그인 메서드를 사용하고자 합니다.
  • 콜백

    • 성공

      • API 호출이 성공하면 요청된 정보가 성공에 포함되고 오류는 None이(가) 됩니다.
      • 로그인 요청의 경우 성공에는 플레이어에 대한 몇 가지 기본 정보가 포함되지만 대부분의 사용자에게 있어서 로그인은 다른 API를 호출하기 전에 필요한 단계 중 하나일 뿐입니다.
    • Failure

      • API 호출이 실패하면 일부 오류 정보가 실패에 포함되고 성공은 None이(가) 됩니다.
      • API 호출은 여러 가지 이유로 실패할 수 있으며, 항상 실패 처리를 시도해야 합니다.
      • API 호출이 실패하는 이유(가능성이 높은 순서대로 나열)
        • PlayFabSettings.TitleId이(가) 설정되지 않았습니다. 타이틀에 titleId를 설정하는 것을 잊은 경우 아무 작업도 수행되지 않습니다.
        • 요청 매개 변수. 특정 API 호출에 대해 정확한 또는 필요한 정보를 제공하지 않은 경우 호출에 실패합니다.
        • 장치 연결 문제. 휴대폰은 지속적으로 연결이 끊어졌다가 다시 연결되므로 언제든지 모든 API 호출이 실패한 후 바로 다시 작동할 수 있습니다. 터널로 들어가면 연결이 완전히 끊길 수 있습니다.
        • PlayFab 서버 문제. 모든 소프트웨어와 마찬가지로 문제가 있을 수 있습니다. 업데이트에 대해서는 릴리스 정보를 참조하세요.
        • 인터넷은 100% 신뢰할 수 없습니다. 때때로 메시지가 손상되었거나 PlayFab 서버에 연결되지 않을 수 있습니다.
  • PlayFabClientAPI.LoginWithCustomID

    • 동기적으로 API 호출을 트리거합니다. 완료되면 콜백이 호출됩니다.