90 lines
4.3 KiB
C
90 lines
4.3 KiB
C
/*
|
||
* chat_member.h — единая структура мембера для отображения в GUI
|
||
*
|
||
* Используется chatgui (desktop), headless CLI, Android.
|
||
* Live-снимки для всех потребителей формирует chat_core_get_member_list() в uasync-потоке.
|
||
* Android дополняет ими свой JSON-список с расширенными свойствами участников.
|
||
*
|
||
* Формат на проводе (ручная сериализация, фиксированный размер 158 байт):
|
||
* [0-7] node_id uint64_t LE
|
||
* [8] online uint8_t
|
||
* [9] is_self uint8_t
|
||
* [10] flags uint8_t 0x01=supernode 0x02=admin 0x04=moder 0x08=deleted 0x10=radio 0x20=local radio mute
|
||
* [11-12] rtt uint16_t LE (ms, 0xFFFF=нет данных)
|
||
* [13] nat_type uint8_t ADDR_TYPE_*
|
||
* [14] storage uint8_t
|
||
* [15-78] name char[64] local_nick если задан, иначе node name. \0-padded
|
||
* [79-86] avatar_server uint64_t LE; 0 = нет аватарки
|
||
* [87-156] avatar_file char[70], sha256.json с NUL
|
||
* [157] storage_role uint8_t, подписанная роль, независимо от сетевого приоритета storage
|
||
*/
|
||
|
||
#ifndef CHAT_MEMBER_H
|
||
#define CHAT_MEMBER_H
|
||
|
||
#include <stdint.h>
|
||
#include <stddef.h>
|
||
|
||
#ifdef __cplusplus
|
||
extern "C" {
|
||
#endif
|
||
|
||
#define CHAT_MEMBER_FLAG_SUPERNODE 0x01
|
||
#define CHAT_MEMBER_FLAG_ADMIN 0x02
|
||
#define CHAT_MEMBER_FLAG_MODER 0x04
|
||
#define CHAT_MEMBER_FLAG_DELETED 0x08
|
||
#define CHAT_MEMBER_FLAG_RADIO 0x10
|
||
#define CHAT_MEMBER_FLAG_RADIO_MUTED 0x20 /* локальное отключение голоса участника */
|
||
|
||
#define CHAT_MEMBER_DISPLAY_SIZE 158
|
||
|
||
/* Получить всех мемберов канала. out = u_malloc-массив, count = количество. */
|
||
int chat_core_get_member_list(struct UTUN_INSTANCE* inst, const char* ch_id, uint8_t** out, int* count);
|
||
|
||
/* Получить одного мембера по node_id. out = буфер размером CHAT_MEMBER_DISPLAY_SIZE. */
|
||
int chat_core_get_single_member(struct UTUN_INSTANCE* inst, const char* ch_id, uint64_t node_id, uint8_t* out);
|
||
|
||
/* Live-онлайн: узел присутствует в BGP/topo_group канала (self всегда онлайн).
|
||
Не читает nodes.online — статус не хранится в БД. */
|
||
int chat_core_member_online(struct UTUN_INSTANCE* inst, const char* ch_id, uint64_t node_id);
|
||
|
||
/* Сериализовать из внутренней структуры в wire-формат */
|
||
struct chat_member_display {
|
||
uint64_t node_id;
|
||
uint8_t online;
|
||
uint8_t is_self;
|
||
uint8_t flags;
|
||
uint16_t rtt;
|
||
uint8_t nat_type;
|
||
uint8_t storage;
|
||
char name[64];
|
||
uint64_t avatar_server;
|
||
char avatar_file[70];
|
||
uint8_t storage_role;
|
||
};
|
||
|
||
void chat_core_serialize_member(const struct chat_member_display* src, uint8_t* dst);
|
||
int chat_core_deserialize_member(const uint8_t* src, struct chat_member_display* dst);
|
||
|
||
/* Трамплин для gui_bridge: GUI запрашивает полный список мемберов канала.
|
||
* arg = struct chat_member_list_req*. Результат: CHAT_EVT_MEMBER_LIST. */
|
||
struct chat_member_list_req { struct UTUN_INSTANCE* inst; char ch_id[64]; };
|
||
void chat_core_request_member_list_trampoline(void* arg);
|
||
|
||
/* Трамплин для gui_bridge: GUI запрашивает RTT мемберов канала.
|
||
* arg = struct chat_member_list_req*. Результат: CHAT_EVT_MEMBER_UPDATED с RTT-обновлениями. */
|
||
void chat_core_request_member_rtt_trampoline(void* arg);
|
||
|
||
/* Локальный переключатель рации; каждый запрос меняет актуальное состояние в uasync. */
|
||
int chat_core_toggle_member_radio_mute(struct UTUN_INSTANCE* inst, const char* ch_id, uint64_t node_id);
|
||
struct chat_member_radio_mute_req { struct UTUN_INSTANCE* inst; char ch_id[64]; uint64_t node_id; };
|
||
void chat_core_toggle_member_radio_mute_trampoline(void* arg);
|
||
|
||
/* Инициализация: регистрирует node_props_changed callback для рассылки MEMBER_UPDATED. */
|
||
void chat_member_init(struct UTUN_INSTANCE* inst);
|
||
|
||
#ifdef __cplusplus
|
||
}
|
||
#endif
|
||
#endif /* CHAT_MEMBER_H */
|