Network

このドキュメントでは、リアルタイムデータ転送サービスの操作方法について説明します。 私たちのネットワークを使用する方法を理解するために、このドキュメントを慎重にお読みください。

最初の接続:

まず、サーバーのIPアドレスとポートを決定する必要があります。 複数のサーバーが存在し、一部のサーバーが切断されて接続されている可能性があるため、API v2getListSpotServersメソッドを使用してください。 このメソッドは、接続先のIPアドレスとサーバーポートのリストを返します。

サードパーティ製ソフトウェアのTCPロガーを使用して接続するか、ターミナルでコマンドを実行して接続できます。:

telnt {ip} {port}

接続後、json形式でメッセージの受信を開始し、これらのメッセージについてイベントとして話します。 以下は、スポットイベントの例であり、どのイベントが存在し、それらをどのように処理するかを読んでいます。

イベント:

現時点では、3イベントのみがあり、これらはspot, message, sunです。 GetListSpotServersメソッドからサーバーにブロードキャストされるすべてのイベントは同じです。 これは、システムのすべてのユーザーにメッセージ、スポット、その他のデータを確実に配信するために行われます。 ユーザーがどの特定のサーバーに接続されているかに関係なく、ユーザーは完全で同一のイベントセットを受け取ります。 これにより、分散環境でのデータの均一性とすべてのクライアントの同期性が保証されます。

{
    "event": "name_event", // 列挙型は値を持つことができます: spot, message, sun
    "data": {...}, // イベントを指定して、イベントの説明を読んでください。
    "event_at": "Y-m-d H:i:s" // イベントの日付と時刻: 2025-08-29 19:19:46
}

イベント:{イベント}

このイベントは、チャットでメッセージを送信することについて通知します。 この目的のために、sendMessageメソッドへのAPI要求が使用されます。 メッセージの送信の操作の詳細については、API v2のドキュメントを参照してください。

{Link}メソッドを使用してチャットのリストを取得できます。

{
    "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 — 極端な嵐。