292 lines
7.5 KiB
Markdown
292 lines
7.5 KiB
Markdown
# ⚡ БЫСТРЫЙ СТАРТ - CamControl (5 минут)
|
||
|
||
## 🎯 ДЛЯ НЕТЕРПЕЛИВЫХ
|
||
|
||
### Сервер (Компьютер)
|
||
|
||
```bash
|
||
# 1. Установить зависимости
|
||
pip install fastapi uvicorn opencv-python numpy websockets python-dotenv psutil
|
||
|
||
# 2. Запустить
|
||
python server.py
|
||
|
||
# Результат:
|
||
# 🌐 Web Interface: http://192.168.1.100:8000
|
||
```
|
||
|
||
### Веб-интерфейс (Браузер)
|
||
|
||
```
|
||
http://192.168.1.100:8000
|
||
Логин: admin / admin123
|
||
Нажать: Create Room
|
||
Сохранить: Room ID и пароль
|
||
```
|
||
|
||
### Приложение (Телефон)
|
||
|
||
```bash
|
||
# 1. Собрать
|
||
./gradlew installDebug
|
||
|
||
# 2. Запустить
|
||
# Нажать иконку приложения на телефоне
|
||
|
||
# 3. Ввести в форме:
|
||
IP: 192.168.1.100
|
||
Порт: 8000
|
||
Room ID: (из браузера)
|
||
Password: (из браузера)
|
||
|
||
# 4. Нажать: Подключиться
|
||
|
||
# 5. В браузере нажать: View
|
||
```
|
||
|
||
**Готово! 🎉 Видео транслируется!**
|
||
|
||
---
|
||
|
||
## 🔍 ОСНОВНЫЕ КОМАНДЫ
|
||
|
||
### Build & Run
|
||
|
||
```bash
|
||
# Быстрая сборка
|
||
./gradlew assembleDebug
|
||
|
||
# Быстрая установка
|
||
./gradlew installDebug
|
||
|
||
# All-in-one (сборка + установка + запуск)
|
||
./gradlew installDebug && adb shell am start -n com.example.camcontrol/.MainActivity
|
||
```
|
||
|
||
### Debug
|
||
|
||
```bash
|
||
# Посмотреть логи
|
||
adb logcat | grep "camControl"
|
||
|
||
# Очистить кэш
|
||
adb shell pm clear com.example.camcontrol
|
||
|
||
# Переустановить
|
||
adb uninstall com.example.camcontrol
|
||
./gradlew installDebug
|
||
```
|
||
|
||
### Сервер
|
||
|
||
```bash
|
||
# Запустить
|
||
python server.py
|
||
|
||
# Остановить
|
||
Ctrl+C
|
||
|
||
# Просмотреть логи
|
||
# Смотреть вывод в консоли
|
||
```
|
||
|
||
---
|
||
|
||
## 📱 ИНТЕРФЕЙС ПРИЛОЖЕНИЯ
|
||
|
||
### Экран подключения
|
||
|
||
```
|
||
┌─────────────────────────┐
|
||
│ 🎥 CamControl │
|
||
├─────────────────────────┤
|
||
│ IP: [192.168.1.100] │
|
||
│ Порт: [8000] │
|
||
│ ID: [abc123] │
|
||
│ Пароль: [pass] │
|
||
│ [Подключиться] │
|
||
└─────────────────────────┘
|
||
```
|
||
|
||
### Экран трансляции
|
||
|
||
```
|
||
┌─────────────────────────┐
|
||
│ 🎥 Camera Preview │
|
||
├─────────────────────────┤
|
||
│ ✓ Подключено (30 FPS) │
|
||
│ 📊 5.2 MB переслано │
|
||
│ │
|
||
│ [Rotate] [Flip] │
|
||
│ [Gray] [Reset] │
|
||
│ [Отключиться] │
|
||
└─────────────────────────┘
|
||
```
|
||
|
||
---
|
||
|
||
## 🔧 РЕШЕНИЕ ПРОБЛЕМ (5 минут)
|
||
|
||
### Приложение не подключается
|
||
|
||
```bash
|
||
# 1. Проверить IP сервера
|
||
ping 192.168.1.100
|
||
|
||
# 2. Проверить сервер запущен
|
||
python server.py # должно быть запущено
|
||
|
||
# 3. Очистить приложение
|
||
adb shell pm clear com.example.camcontrol
|
||
```
|
||
|
||
### Камера не работает
|
||
|
||
```bash
|
||
# 1. Выдать разрешение
|
||
adb shell pm grant com.example.camcontrol android.permission.CAMERA
|
||
|
||
# 2. Перезагрузить приложение
|
||
adb shell am force-stop com.example.camcontrol
|
||
adb shell am start -n com.example.camcontrol/.MainActivity
|
||
```
|
||
|
||
### Ошибка при сборке
|
||
|
||
```bash
|
||
# 1. Очистить
|
||
./gradlew clean
|
||
|
||
# 2. Пересоберить
|
||
./gradlew build --refresh-dependencies
|
||
|
||
# 3. Переустановить
|
||
./gradlew installDebug
|
||
```
|
||
|
||
---
|
||
|
||
## 📊 ПРОВЕРОЧНЫЙ ЛИСТ
|
||
|
||
```
|
||
Сервер:
|
||
✅ Python установлен (python --version)
|
||
✅ Зависимости установлены (pip list)
|
||
✅ Сервер запущен (python server.py)
|
||
✅ Веб-интерфейс доступен (http://192.168.1.100:8000)
|
||
|
||
Приложение:
|
||
✅ Android SDK установлен
|
||
✅ Gradle синхронизирован
|
||
✅ Приложение собирается (./gradlew build)
|
||
✅ Приложение устанавливается (./gradlew installDebug)
|
||
|
||
Тестирование:
|
||
✅ Форма подключения работает
|
||
✅ WebSocket соединяется
|
||
✅ Видео передается
|
||
✅ Команды отправляются
|
||
```
|
||
|
||
---
|
||
|
||
## 💡 ПОЛЕЗНЫЕ СОВЕТЫ
|
||
|
||
### Найти IP сервера
|
||
|
||
```bash
|
||
# Windows
|
||
ipconfig | findstr "IPv4"
|
||
|
||
# Linux/Mac
|
||
ifconfig | grep "inet "
|
||
|
||
# Результат: 192.168.1.100 (используйте это в приложении)
|
||
```
|
||
|
||
### Использовать на разных устройствах
|
||
|
||
```bash
|
||
# Сервер на ПК: 192.168.1.100:8000
|
||
# Тел 1 подключается к: 192.168.1.100:8000
|
||
# Тел 2 подключается к: 192.168.1.100:8000
|
||
# В браузере: видны оба потока!
|
||
```
|
||
|
||
### Запись видео трансляции
|
||
|
||
```bash
|
||
# В браузере нажать F12
|
||
# DevTools → Screen Capture
|
||
# Нажать Record → View stream → Stop
|
||
# Видео сохранится в Downloads
|
||
```
|
||
|
||
---
|
||
|
||
## 🚨 ЧАСТЫЕ ОШИБКИ
|
||
|
||
| Ошибка | Причина | Решение |
|
||
|--------|---------|--------|
|
||
| Connection refused | Сервер не запущен | `python server.py` |
|
||
| Invalid room | Room ID неправильный | Скопируйте точно из браузера |
|
||
| Camera permission | Разрешение не дано | Выдайте разрешение |
|
||
| WebSocket error | Сеть разорвана | Переподключитесь |
|
||
|
||
---
|
||
|
||
## 📞 КОГДА НУЖНА ПОМОЩЬ
|
||
|
||
1. **Проверьте README.md** - полная документация
|
||
2. **Смотрите логи** - `adb logcat | grep camControl`
|
||
3. **Очистите кэш** - `adb shell pm clear com.example.camcontrol`
|
||
4. **Переустановите** - `./gradlew installDebug`
|
||
|
||
---
|
||
|
||
## 🎯 СЛЕДУЮЩИЕ ШАГИ
|
||
|
||
После успешного запуска:
|
||
|
||
1. **Изучите код** - файлы хорошо задокументированы
|
||
2. **Добавьте функции** - расширьте приложение под свои нужды
|
||
3. **Оптимизируйте** - улучшите производительность
|
||
4. **Разверните** - выпустите в Play Store
|
||
|
||
---
|
||
|
||
## ✅ ГОТОВО!
|
||
|
||
```
|
||
Поздравляем! 🎉
|
||
|
||
Ваше мобильное приложение для видеотрансляции готово!
|
||
|
||
Все работает:
|
||
✅ Подключение к серверу
|
||
✅ Трансляция видео
|
||
✅ Управление эффектами
|
||
✅ Мониторинг статистики
|
||
|
||
Начните использовать CamControl прямо сейчас!
|
||
```
|
||
|
||
---
|
||
|
||
## 📚 ПОЛНАЯ ДОКУМЕНТАЦИЯ
|
||
|
||
Для подробной информации смотрите:
|
||
|
||
1. **README.md** - функции и требования
|
||
2. **SETUP_GUIDE.md** - полная инструкция
|
||
3. **INTEGRATION.md** - техническая информация
|
||
4. **BUILD_INSTRUCTIONS.md** - сборка и запуск
|
||
5. **FINAL_REPORT.md** - итоговый отчет
|
||
|
||
---
|
||
|
||
**Время на запуск: 5-10 минут ⚡**
|
||
|
||
Все готово к использованию! 🚀
|
||
|