eufy_security
v8.0.4
歡迎使用 Home Assistant 的 Eufy 安全整合 Alpha 版本。恭喜您成為勇敢的人並嘗試這個版本。
eufy-security-client eufy-security-ws來模仿行動應用程式和 Web 入口網站功能，並將eufy-security-ws包裝為hassio-eufy-security-ws以便我們可以將其用作家庭助理附加組件。event duration in seconds為單位）。請檢查此處：https://github.com/bropat/eufy-security-client#known-working-devices
在接下來的步驟中，您將至少安裝一個附加元件和兩個整合。
在 Home Assistant 生態系統中，如果您使用受監督或基於 HASS 作業系統的設置，則可以使用 Home Assistant 的Add-ons頁面來安裝它們。如果您使用的是 Core，或者您的設定中沒有Add-ons選項，則需要安裝 docker 並自行執行這些容器。您將在各個步驟中看到相應的命令。如果您有興趣建立 docker 容器，請查看末尾部分
此整合不是 Home Assistant Core 的一部分，因此您必須將其安裝為自訂整合。有兩種方法可以執行此操作，手動下載和複製檔案或使用 HACS（家庭助理社區商店）。我將在這裡使用 HACS 方法。
如果您打算將此整合用於視訊串流目的，並且您的相機不支援基於 RTSP（即時串流協定）的串流（相機設定中沒有連續或 NAS 錄製選項），您還需要安裝 webrtc 自訂整合其中將包括go2rtc 二進位（go2rtc 也作為獨立的附加元件存在）。這個附加元件將使我們能夠將點對點 (P2P) 位元組轉換為 RTSP 串流，以便您可以在 Home Assistant（帶或不帶 RTC）或 VLC 播放器中很好地播放它。
如果您打算將此整合用於視訊串流，並且您的相機支援 RTSP，您可能會享受可靠的串流，因為生成 RTSP 串流是硬體的責任，並且它比基於 P2P 的串流可靠得多。無需將傳入的 P2P 位元組轉換為 RTSP 流。有一些 Eufy Security 的 Android apk 的修改版本可以為不支援的裝置啟用 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 和相應的前端卡，以實現更快的串流媒體傳輸。可透過以下連結安裝有或沒有 webrtc 的 go2rtc：https://github.com/fuatakgun/WebRTC。此WebRTC是一個客製化版本，可以輕鬆管理條件卡，進一步的設定將依賴於此。
1- 如果您尚未安裝，請依照本指南安裝HACS ：https://hacs.xyz/docs/setup/download
2- 當HACS準備就緒時，在HACS整合中搜尋Eufy Security 。
3- 透過 HACS 安裝Eufy Security集成，重新啟動您的 Home Assistant 實例。
4-導覽至 Home Assistant 的Settings -> Devices & Services頁面 (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) 警告，請重新配置整合。驗證碼將顯示在重新配置頁面上，並且 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 秒後，該實體將可用。
本機 Home Assistant 串流傳輸速度相當緩慢（也許不是？），因此強烈建議您從 HACS 安裝 WebRTC 整合。
下面的程式碼將在相機未串流時顯示相機圖片，並在相機串流時顯示 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 : DOWNDebug (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 - 傳送門鈴快速回應訊息，您可以從裝置的Debug (device)感測器屬性中取得voice_id資訊。僅當攝影機即時串流（p2p - 而非 rtsp）時才能執行此操作snooze - 在給定的時間內暫停正在進行的通知。trigger_base_alarm_with_duration - 在給定持續時間內觸發站上的警報reset_alarm - 重置給定持續時間內正在進行的警報snooze - 在給定的時間內暫停正在進行的通知。arm_home - 切換到 Home 狀態arm_away - 切換到離開狀態disarm - 撤防面板alarm_arm_custom1 - 切換到自訂 1，它與您在 Eufy Security 應用程式中建立的第一個、第二個和第三個自訂防護（或模式）相關。alarm_arm_custom2 - 切換到自訂 2alarm_arm_custom3 - 切換到自訂 3geofence - 切換到地理圍欄，這可能不會影響面板的狀態，因為它將透過 Eufy 應用程式根據地理位置更改其狀態schedule - 切換到自訂 3，這可能不會影響面板的狀態，因為它將透過 Eufy 應用程式根據時間表更改其狀態chime - 在基地台上觸發鈴聲（喜歡它） - 我不知道可用鈴聲的確切列表，請自己嘗試。lock和unlockunlock將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首先，檢查所有問題（打開或關閉）以找出是否有任何類似的問題，而不是重複它。重點關注啟用推播通知設定、降低攝影機串流/錄製品質以及消除任何網路層級隔離/限制。大多數問題都可以透過這些來消除。稍後，如果您發現類似的問題，請直接+1，一遍又一遍地共享相同的日誌根本沒有幫助。最後，按照模板創建您的問題。我稍後可能會提出後續問題。
只要您按照設定說明進行操作，我就非常樂意調試個別問題。我需要您與我分享您有問題的相機，以便我可以使用我自己的機器來調試問題。對於每個偵錯請求，請建立一個 github 問題，以便我們可以從那裡進行追蹤。完成後不要忘記刪除共享設定:)
要安排時間，請使用此連結：https://calendly.com/fuatakgun/office-hour
