固定消息

固定消息

在聊天中,固定消息(Pinned Message)是将重要消息固定在聊天房间或群组对话的顶部的功能。这使得参与者每次打开该聊天时都能轻松看到,从而避免错过重要的信息或通知。以下是固定消息的主要特点和使用方法说明。

固定消息的使用方法

  • 会议日程公告:将定期会议或重要事件的日程设置为固定消息,以确保参与者不会忘记日程。

  • 重要文档链接:将重要文档或资料的链接固定,确保所有参与者可以轻松访问。

  • 规则与指南共享:将聊天房间的规则或项目指南设置为固定消息,以便新参与者也能轻松查看指南。

  • 紧急公告:迅速通过固定消息分享需要紧急传达的内容或变更。

固定消息功能在各种通讯平台上提供,若能有效利用,将显著提高团队沟通的效率。

固定消息创建

在聊天应用程序中,固定消息功能允许将重要消息固定在聊天窗口的顶部,以便用户可以轻松查看。以下是使用 C# 代码在聊天频道中固定消息的方法示例:

var newPin = await nc.createPin(channelId, messageId, pinned, pinnedAt, expiredAt);
  • channelId: 消息将被固定的聊天频道的唯一标识符。

  • pinned: 要固定的消息内容。

  • pinnedAt: 消息被固定的时间。

  • expiredAt: 消息固定将被解除的时间。

使用此功能可以轻松突出显示在特定聊天频道中的重要消息。

修改固定消息

这是一个用于更新已有固定消息信息的功能。您可以更改消息内容、固定时间或过期时间。

var updatedPin = await nc.updatePin(id, channelId, pinned, pinnedAt, expiredAt);
  • channelId: 要修改消息的频道ID。

  • pinned: 修改后的消息内容。

  • pinnedAt: 消息被重新固定的时间。

  • expiredAt: 消息固定的新过期时间。

此代码用于更改已固定消息的详细信息,当消息的重要性发生变化或需要调整固定时间时非常有用。

固定消息信息

这是一个用于查询特定消息固定相关信息的功能。您可以查看消息的固定状态、固定时间、过期时间等。

var pin = await nc.getPin(channelId, messageId);
  • channelId: 要查询信息的频道ID。

  • messageId: 固定消息的唯一标识符

通过此功能,您可以确认特定消息的当前状态,这有助于管理员或用户更有效地管理频道中的消息。

固定消息列表

这是一个用于查询聊天频道中当前所有固定消息列表的功能。此功能支持分页,以便在大规模频道中也能高效处理数据。用户可以通过设置 offset 和 per_page 来获取所需范围的数据。

Hashtable filter = new Hashtable
{
    { "channel_id", channelId },
};
Hashtable sort = new Hashtable
{
    { "created_at", -1 },
};
Hashtable option = new Hashtable
{
    { "offset", 0 },
    { "per_page", 10 },
};
var pins = await nc.getPins(channelId, filter, sort, option);

参数说明

  • filter: 定义用于筛选查询数据的条件。例如,可以在特定频道中查询固定的消息。

  • sort: 定义结果列表的排序方式。在这里,使用了按创建时间(created_at)降序(-1)排序。

  • option: 定义查询时使用的选项。offset 是查询的起始位置,per_page 是每页显示的消息数量。

选项详细信息

使用此功能,频道管理员可以轻松监控和管理频道中的重要消息。此外,还可以根据特定用户或时间快速搜索和排序固定消息,从而帮助频道实现高效运作。

Last updated