vladpen / cams

Android mobile app
MIT License
120 stars 18 forks source link

Cams

Cams

Простое мобильное приложение под Android для воспроизведения RTSP потоков с IP камер.

Особенности:

<img src="https://raw.githubusercontent.com/vladpen/cams/main/fastlane/metadata/android/ru-RU/images/phoneScreenshots/1_main_ru.jpg" alt="Main screen" width="200">  <img src="https://raw.githubusercontent.com/vladpen/cams/main/fastlane/metadata/android/ru-RU/images/phoneScreenshots/2_edit_ru.jpg" alt="Edit screen" width="200">  <img src="https://raw.githubusercontent.com/vladpen/cams/main/fastlane/metadata/android/ru-RU/images/phoneScreenshots/3_files_ru.jpg" alt="Files screen" width="200">  <img src="https://raw.githubusercontent.com/vladpen/cams/main/fastlane/metadata/android/ru-RU/images/phoneScreenshots/4_video_ru.jpg" alt="Video screen" width="200">

Приложение написано для совместного использования с сервером python-rtsp-server, но прекрасно работает автономно благодаря возможности подключения к любым IP камерам, а также видеорегистраторам, поддерживающим SFTP.

Воспроизводит большинство типов видеопотоков (не только RTSP). На снимке экрана выше показано изображение с реальной видеокамеры и три тестовых ролика в режиме "Группа".

ВАЖНО. Приложение ориентировано на безопасность и приватность данных, поэтому не собирает и не обрабатывает никакую информацию о пользователе. Данные не отправляются ни на какие сервера, включая техническую инфраструктуру Google и "облачные" хранилища производителей камер.

Установка

APK файл можно собрать самостоятельно, скачать с Github, установить с помощью F-Droid или RuStore. Поддерживается архитектура ARM-64 (используется в большинстве современных мобильных телефонов), ARM, x86-64 и x86.

Настройка

Для подключения к видеокамере нужно ввести в поле "Адрес" ее URL, указанный производителем. Обычно он выглядит так:

[rtsp://][<пользователь>:<пароль>@]<IP>[:<порт>][/<путь>]

Параметры в квадратных скобках необязательны (зависит от настроек камеры).

Для двухканальных камер дополнительно можно указать адрес второго канала. Нпример, для камер Hikvision и их производных путь будет иметь такой вид:

ISAPI/Streaming/Channels/<номер канала>

Тогда первый канал (высокого разрешения) будет иметь номер 101, а второй (низкого разрешения) — 102.

Каналы низкого разрешения можно использовать для ускорения загрузки изображения, для экономии трафика и для снижения нагрузки на процессор устройства. Это особенно удобно для просмотра группы камер при низкой скорости соединения. При воспроизведении каналы можно переключать кнопкой К1/К2 в нижнем правом углу экрана. На экранах групп камер по умолчанию используется K2.

Также для снижения нагрузки воспроизведение камер, выходящих за границы экрана при увеличении изображения, приостанавливается.

Адрес SFTP сервера или видеорегистратора выглядит так:

[sftp://]<пользователь>:<пароль>@<IP>[:<порт>][/<путь>]

ВНИМАНИЕ! Настоятельно не рекомендуется использовать данные доступа администратора. Для SFTP сервера лучше создать chroot, например, как описано тут.

Совет: в названии камеры можно использовать эмодзи в качестве иконки. Например, на снимках экрана выше использованы иконки из стандартного набора мобильного телефона.

Оповещение о движении

Опционально приложение может уведомлять о срабатывании детектора движения камер. Оповещение срабатывает в момент появления нового изображения с камеры в указанной папке SFTP сервера. Для работы этой функции требуется настроить камеры и сервер хранения полученных изображений. Подробно эти настройки описаны в параллельном проекте Cams-PWA.

Подробное обсуждение приложения: habr.com/ru/post/654915 и сервера: habr.com/ru/post/597363.

<img src="https://github.githubassets.com/images/modules/logos_page/GitHub-Mark.png" alt="Get it on Github" height="80"> <img src="https://fdroid.gitlab.io/artwork/badge/get-it-on.png" alt="Get it on F-Droid" height="80">

  <img src="https://user-images.githubusercontent.com/3853013/194689050-e6da2f21-9aa3-4662-9b7d-7293b140f22f.svg" alt="Доступно в RuStore" height="57">

Copyright (c) 2022-2024 vladpen under MIT license. Use it with absolutely no warranty.