Files
cam_control_android/QUICK_START.md
2025-12-03 19:39:42 +09:00

7.5 KiB
Raw Permalink Blame History

БЫСТРЫЙ СТАРТ - CamControl (5 минут)

🎯 ДЛЯ НЕТЕРПЕЛИВЫХ

Сервер (Компьютер)

# 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 и пароль

Приложение (Телефон)

# 1. Собрать
./gradlew installDebug

# 2. Запустить
# Нажать иконку приложения на телефоне

# 3. Ввести в форме:
IP: 192.168.1.100
Порт: 8000
Room ID: (из браузера)
Password: (из браузера)

# 4. Нажать: Подключиться

# 5. В браузере нажать: View

Готово! 🎉 Видео транслируется!


🔍 ОСНОВНЫЕ КОМАНДЫ

Build & Run

# Быстрая сборка
./gradlew assembleDebug

# Быстрая установка
./gradlew installDebug

# All-in-one (сборка + установка + запуск)
./gradlew installDebug && adb shell am start -n com.example.camcontrol/.MainActivity

Debug

# Посмотреть логи
adb logcat | grep "camControl"

# Очистить кэш
adb shell pm clear com.example.camcontrol

# Переустановить
adb uninstall com.example.camcontrol
./gradlew installDebug

Сервер

# Запустить
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 минут)

Приложение не подключается

# 1. Проверить IP сервера
ping 192.168.1.100

# 2. Проверить сервер запущен
python server.py  # должно быть запущено

# 3. Очистить приложение
adb shell pm clear com.example.camcontrol

Камера не работает

# 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

Ошибка при сборке

# 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 сервера

# Windows
ipconfig | findstr "IPv4"

# Linux/Mac
ifconfig | grep "inet "

# Результат: 192.168.1.100 (используйте это в приложении)

Использовать на разных устройствах

# Сервер на ПК:    192.168.1.100:8000
# Тел 1 подключается к: 192.168.1.100:8000
# Тел 2 подключается к: 192.168.1.100:8000
# В браузере: видны оба потока!

Запись видео трансляции

# В браузере нажать 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 минут

Все готово к использованию! 🚀