Добро пожаловать в альфа-версию Eufy Security Integration для Home Assistant. Поздравляем с тем, что вы проявили смелость и попробовали эту версию.
eufy-security-ws
с использованием eufy-security-client
для имитации функций мобильного приложения и веб-портала и обернул eufy-security-ws
как hassio-eufy-security-ws
чтобы мы могли использовать его в качестве надстройки Home Assistant.event duration in seconds
.Пожалуйста, проверьте здесь: https://github.com/bropat/eufy-security-client#known-working-devices.
На следующих шагах вы собираетесь установить как минимум одно дополнение и две интеграции.
В экосистеме Home Assistant, если вы используете настройку на основе контролируемой ОС или HASS, вы можете использовать страницу Add-ons
Home Assistant для их установки. Если вы используете Core или в вашей настройке нет опции Add-ons
, вам необходимо установить докер и запустить эти контейнеры самостоятельно. Вы увидите соответствующие команды на соответствующих шагах. Если вы заинтересованы в создании своего докер-контейнера, пожалуйста, проверьте конечный раздел.
Эта интеграция не является частью Home Assistant Core, поэтому вам необходимо установить ее как пользовательскую интеграцию. Есть два способа сделать это: вручную загрузить и скопировать файлы или использовать HACS (магазин сообщества Home Assistant). Здесь я буду использовать метод HACS.
Если вы собираетесь использовать эту интеграцию для потоковой передачи видео и если ваша камера не поддерживает потоковую передачу на основе RTSP (протокол потоковой передачи в реальном времени) (в настройках камеры нет возможности непрерывной записи или записи NAS), вам также необходимо установить пользовательскую интеграцию webrtc. который будет включать двоичный файл go2rtc (go2rtc также существует как отдельное дополнение). Это дополнение позволит нам преобразовывать байты одноранговой сети (P2P) в поток RTSP, чтобы вы могли удобно воспроизводить его в Home Assistant (с RTC или без него) или с помощью VLC Player.
Если вы собираетесь использовать эту интеграцию для потоковой передачи видео и если ваша камера поддерживает RTSP, вам, вероятно, понравится надежный поток, поскольку за создание потока RTSP отвечает аппаратное обеспечение, и он очень надежен, чем потоковая передача на основе P2P. Нет необходимости конвертировать входящие P2P-байты в поток RTSP. Существует несколько модифицированных версий Android apk Eufy Security, которые могут включать поток RTSP для неподдерживаемых устройств, но я не пробовал. Более того, у меня лично нет устройства, необходимого для P2P, потому что во многих случаях я не могу воспроизвести ваши проблемы локально, и нам нужно работать вместе для устранения этих проблем.
Наконец, ваша камера не начнет потоковую передачу волшебным образом сама по себе, вам придется вызывать службы turn_on
или turn_off
соответствующих объектов камеры. Итак, при первой установке у вас не будет видео, пока вы не вызовете эти функции. Более того, потоковая передача P2P может случайно прекратиться из-за технических проблем низкого уровня. Вы можете перезапустить ее снова с помощью turn_off
и turn_on
. Вы можете активировать автоматизацию в состояниях камеры (ожидание, подготовка, потоковая передача).
Итак, начнем.
Пожалуйста, следуйте инструкциям здесь: https://github.com/bropat/hassio-eufy-security-ws.
Это необходимо для потоковой передачи P2P и приятно иметь для потоковой передачи RTSP. Потоковая передача P2P будет использовать go2rtc для генерации потока с определенным адресом RTSP. Потоковая передача RTSP будет использовать это для более быстрой потоковой передачи.
Есть два способа сделать это: либо установить надстройку, либо установить специальную интеграцию Webrtc. Я предлагаю вам установить специальную интеграцию Webrtc, которая включает go2rtc и соответствующую интерфейсную карту для более быстрой потоковой передачи. Установить go2rtc с webrtc или без него можно по этой ссылке: https://github.com/fuatakgun/WebRTC. Этот WebRTC представляет собой настроенную версию, позволяющую легко управлять условной картой, и дальнейшая настройка будет зависеть от нее.
1. Если вы еще не установили HACS
, следуйте этому руководству: https://hacs.xyz/docs/setup/download.
2. Когда HACS
будет готов, найдите Eufy Security
в разделе «Интеграции HACS
.
3. Установите интеграцию Eufy Security
через HACS, перезапустите экземпляр Home Assistant.
4. Перейдите на страницу Settings -> Devices & Services
Home Assistant (https://your-instance.duckdns.org/config/integrations). Нажмите Add Integration
и найдите Eufy Security
(не Eufy
, а именно Eufy Security
). Если вы его не видите, сначала убедитесь, что он установлен через HACS и вы его перезапустили, а затем попробуйте использовать другой браузер. Список интеграций может быть уже кэширован в вашем браузере.
5- Введите Eufy Security Add-on IP Address
(127.0.0.1 для контролируемой установки) и configured port
(по умолчанию 3000) и нажмите «Отправить».
6. Вы можете получить предупреждения о капче или многофакторной аутентификации (MFA). Перенастройте интеграцию. Код Captcha будет виден на странице перенастройки, а код MFA будет отправлен вам по электронной почте или в текстовом сообщении. Пожалуйста, введите эти значения. После этого вам может потребоваться перезапустить экземпляр Home Assistant.
7. Если вы установили webrtc custom integration with go2rtc or standalone go2rtc Add-On
, укажите ее IP Address
на странице конфигурации интеграции. Вы можете поставить 127.0.0.1
для контролируемой установки.
8. Вы также можете настроить Cloud Scan Interval
, продолжительность анализа видео, Custom Name 1
, Custom Name 2
и Custom Name 3
Примечание. Пользовательское имя 1, Пользовательское имя 2 и Пользовательское имя 3 — это метки, используемые для обозначения первого, второго и третьего пользовательских средств защиты (режимов), созданных вами в приложении Eufy Security. Вы можете активировать свою индивидуальную охрану, используя встроенную карту панели сигнализации, следующим образом:
arm_custom_bypass -> triggers your first custom guard defined in Eufy security app (ordered by 'created date')
arm_night -> trigger second custom guard
arm_vacation -> trigger third custom guard
Например, вы создаете режим «перед сном» в приложении Eufy Security, по умолчанию не будет возможности активировать его с помощью карты панели сигнализации. Однако, используя эту интеграцию, вы можете вызвать сервис arm_custom_bypass
из панели сигнализации, что включит ваш «ночной» режим. Вы можете настроить отображаемое имя этого режима, выполнив шаг 8 выше.
Эти встроенные службы панели сигнализации не соответствуют каким-либо средствам защиты Eufy по умолчанию, поэтому их назначение изменено, чтобы обеспечить дополнительную гибкость для запуска пользовательских режимов безопасности с использованием этой интеграции. Более подробную информацию смотрите в обсуждении в № 145.
9- Включите диагностические объекты, которые отключены по умолчанию. После установки некоторые объекты отключаются, чтобы избежать создания слишком больших объемов данных. Это ожидаемое поведение. Если вы считаете, что какой-либо объект важен, просто включите его. Для этого выберите одно из устройств в интеграции eufy_security. Затем прокрутите вниз до раздела «Диагностика» и выберите один из объектов. Вверху зайдите в настройки и включите в настройках параметры Enabled
и Visible
. Примерно через 30 секунд этот объект будет доступен.
Потоковая передача Native Home Assistant довольно медленная (а может, и нет?), поэтому настоятельно рекомендуется установить интеграцию WebRTC с HACS.
Код ниже будет отображать изображение с камеры, когда камера не осуществляет потоковую передачу, и карту webrtc, когда камера осуществляет потоковую передачу (условные карты). Замените camera.entrance
на имя объекта вашей камеры.
type : custom:webrtc-camera
entity : camera.entrance
poster : image.entrance_event_image
ui : true
shortcuts :
- name : Play
icon : mdi:play
service : camera.turn_on
service_data :
entity_id : camera.entrance
- name : Stop
icon : mdi:stop
service : camera.turn_off
service_data :
entity_id : camera.entrance
Если ваша камера поддерживает панорамирование и наклон, вы можете добавить соответствующие команды в интерфейс webrtc.
type : custom:webrtc-camera
entity : camera.garden
ptz :
service : eufy_security.ptz
data_left :
entity_id : camera.garden
direction : LEFT
data_right :
entity_id : camera.garden
direction : RIGHT
data_up :
entity_id : camera.garden
direction : UP
data_down :
entity_id : camera.garden
direction : DOWN
Debug (device)
и Debug (station)
чтобы я мог извлечь эти датчики. Если эти датчики невозможно извлечь из состояния устройства, укажите это явно.button
, switch
и select
объектов, используйте их.turn_on
и turn_off
— интеграция проверит, поддерживает ли ваше устройство RTSP и резервную потоковую передачу на основе P2P.start_rtsp_livestream
и stop_rtsp_livestream
— трансляция будет запущена с использованием RTSP, если ваше устройство его поддерживает.start_p2p_livestream
и stop_p2p_livestream
— стрим будет запущен по P2P, здесь работают все устройстваgenerate_image
— создаст миниатюру для Home Assistant, если камера уже ведет потоковую передачу.ptz_up
, ptz_down
, ptz_right
, ptz_left
, ptz_360
— команды панорамирования и наклона.trigger_camera_alarm_with_duration
— вызвать тревогу на камере на заданную продолжительность.quick_response
— отправьте сообщение быстрого ответа на дверной звонок. Вы можете получить информацию voice_id
из атрибутов датчика Debug (device)
устройства. Это можно выполнить ТОЛЬКО при потоковой передаче с камеры (p2p, а не rtsp).snooze
— отложить текущее уведомление на заданный период времени.trigger_base_alarm_with_duration
— вызвать тревогу на станции на заданную продолжительность.reset_alarm
— Сбросить текущий сигнал тревоги в течение заданного периода времени.snooze
— отложить текущее уведомление на заданный период времени.arm_home
— переключиться в состояние «Домой»arm_away
— переключиться в состояние «Отошел»disarm
- Снять панель с охраныalarm_arm_custom1
— переключитесь на пользовательский вариант 1, который относится к первому, второму и третьему пользовательским средствам защиты (или режимам), созданным вами в приложении Eufy Security.alarm_arm_custom2
- Переключиться на кастом 2alarm_arm_custom3
- Переключиться на кастом 3geofence
— переключитесь на геозону, это может не повлиять на состояние панели, поскольку она изменит свое состояние в зависимости от географического местоположения через приложение Eufy.schedule
— переключитесь на пользовательский вариант 3, это может не повлиять на состояние панели, поскольку оно будет менять свое состояние в зависимости от расписания через приложение Eufy.chime
- Включить звуковой сигнал на базовой станции (понравилось) - Я не знаю точного списка доступных мелодий, попробуйте сами.lock
и unlock
замкиunlock
кодом для сейфов Замените camera.entrance
на свое собственное имя объекта.
alias : Capture Image on Trigger, Send Mobile Notification with Actions, Snooze or Alarm via Actions
description : " "
trigger :
- platform : state
entity_id :
- binary_sensor.entrance_motion_detected
- binary_sensor.entrance_person_detected
to : " on "
id : sensor
- platform : event
event_type : mobile_app_notification_action
id : snooze
event_data :
action : SNOOZE
- platform : event
event_type : mobile_app_notification_action
id : alarm
event_data :
action : ALARM
condition : []
action :
- choose :
- conditions :
- condition : trigger
id : sensor
sequence :
- delay :
hours : 0
minutes : 0
seconds : 3
milliseconds : 0
- service : notify.mobile_app_fuatx3pro
data :
message : Motion detected
data :
image : /api/image_proxy/image.entrance_event_image
actions :
- action : ALARM
title : Alarm
- action : SNOOZE
title : Snooze
- conditions :
- condition : trigger
id : snooze
sequence :
- service : eufy_security.snooze
data :
snooze_time : 10
snooze_chime : false
snooze_motion : true
snooze_homebase : false
target :
entity_id : camera.entrance
- conditions :
- condition : trigger
id : alarm
sequence :
- service : eufy_security.trigger_camera_alarm_with_duration
data :
duration : 1
target :
entity_id : camera.entrance
mode : single
Это условие запуска запускает автоматизацию сразу после обновления изображения события. В некоторых случаях это надежнее и немного быстрее. Если предыдущая автоматизация выдает устаревшие изображения или вызывает проблемы, попробуйте вместо этого другой триггер и условие:
trigger :
- platform : state
entity_id :
- image.entrance_cam
id : sensor
condition :
- condition : template
value_template : >-
{{ as_timestamp(states.image.entrance_cam.last_changed) == as_timestamp(states.image.entrance_cam.last_updated) }}
service : lock.unlock
data :
code : " testtest "
target :
entity_id : lock.safe
Сначала проверьте все проблемы (открытые или закрытые), чтобы узнать, был ли какой-либо похожий вопрос, а не дублировать его. Сосредоточьтесь на включении настроек push-уведомлений, снижении качества потоковой передачи/записи с камеры и снятии изоляции/ограничений на уровне сети. С их помощью можно решить большинство проблем. Позже, если вы обнаружите подобную проблему, просто поставьте +1, совместное использование одних и тех же журналов снова и снова не поможет. Наконец, создайте свою проблему по шаблону. Возможно, позже я задам уточняющие вопросы.
Я более чем рад устранить отдельные проблемы, если вы будете следовать инструкциям по настройке. Мне нужно, чтобы вы рассказали мне о своих проблемных камерах, чтобы я мог использовать свою собственную машину для устранения проблемы. Для каждого запроса на отладку создавайте задачу на GitHub, чтобы мы могли отслеживать ее оттуда. Не забудьте удалить настройки общего доступа после того, как мы закончим :)
Чтобы запланировать время, воспользуйтесь этой ссылкой: https://calendly.com/fuatakgun/office-hour