提及

此功能允許您在頻道消息中提及特定用戶並向他們發送通知。

「提及」功能的運作如下：

沒有獨立的 API 專門用於提及功能；相反，提及信息包含在現有 API 的響應數據中。
被提及的用戶會收到單獨的推送通知（遠程推送，需 SDK）。

API 回應包含提及資訊¶

本節解釋了在channel message history API的回應中包含的提及信息。

回應主體 > 數據 > 內容 > 插件數據¶

如果频道消息包含提及信息，则 mentions 字段包含在频道消息历史 API 响应体的 data > content > pluginData 中。

欄位	描述	類型
mentions	提及資訊	物件陣列

回應主體 > 數據 > 內容 > 插件數據 > 提及¶

欄位	描述	類型
playerId	提到的用戶的玩家ID	long

回應範例¶

{
  // ...omitted
        "content": [
            {
                "gameIndex": 1374,
                "from": 1,
                "messageId": "ggJ5Csh15J-mI3i5",
                "extraData": "",
                "pluginData": {
                    "mentions": [
                        {
                            "playerId": 101
                        }
                    ]
                },
                "to": "public:10",
                "message": "aaa",
                "langCode": "ko",
                "timestamp": "2025-07-17T00:56:17.156Z",
                "timestampMillis": 1752713777156
            }
        ]
  // ...omitted
}