Сохраняет текущую позицию PTZ в пресет

• name Обязательный: Имя пресета. Не может быть пустым или числом

Удаляет пресет

• preset Обязательный: ID пресета PTZ или имя. См. возможные пресеты в атрибутах сущности

Эта интеграция предоставляет 4 различные сущности камеры:

• HD Stream
• SD Stream
• HD Stream (Direct)
• SD Stream (Direct)

Прямые потоки используют проприетарный потоковый протокол TP-Link. Непрямые используют стандартный протокол RTSP.

Зачем использовать прямые потоки?

1. Если у вас устройство без функции RTSP, это единственный способ. Сюда входят устройства на батареях, солнечные устройства, а также устройства, работающие через хаб.
2. Если вы израсходовали все свои RTSP-потоки и/или ваши RTSP-потоки нестабильны в Home Assistant.
3. Прямые потоки чрезвычайно быстро загружаются и имеют задержку менее половины секунды* (*убедитесь, что вы ОТКЛЮЧИЛИ Use Stream from Home Assistant (restart required) в опциях интеграции для максимально быстрой работы). Под капотом новые потоки представляют собой бинарный поток данных "напрямую в ваш браузер", без лишних преобразований и накладных расходов.

Почему не использовать прямые потоки?

Если у вас есть возможность использовать RTSP, рекомендуется придерживаться RTSP-потоков.

1. Прямые потоки требуют немного больше ресурсов ЦП, поскольку устройство, на котором работает эта интеграция, теперь обрабатывает бинарный поток напрямую, вместо того чтобы камера предоставляла стандартизированный RTSP-поток.
2. Прямые потоки нельзя использовать с webrtc карточкой или go2rtc.
3. RTSP-потоки очень быстрые и почти без задержки с помощью webrtc карточки камеры Home Assistant

Датчик движения добавляется только после первого обнаружения движения.

Для него также требуется поддержка ONVIF на устройстве. Если устройство не предоставляет интерфейс Onvif (скорее всего, если оно работает от батареи или от солнца), события движения работать не будут.

• Убедитесь, что на камере включено обнаружение движения
• Убедитесь, что на камере выключен режим конфиденциальности
• Убедитесь, что камера видит вас и ваши движения
• Если у вас включены вебхуки и ваш внутренний URL Home Assistant доступен по HTTP, убедитесь, что камера может до него достучаться.
• Убедитесь, что у вас указан правильный IP для Home Assistant. Включите Advanced Mode в /profile. Перейдите в /config/network и в разделе Network Adapter проверьте, что для устройства указан правильный IP. Если он неверный, в разделе Home Assistant URL снимите флажок Automatic рядом с Local Network и укажите http://<some IP address>:8123. НЕ ИСПОЛЬЗУЙТЕ HTTPS.
• Некоторые прошивки камер имеют сломанный pullpoint, работают только вебхуки. Если вы не можете запустить вебхуки из-за вышеперечисленного (https или vlan конфигурация), бинарный сенсор никогда не появится.
• Попробуйте пройти перед камерой
• Если вышеуказанное не помогло, перезапустите камеру и попробуйте снова

Также убедитесь, что:

• бинарный сенсор не отключён через сущность, проверьте .storage/core.entity_registry на наличие отключённых сущностей, ищите "disabled_by": "user" на платформе "tapo_control". Если он отключён, удалите всю сущность или измените на "disabled_by": null и перезапустите HASS.

Это известная проблема Home Assistant.

Существует возможность отключить использование компонента Stream Home Assistant для камеры, что может значительно снизить задержку ценой более высокой нагрузки на ЦП.

Вы можете отключить компонент stream при добавлении камеры или через Options, если камера уже добавлена. Это изменение требует перезапуска Home Assistant.

У этого могут быть некоторые недостатки, например потеря возможности управления воспроизведением и более высокая нагрузка на ЦП. Результаты зависят от вашего оборудования и будущих обновлений Home Assistant.

Если вы отключите stream и ваше оборудование не справится, вы получите артефакты, большую задержку и зависания.

При желании попробуйте и посмотрите, что лучше всего подходит вам.

Ещё одна возможность — использование WebRTC Camera by AlexxIT.

Пример рабочей конфигурации:``` type: custom:webrtc-camera entity: camera.bedroom_hd

</details>

<details>
  <summary>Нет звука в потоке с камеры</summary>

Поддерживаемые аудиокодеки в Home Assistant: "aac", "ac3" и "mp3".

Камеры Tapo используют PCM ALAW (alaw), который не поддерживается.

[Подробнее здесь.](https://github.com/JurajNyiri/HomeAssistant-Tapo-Control/issues/58#issuecomment-762787442)

**Вы можете добиться работы звука с помощью [WebRTC Camera от AlexxIT](https://github.com/AlexxIT/WebRTC).**

Пример рабочей конфигурации:```
type: custom:webrtc-camera
entity: camera.bedroom_hd

Возможно, вы вводите неправильный пароль или столкнулись с ограничением камеры.

• Проверьте журналы на наличие сообщений об ошибках
• Проверьте, что HA может подключиться к камере на портах 554 и 2020

Наконец, наиболее вероятная причина — см. официальную документацию Tapo

Q3: Могут ли несколько учётных записей/устройств одновременно просматривать камеру Tapo?

A: В настоящее время каждой камерой может управлять только одна учётная запись в приложении Tapo. Вы можете предоставить доступ к ней не более чем 5 различным учётным записям, и эти две учётные записи могут получать доступ только к функциям просмотра в реальном времени и воспроизведения записей камеры.

