Triggers

Triggers では、設定した瞬間に、または Unity Gaming Services (UGS) から別のサーバーイベントの結果として、サーバーサイドアクションを自動化できます。

これらにより、Cloud Code スクリプトとモジュールは自動的に実行されます。クライアントがサーバーにリクエストを行う必要はありません。

イベント

イベントは、サーバーで発生した状態の変更を定義します。イベントは、Authentication サービスなどの内部 Unity Gaming Services によって、または Scheduler サービスによって発行できます。

例えば、プレイヤーがサインインするたびに、Authentication サービスはイベントを発行します。

詳細については、イベント および サポートされる UGS イベント を参照してください。

Scheduler

Scheduler サービスを使用して、設定した時刻または反復的な瞬間にイベントを発行します。

例えば、スケジューラーにより、以下を行うことができます。

  • 1 月 1 日の 00:00:00 UTC に新年の挨拶をするお知らせをすべてのユーザーに送信します。
  • 毎月 1 日の 00:00:00 UTC にゲームのテーマを変更します。
  • 毎月の終わりに上位のプレイヤーに報酬を付与します。

Triggers

Triggers サービスは、Unity Gaming Services および Scheduler サービスによって発行された内部イベントのストリームを監視します。Triggers により、ユーザーは、UGS が特定のイベントを発行したときに選択したアクション (例えば、Cloud Code スクリプトの実行) を自動的に実行するルールを定義できます。

トリガーにより、以下のようなユースケースを有効にできます。

ユースケースイベント発行元トリガー元アクション
新しいプレイヤーがサインアップするたびに、Cloud Save 内のプレイヤーデータを初期化する認証サインアップイベントCloud Code モジュールまたはスクリプトを実行します。
新年の挨拶をするプッシュメッセージをすべてのユーザーに送信するSchedulerスケジュールされたイベントCloud Code モジュール実行します。
シーズンの終わりにゲーム内通貨で上位プレイヤーに報酬を与えるLeaderboardsリセットイベントCloud Code モジュールまたはスクリプトを実行します。
スコアが破られたプレイヤーにプッシュメッセージを送信するLeaderboardsスコア送信イベントCloud Code モジュール実行します。
参加ロビー内のすべてのプレイヤーにレベルアップをアナウンスするCloud Saveキー保存イベントCloud Code モジュール実行します。
プレイヤーアクションを審査するModeration (モデレーション)Moderation イベントCloud Code モデレーションスクリプトを実行します。

フィルター

フィルターは、トリガーがいつ起動するかを定義するために、トリガーに追加できる任意の条件です。例えば、プレイヤーが 100 以上のスコアを送信する Leaderboard イベントに対してのみトリガーを起動するフィルターを定義できます。

詳細については、フィルター を参照してください。

ノート: 現在、CLI を使用して、フィルターを使用するトリガーを作成することはできません。Triggers API または Unity Cloud Dashboard を使用してください。

次のステップ

以下のガイドを参照して、Triggers の詳細を確認します。

ガイド説明
イベントイベントのしくみ、それらが発行される方法およびそれらの構造について説明します。
トリガーの構造トリガーの構造、およびそれをイベントに関連付ける方法を説明します。
サポートされている UGS イベントUGS によって発行できるさまざまなタイプのイベントについて説明します。
CLI または API を使用したイベントのスケジュール。スケジュールされたイベントの作成方法を説明します。
CLIAPI または Unity Cloud Dashboard を使用したトリガーの定義。イベントの発行時に Cloud Code スクリプトまたはモジュールを実行するトリガーを定義する方法を説明します。
アクセス制御トリガーのアクセス制御モデルについて説明します。