通知濾盒 Filter Box 進階過濾規則指南

通知濾盒從 1.0.0 版開始新增進階過濾，可以根據通知的任意屬性來進行自訂判斷過濾。可以實現如「清除音樂 App 除播放控制外的所有通知」這樣較複雜的功能。

進階過濾功能使用 JSON 語法。使用前請確保您知道如何撰寫 JSON，了解規則運算式。

範例

以下是實現音樂 App 保留播放控制列並去除廣告的設定範例：

{
  "match": "NONE",
  "node": [
    {
      "field": "android.template",
      "regex": "MediaStyle"
    },
    {
      "field": "filterbox.field.HAS_BIG_CONTENT_VIEW",
      "regex": "true"
    }
    ]
}

在通知濾盒中新增一條規則，勾選你常用的音樂 App，選擇「進階比對模式」，複製並貼上上述 JSON 即可使用。

語法

逐行解釋：

  "match": "NONE",

比對模式，目前支援 ALL、ANY、NONE 三種選項，均為大寫。

分別表示一則通知如果 符合所有節點 / 符合任意一個節點 / 不符合任何節點 就會被過濾。

  "node": [],

比對節點陣列，數量不限。

    {
      "field": "android.template",
      "regex": "MediaStyle"
    },

節點：每一個節點都需要 field 和 regex 兩個欄位。

regex 為規則運算式，滿足該規則運算式即被比對。

有哪些 field 欄位可用呢？請直接在通知濾盒時間軸內點開最近的 20 則通知（為節省記憶體，舊通知可能會被清除），選擇「偵錯資訊」即可看到所有可用的欄位。

上述欄位中，filterbox.field.XXX 是由通知濾盒實作填入的；其餘所有欄位都是讀取 Notification#extras 得到的。

為了便於處理，所有內容都被轉換為字串。

TIPS

• 為什麼上述規則用了兩個節點呢？

大部分 App 開發者遵守 Android 開發規範，會使用 Android 原生的音樂通知實作，也就是 MediaStyle。

少部分 App 開發者繞開 Android 系統自行繪製介面，因此對它們使用 filterbox.field.HAS_BIG_CONTENT_VIEW （是否有自訂展開檢視）進行鑑別。

所以需要兩個節點都不滿足的通知，才會被過濾。

• 手寫 JSON 很容易出錯？

是的，推薦使用各種編輯器來避免漏逗號之類的語法錯誤。或許你可以試試這個線上的： http://jsoneditoronline.org/