Network

本文档介绍如何使用实时数据传输服务。 请仔细阅读本文档，以了解如何使用我们的网络。

第一个连接:

首先，您需要确定服务器的IP地址和端口。 由于可能有多个服务器，并且某些服务器可能被我们断开连接，因此请使用API v2getListSpotServers方法。 此方法将返回要连接的IP地址和服务器端口列表。

您可以使用第三方软件的TCP记录器或在终端中运行命令进行连接。:

telnt {ip} {port}

连接后，您将开始接收json格式的消息，然后我们将这些消息作为事件进行讨论。 下面是spot事件的示例，哪些事件存在以及如何处理它们，请继续阅读。

活动:

目前，只有3事件，这些是：spot, message, sun。 从getListSpotServers方法在服务器上广播的所有事件都是相同的。 这样做是为了确保向系统的所有用户传递消息、点和任何其他数据。 无论用户连接到哪个特定服务器，他们都将收到一组完整且相同的事件。 这保证了数据的一致性和分布式环境中所有客户端的同步性。

{
    "event": "name_event", // 枚举可以有值: spot, message, sun
    "data": {...}, // 鉴于事件，请阅读事件的描述。
    "event_at": "Y-m-d H:i:s" // 事件的日期和时间: 2025-08-29 19:15:53
}

事件：{事件}

此事件通知您有关在聊天中发送消息的信息。 对sendMessage方法的API请求用于此目的。 有关如何处理发送消息的更多信息，请参阅API v2文档。

您可以使用getChats方法获取聊天列表。

{
    "chat_id": 1,
    "sender": "R4CAT/P",
    "text_color": "#1E3A5F",
    "background_color": "#E6F0FA",
    "text": "嗨！ 我现在在外地，派人喝茶，这里很冷。"
}

结果:

事件：{事件}

它发送太阳活动的最新指数。 跟踪它非常有用，这样您就不会访问服务的API。

{
    "value": 4 // 小地磁暴。
}

1. 1 — 没有明显的干扰。
2. 2 — 小干扰。
3. 3 — 弱的地磁暴。
4. 4 — 小地磁暴。
5. 5 — 中度地磁暴。
6. 6 — 强地磁暴。
7. 7 — 严重的地磁暴。
8. 8 — 一场极端的风暴。