跳轉到主要內容

動作與規則快速入門

PlayStream 規則可讓您即時回應某一種類型 PlayStream 事件的子集。

需求

相關術語的快速詞彙表:
  • PlayStream:構成 PlayFab 事件管線的功能群組。
    • PlayStream 事件是描述有關玩家或遊戲之事件的 JSON 格式字串。
    • PlayStream 事件的大小上限取決於您的自動化功能層級。
  • 規則:即時回應某一種類型的 PlayStream 事件,執行額外的邏輯。
    • 由以下項目組成:一個事件觸發程序、選擇性的條件清單,以及選擇性的動作清單。
  • 觸發程序:啟動此規則的事件名稱。
  • 條件:規則和其他 PlayStream 功能的內容篩選條件。
    • 對 PlayStream 事件 JSON 物件執行非常輕量的評估,並略過不符合需求的事件。
  • 動作:要在適當實體上執行的情境式工作。
規則只包含一個觸發程序、選擇性的條件清單,且通常至少有一個動作 (非必要,但沒有動作的話就相當無用)。 觸發程序、條件和動作也是其他系統的一部分:大量動作和錦標賽排行榜 (已淘汰)。

範例案例:計算來自用戶端的自訂事件

在以下範例中,我們從用戶端張貼以下自訂事件。
在此案例中,用戶端會手動回報自訂的 ForumPostEvent (目前不對應 PlayFab 或支援的合作夥伴中的任何自動事件) 我們將使用 PlayStream 規則來計算玩家以此方式回報論壇文章的次數。 需求:您的遊戲必須已經在張貼此類型的事件,Game Manager GUI 才會允許您建立以其觸發的規則。 前往您的 Game Manager:
  • 瀏覽至您的 Title。
  • 選取 Automation。
  • 前往 Rules。
  • 選取 New Rule。
Game Manager - automation - new rule 讓我們逐一評估此範例中的 New Rule:
  • title.6195.ForumPostEvent
    • 6195 是本教學課程中使用的遊戲。您的 titleId 將會與您自己的遊戲相符。
    • ForumPostEvent 是此範例案例程式碼中使用的事件名稱。
    • 只有當您最近在遊戲中張貼過至少一個 ForumPostEvent 時,才會出現此行。
  • 此範例中特別使用的 Conditions 用途很有限。
    • 不過,它確實示範了當 Body 字典中的 Body 索引鍵對應至 Invalid string 時,如何篩選我們的自訂事件。
    • 篩選條件是選擇性的,應從您的規則中移除不相關的玩家。
  • 此案例中所選的 Actions 會將統計資料計數器遞增一。
    • 需求:必須在 Game Manager 的 Leaderboards 下定義 Forum Posts 統計資料。
在 Game Manager PlayStream Debugger (如下所示) 中,您可以觀察觸發程序生效的情形。 Game Manager - PlayStream - debugger - event trigger 如您所見,自訂的 ForumPostEvent 會自動觸發我們在新規則的 Actions 下設定的統計資料。

進階:CloudScript 動作

PlayFab 中許多內建動作都相當簡單,可能無法提供您所需的完整功能。因此,我們允許您使用 CloudScript 完全自訂動作邏輯。 讓我們編輯 Rule。
  • 移除 Condition。
  • 將 Action 設定為 Execute CloudScript。
  • 選取 Save Action 按鈕。
Game Manager - automation - edit rule 現在,如果我們張貼新的 ForumPostEvent,就會看到 CloudScript 執行。 Game Manager - PlayStream - debugger - CloudScript execution 撰寫 CloudScript 以回應 PlayStream 規則是一個進階主題,我們的教學課程中有相關說明:搭配 PlayStream 使用 CloudScript 動作。
最後修改於 2026年10月6日