Files
utun2/tools/chatgui-android/jni_bridge/android_jni_bridge.h
T

293 lines
23 KiB
C
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
/*
* 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 */