Aplikacja na Androida do zmiany strumienia wideo "HookCamera"

Specyfikacja techniczna dla rozwoju aplikacji Android "PrivatCam"**ShadowHook

### 1. Informacje ogólne

**Nazwa projektu: PrivatCam  

Cel: Zmiana strumienia wideo z rzeczywistej kamery na strumień RTMP, aby inne aplikacje postrzegały strumień jako zwykły obraz z kamery.  

Platforma: Android (wersja 13, z dostępem root)  

Dodatkowe wymagania: Urządzenie z dostępem root, zainstalowany Magisk, połączenie z PC przez USB, praca z ADB.  

### 2. Wymagania funkcjonalne

#### 2.1 Podstawowa funkcjonalność

- Interfejs do wprowadzania adresu strumienia RTMP, na przykład: rtmp://localhost/live/test

- Przycisk "Zamień kamerę" do rozpoczęcia transmisji

- Możliwość zatrzymania zamiany kamery

- Emulacja kamery Android, aby inne aplikacje postrzegały strumień wideo jako rzeczywistą kamerę

- Wsparcie dla odwrotnego przekierowania portu przez ADB (adb reverse tcp:1935 tcp:1935)

#### 2.2 Interakcja z serwerem

- Użycie protokołu RTMP do odbioru strumienia wideo

- Uruchomienie strumienia w OBS Studio z adresem rtmp://localhost/live i kluczem test

- Praca z lokalnym serwerem MonaServer, zainstalowanym na PC

#### 2.3 Wymagania dotyczące wideo

- Wsparcie dla różnych rozdzielczości (720p, 1080p)

- Wsparcie dla standardowych kodeków (H.264)

- Minimalne opóźnienie strumienia wideo

### 3. Wymagania techniczne

#### 3.1 Wymagane technologie

- FFmpeg – do dekodowania i przetwarzania strumienia wideo RTMP

- Android Camera HAL (Hardware Abstraction Layer) – do zamiany wejścia wideo

 możliwe przechwycenie kamery przez ShadowHook

- Moduł Magisk  – do integracji z usługami systemowymi

- **Dostęp root – do manipulacji z systemowymi sterownikami

- ADB Reverse – do przekazywania lokalnego połączenia między PC a smartfonem

#### 3.2 Możliwe podejścia do realizacji

1. Tworzenie wirtualnego urządzenia kamery

   - Opracowanie niestandardowego sterownika do emulacji kamery

   - Interakcja z Camera HAL przez API

2. Przetwarzanie strumienia wideo

   - Odbieranie strumienia RTMP przez FFmpeg

   - Dekodowanie strumienia wideo i podawanie do wirtualnego urządzenia

   - Wsparcie dla dynamicznej zmiany parametrów strumienia

3. Emulacja standardowego interfejsu kamery

   - Użycie Camera2 API lub niestandardowych bibliotek HAL

   - Przechwytywanie i transmisja strumienia wideo do aplikacji zewnętrznych

### 4. Interfejs użytkownika

#### 4.1 Ekran główny

- Pole do wprowadzania linku RTMP

- Przycisk "Połącz z strumieniem"

- Przycisk "Zatrzymaj zamianę"

- Wskaźnik statusu połączenia

- Dziennik błędów i wiadomości

### 5. Testowanie

- Sprawdzenie działania z różnymi aplikacjami (WhatsApp, Zoom, Skype, Instagram, Google Meet)

- Sprawdzenie stabilności połączenia

- Pomiar opóźnienia strumienia wideo

- Testowanie na kilku urządzeniach z dostępem root

### 6. Wdrożenie

- Ręczna instalacja APK (bez publikacji w Google Play, ponieważ wymaga dostępu root)

- Możliwość instalacji przez Moduł Magisk (jeśli zajdzie taka potrzeba)

### 7. Oczekiwane wyniki 

- Działająca aplikacja, która pozwala na zamianę strumienia wideo kamery w dowolnej aplikacji Android

Техническое задание на разработку 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-приложении