提及

此功能允许您在频道消息中提及特定用户并向他们发送通知。

“提及”功能的操作如下：

没有独立的 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
}