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 モジュール実行します。

次のステップ

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

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