CloudScript (レガシ) のクイック スタート

CloudScript は、高速で、安全で、スケーラブルな、専用サーバーの代替品です。 カスタム JavaScript は PlayFab マシンに直接存在し、実行されます。

注意

Azure Functions を使用する ClouScript は、より多くの言語をサポートし、デバッグ ワークフローを改善しました。

ここから、コードをゲーム クライアントによって直接呼び出すか、PlayStream アクションを通じて間接的に呼び出すことができます。 さらに、CloudScript (レガシ) メソッドは PlayFab のサーバー API セットに完全にアクセスできます。

このクイック スタートでは、PlayFab ゲーム マネージャーでの CloudScript ファイルのアップロードと管理について説明します。

注意

カスタム CloudScript の記述チュートリアルでは、CloudScript (レガシ) コード自体の記述について説明します。

本書を読む際は以下に留意してください。

  • PlayFab の基本を理解しておく必要があります。
  • ここで示す C# サンプルは、PlayFab Unity SDK の使用と対応しています。
  • PlayFab CloudScript (レガシ) サービスを使用するサンプルの JavaScript が対応しています。

最初の CloudScript (レガシ) リビジョン

タイトルを作成すると、PlayFab には、最初のリビジョンとしてスクリプトの例が自動的に含まれます。 このリビジョンには、CloudScript (レガシ) の学習とテストに使える多くのメソッドが含まれています。

これらの関数を確認するには以下を実行してください。

  • ゲーム マネージャーを開きます。
  • タイトルを選択します。
  • 左側のバーの [Automation (自動化)] を選択します。

HelloWorld など、多くの CloudScript (レガシ) メソッドが表示されます。このメソッドは、Hello PLAYERID のメッセージをログ記録します。PLAYERID は、現在のプレイヤーの PlayFab ID です。

ゲーム マネージャー - 自動化 - CloudScript

独自のリビジョンをアップロードする

ゲーム マネージャーを使用して、独自のカスタム メソッドをアップロードできます。 アップロードした各ファイルによって新しいリビジョンが作成されます。 アップロード中、PlayFab サービスは CloudScript (レガシ) に対して簡単な LINT チェックを実行し、構文エラーを確認します。

エラーが検出された場合

  • エラー メッセージが表示されます。
  • エラーを修正し、再度 [SUBMIT] (送信) を選択します。
  • 既定では、新しいアップロードは [DEPLOY REVISION # TO LIVE] (リビジョン番号をライブに展開) リンクを選択することによって展開する必要があります。 これにより、複数のバージョンの CloudScript (レガシ) に更新またはロール バックできます。

オレンジ色の [UPLOAD NEW REVISION] (新しいリビジョンのアップロード) を最初に押すと、ファイル セレクターが表示され、ローカル マシンからファイルをアップロードできます。

ゲーム マネージャー - CloudScript ファイルのアップロード

いくつかのリビジョンを追加した後、ドロップ ダウンで、どのリビジョンをライブにするかを選択できます。

ゲーム マネージャー - CloudScript のアップロード - リビジョンの選択

GitHub との統合

GitHub を使用して CloudScript (レガシ) のリビジョンを管理することもできます。 GitHub のアカウントが必要です。また、ログインする必要があります。

  • [USE GITHUB] (GitHub を使用) を選択します (前のスクリーンショットの灰色のボタン)。
  • 次のウィンドウにはオレンジ色の [AUTHORIZE GITHUB ACCOUNT] (GitHub アカウントを承認) があります。
  • GitHub に新しい空のリポジトリを作成します。
  • PlayFab ゲーム マネージャーの [GitHub] ページに戻ります (更新タブ)。
  • この時点で、[GitHub] リポジトリを選択し、タイトルにバインドできます。

ゲーム マネージャー - アドオン - GitHub

GitHub にバインドされた後、手動アップロードのオプションは削除され、GitHub コミットごとに新しい CloudScript (レガシ) リビジョンが "master" ブランチに自動的に作成されます。

複数のファイルをコミットする場合、単一の PlayFab CloudScript (レガシ) リビジョンに連結されます。 ライブ リビジョンの選択は同じです。上記で説明したように、GitHub への新しいコミットはゲーム マネージャーでライブに設定する必要があります。

まとめ

CloudScript (レガシ) は、PlayFab にファイルをアップロードし、Microsoft のサーバーでユーザーのコードを実行することを可能にします。 左側のバーの [自動化] オプションから CloudScript (レガシ) ファイルを管理できます。 自分のコンピューターからファイルを手動でアップロードするか、GitHub アカウントにタイトルをバインドできます。

このクイックスタートでは、コード ファイルを管理し、PlayFab にアップロードする方法を説明します。

さらに質問がある場合は、「カスタム CloudScript (レガシ) の記述」チュートリアルで、CloudScript (レガシ) コード ファイルの記述方法について詳しく説明しています。