Каждая камера также поддерживает до 2 одновременных видеопотоков. Вы можете использовать до 2 устройств для одновременного просмотра прямой трансляции камеры через приложение Tapo или через RTSP. Воспроизведение записей камеры можно просматривать только через одно приложение Tapo за раз.

А также:

Q4: Почему я не могу одновременно использовать Tapo Care, SD-карту и NVR?

A: Из-за ограниченной производительности аппаратного обеспечения самой камеры Tapo Care лучше всего работает с одним из режимов записи — NVR или SD-карта.

Если вы одновременно используете SD-карту и Tapo Care, NVR (RTSP/ONVIF) будет отключён.

Чтобы возобновить запись на NVR, пожалуйста, извлеките SD-карту из камеры.

1. Убедитесь, что в официальном приложении Tapo на вашем смартфоне включён параметр Third Party Compatibility. Tapo App -> Me -> Tapo Lab -> Third-Party Compatibility -> On
2. Убедитесь, что «Двухэтапная проверка» (Two-Step Verification) для входа отключена. Откройте приложение Tapo > Me > View Account > Login Security > выключите «Двухэтапную проверку».
3. Сбросьте пароль.
4. Убедитесь, что камера имеет доступ к интернету.
5. Перезагрузите камеру несколько раз.
6. Сбросьте камеру. Удалите её из своей учётной записи, выполните сброс к заводским настройкам, добавьте её обратно с доступом в интернет, затем снова добавьте в интеграцию.
7. Попробуйте выключить и снова включить Third-Party Compatibility и открыть камеру через приложение Tapo.
8. Если всё это не помогло (что маловероятно), повторите с шага 1, подождите несколько часов и попробуйте ещё раз.

Пользователи сообщили о полной функциональности со следующими камерами, дверными звонками и чимами Tapo:

• TC55
• TC60
• TC70
• TC85
• C100
• C110
• C120
• C200
• C210
• C211
• C220
• C225
• C310
• C320WS
• C410
• C420
• C420S2
• C500
• C510W
• C520WS
• C530WS
• C720
• D100C
• D230
• D235

Интеграция должна работать с любыми другими устройствами на основе камер Tapo и чимами.

Если у вас всё успешно заработало с какой-либо другой моделью, пожалуйста, сообщите об этом, создав новую issue.

Примечание: Если устройство не предоставляет интерфейс ONVIF (скорее всего, если оно питается от батареи или солнечной панели), события движения работать не будут.

Камера использует стандарт ONVIF для передачи событий движения. Такая связь может работать двумя способами:

1. Pullpoint: клиент открывает соединение с камерой и ждёт, пока камера ответит. Камера отвечает только тогда, когда есть событие, которое нужно передать. После ответа камеры клиент заново открывает соединение и снова ждёт.
2. Webhook: клиент сообщает камере свой URL для получения событий. Когда происходит событие, камера передаёт его на URL, указанный клиентом.

Вебхуки являются предпочтительным методом связи, поскольку они быстрее и легче. Тем не менее:

• Вебхуки требуют настройки HA только по HTTP, поскольку камеры Tapo не поддерживают HTTPS-вебхуки.
• Вебхуки требуют, чтобы в HA был определён корректный base_url, чтобы передаваемый URL был правильным (вы можете проверить отправляемый URL, включив журналы отладки для homeassistant.onvif).

Указанные выше пункты автоматически определяются этой интеграцией, и если HA не соответствует критериям, вебхуки отключаются. Тем не менее:

• Существуют камеры (и/или прошивки), которые зависают, когда одновременно создаются и вебхук, и pullpoint-соединение; это происходит в начале, чтобы проверить, поддерживаются ли вебхуки вообще, чтобы затем можно было вернуться к pullpoint.
• Существуют прошивки камер, в которых pullpoint не работает (1.3.6 C200), и работают только вебхуки.

Для работы вебхуков пользователю нужно лишь убедиться, что он использует HA по HTTP и что HA доступен по передаваемому URL.

Да, интеграция бесплатна и не требует платных подписок. Она также полностью локальна и не требует доступа в интернет ни от камеры, ни от самой интеграции.

Прошивки камер ожидают сообщения в последовательном порядке. Отправка их параллельно может привести к коду 401 от камеры, который отображается у нас этим исключением.

Вместо этого вам нужно отправлять действия автоматизации последовательно, возможно, также с задержкой, если это необходимо.

См. https://github.com/JurajNyiri/HomeAssistant-Tapo-Control/issues/488 для получения дополнительной информации.

Из-за неизвестной первопричины некоторые камеры ведут себя иначе, чем другие, при установке времени через стандарт ONVIF, и до сих пор первопричина не найдена.

Установка времени невозможна через официальное приложение, и эта интеграция использует недокументированную и неподдерживаемую функциональность камеры через стандарт ONVIF.

Если время установлено неверно, например, на 1 час вперёд:

1. Убедитесь, что правильный часовой пояс установлен и для Home Assistant, и для устройства.
2. Если проблема остаётся, перейдите в /config/integrations/integration/tapo_control.
3. Нажмите «Настроить» (Configure) под устройством, для которого вы хотите синхронизировать время.
4. Выберите Configure time synchronization, нажмите Submit.
5. Отрегулируйте смещение времени либо на период перехода на летнее время (DST), либо вне DST.