293 lines
23 KiB
C
293 lines
23 KiB
C
/*
|
||
* C API Android bridge; JNI-точки входа Kotlin находятся в .c под __ANDROID__ и не все входят в этот заголовок.
|
||
* NDK собирает bridge с общим ядром в libutun.so. Команды обычно ставятся в uasync, готовность/результат приходят событиями.
|
||
* Синхронные getters читают SQLite/живые структуры в вызывающем потоке; set_member_nick также пишет SQLite напрямую.
|
||
* Внешний владелец сериализует такие вызовы и команды по сырым handles с stop/restart; getter не удерживает instance.
|
||
* Все char* JSON-результаты принадлежат caller (u_free); при ошибке возможны []/{}, при OOM также NULL.
|
||
* channel_id — десятичная NUL-строка; conv_id — ID DM без dm:. Префикс dm: нужен только voice/video target.
|
||
* reply_to в send/voice/photo/video для канала — обязательный указатель на 32 байта (нули = без ответа).
|
||
* request_id коррелирует канальную публикацию с CHAT_EVT_MSG_SUBMITTED; постановка в очередь не означает доставку.
|
||
* Аргументы строк/PCM заимствованы на вызов, асинхронные команды копируют их; сроки жизни файлов описаны ниже.
|
||
*/
|
||
#ifndef ANDROID_JNI_BRIDGE_H
|
||
#define ANDROID_JNI_BRIDGE_H
|
||
|
||
#include <stdint.h>
|
||
#include <stddef.h>
|
||
#include <stdbool.h>
|
||
|
||
#ifdef __cplusplus
|
||
extern "C" {
|
||
#endif
|
||
|
||
/* ── Callback types (C → Kotlin) ── */
|
||
|
||
/* Native-поток; строки заимствованы на вызов. level: TRACE=0, DEBUG=1, INFO=2, WARN=3, ERROR=4. */
|
||
typedef void (*utun_log_fn)(int level, const char* category, const char* message);
|
||
|
||
/* Отдельный C JSON-callback, вызываемый utun_bridge_event; это не бинарный CHAT_EVT_* callback JNI.
|
||
* Рабочие события instance_lite передаются instance_lite_event_fn / Kotlin onEvent(type, ByteArray?). */
|
||
typedef void (*utun_event_fn)(int event_type, const char* json_data);
|
||
|
||
/* Дополнительный callback-конфиг обёртки; основной конфиг ядра передаётся INI в start. */
|
||
typedef const char* (*utun_config_string_fn)(const char* key);
|
||
typedef int64_t (*utun_config_int64_fn)(const char* key);
|
||
typedef int (*utun_config_int_fn)(const char* key);
|
||
|
||
struct utun_bridge_config {
|
||
utun_config_string_fn get_string; /* NUL-строка, NULL → default; результат не копируется wrapper. */
|
||
utun_config_int64_fn get_int64; /* NULL → default, установленный callback сам определяет отсутствие ключа. */
|
||
utun_config_int_fn get_int; /* То же для int. Функции и их окружение живут до destroy. */
|
||
};
|
||
|
||
/* Сохранить callbacks, установить debug hook, инициализировать voice_recorder(db_path).
|
||
* Таблицы callbacks копируются, config=NULL отключает прежний config-provider; функции/окружение остаются у caller.
|
||
* control_port только логируется: listener и ядро здесь не запускаются. Текущая реализация возвращает true
|
||
* независимо от результата voice_recorder_init; start нужен отдельно. */
|
||
|
||
bool utun_bridge_init(const char* db_path, int control_port,
|
||
utun_log_fn on_log,
|
||
utun_event_fn on_event,
|
||
const struct utun_bridge_config* config);
|
||
|
||
/* INI копируется в instance_lite: 0 — поток создан/уже существует, -1 — отказ.
|
||
* Готовность сервисов — CHAT_EVT_SERVICE_STARTED, а не возврат start. */
|
||
int utun_bridge_start(const char* config_text);
|
||
|
||
/* После полного stop, без параллельного start: удалить chats.db и его -wal/-shm из db_path.
|
||
* db_path — непустой каталог. 0 — все файлы удалены/уже отсутствуют; -1 — неверный путь, память либо ошибка IO.
|
||
* При частичном отказе проверяет остальные файлы; каждую ошибку и итоговые счётчики пишет в лог. */
|
||
int utun_bridge_clear_database(const char* db_path);
|
||
|
||
/* Полностью остановить/join worker, освободить recorder и снять C log/config callbacks.
|
||
* Config-provider сбрасывается к defaults; повторный init начинает новую регистрацию.
|
||
* Перед вызовом остановить внешние media workers/DSP, ждать вне UI; контракт ожидания — instance_lite.h.
|
||
* 0 — очистка завершена; -1 — stop/join отклонён, recorder и callbacks сохранены, новый init запрещён.
|
||
* JNI nativeStop дополнительно останавливает UDP-лог, nativeDestroy освобождает JNI global refs. */
|
||
int utun_bridge_destroy(void);
|
||
|
||
/* ── Actions (Kotlin → C) ── */
|
||
|
||
/* text — NUL-строка UTF-8; 0 — запрос поставлен в uasync, -1 — отказ подготовки. */
|
||
int utun_bridge_send_message(const char* channel_id, const char* text, const uint8_t reply_to[32], uint64_t request_id);
|
||
/* Создать канал по name; переданный channel_id игнорируется, ID генерирует ядро. Результат — CHAT_EVT_CHANNEL_UPDATED. */
|
||
void utun_bridge_create_channel(const char* name, const char* channel_id);
|
||
/* Заглушка: только пишет address/port/pubkey_hex в лог, соединение не создаёт. */
|
||
void utun_bridge_connect_node(const char* address, int port, const char* pubkey_hex);
|
||
|
||
/* Поставить запрос автоподключения канала; выбор пиров выполняет общий topo_group_connect. */
|
||
void utun_bridge_connect_channel(const char* channel_id);
|
||
|
||
/* Однократная попытка подключения к конкретному узлу канала (ручной "Connect"). */
|
||
void utun_bridge_connect_member_node(const char* channel_id, uint64_t node_id);
|
||
|
||
/* Синхронные JSON-снимки; память освобождать u_free. */
|
||
|
||
char* utun_bridge_get_channels_json(void);
|
||
/* limit<=0 → 50; anchor=NULL — последние сообщения, иначе окно вокруг 32-байтового message_id.
|
||
* exact!=0 с anchor выбирает только этот ID; порядок результата timestamp/message_id по возрастанию.
|
||
* Зашифрованный файл доступен UI только после decrypt с валидными метаданными. */
|
||
char* utun_bridge_get_messages_json(const char* channel_id, int limit, const uint8_t* anchor, int exact);
|
||
/* Текущий node_id либо 0, если чат не инициализирован. */
|
||
uint64_t utun_bridge_get_my_node_id(void);
|
||
|
||
/* Передать INI в instance_lite_restart, затем до 5с опрашивать is_running.
|
||
* У живого ядра старое is_running может сразу дать 1: возврат не гарантирует завершение рестарта.
|
||
* Событие CHAT_EVT_SERVICE_STARTED подтверждает запуск нового ядра; перед вызовом остановить media workers/DSP. */
|
||
|
||
void utun_bridge_restart(const char* config_text);
|
||
|
||
/* Копирует INI, ставит reload [server:*] в uasync (auto_sockets=android); без готового ядра запрос отбрасывается. */
|
||
|
||
void utun_bridge_update_sockets(const char* config_text);
|
||
|
||
/* Локальный ping uasync; is_responsive=1 после обработки последнего ping, 0 до первого/после stop.
|
||
* Ожидания и таймаута здесь нет, доступность пиров не проверяется. */
|
||
|
||
void utun_bridge_ping(void);
|
||
int utun_bridge_is_responsive(void);
|
||
|
||
/* Voice recorder: start лениво делает init, фиксирует target канала/dm:conv_id, reply/request/generation.
|
||
* Формат int16 mono 48kHz; feed count — число отсчётов. 0 — успех, -1 — отказ.
|
||
* stop(out_duration_ms nullable) передаёт PCM/compressor фоновой подготовке, запись <500мс отбрасывает с 0.
|
||
* is_active=0/1; preset=0..2; peak=(2*RMS+peak)/2 последнего raw feed. Подробности — voice_recorder.h. */
|
||
|
||
int utun_bridge_voice_start(const char* channel_id, const uint8_t reply_to[32], uint64_t request_id, uint64_t generation);
|
||
int utun_bridge_voice_feed(const int16_t* samples, int count);
|
||
int utun_bridge_voice_stop(int* out_duration_ms);
|
||
void utun_bridge_voice_cancel(void);
|
||
int utun_bridge_voice_is_active(void);
|
||
void utun_bridge_voice_set_preset(int preset);
|
||
int utun_bridge_voice_get_preset(void);
|
||
void utun_bridge_voice_set_compressor(int enabled);
|
||
int utun_bridge_voice_get_compressor(void);
|
||
void utun_bridge_voice_set_compressor_config(int max_gain_db, int lookback_ms, int lookahead_ms,
|
||
float rise_rate_per_sec, float target_level_db);
|
||
float utun_bridge_voice_get_peak_level(void);
|
||
|
||
/* Обычный файл в канал: 0 — поставлено, -1 — отказ. db_path — каталог БД;
|
||
* исходный файл остаётся у caller и нужен неизменным до завершения media-копирования. */
|
||
|
||
int utun_bridge_attachment_send(const char* channel_id, const char* file_path, const char* db_path,
|
||
const uint8_t reply_to[32], uint64_t request_id);
|
||
/* Скачать вложение: msg_id>0 — локальный SQLite row ID; 0 — запрос поставлен, -1 — отказ. */
|
||
int utun_bridge_attachment_download(const char* channel_id, int64_t msg_id);
|
||
|
||
/* Готовый MP4 в канал/dm:conv_id, без транскода; db_path игнорируется.
|
||
* 0 передаёт владение временным файлом задаче (удаление также при ошибке/отмене), -1 оставляет файл caller.
|
||
* duration_ms=1..86400000, размеры=1..16384; generation применяется к DM. См. video_sender.h. */
|
||
int utun_bridge_video_send(const char* channel_id, const char* file_path, const char* db_path,
|
||
int duration_ms, int width, int height, const uint8_t reply_to[32], uint64_t request_id, uint64_t generation);
|
||
|
||
/* Готовое фото в канал, без декодирования; JPEG/PNG/GIF/BMP/WebP по расширению, caller задаёт размеры.
|
||
* db_path — каталог БД; источник остаётся у caller до завершения копирования. 0/-1, см. photo_sender.h. */
|
||
int utun_bridge_photo_send(const char* channel_id, const char* file_path, const char* db_path,
|
||
int width, int height, const uint8_t reply_to[32], uint64_t request_id);
|
||
|
||
/* Декодирование собственного OPUS-файла (не Ogg): open возвращает owned handle либо NULL.
|
||
* Все три out обязательны: частота, число каналов, общее число int16 (включая interleaved каналы).
|
||
* Один последовательный reader на handle; close освобождает decoder/FILE, NULL допустим. */
|
||
|
||
void* utun_bridge_voice_decode_open(const char* file_path,
|
||
int* out_sample_rate, int* out_channels,
|
||
int* out_total_samples);
|
||
/* buf вмещает max_samples int16, выдаются только целые 20мс кадры (rate/50*channels).
|
||
* Возврат: число int16, 0 — EOF либо ёмкость меньше кадра, -1 — аргументы/ошибка чтения или decode.
|
||
* Последний батч ограничивается оставшимися отсчётами: EOF возвращает 0 при следующих чтениях.
|
||
* После ошибки чтения/decode закрыть handle; продолжение этого потока не поддерживается. */
|
||
int utun_bridge_voice_decode_read(void* handle, int16_t* buf, int max_samples);
|
||
void utun_bridge_voice_decode_close(void* handle);
|
||
|
||
/* Сигналинг ставится в uasync: ch_id — десятичный ID группы либо dm:conv_id, peer_node_id и call_id ненулевые.
|
||
* Результат — CHAT_EVT_CALL_*; accept/decline/hangup применяются к указанному call_id. */
|
||
|
||
void utun_bridge_call_start(const char* ch_id, uint64_t peer_node_id, uint64_t call_id);
|
||
void utun_bridge_call_accept(uint64_t call_id);
|
||
void utun_bridge_call_decline(uint64_t call_id);
|
||
void utun_bridge_call_hangup(uint64_t call_id);
|
||
|
||
/* Аудио-движок звонка (call_audio.c, единый голосовой стек): PCM из AudioRecord →
|
||
* Opus → peer (feed); принятый Opus → джиттер+декод+stretch → PCM (pull). */
|
||
/* GUI-поток: начать DSP после готовности ядра; call_audio уже привязан его worker. 0 = успех, -1 = ошибка. */
|
||
int utun_bridge_call_audio_start(uint64_t call_id);
|
||
/* Capture worker: настоящий raw PCM, ровно 960 mono-сэмплов @48кГц; muted!=0 применяется после AEC/AGC.
|
||
* capture_pts_us — монотонная метка первого сэмпла либо INT64_MIN. 0 = поставлено в uasync, -1 = отказ/ошибка. */
|
||
int utun_bridge_call_audio_feed(uint64_t call_id, const int16_t* pcm, int count, int muted, int64_t capture_pts_us);
|
||
/* Playback worker: int16 mono 48kHz, активный DSP выдаёт max_samples; 0 — нет движка/неверные аргументы. */
|
||
int utun_bridge_call_audio_pull(uint64_t call_id, int16_t* out, int max_samples);
|
||
/* После остановки внешних feed/pull workers освободить DSP; привязку к instance снимает worker ядра. */
|
||
void utun_bridge_call_audio_stop(void);
|
||
|
||
/* Подписка — posted-команда; subscribers читает текущий счётчик синхронно (0 без instance). */
|
||
|
||
void utun_bridge_radio_set_active(uint64_t group_id, int on);
|
||
int utun_bridge_radio_subscribers(uint64_t group_id);
|
||
/* Создать/привязать DSP и начать рацию: capture_channels=0 только RX, 1/2 RX+TX. 0/-1.
|
||
* Один TX writer для feed/talk_begin/end и отдельный RX writer для pull; lifecycle сериализует frontend. */
|
||
int utun_bridge_radio_audio_start(uint64_t group_id, int capture_channels);
|
||
/* PCM 48kHz int16 interleaved, count — число int16, кратное числу каналов; длина произвольная. См. radio_audio.h. */
|
||
int utun_bridge_radio_audio_feed(uint64_t group_id, const int16_t* pcm, int count);
|
||
/* PCM 48kHz stereo, max_samples/возврат — число int16, а не кадров; см. radio_audio.h. */
|
||
int utun_bridge_radio_audio_pull(uint64_t group_id, int16_t* out, int max_samples);
|
||
/* Остановить после завершения внешних feed/pull callers. */
|
||
void utun_bridge_radio_audio_stop(void);
|
||
/* RADIO_AUTO_OFF/VAD/LEVEL; ручные talk_begin/end управляют PTT текущей группы. */
|
||
int utun_bridge_radio_auto_mode(void);
|
||
void utun_bridge_radio_talk_begin(uint64_t group_id);
|
||
void utun_bridge_radio_talk_end(uint64_t group_id);
|
||
|
||
/* ── Invite link (for sharing) — асинхронно через uasync-поток.
|
||
Результат приходит событиями CHAT_EVT_INVITE_CANDIDATES / CHAT_EVT_INVITE_LINK_READY. ── */
|
||
void utun_bridge_request_invite_candidates(const char* channel_id);
|
||
void utun_bridge_request_invite_link(const char* channel_id, uint64_t target_node_id, uint64_t request_id);
|
||
|
||
/* Применить уровень синхронно: пустая/NULL category → общий уровень, иначе имя из debug_config. */
|
||
|
||
void utun_bridge_set_debug_level(const char* category, const char* level);
|
||
|
||
/* C API: set синхронно вызывает chat_core_set_setting, только из uasync; get читает с fallback def.
|
||
* JNI nativeSetChatSetting отдельно копирует запрос и ставит trampoline в uasync. */
|
||
|
||
void utun_bridge_chat_setting_set(const char* name, const char* value);
|
||
int utun_bridge_chat_setting_get_int(const char* name, int def);
|
||
|
||
/* ── Channel members ── */
|
||
|
||
/* Снимок БД, поле on здесь всегда 0; актуальное состояние — отдельное событие CHAT_EVT_MEMBER_LIST. */
|
||
char* utun_bridge_get_channel_members_json(const char* channel_id);
|
||
/* Данные БД (адреса/инвайтер); live-достижимость получать отдельным CHAT_EVT_MEMBER_LIST. */
|
||
char* utun_bridge_get_member_detail_json(const char* channel_id, uint64_t node_id);
|
||
/* Синхронная локальная правка SQLite: пустой/NULL nick сбрасывает псевдоним. В сеть не распространяется. */
|
||
void utun_bridge_set_member_nick(const char* channel_id, uint64_t node_id, const char* nick);
|
||
/* Асинхронный toggle локального mute участника рации: 0 — поставлено, -1 — отказ. */
|
||
int utun_bridge_toggle_member_radio_mute(const char* channel_id, uint64_t node_id);
|
||
/* 1 — в локальной БД есть приватный ключ канала, 0 — нет/ошибка; не общий тест всех административных прав. */
|
||
int utun_bridge_is_channel_owner(const char* channel_id);
|
||
/* Поставить подписанную правку всех шести тегов; проверку полномочий выполняет chat_member_tags_commit. */
|
||
void utun_bridge_set_member_flags(const char* channel_id, uint64_t node_id,
|
||
int admin, int supernode, int moder, int storage,
|
||
int verified, int deleted);
|
||
|
||
/* Синхронный обход живых ETCP links, {} без соединения. Не вызывать параллельно изменениям списка. */
|
||
char* utun_bridge_get_member_links_json(uint64_t node_id);
|
||
|
||
/* Асинхронно передать канальный приватный ключ (права админа) другому узлу. */
|
||
void utun_bridge_transfer_admin(const char* channel_id, uint64_t node_id);
|
||
|
||
/* Поставить локальное удаление канала (таблицы, соединения, медиа, db_sync); удаление не распространяется по сети. */
|
||
void utun_bridge_delete_channel(const char* channel_id);
|
||
|
||
/* Политика звука канала: get синхронный (fallback 1), set ставится в uasync и нормализует on к 0/1. */
|
||
|
||
int utun_bridge_get_sound_on_message(const char* channel_id);
|
||
void utun_bridge_set_sound_on_message(const char* channel_id, int on);
|
||
|
||
/* Синхронный обход живых сокетов/links для UI auto-mode; probe_only скрыты, [] без готового чата. */
|
||
|
||
char* utun_bridge_get_local_sockets_json(void);
|
||
|
||
/* Делегировать auto_socket_on_network_change: режим android игнорирует вызов (нужен update_sockets),
|
||
* в других режимах auto_socket ставит scan в uasync. */
|
||
|
||
void utun_bridge_on_network_change(void);
|
||
|
||
/* Поставить запрос client_activity в uasync: active!=0 — ACTIVE, 0 — STANDBY.
|
||
* 0 — команда поставлена живому worker под защитой его владельца; -1 — отказ с диагностикой.
|
||
* При stop ожидающая команда может отмениться. Возврат не подтверждает применение; ядро учитывает удержание трансляций,
|
||
* ошибки перехода логирует trampoline в потоке ядра. */
|
||
|
||
int utun_bridge_set_active(int active);
|
||
|
||
/* Состояние SIM: state=0 UNKNOWN/1 IDLE/2 BUSY, policy — маска call_policy (0..31).
|
||
* Frontend: 0 — копия данных поставлена живому worker под защитой владельца, -1 — отказ с диагностикой.
|
||
* Применение асинхронно; stop/restart может отменить команду без утечки. После SERVICE_STARTED отправить текущее состояние снова. */
|
||
int utun_bridge_set_phone_state(int state, unsigned policy);
|
||
|
||
/* Поставить уведомление standby в uasync; досрочный wake только в SLEEP после min_sleep. */
|
||
|
||
void utun_bridge_notify_network_active(void);
|
||
|
||
/* Асинхронные снимки через CHAT_EVT_CONN_LIST/CHAT_EVT_CONN_METRICS. */
|
||
|
||
void utun_bridge_collect_conn_list(void);
|
||
void utun_bridge_collect_conn_metrics(uint64_t peer_node_id);
|
||
|
||
/* ── DM (личные сообщения) ──
|
||
* dm_start/dm_send выполняются асинхронно через uasync (трамплины dm_core).
|
||
* Результат dm_start — CHAT_EVT_DM_CONV_UPDATED; source_ch_id/peer_name могут быть NULL.
|
||
* generation в send/history/file относится к поколению беседы, не к instance. */
|
||
void utun_bridge_dm_start(uint64_t node_id, const char* source_ch_id, const char* peer_name);
|
||
void utun_bridge_dm_send(const char* conv_id, const char* text, uint64_t generation);
|
||
/* Запросить CHAT_EVT_DM_CONVERSATIONS. */
|
||
void utun_bridge_dm_request_conversations(void);
|
||
/* Снимок видимой истории указанного поколения; запоздалый запрос отбрасывается в uasync. */
|
||
void utun_bridge_dm_request_messages(const char* conv_id, uint64_t generation);
|
||
/* 0 — принято и передано владение временным path (удаляется задачей), -1 — отказ, файл остаётся caller.
|
||
* name — отображаемое имя, строки копируются. Поколение беседы проверяется в uasync. */
|
||
int utun_bridge_dm_send_file(const char* conv_id, const char* path, const char* name, uint64_t generation);
|
||
|
||
#ifdef __cplusplus
|
||
}
|
||
#endif
|
||
#endif /* ANDROID_JNI_BRIDGE_H */
|