Python クイックスタート

• ゲームを維持するためのスタンドアロン コンソール管理ツールとして。
• 既存の Python ベースのゲーム エンジンへの統合。
  • Python ゲーム エンジンの一覧については、python.org の PythonGameLibraries を参照してください。

​

前提条件

• PlayFab 開発者アカウント。
• お使いのシステムにインストールされた Python 3。
  • requests モジュールもインストールされている必要があります。

​

Python プロジェクトのセットアップ

1. コマンド プロンプトから、次のコマンドを使用して PlayFab パッケージ をインストールします。

pip install playfab

python -m pip install playfab

2. プロジェクト ディレクトリに、playfab_test.py という名前の Python スクリプトを作成します。

​

最初の API 呼び出しをセットアップする

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 playfab_test.py

​

コードの詳細解説

• インポート
  • PlayFab のインポートにより、API へのアクセスが得られます。
• PlayFabSettings.TitleId = "144"
  • すべての PlayFab 開発者は、Game Manager でタイトルを作成します。ゲームを公開する際、その titleId をゲームにコーディングする必要があります。これにより、クライアントは PlayFab 内の正しいデータへのアクセス方法を知ることができます。ほとんどのユーザーにとって、これは PlayFab を動作させるために必要な手順と考えてください。
• request
  • ほとんどの PlayFab API メソッドは入力パラメーターを必要とし、それらの入力パラメーターは辞書オブジェクトにまとめられます。
    • LoginWithCustomIDRequest は、プレイヤーを一意に識別して関連するエンティティ トークンを返す必須パラメーター CustomId と、この呼び出しで新しいアカウントの作成を許可する CreateAccount を受け取ります。
    • ログインについては、ほとんどの開発者はより適切なログイン メソッドを使用することを望むでしょう。
      • すべてのログイン メソッドと入力パラメーターの一覧については、PlayFab ログイン ドキュメント を参照してください。一般的な選択肢は次のとおりです。
        • LoginWithAndroidDeviceID
        • LoginWithIOSDeviceID
        • LoginWithEmailAddress
• コールバック
  • Success
    • API 呼び出しが成功した場合、success には要求された情報が含まれ、failure は None になります。
    • ログイン リクエストの場合、success にはプレイヤーに関する基本情報が含まれますが、ほとんどのユーザーにとって、ログインは他の API を呼び出す前の必須ステップにすぎません。
  • Failure
    • API 呼び出しが成功しなかった場合、failure にはエラー情報が含まれ、success は None になります。
    • API 呼び出しはさまざまな理由で失敗する可能性があるため、常に失敗を処理するようにしてください。
    • API 呼び出しが失敗する理由 (可能性の高い順)
      • PlayFabSettings.TitleId が設定されていない。titleId をタイトルに設定するのを忘れた場合、何も動作しません。
      • リクエスト パラメーター。特定の API 呼び出しに対して正しい情報や必要な情報を提供していない場合、失敗します。
      • デバイスの接続の問題。携帯電話は接続を頻繁に失ったり回復したりします。そのため、いつでも API 呼び出しがランダムに失敗し、その後すぐに動作することがあります。トンネルに入ると、完全に切断される可能性があります。
      • PlayFab サーバーの問題。すべてのソフトウェアと同様に、問題が発生する可能性があります。更新については リリース ノート を参照してください。
      • インターネットは 100% 信頼できるわけではありません。メッセージが破損したり、PlayFab サーバーに到達しなかったりすることがあります。
• PlayFabClientAPI.LoginWithCustomID
  • API 呼び出しを同期的にトリガーします。完了すると、コールバックが呼び出されます。