ドキュメント

サポート

Cloud Code

Open Unity Dashboard

Cloud Code

Unity Cloud Dashboard

Preview, create, and delete triggers using the graphical interface of the Unity Dashboard.
読み終わるまでの所要時間 4 分最終更新 23日前
Unity Cloud Dashboard は、グラフィカルなインターフェースを通じてトリガーを完全にコントロールできるため、使用の準備が簡単です。このセクションでは、トリガーをプレビュー、作成、削除する方法について説明します。

トリガーのプレビュー

Unity Cloud Dashboard から 環境 のすべてのトリガーのリストにアクセスできます。
  1. Unity Cloud Dashboard で Cloud Code を選択します。
  2. Triggers (トリガー) を選択します。
  3. 環境のリストから環境を選択します。
プロジェクトの選択した環境内のすべてのトリガーのリストが表示されます。この表には、名前、トリガー、タイプ、最終更新のタイムスタンプが含まれます。

トリガーの詳細

トリガーのリストからトリガーを選択すると、トリガーの詳細ページに移動できます。トリガーの詳細ページには以下の情報が表示されます。

Data

説明

名前トリガーの名前。
型トリガーのタイプ: Event (イベント) または Schedule (スケジュール)。
Trigger (トリガー)スクリプトをトリガーするイベント。例えば、
Cloud Save
による 
key_saved
。
Event Type (イベントタイプ)イベントタイプの正式表記 (例: 
com.unity.services.cloud-save.key-saved.v1
)。イベントタイプの詳細については、イベントの構造 を参照してください。
Last updated (最終更新)トリガー設定が最後に更新された RFC3339 タイムスタンプ。
トリガー定義カードには、トリガー設定の概要が表示されます。
  • 発生するとき (イベントタイプ)
  • 場所 (フィルター)
  • これを行う (アクション、 Cloud Code スクリプト、モジュール)
フィルターが chip で表示され、フィルターの属性、演算子、値が示されます。ダッシュボードによって、chip 形式でフィルターを表示できない場合は、オリジナルの CEL 形式でフィルターが表示されます。

ログへの移動

トリガーのログページに移動して、トリガー実行のログを確認するには、View Trigger Logs (トリガーログの表示) ボタンを選択します。ログの詳細については、ログ セクションを参照してください。

アクションへの移動

トリガーが既存のスクリプトまたはモジュールに関連付けられている場合、トリガー定義カードにはスクリプトまたはモジュールへのリンクがあります。スクリプトまたはモジュールの詳細ページに移動するには、そのリンクを選択します。

トリガーの作成

Unity Cloud Dashboard でイベントベースのトリガーを作成できます。
  1. Unity Cloud Dashboard で Products (製品) > Cloud Code を選択します。
  2. Triggers (トリガー) を選択します。
  3. New trigger (新しいトリガー) を選択します。
  4. 以下の情報を入力します。
    • Name (名前): トリガーの名前。設定を識別するために使用されます。トリガー名はプロジェクトおよび環境内で一意にする必要があり、255 文字を超えてはなりません。
    • Type (型): トリガーのタイプ。イベントベースのトリガーとは、UGS で発行されるイベントによってトリガーされるトリガーです。
  5. Next (次へ) を選択します。
  6. 次のステップでは以下の情報を選択します。
    • When this happens (発生するとき) セクションで:
      1. Add Trigger Event (トリガーイベントを追加) ボタンを選択します。
      2. スクリプトをトリガーするイベントを選択します。
      3. Add Filter (フィルターを追加) を選択して、フィルターをイベントに追加します。
    • Do this (これを行う) セクションで:
      1. Add Action (アクションを追加) ドロップダウンを選択します。
      2. トリガーがアクティベートされたときに実行するアクションを選択します。このアクションとして、スクリプトまたはモジュールを選択できます。
  7. Confirm (確認) を選択します。
トリガーを作成すると、トリガーのリストページにリダイレクトされます。トリガー設定を調査するには、表のトリガー名を選択します。

