Андроид приложение для изминения видеопотока "HookCamera"

Техническое задание на разработку Android-приложения "PrivatCam"**ShadowHook

### 1. Общая информация

**Название проекта: PrivatCam  

Цель: Подмена видеопотока реальной камеры на RTMP-стрим, чтобы другие приложения воспринимали поток как обычное изображение с камеры.  

Платформа: Android (версия 13, с root-доступом)  

Дополнительные требования: Устройство с root-доступом, установленный Magisk, подключение к ПК через USB, работа с ADB.  

### 2. Функциональные требования

#### 2.1 Основной функционал

- Интерфейс для ввода RTMP-адреса потока, например: rtmp://localhost/live/test

- Кнопка "Подменить камеру" для старта трансляции

- Возможность остановки подмены камеры

- Эмуляция камеры Android, чтобы другие приложения воспринимали видеопоток как реальную камеру

- Поддержка обратного проброса порта через ADB (adb reverse tcp:1935 tcp:1935)

#### 2.2 Взаимодействие с сервером

- Использование RTMP-протокола для получения видеопотока

- Запуск стрима в OBS Studio с адресом rtmp://localhost/live и ключом test

- Работа с локальным сервером MonaServer, установленным на ПК

#### 2.3 Требования к видео

- Поддержка различных разрешений (720p, 1080p)

- Поддержка стандартных кодеков (H.264)

- Минимальная задержка видеопотока

### 3. Технические требования

#### 3.1 Требуемые технологии

- FFmpeg – для декодирования и обработки видеопотока RTMP

- Android Camera HAL (Hardware Abstraction Layer) – для подмены видеовхода

 возможен Перехват камеры через ShadowHook

- Magisk Module  – для интеграции с системными сервисами

- **Root-доступ – для манипуляции с системными драйверами

- ADB Reverse – для прокидывания локального соединения между ПК и смартфоном

#### 3.2 Возможные подходы к реализации

1. Создание виртуального устройства камеры

   - Разработка кастомного драйвера для эмуляции камеры

   - Взаимодействие с Camera HAL через API

2. Обработка видеопотока

   - Получение RTMP-потока через FFmpeg

   - Декодирование видеопотока и подача в виртуальное устройство

   - Поддержка динамического изменения параметров потока

3. Эмуляция стандартного интерфейса камеры

   - Использование Camera2 API или кастомных HAL-библиотек

   - Перехват и трансляция видеопотока в сторонние приложения

### 4. Интерфейс пользователя

#### 4.1 Основной экран

- Поле для ввода RTMP-ссылки

- Кнопка "Подключиться к потоку"

- Кнопка "Остановить подмену"

- Индикатор статуса соединения

- Лог ошибок и сообщений

### 5. Тестирование

- Проверка работы с разными приложениями (WhatsApp, Zoom, Skype, Instagram, Google Meet)

- Проверка стабильности соединения

- Измерение задержки видеопотока

- Тестирование на нескольких устройствах с root-доступом

### 6. Развертывание

- Установка APK вручную (без публикации в Google Play, так как требует root)

- Возможность установки через Magisk Module (если потребуется)

### 7. Ожидаемые результаты 

- Рабочее приложение, позволяющее подменять видеопоток камеры в любом Android-приложении