> ## Documentation Index
> Fetch the complete documentation index at: https://docs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# CloudScript クイックスタート

> Game Manager から PlayFab CloudScript の JavaScript ファイルをアップロード、リビジョン管理、呼び出しを行い、Unity ゲーム クライアントや PlayStream アクションから呼び出します。

CloudScript は、専用サーバーに代わる高速でセキュア、スケーラブルな選択肢です。カスタム JavaScript は PlayFab のマシン上で直接実行されます。

> [!NOTE]
>
> [Azure Functions を利用した CloudScript](https://docs.xbox.com/ja-jp/services/playfab/live-service-management/service-gateway/automation/cloudscript-af/quickstart.md) は、より多くの言語に対応し、デバッグ ワークフローも改善されています。

ここから、コードはゲーム クライアントから *直接* 呼び出せるだけでなく、PlayStream アクションを介して間接的に呼び出せます。さらに、CloudScript メソッドは PlayFab の [Server](https://docs.xbox.com/ja-jp/services/playfab/api-references.md) API 一式へのフル アクセスを持ちます。

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

> [!NOTE]
>
> [カスタム CloudScript の作成](https://docs.xbox.com/ja-jp/services/playfab/live-service-management/service-gateway/automation/cloudscript/writing-custom-cloudscript.md) チュートリアルでは、CloudScript コード自体の記述方法について説明しています。

本ドキュメントを読む際は、以下の点にご注意ください:

* PlayFab の基本を理解している必要があります。
* 掲載されている **C#** サンプルは PlayFab Unity SDK を使用したものです。
* JavaScript サンプルは PlayFab CloudScript サービスを使用したものです。

## 最初の CloudScript リビジョン

タイトルを作成した後、PlayFab は最初のリビジョンとしてサンプル スクリプトを自動的に含めます。このリビジョンには、CloudScript の学習やテストに使用できるいくつかのメソッドが含まれています。

これらの関数を確認するには:

* [Game Manager](https://developer.playfab.com/) を開きます。
* タイトルを選択します。
* 左側のサイドバーで **Automation** を選択します。

**Hello PLAYERID** というメッセージをログに記録する **HelloWorld** など、いくつかの CloudScript メソッドが表示されます。ここで **PLAYERID** は現在のプレイヤーの PlayFab ID です。

![Game Manager - Automation - CloudScript](https://mintcdn.com/microsoft-4404708b/dqv53299jA1M-fNi/images/playfab/live-service-management/service-gateway/automation/cloudscript/tutorials/game-manager-cloudscript.png?fit=max\&auto=format\&n=dqv53299jA1M-fNi\&q=85\&s=c97908f94559bbfd9d2b48d955d581a2)

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

独自のカスタム メソッドは Game Manager からアップロードできます。ファイルをアップロードするたびに新しいリビジョンが作成されます。アップロード時に、PlayFab サービスは CloudScript の構文エラーを簡単な LINT でチェックします。

エラーが見つかった場合:

* エラー メッセージが表示されます。
* エラーを修正し、もう一度 **SUBMIT** を選択します。
* デフォルトでは、新しいアップロードは **DEPLOY REVISION # TO LIVE** リンクを選択して展開する必要があります。これにより、複数バージョンの CloudScript を更新したり、ロールバックしたりできます。

初めてオレンジ色の **UPLOAD NEW REVISION** ボタンを押すと、ローカル マシンからファイルをアップロードできるファイル セレクターが表示されます。

![Game Manager - Upload CloudScript file](https://mintcdn.com/microsoft-4404708b/dqv53299jA1M-fNi/images/playfab/live-service-management/service-gateway/automation/cloudscript/tutorials/game-manager-upload-cloudscript.png?fit=max\&auto=format\&n=dqv53299jA1M-fNi\&q=85\&s=68f6073c262ee7022e2d177b9ef0b0d8)

複数のリビジョンを追加した後は、ドロップダウンで送信済みリビジョンのうち *どれ* をライブにするか選択できます。

![Game Manager - Upload CloudScript - select revision](https://mintcdn.com/microsoft-4404708b/dqv53299jA1M-fNi/images/playfab/live-service-management/service-gateway/automation/cloudscript/tutorials/game-manager-cloudscript-select-revision.png?fit=max\&auto=format\&n=dqv53299jA1M-fNi\&q=85\&s=cd0cb0ba3694a687309320bb0dd9b208)

## GitHub との統合

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

* **USE GITHUB** ボタン (前のスクリーンショットにあるグレーのボタン) を選択します。
* 次のウィンドウには、オレンジ色の **AUTHORIZE GITHUB ACCOUNT** ボタンが表示されます。
* **GitHub** で新しい空のリポジトリを作成します。
* PlayFab Game Manager の **GitHub** ページに戻ります (タブを更新)。
* この時点で、**GitHub** リポジトリを選択し、タイトルにバインドできるはずです。

![Game Manager - Addons - GitHub](https://mintcdn.com/microsoft-4404708b/dqv53299jA1M-fNi/images/playfab/live-service-management/service-gateway/automation/cloudscript/tutorials/game-manager-addons-github.png?fit=max\&auto=format\&n=dqv53299jA1M-fNi\&q=85\&s=dbc72c3437b55c738803cf6cb013ae90)

GitHub にバインドされると、手動アップロードのオプションは削除され、「master」ブランチへの各 GitHub コミットに対して新しい CloudScript リビジョンが自動的に作成されます。

*複数* のファイルをコミットすると、それらは 1 つの PlayFab CloudScript リビジョンに連結されます。ライブ リビジョンの選択は同様で、GitHub への新しいコミットは前述のとおり Game Manager でライブに設定する必要があります。

## まとめ

CloudScript を使用すると、PlayFab にファイルをアップロードし、当社のサーバーでコードを実行できます。左側のサイドバーの **Automation** オプションから CloudScript ファイルを管理できます。ファイルは自身のコンピューターから手動でアップロードするか、タイトルを GitHub アカウントにバインドできます。

このクイックスタートでは、コード ファイルの管理と PlayFab へのアップロードを取り上げました。

さらに質問がある場合は、[カスタム CloudScript の作成チュートリアル](https://docs.xbox.com/ja-jp/services/playfab/live-service-management/service-gateway/automation/cloudscript/writing-custom-cloudscript.md) で、CloudScript コード ファイルの記述方法について詳しく説明しています。


## Related topics

- [Title Data クイックスタート](https://docs.xbox.com/ja-jp/services/playfab/live-service-management/game-configuration/titledata/quickstart.md)
- [スケジュール タスクのクイックスタート](https://docs.xbox.com/ja-jp/services/playfab/data-analytics/acting-data/scheduled-tasks/quickstart.md)
- [クイックスタート: プレイヤー データ](https://docs.xbox.com/ja-jp/services/playfab/player-progression/player-data/quickstart.md)
- [CloudScript](https://docs.xbox.com/ja-jp/services/playfab/live-service-management/service-gateway/automation/cloudscript/index.md)
- [パブリッシャー データの使用](https://docs.xbox.com/ja-jp/services/playfab/live-service-management/game-configuration/titledata/using-publisher-data.md)
