Selamat datang di rilis Alpha Integrasi Keamanan Eufy untuk Asisten Rumah. Selamat telah menjadi orang yang berhati berani dan mencoba versi ini.
eufy-security-ws
menggunakan eufy-security-client
untuk meniru fungsi aplikasi seluler dan portal web dan menggabungkan eufy-security-ws
sebagai hassio-eufy-security-ws
sehingga kami dapat menggunakannya sebagai Add-on Asisten Rumah.event duration in seconds
.Silakan periksa di sini: https://github.com/bropat/eufy-security-client#known-working-devices
Pada langkah selanjutnya, Anda akan menginstal setidaknya satu add-on dan dua integrasi.
Di ekosistem Home Assistant, jika Anda menggunakan pengaturan berbasis Supervised atau HASS OS, Anda dapat menggunakan halaman Add-ons
Home Assistant untuk menginstalnya. Jika Anda menjalankan Core atau tidak memiliki opsi Add-ons
di pengaturan Anda, Anda perlu menginstal buruh pelabuhan dan menjalankan sendiri container ini. Anda akan melihat perintah masing-masing di langkah masing-masing. Jika Anda tertarik untuk membuat container buruh pelabuhan Anda, silakan periksa bagian akhir
Integrasi ini bukan bagian dari Home Assistant Core jadi Anda harus menginstalnya sebagai integrasi khusus. Ada dua cara untuk melakukan ini, mengunduh dan menyalin file secara manual atau menggunakan HACS (Home Assistant Community Store). Saya akan menggunakan metode HACS di sini.
Jika Anda bermaksud menggunakan integrasi ini untuk tujuan streaming video dan jika kamera Anda tidak mendukung streaming berbasis RTSP (Real Time Streaming Protocol) (tidak ada opsi perekaman berkelanjutan atau NAS di pengaturan kamera Anda), Anda juga perlu menginstal integrasi khusus webrtc yang akan menyertakan biner go2rtc (go2rtc juga ada sebagai add-on mandiri). Add-on ini memungkinkan kami mengonversi byte peer to peer (P2P) menjadi aliran RTSP sehingga Anda dapat memutarnya dengan baik di dalam Home Assistant (dengan atau tanpa RTC) atau dengan VLC Player.
Jika Anda bermaksud menggunakan integrasi ini untuk tujuan streaming video dan jika kamera Anda mendukung RTSP, Anda mungkin akan menikmati streaming yang andal karena menghasilkan streaming RTSP adalah tanggung jawab perangkat keras dan sangat andal dibandingkan streaming berbasis P2P. Tidak perlu mengubah byte P2P yang masuk menjadi aliran RTSP. Ada beberapa versi modifikasi apk Android Eufy Security di luar sana yang dapat mengaktifkan aliran RTSP untuk perangkat yang tidak didukung tetapi saya belum mencobanya. Selain itu, secara pribadi saya tidak memiliki perangkat yang memerlukan P2P, hal ini karena, sering kali, saya tidak dapat mereplikasi masalah Anda secara lokal dan kita perlu bekerja sama untuk men-debug masalah ini.
Terakhir, kamera Anda tidak akan mulai streaming secara ajaib dengan sendirinya, Anda harus menghubungi layanan turn_on
atau turn_off
dari masing-masing entitas kamera. Jadi, saat Anda pertama kali menginstal semuanya, Anda tidak akan memiliki video apa pun sampai Anda memanggil fungsi-fungsi ini. Selain itu, streaming P2P mungkin berhenti secara acak karena masalah teknis tingkat rendah, Anda dapat memulai ulang lagi dengan turn_off
dan turn_on
. Anda dapat memicu otomatisasi pada status kamera (idle, persiapan, streaming).
Jadi mari kita mulai.
Silakan ikuti panduan dari sini: https://github.com/bropat/hassio-eufy-security-ws
Ini adalah suatu keharusan untuk streaming P2P dan bagus untuk streaming RTSP. Streaming P2P akan menggunakan go2rtc untuk menghasilkan streaming dengan alamat RTSP tertentu. Streaming RTSP akan menggunakan ini untuk streaming lebih cepat.
Ada dua cara untuk melakukan ini, menginstal add-on itu sendiri atau menginstal integrasi kustom Webrtc. Saya menyarankan Anda untuk menginstal integrasi khusus Webrtc, yang mencakup go2rtc dan masing-masing kartu front-end untuk streaming lebih cepat. Instalasi go2rtc dengan atau tanpa webrtc dapat dilakukan dengan mengikuti link ini: https://github.com/fuatakgun/WebRTC . WebRTC ini adalah versi yang disesuaikan untuk mengelola kartu bersyarat dengan mudah dan pengaturan lebih lanjut akan bergantung pada yang satu ini.
1- Jika Anda belum menginstal, instal HACS
dengan mengikuti panduan ini: https://hacs.xyz/docs/setup/download
2- Ketika HACS
sudah siap, cari Eufy Security
di dalam HACS
Integrations.
3- Instal integrasi Eufy Security
melalui HACS, mulai ulang instance Home Assistant Anda.
4- Navigasikan ke halaman Settings -> Devices & Services
Asisten Rumah (https://your-instance.duckdns.org/config/integrations). Klik Add Integration
dan cari Eufy Security
(bukan Eufy
, tepatnya Eufy Security
). Jika Anda tidak melihatnya, validasi terlebih dahulu bahwa itu diinstal melalui HACS dan Anda telah memulai ulang, kemudian coba dengan browser lain. Daftar integrasi mungkin sudah disimpan dalam cache di browser Anda.
5- Masukkan Eufy Security Add-on IP Address
(127.0.0.1 untuk instalasi yang Diawasi) dan configured port
(default 3000) dan klik Kirim.
6- Anda mungkin menerima peringatan Captcha atau Otentikasi Multi Faktor (MFA), harap Konfigurasi ulang integrasinya. Kode Captcha akan terlihat di halaman Konfigurasi Ulang dan Kode MFA akan dikirimkan melalui email atau SMS kepada Anda. Silakan masukkan nilai-nilai ini. Setelah ini, Anda mungkin perlu memulai ulang instance Home Assistant Anda.
7- Jika Anda telah menginstal webrtc custom integration with go2rtc or standalone go2rtc Add-On
, masukkan IP Address
-nya ke halaman Konfigurasi Integrasi. Anda dapat memasukkan 127.0.0.1
untuk instalasi yang diawasi.
8- Anda juga dapat mengonfigurasi Cloud Scan Interval
, Durasi Analisis Video, Custom Name 1
, Custom Name 2
dan Custom Name 3
Catatan: Nama Kustom 1, Nama Kustom 2, dan Nama Kustom 3 adalah label yang digunakan untuk mewakili penjaga (mode) khusus pertama, kedua, dan ketiga yang Anda buat di aplikasi Eufy Security. Anda dapat memicu penjaga khusus Anda menggunakan kartu panel alarm bawaan seperti:
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
Misalnya, Anda membuat mode "waktu tidur" di aplikasi Eufy Security, secara default tidak ada cara untuk memicunya menggunakan kartu panel alarm. Namun, dengan menggunakan integrasi ini, Anda dapat memanggil layanan arm_custom_bypass
dari panel alarm, yang akan mengaktifkan mode "waktu tidur" Anda. Anda dapat menyesuaikan nama tampilan mode ini menggunakan Langkah 8 di atas.
Layanan panel alarm bawaan ini tidak sesuai dengan pelindung Eufy default mana pun, sehingga layanan ini dirancang ulang untuk memberikan fleksibilitas lebih lanjut guna memicu mode keamanan khusus menggunakan integrasi ini. Lihat pembahasan di #145 untuk lebih jelasnya.
9- Aktifkan entitas diagnostik yang dinonaktifkan secara default. Setelah instalasi, beberapa entitas dinonaktifkan untuk menghindari pembuatan data dalam jumlah terlalu besar. Ini adalah perilaku yang diharapkan. Jika menurut Anda entitas mana pun penting, aktifkan saja. Untuk melakukan ini pilih salah satu perangkat dalam integrasi eufy_security. Kemudian gulir ke bawah ke bagian Diagnostik dan pilih salah satu entitas. Di bagian atas, buka pengaturan dan aktifkan parameter Enabled
dan Visible
di pengaturan. Setelah sekitar 30 detik, entitas ini akan tersedia.
Streaming Native Home Assistant cukup lambat (mungkin tidak?), jadi Anda sangat disarankan untuk menginstal integrasi WebRTC dari HACS.
Kode di bawah ini akan menampilkan gambar kamera saat kamera tidak streaming dan kartu webrtc saat kamera streaming (kartu bersyarat). Silakan ganti camera.entrance
dengan nama entitas kamera Anda.
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
Jika kamera Anda mendukung geser dan miring, Anda dapat menambahkan perintah masing-masing ke antarmuka 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)
dan Debug (station)
Anda sehingga saya dapat mengekstrak sensor ini. Jika sensor ini tidak dapat diambil dari status perangkat, harap sebutkan secara eksplisit.button
, switch
, dan select
entitas, silakan gunakan.turn_on
dan turn_off
- Integrasi akan memeriksa apakah perangkat Anda mendukung streaming berbasis RTSP dan fallback P2Pstart_rtsp_livestream
dan stop_rtsp_livestream
- Streaming akan dimulai menggunakan RTSP jika perangkat Anda mendukungnyastart_p2p_livestream
dan stop_p2p_livestream
- Streaming akan dimulai menggunakan P2P, semua perangkat berfungsi di sinigenerate_image
- Ini akan menghasilkan thumbnail untuk Home Assistant jika kamera sudah streamingptz_up
, ptz_down
, ptz_right
, ptz_left
, ptz_360
- Perintah Geser dan Miringtrigger_camera_alarm_with_duration
- Memicu alarm pada kamera selama durasi tertentuquick_response
- Kirim pesan respons cepat untuk bel pintu, Anda bisa mendapatkan informasi voice_id
dari atribut sensor Debug (device)
perangkat. Ini HANYA dapat dijalankan saat kamera sedang streaming langsung (p2p - bukan rtsp)snooze
- Menunda notifikasi yang sedang berlangsung selama durasi tertentu.trigger_base_alarm_with_duration
- Memicu alarm di stasiun untuk durasi tertentureset_alarm
- Menyetel ulang alarm yang sedang berlangsung selama durasi tertentusnooze
- Menunda notifikasi yang sedang berlangsung selama durasi tertentu.arm_home
- Beralih ke status Berandaarm_away
- Beralih ke status Jauhdisarm
- Melucuti panelalarm_arm_custom1
- Beralih ke kustom 1, yang terkait dengan penjaga (atau mode) khusus pertama, kedua, dan ketiga yang Anda buat di aplikasi Eufy Security.alarm_arm_custom2
- Beralih ke kustom 2alarm_arm_custom3
- Beralih ke kustom 3geofence
- Beralih ke geofencing, ini mungkin tidak memengaruhi status panel karena panel akan mengubah statusnya berdasarkan lokasi geografis melalui aplikasi Eufyschedule
- Beralih ke kustom 3, ini mungkin tidak memengaruhi status panel karena statusnya akan berubah berdasarkan jadwal melalui aplikasi Eufychime
- Memicu suara berpadu di stasiun pangkalan (menyukainya) - Saya tidak tahu persis daftar nada dering yang tersedia, cobalah sendiri.lock
dan unlock
untuk kunciunlock
dengan kode untuk brankas Ganti camera.entrance
dengan nama entitas Anda sendiri.
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
Kondisi pemicu ini memulai otomatisasi tepat ketika gambar peristiwa diperbarui. Dalam beberapa instalasi, ini lebih dapat diandalkan dan sedikit lebih cepat. Jika otomatisasi sebelumnya memberikan gambar yang ketinggalan jaman atau menyebabkan masalah, cobalah pemicu dan kondisi yang berbeda ini:
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
Pertama, periksa semua masalah (terbuka atau tertutup) untuk mengetahui apakah ada pertanyaan serupa daripada menduplikasinya. Fokus pada mengaktifkan pengaturan pemberitahuan push, menurunkan kualitas streaming/perekaman kamera, dan menghapus isolasi/pembatasan tingkat jaringan apa pun. Sebagian besar permasalahan dapat diatasi melalui hal ini. Nanti, jika Anda menemukan masalah serupa, harap beri +1 saja, berbagi log yang sama berulang kali tidak membantu sama sekali. Terakhir, buat masalah Anda dengan mengikuti templat. Saya mungkin akan menanyakan pertanyaan lanjutan nanti.
Saya dengan senang hati akan men-debug setiap masalah selama Anda mengikuti petunjuk penyiapan. Saya ingin Anda membagikan kamera Anda yang bermasalah kepada saya sehingga saya dapat menggunakan mesin saya sendiri untuk men-debug masalah tersebut. Untuk setiap permintaan debugging, harap buat masalah github sehingga kami dapat melacaknya dari sana. Jangan lupa untuk menghapus pengaturan berbagi setelah kita selesai :)
Untuk menjadwalkan waktunya, silakan gunakan tautan ini: https://calendly.com/fuatakgun/office-hour