Skip to main content

アクションとルールのクイックスタート

PlayStream ルールを使用すると、1 つのタイプの PlayStream イベントのサブセットにリアルタイムで反応できます。

必要条件

関連用語の簡単な用語集:
  • PlayStream: PlayFab イベント パイプラインを構成する機能のグループ。
    • PlayStream イベント は、プレイヤーまたはタイトルに関するイベントを記述する JSON 形式の文字列です。
    • PlayStream イベント には、Automation 機能ティアに基づいた最大サイズがあります。
  • Rule: リアルタイムで 1 つのタイプの PlayStream イベントに応答して追加のロジックを実行します。
    • 合計: 1 つの Event TriggerConditions のオプション リスト、および Actions のオプション リスト。
  • Trigger: このルールをアクティブ化するイベントの名前。
  • Condition: ルールおよびその他の PlayStream 機能のコンテンツ フィルター。
    • PlayStream イベント JSON オブジェクトの非常に軽量な評価を実行し、要件に一致しないイベントをスキップします。
  • Action: 適切なエンティティに対して実行される文脈的な作業。
ルールは、正確に 1 つの Trigger、Conditions のオプション リスト、および通常は少なくとも 1 つの Action で構成されます (必須ではありませんが、それがないとほぼ役に立ちません)。 Triggers、Conditions、および Actions は、他のシステムの一部でもあります: 一括アクショントーナメント リーダーボード (非推奨)

例のケース: クライアントからのカスタム イベントをカウントする

以下に示す例では、クライアントから次のカスタム イベントを投稿します。
この場合、クライアントはカスタムの ForumPostEvent を手動で報告しています (これは現在、PlayFab またはサポートされているパートナーの自動イベントには対応していません)。 プレイヤーがこの方法でフォーラム投稿を報告した回数をカウントするために、PlayStream ルールを使用します。 要件: Game Manager の GUI でこれをトリガーするルールを作成できるようにするには、ゲームが 既に このタイプのイベントを投稿している必要があります。 Game Manager に移動します:
  • タイトル に移動します。
  • Automation を選択します。
  • Rules に移動します。
  • New Rule を選択します。
この例の New Rule を 1 つずつ評価してみましょう:
  • title.6195.ForumPostEvent
    • 6195 はこのチュートリアルで使用されているタイトルです。あなたの titleId は自分のタイトルと一致します。
    • ForumPostEvent は、このサンプル ケースのコードで使用されているイベント名です。
    • この行は、タイトルで少なくとも 1 つの ForumPostEvent を最近投稿した場合にのみ使用可能になります。
  • この例で具体的に使用されている Conditions は、最小限の用途しかありません。
    • ただし、Body ディクショナリの Body キーが Invalid string にマップされている場合にカスタム イベントをフィルタリングする様子を実証しています。
    • フィルターはオプションであり、無関係なプレイヤーをルールから削除する必要があります。
  • この場合に選択された Actions は、統計カウンターを 1 増やします。
    • 要件: Game Manager の Leaderboards の下で Forum Posts 統計を定義する必要があります。
Game Manager の PlayStream Debugger (以下に示す) で、トリガーが効果を発揮するのを観察できます。 ご覧のように、カスタム ForumPostEvent は、新しいルールの Actions で設定した統計を自動的にトリガーします。

高度な: CloudScript アクション

PlayFab の組み込みアクションの多くはかなりシンプルで、必要な完全な力を提供できない場合があります。だからこそ、CloudScript でアクション ロジックを完全にカスタマイズできるようにしています。 ルール を編集しましょう。
  • Condition を削除します。
  • ActionExecute CloudScript に設定します。
  • Save Action ボタンを選択します。
これで、新しい ForumPostEvent を投稿すると、CloudScript の実行が表示されます。 PlayStream ルールに反応するように CloudScript を作成することは、PlayStream で CloudScript アクションを使用する チュートリアルで扱う高度なトピックです。
最終更新日 2026年8月13日