WebRTC
v3.6.0 - 2024-10-12
Komponen khusus Asisten Rumah untuk melihat hampir semua aliran kamera secara real-time menggunakan WebRTC dan teknologi lainnya.
Mulai versi 3 server streaming telah diubah dari RTSPtoWebRTC menjadi go2rtc.
pergi2rtc
Instalasi
Konfigurasi
Kartu khusus
Templat
Audio dua arah
Jepretan ke Telegram
Transmisikan atau bagikan streaming
Streaming ke kamera
Pertanyaan Umum
Men-debug
Kamera kerja yang dikenal
Komponen ini menggunakan aplikasi go2rtc sebagai server streaming:
latensi streaming serendah mungkin untuk banyak protokol yang didukung
streaming dari RTSP, RTMP, HTTP (FLV/MJPEG/JPEG), kamera HomeKit, kamera USB, dan sumber lainnya
streaming ke RTSP, WebRTC, MSE/MP4 atau MJPEG
mendukung codec populer H264/H265, AAC, PCMU/PCMA, OPUS
transcoding on-the-fly untuk codec yang tidak didukung melalui FFmpeg
pilih otomatis teknologi streaming berdasarkan codec streaming, kemampuan browser, konfigurasi jaringan
Baca selengkapnya di dokumen go2rtc!
Anda dapat menginstal go2rtc dengan beberapa cara:
Pengguna dasar - komponen ini akan secara otomatis mengunduh dan menjalankan go2rtc versi terbaru, Anda tidak perlu melakukan apa pun sendiri.
Pengguna tingkat lanjut - instal add-on go2rtc atau Frigate 12+.
Peretas - instal go2rtc sebagai biner atau Docker di server mana pun di LAN.
Anda dapat mengubah pengaturan go2rtc dengan menambahkan file go2rtc.yaml ke folder konfigurasi Hass Anda.
Penting. go2rtc menjalankan antarmuka webnya sendiri pada port 1984 tanpa kata sandi. Di sana Anda dapat melihat daftar aliran kamera aktif. Siapa pun di LAN Anda dapat mengaksesnya tanpa kata sandi . Anda dapat menonaktifkan ini di konfigurasi go2rtc.
PS. Ada juga kartu bagus lainnya dengan dukungan go2rtc - Frigate Lovelace Card.
Metode 1. HACS > Integrasi > Plus > WebRTC > Instal
Metode 2. Salin folder webrtc secara manual dari rilis terbaru ke folder /config/custom_components .
custom_card akan otomatis didaftarkan ke UI Home Assistant, kecuali saat Anda mengelola UI dalam mode YAML. Jika Anda mengelola UI dalam mode YAML, tambahkan ini ke sumber daya UI Anda agar kartu custom:webrtc-camera berfungsi:
url: /webrtc/webrtc-camera.jstype: modul
Segarkan browser Anda
Pengaturan > Perangkat & Layanan > Tambahkan Integrasi > WebRTC
Jika integrasi tidak ada dalam daftar, Anda perlu menghapus cache browser.
Komponen tidak membuat perangkat dan entitas . Ini hanya menciptakan dua layanan dan kartu khusus lovelace.
Sebagai url Anda dapat menggunakan:
protokol apa pun yang didukung oleh go2rtc ( rtsp , rtmp , http , onvif , dvrip , homekit , roborock , dll.)
name aliran dari konfigurasi go2rtc
Templat Jinja2 (harus merender protokol atau name aliran yang didukung)
Sebagai entity Anda dapat menggunakan hampir semua kamera dari Hass.
Sebagai poster Anda dapat menggunakan:
http -link (tautan harus tersedia untuk umum)
entity kamera dari Hass
name aliran dari konfigurasi go2rtc
Templat Jinja2 (harus merender entity kamera atau name aliran)
Minimal
ketik: 'custom:webrtc-camera'url: 'rtsp://rtsp:[email protected]:554/av_stream/ch0'
atau
ketik: 'custom:webrtc-camera'url: 'camera1' # nama streaming dari go2rtc.yaml
atau
ketik: 'custom:webrtc-camera'entity: camera.generic_stream # ubah ke entitas_id kamera Anda
atau
ketik: 'kustom:webrtc-kamera'aliran: - url: go2rtc_stream_hdname: HD # nama bersifat opsionalmode: webrtc # mode bersifat opsionalmedia: video # media bersifat opsional - url: go2rtc_stream_sdname: SDmode: msemedia: audio
PS. Anda dapat mengubah aliran aktif dengan mengklik label mode . Atau dengan mengeklik name aliran dengan ui: true .
Penuh
Semua pengaturan bersifat opsional! Hanya pengaturan yang diperlukan - url atau entity atau streams .
ketik: 'custom:webrtc-camera'url: 'rtsp://rtsp:[email protected]:554/av_stream/ch0'entity: camera.generic_streammode: webrtc,webrtc/tcp,mse,hls,mjpeg # teknologi streaming , default semuanya media: video, audio # pilih hanya video atau trek audio, default keduanya server: http://192.168.1.123:1984/ # alamat server go2rtc khusus, default kosong: benar # kontrol video khusus, default falsedigital_ptz: # zoom digital dan geser melalui mouse/sentuh, default: mouse_drag_pan: benar mouse_wheel_zoom: benar mouse_double_click_zoom: benar touch_drag_pan: benar touch_pinch_zoom: benar touch_tap_drag_zoom: benar persist: true # faktor zoom dan posisi viewport bertahan saat memuat ulang halaman# digital_ptz: false # untuk menonaktifkan semua zoom digital mouse/sentuh dan pantitle: Kamera super saya # poster judul kartu opsional: https://home-assistant.io/images/cast/ splash.png # gambar diam ketika streaming sedang dimuat dibisukan: benar # status peralihan senyap awal, defaultnya adalah salah (dinyalakan) persimpangan: 0,75 # streaming otomatis berhenti ketika kurang dari 75% elemen video ada di layar, 50% secara defaultlatar belakang: benar # jalankan streaming saat tidak ditampilkan (mis. untuk memuat video cepat), pintasan palsu default: # pintasan khusus, tidak ada default- nama: Rekam ikon: mdi:record-circle-outline layanan: switch.toggle service_data:entity_id: switch.camera_record
Kontrol geser, miringkan, zoom: Contoh konfigurasi PTZ.
Dijeda secara default
ketik: custom:webrtc-cameraposter: dahua1-snap # nama streaming dari go2rtc.yaml (http-snapshot)stream: - url: '' #url kosong, jadi yang ditampilkan hanya poster - url: dahua1 # nama streaming dari go2rtc.yaml (rtsp-stream)
Masalah rasio aspek video
gaya: "video {rasio aspek: 16/9; kesesuaian objek: isi;}"Rotasi video
Pada klien (CPU gratis):
gaya: 'video {transformasi: putar (90 derajat); rasio aspek: 1}'Di server - transcoding FFmpeg (biaya CPU tinggi)
Sembunyikan label mode
gaya: '.mode {tampilan: tidak ada}'Sembunyikan tombol layar penuh
gaya: '.layar penuh {display: tidak ada}'Sembunyikan tombol tangkapan layar
gaya: '.tangkapan layar {display: tidak ada}'Sembunyikan tombol PIP
gaya: '.pictureinpicture {display: tidak ada}'Posisi jalan pintas
style: ".shortcuts {kiri: tidak disetel; atas: 25 piksel; kanan: 5 piksel; tampilan: fleksibel; arah fleksibel: kolom}"posisi PTZ
gaya: ".ptz {kanan: tidak disetel; kiri: 10px}"Posisi label mode
gaya: '.header {bawah: 6px} .mode {posisi: absolut; bawah: 0px}'Posisi garis header
gaya: '.header {atas: tidak disetel; bawah: 6px}'Baru di v3.6.0.
shortcuts opsi kartu, style , dan ptz mendukung templat JavaScript
Dalam shortcuts dan style Anda dapat menggunakan templat terkait states
Di ptz Anda dapat menggunakan templat terkait streamName / streamID (berguna untuk kartu dengan banyak templat)
jalan pintas:
- nama: Barn Lighticon: ${ menyatakan['light.yeelight_lamp'].state === 'on' ? 'mdi:outdoor-lamp':'mdi:lamp' }layanan: light.toggleservice_data: entitas_id: light.yeelight_lamp ptz: layanan: notify.persistent_notification
data_left:message: Tersisa untuk ${ this.streamName } diklik
data_right:message: Hak untuk ${ this.streamID } diklikBaru di v3.4.0.
Hanya untuk sumber yang didukung di go2rtc
Hanya untuk Hass dengan akses HTTPS, batasan ini berasal dari browser
Hanya untuk mode WebRTC
HTTPS juga penting untuk Aplikasi Seluler Hass!
Anda harus menambahkan microphone ke parameter media . Anda dapat menggunakan dua aliran: satu dengan mikrofon, kedua tanpa:
ketik: 'kustom:webrtc-kamera'aliran: - url: go2rtc_stream - url: go2rtc_streammode: webrtcmedia: video,audio,mikrofon
PS. Untuk Aplikasi Seluler Hass, pastikan Anda dapat menggunakan mikrofon dengan Bantuan bawaan.
Baca selengkapnya
Komponen mendukung streaming ke perangkat Google Cast Chromecast (termasuk Android TV dan Google Smart Screen). Baca lebih lanjut di wiki.
Juga dukungan komponen membuat tautan sementara atau permanen ke aliran tanpa membagikan akses ke Asisten Rumah Anda. Baca lebih lanjut di wiki.
Baru di v3.1.0.
dukungan go2rtc memutar file audio (mis. musik atau TTS) dan streaming langsung (mis. radio) pada kamera dengan dukungan audio dua arah. Anda perlu:
Periksa apakah kamera Anda mendukung sumber audio dua arah
Siapkan aliran kamera di konfigurasi go2rtc.yaml
Periksa codec audio yang didukung kamera Anda
Buat Pemutar Media virtual untuk kamera Anda di configuration.yaml :
pemutar_media: - platform: nama webrtc: Dahua Camerastream: dahuaaudio: pcmu/48000 - platform: nama webrtc: Tapo Camerastream: tapoaudio: pcma
T. Akses eksternal dengan WebRTC tidak berfungsi
A. Baca lebih lanjut dan jangan membuat isu baru.
T. Audio tidak berfungsi
A. Periksa codec audio apa yang dihasilkan kamera Anda. Dan teknologi apa yang Anda gunakan untuk menonton video. Teknologi yang berbeda mendukung codec yang berbeda.
Tambahkan ke configuration.yaml Anda:
logger: default: peringatan logs:custom_components.webrtc: debug
| Merek | Model | Komentar |
|---|---|---|
| Kamera Aktif | AC-D2121IR3 | |
| Kamera Aktif | AC-D7121IR1W | suara pendukung |
| Android | IP Kamera Web Pro | suara pendukung, rtsp://192.168.1.123:8080/h264_ulaw.sdp |
| C-tronic | CTIPC-690C | dukungan suara, utama : rtsp://username:[email protected]:554/11 atau onvif://username:[email protected]:8080?subtype=MainStreamProfileToken |
| Dahua | DH-IPC-HDPW1431FP-AS-0280B, VTO2211G-P | suara pendukung |
| Dahua | VTO2202F-P-S2 | Baca selengkapnya |
| EZVIZ | C3S | rtsp://admin:[email protected]:554/h264/ch01/main/av_stream dan /h264/ch01/sub/av_stream |
| EZVIZ | C3W, C3WN, C6CN, C6T | rtsp://admin:[email protected]:554/h264_stream |
| EZVIZ | C8C | rtsp://admin:[email protected]:554/channel80 |
| kamera fos | C1 | rtsp://user:[email protected]:554/videoMain |
| kamera fos | C2M, R2M | rtsp://user:[email protected]:88/videoMain |
| Keamanan GW | GW5088IP | rtsp://192.168.1.123:554/mpeg4cif?username=admin&password=123456 |
| Keamanan GW | GW5078IP | rtsp://192.168.1.123:554/stream0?username=admin&password=123456 |
| Keamanan GW | GW5071IP | Belum berfungsi, sesuatu yang mirip dengan rtsp://admin:[email protected]:554/live/main atau rtsp://192.168.0.207:554/live/main?username=admin&password=123456 |
| Hikvision | DS-2CD2T47G1-L, DS-2CD1321-I, DS-2CD2143G0-IS | rtsp://user:[email protected]:554/ISAPI/Streaming/Channels/102 |
| Hikvision | IPC-HDW3849H-AS-PV, IPC-EW5531-AS | dikabelkan ke nvr DHI-NVR2108HS-8P-I menggunakan komponen khusus |
| aku | IPC-F42-B2E3 (Peluru 2C 4MP) | rtsp://admin:[email protected]:554/cam/realmonitor?channel=1&subtype=0 |
| QNAP | QUSBCam2 | rtsp://username:[email protected]:554/channel1 dokumen |
| Raspberry Pi | Gambar | Baca selengkapnya |
| Tautan ulang | RLC-410, RLC-410W, RLC-510WA, E1 Pro, E1 Zoom, 4505MP | RLC-510WA mendukung suara, E1 Zoom mendukung suara, PTZ dan zoom |
| Tautan ulang | E1 | rtsp://admin:[email protected]:554/h264Preview_01_main |
| Sonoff | GK-200MP2-B | mendukung suara dan PTZ, rtsp://rtsp:[email protected]:554/av_stream/ch0 dan /av_stream/ch1 |
| SriHome | SH035 | rtsp://192.168.xxx.xxx:8554/profile0 dan /profile1 dan /profile2 |
| Topvico | rtsp://192.168.1.123:8554/stream0 atau rtsp://192.168.1.123:554/ch0_0.264 | |
| TP-Link | Tapo C100/C200/C210/C220/C310 | rtsp://user:[email protected]:554/stream1 dan /stream2 |
| TVT/Secutech | NVR-0808B2-8P | rtsp://user:[email protected]:554/chID=1&streamType=main dan chID=2&streamType=main |
| TVT/Secutech | IPC5-DF28SN | rtsp://user:[email protected]:554/profile1 dan /profile2 |
| menyatukan | G4 Dome, bel pintu G4, Peluru G3, G3 Flex | Salin tautan rtsps dari pengaturan kamera di Unifi Protect, tetapi ubah tautan menjadi rstp:// (defaultnya adalah rstps://), ubah port menjadi 7447 , dan hapus parameter kueri apa pun |
| Wyze | Kamera v2/v3, Kamera Pan v1/v2 | suara pendukung |
| Xiaomi | Dafang | dengan retas, rtsp://192.168.1.123:8554/unicastVideo: H264, ukuran: 1920x1080, kecepatan bit: 1000, format: VBR, kecepatan bingkai: 10 Audio: PCMU, laju masuk: 8000, laju keluar: 44100 |
| Yale | SV-4CFDVR-2 | rtsp://admin:[email protected]/cam/realmonitor?channel=1&subtype=0 |
| Yi | Chipset Hi3518e | dengan retas |
| Yi | Chipset MStar Tak Terbatas | dengan retas |