Unity Cloud Dashboard のフィルター

トリガー設定にフィルターを追加して、トリガーがアクティベートする条件を指定できます。Unity Cloud Dashboard では、イベントペイロードのフィルターに使用できる限られたセットのフィルターがサポートされています。 フィルターのしくみについては、フィルター セクションを参照してください。各 UGS イベントのイベントペイロードを調査するには、サポートされている UGS イベント を参照してください。

サポートされている演算子

Unity Cloud Dashboard には、属性型に応じてさまざまな演算子が表示されます。

演算子

サポートする型

equals toすべての属性型
not equals toすべての属性型
より大きいint、double、JSON 型
greater than or equals toint、double、JSON 型
より小さいint、double、JSON 型
less than or equals toint、double、JSON 型
matchesstring および JSON 型
not matchesstring および JSON 型
containsstring および JSON 型
starts withstring および JSON 型
ends withstring および JSON 型

フィルターの結合

1 つのトリガーに最大 10 個のフィルターを定義できます。論理演算子 
AND
と 
OR
によってフィルターを結合できます。これらの演算子を使用して、複数のフィルターを結合して複雑な条件を作成できます。

Cloud Save key-saved イベントに対するフィルターの定義

特定のキーが Cloud Save に保存されたときだけアクティベートするトリガーを定義できます。例えば、キー 
playerData
が保存されたときだけトリガーをアクティベートするようにフィルターを定義できます。 Unity Cloud Dashboard で、このフィルターをトリガー設定に追加できます。
  1. When this happens (発生するとき) セクションで Add Event (イベントを追加) ボタンを選択します。
  2. イベントのドロップダウンを選択し、Cloud Save key-saved イベントを選択します。
  3. Add filter (フィルターを追加) ボタンを選択します。
  4. 新しい Filter (フィルター) カードで:
    1. 最初のドロップダウンで 
      key
      属性を選択します。
    2. 2 番目のドロップダウンで 
      equals to
      演算子を選択します。
    3. 3 番目のドロップダウンに値 
      playerData
      を入力します。
このフィルターを定義する場合は、キー 
playerData
が Cloud Save に保存されるときだけトリガーがアクティベートすることを確認します。

Leaderboard score-submitted イベントに対するフィルターの定義

特定のスコアがリーダーボードに送信されたときだけアクティベートするトリガーを定義できます。例えば、特定の範囲のスコアについてのみトリガーをアクティベートするようにフィルターを定義できます。 Unity Cloud Dashboard で、このフィルターをトリガー設定に追加できます。
  1. When this happens (発生するとき) セクションで Add Event (イベントを追加) ボタンを選択します。
  2. イベントのドロップダウンを選択し、Leaderboards score-submitted イベントを選択します。
  3. Add filter (フィルターを追加) ボタンを選択します。
  4. 新しい Filter (フィルター) カードで:
    1. 最初のドロップダウンで 
      score
      属性を選択します。
    2. 2 番目のドロップダウンで 
      greater than
      演算子を選択します。
    3. 3 番目のドロップダウンに値 
      0
      を入力します。
  5. Add filter (フィルターを追加) ボタンを選択します。
  6. 新しい Filter (フィルター) カードで:
    1. 最初のドロップダウンで 
      score
      属性を選択します。
    2. 2 番目のドロップダウンで 
      less than
      演算子を選択します。
    3. 3 番目のドロップダウンに値 
      100
      を入力します。
このフィルターを定義すると、0 から 100 までのスコアがリーダーボードに送信されたときだけ確実にトリガーがアクティベートします。

トリガーの削除

Unity Cloud Dashboard からトリガーを削除するには、以下を行います。
  1. Triggers list (トリガーリスト) ページに移動します。
  2. bin (ビン) アイコンを選択します。削除したトリガーは元に戻せないことを警告するダイアログが表示されます。
  3. Delete (削除) を選択して削除を確定します。
または、トリガーの詳細 ページに移動し、Delete (削除) ボタンを選択してトリガーを削除することもできます。