Unity Dashboard#

Unity Dashboard は、グラフィカルなインターフェースを通じてスクリプトを完全にコントロールできるため、使用の準備を簡単に行える方法です。このセクションでは、スクリプトをプレビュー、作成、編集、削除する方法について説明します。

スクリプトのプレビュー

Unity Dashboard から 環境 のすべての Cloud Code スクリプトのリストにアクセスできます。これにアクセスするには、以下を行います。

1. Unity Dashboard の LiveOps セクション内で、Cloud Code を選択します。
2. Scripts (スクリプト) を選択します。
3. 環境のリストから環境を選択します。

プロジェクトの選択した環境内のすべての Cloud Code スクリプトのリストが表示されます。テーブルには、名前、タイプ、最終公開日、バージョンが含まれています。スクリプト名でテーブルをソートしたり、ページ処理を使用してスクリプトの範囲全体を表示したりすることができます。

スクリプトの作成#

Unity Dashboard で最初のスクリプトを作成して、Cloud Code の使用を準備します。

1. LiveOps セクション内で、Cloud Code に移動し、Explore (探す) を選択します。

2. Create a new script (新しいスクリプトの作成) を選択します。

   各スクリプトは、特定の 環境 にリンクされます。

3. 以下の情報を入力します。

   • Name (名前): スクリプトの説明的な名前。Cloud Code バックエンドでスクリプトの識別と実行に使用されます。スクリプト名はプロジェクトと環境全体で一意である必要があり、文字、数字、アンダースコア、ダッシュのみ使用でき、50 文字を超えることはできません。

   • Type (タイプ): スクリプトのタイプ。

     現在、Cloud Code は API 呼び出しを通じたゲームクライアントからのスクリプトのトリガーのみをサポートしています。

4. Next (次へ) を選択します。

5. 次のウィンドウで、選択したスクリプトのタイプに関する情報を入力します。

次の画面は、コードとその詳細のテストと編集を行える スクリプトエディター です。

パラメーターの追加#

1. スクリプトを追加した後、+ Add parameter (+ パラメーターの追加) を選択します。スクリプトがゲームから受け入れるパラメーターを指定します。スクリプトコードからパラメーターに名前付きプロパティとしてアクセスできます。

2. 以下の情報を入力します。

   1. Parameter name (パラメーター名): トリガーされたときにスクリプトで使用可能なパラメーターの名前。パラメーター名は、スクリプトに対して一意である必要があり、文字、数字、アンダースコア、ダッシュのみ使用でき、50 文字以下である必要があります。

   2. Type (型): このフィールドは、Cloud Code が各リクエストに対して実行するデータ型検証を決定します。

   3. 以下の 1 つを選択します。

      • String
      • Numeric
      • Boolean
      • JSON
      • Any (任意)

   4. Required (必須): このフィールドを有効にして、リクエストでパラメーターが渡されたことを確認します。必要なすべてのパラメーターを指定せずに Cloud Code API を通じてスクリプトを実行すると、エラーが発生します。

   Cloud Code は、スクリプトの実行時にこれらのパラメーターを検証します。無効な入力パラメーターにより、Cloud Code API 呼び出しが失敗します。

3. これらのステップを繰り返して、パラメーターを最大 10 個追加します。

4. Add (追加) を選択します。

スクリプトエディター#

ブラウザーベースのスクリプトエディターには、コードのエラーが表示され、JavaScript のオートコンプリート機能を提供します。

Run Code (コードの実行) タブ内に、以下が表示されます。

• Script Code (スクリプトコード) セクションには、スクリプトコードが含まれます。
• Parameters (パラメーター) テーブルには、作成したすべてのパラメーターとその値がリストされ、テストプレイヤー ID を生成する 機能もあります。必須のマークが付いたパラメーターは、任意のパラメーターよりも前に表示されます。
• Response/Logs/Request (レスポンス/ログ/リクエスト) の各タブ には、実行後のスクリプトに関する情報が表示されます。
• Beautify (整形) ボタンでは、コードの形式が自動的に再設定され、読みやすさが最適化されます。

エディターには以下の機能があります。

• シンプルな JavaScript 機能のためのシンプルなコードオートコンプリート。
• 構文エラー、セミコロンの欠落、到達不能なコードなどの一般的な問題の注釈。
• 型エラー、範囲エラー、その他のスローされたエラーなど、テスト実行中に発生したエラーの注釈。

新しい各スクリプトには、すぐに開始できるように例が入力されています。

スクリプトの詳細#

Details (詳細) タブを選択して、以下の情報を表示します。

• Script name (スクリプト名)
• Type (タイプ)
• Last published date (最終公開日)
• Last published version (最終公開バージョン)

前に作成したスクリプトパラメーターのテーブルも表示されます。これらのパラメーターを編集するか、このテーブルから新規に作成することができます。

保存と公開#

Run Code (コードの実行) タブで、Script Code (スクリプトコード) ウィンドウのコードを変更すると、Cloud Code が Save script (スクリプトの保存) ボタンをアクティベートします。Save script (スクリプトの保存) を選択して、これらの変更を作業中のコピーに保存します。コードは保存されますが、まだライブではないため、ゲームが中断する危険性はありません。

エディターに保留中のコード変更がない場合、Cloud Code は Publish version (バージョンの公開) ボタンをアクティベートします。このボタンを選択し、ダイアログでスクリプトの公開を確認した後で、スクリプトがライブになります。ゲームクライアントが Cloud Code API を呼び出すと、スクリプトは Cloud Code バックエンドで実行されます。

スクリプトの作業中のコピーは編集可能なままになり、プレイヤーのゲーム体験に影響はありません。コードの公開されたバージョンは読み取り専用ですが、再度公開できます。この作業中のコピーは、公開されたスクリプトで何か予期しないことが発生し、作業したスクリプトの以前のバージョンにロールバックしたい場合に役立ちます。

古いバージョンを公開する場合、複製コピーを新しいバージョンとして作成します。スクリプトを公開する場合は、ゲームのライブバージョンを更新するため、公開前にスクリプトが意図したとおりに動作することを確認してください。

スクリプトの現在アクティブなバージョンは再公開できません。これは、選択したスクリプトバージョン (作業中のコピーまたは以前のバージョン) がゲームのライブバージョンのスクリプトと同一である場合、Cloud Code は 2 つの間に違いが生じるまで公開機能を無効にすることを意味します。

バージョン番号は、スクリプトを公開するたびに増加しますが、Cloud Code は最新の 10 バージョンのみを保持します。

スクリプトの削除#

Unity Dashboard からスクリプトを削除するには、以下を行います。

1. Scripts list (スクリプトリスト) ページに移動します。

2. bin (ビン) アイコンを選択します。このスクリプトの削除は元に戻せないことを警告するダイアログが表示されます。

   ライブゲームによって使用中の公開されたスクリプトを削除すると、ゲームクライアントでのエラーの原因となります。

3. Delete (削除) を選択して削除を確認します。