Corona 向け Lua クイックスタート

​

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

1. Corona をダウンロードしてインストールします: https://coronalabs.com/。
2. Corona を実行し、新しいプロジェクトを作成します。以下のリンクには、初回の手順を実施していない場合に役立つ情報が記載されています: https://docs.coronalabs.com/guide/start/installWin/index.html
3. インストール、ログイン、新しいプロジェクトの作成が完了すると、以下の例のようないくつかのウィンドウが表示されます。
4. Corona Marketplace で PlayFab Client プラグインを有効化します: https://marketplace.coronalabs.com/plugin/playfab-client
5. これで PlayFab のインストールは完了です。

​

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

settings =
{
    -- ADD THESE THREE LINES at the top, leave everything else as-is
    plugins = {
        ["plugin.playfab.client"] = { publisherId = "com.playfab" }
    },

-- Other existing lines...
}

local pfClient = require("plugin.playfab.client")
local PlayFabClientApi = pfClient.PlayFabClientApi
PlayFabClientApi.settings.titleId = "144"

local loginRequest = {
    -- See the API reference for LoginWithCustomID.
    CustomId = "GettingStartedGuide",
    CreateAccount = true
}
PlayFabClientApi.LoginWithCustomID(loginRequest,
    function(result) print("Congratulations, you made your first successful API call!") end,
    function(error) print("Something went wrong with your first API call.\nHere's some debug information:\n" .. error.errorMessage) end
)

​

完了して実行する

​

コードの詳細解説

• build.settings
  • plugins = {
    • これは Corona のプラグイン システムを呼び出し、Corona Marketplace プラグインをプロジェクトにダウンロードしてインストールするよう指示します。
  • ["plugin.playfab.client"] = { publisherId = "com.playfab" }
    • これは、PlayFab Client プラグインを具体的にダウンロードするよう指示します。
• main.lua
  • require() 行:
    • PlayFab API 呼び出しに必要な最小限のインポートです。
  • PlayFabClientApi.settings.titleId = "xxxx"
    • すべての PlayFab 開発者は、Game Manager でタイトルを作成します。ゲームを公開する際、その titleId をゲームにコーディングする必要があります。これにより、クライアントは PlayFab 内の正しいデータへのアクセス方法を知ることができます。ほとんどのユーザーにとって、これは PlayFab を動作させるために必要な手順と考えてください。
  • local loginRequest = { CustomId = "GettingStartedGuide", CreateAccount = true }
    • ほとんどの PlayFab API メソッドは入力パラメーターを必要とし、それらの入力パラメーターはリクエスト オブジェクトにまとめられます。
    • すべての API メソッドには、オプションと必須のパラメーターが混在した一意のリクエスト オブジェクトが必要です。
      • LoginWithCustomIDRequest には、プレイヤーを一意に識別する必須パラメーター CustomId と、この呼び出しで新しいアカウントの作成を許可する CreateAccount があります。
  • PlayFabClientApi.LoginWithCustomID(loginRequest, {OnLoginSuccess-function}, {OnLoginError-function})
    • これは LoginWithCustomID への非同期リクエストを開始し、成功した場合は最初の (OnLoginSuccess) コールバックを、失敗した場合は 2 番目の (OnLoginError) 関数を呼び出します。
  • ログインについては、ほとんどの開発者はより適切なログイン メソッドを使用することを望むでしょう。
    • すべてのログイン メソッドと入力パラメーターの一覧については、PlayFab ログイン ドキュメント を参照してください。一般的な選択肢は次のとおりです。
      • LoginWithAndroidDeviceID
      • LoginWithIOSDeviceID
      • LoginWithEmailAddress
    • OnLoginSuccess は、単一のパラメーター (result) を受け取る任意の関数です。
      • result オブジェクトには、呼び出された API に応じた要求された情報が含まれます。
      • LoginResult にはプレイヤーに関する基本情報が含まれますが、ほとんどのユーザーにとって、ログインは他の API を呼び出す前の必須ステップにすぎません。
    • OnLoginError は、単一のパラメーター (error) を受け取る任意の関数です。
      • API 呼び出しはさまざまな理由で失敗する可能性があるため、常に失敗を処理するようにしてください。
      • API 呼び出しが失敗する理由 (可能性の高い順):
        • PlayFabSettings.TitleId が設定されていない。titleId をタイトルに設定するのを忘れた場合、何も動作しません。
        • リクエスト パラメーター。特定の API 呼び出しに対して正しい情報や必要な情報を提供していない場合、失敗します。詳細については、error.errorMessage、error.errorDetails、または error.GenerateErrorReport() を参照してください。
        • デバイスの接続の問題。携帯電話は接続を頻繁に失ったり回復したりします。そのため、いつでも API 呼び出しがランダムに失敗し、その後すぐに動作することがあります。トンネルに入ると、完全に切断される可能性があります。
        • PlayFab サーバーの問題。すべてのソフトウェアと同様に、問題が発生する可能性があります。更新については リリース ノート を参照してください。
        • インターネットは 100% 信頼できるわけではありません。メッセージが破損したり、PlayFab サーバーに到達しなかったりすることがあります。
      • 問題のデバッグに苦労しており、エラー情報内の情報だけでは不十分な場合は、フォーラム にアクセスしてください。