WebRTC
v3.6.0 - 2024-10-12
WebRTC 및 기타 기술을 사용하여 거의 모든 카메라 스트림을 실시간으로 볼 수 있는 홈어시스턴트 사용자 정의 구성 요소입니다.
버전 3부터 스트리밍 서버가 RTSPtoWebRTC에서 go2rtc로 변경되었습니다.
go2rtc
설치
구성
맞춤 카드
템플릿
양방향 오디오
텔레그램에 대한 스냅샷
스트림 전송 또는 공유
카메라로 스트리밍
FAQ
디버그
알려진 업무용 카메라
이 구성 요소는 go2rtc 애플리케이션을 스트리밍 서버로 사용합니다.
지원되는 많은 프로토콜에 대해 가능한 가장 낮은 스트리밍 대기 시간
RTSP, RTMP, HTTP(FLV/MJPEG/JPEG), HomeKit 카메라, USB 카메라 및 기타 소스에서 스트리밍
RTSP, WebRTC, MSE/MP4 또는 MJPEG로 스트리밍
널리 사용되는 코덱 H264/H265, AAC, PCMU/PCMA, OPUS 지원
FFmpeg를 통해 지원되지 않는 코덱에 대한 즉석 트랜스코딩
스트림 코덱, 브라우저 기능, 네트워크 구성을 기반으로 스트리밍 기술 자동 선택
go2rtc 문서에서 자세한 내용을 읽어보세요!
여러 가지 방법으로 go2rtc를 설치할 수 있습니다.
기본 사용자 - 이 구성 요소는 최신 버전의 go2rtc를 자동으로 다운로드하고 실행하므로 직접 아무것도 할 필요가 없습니다.
고급 사용자 - go2rtc 또는 Frigate 12+ 추가 기능을 설치하세요.
Hakers - LAN의 모든 서버에 go2rtc를 바이너리 또는 Docker로 설치합니다.
Hass 구성 폴더에 go2rtc.yaml 파일을 추가하여 go2rtc 설정을 변경할 수 있습니다.
중요한. go2rtc는 비밀번호 없이 포트 1984 에서 자체 웹 인터페이스를 실행합니다. 여기에서 활성 카메라 스트림 목록을 볼 수 있습니다. LAN에 있는 사람은 누구나 비밀번호 없이 액세스 할 수 있습니다. go2rtc 구성에서 이를 비활성화할 수 있습니다.
추신. go2rtc를 지원하는 또 다른 멋진 카드인 Frigate Lovelace Card도 있습니다.
방법 1. HACS > 통합 > Plus > WebRTC > 설치
방법 2. 최신 릴리스의 webrtc 폴더를 /config/custom_components 폴더에 수동으로 복사합니다.
custom_card YAML 모드에서 UI를 관리하는 경우를 제외하고 홈어시스턴트 UI에 자동으로 등록됩니다. YAML 모드에서 UI를 관리하는 경우 custom:webrtc-camera 카드가 작동하도록 UI 리소스에 다음을 추가합니다.
URL: /webrtc/webrtc-camera.js유형: 모듈
브라우저 새로 고침
설정 > 장치 및 서비스 > 통합 추가 > WebRTC
통합이 목록에 없으면 브라우저 캐시를 지워야 합니다.
구성 요소는 장치 및 엔터티를 생성하지 않습니다 . 단 두 가지 서비스와 러브레이스 커스텀 카드를 생성합니다.
url 로 다음을 사용할 수 있습니다.
go2rtc에서 지원하는 모든 프로토콜( rtsp , rtmp , http , onvif , dvrip , homekit , roborock 등)
go2rtc 구성의 스트림 name
Jinja2 템플릿(지원되는 프로토콜 또는 스트림 name 렌더링해야 함)
entity 로서 Hass의 거의 모든 카메라를 사용할 수 있습니다.
poster 로 다음을 사용할 수 있습니다.
http -link(공개적으로 사용 가능한 링크여야 함)
Hass의 카메라 entity
go2rtc 구성의 스트림 name
Jinja2 템플릿(카메라 entity 또는 스트림 name 렌더링해야 함)
최소
유형: 'custom:webrtc-camera'url: 'rtsp://rtsp:[email protected]:554/av_stream/ch0'
또는
유형: 'custom:webrtc-camera'url: 'camera1' # go2rtc.yaml의 스트림 이름
또는
유형: 'custom:webrtc-camera'entity: Camera.generic_stream # 카메라 엔터티_ID로 변경
또는
유형: 'custom:webrtc-camera'스트림: - url: go2rtc_stream_hdname: HD # 이름은 선택 사항mode: webrtc # 모드는 선택 사항media: video # 미디어는 선택 사항 - URL: go2rtc_stream_sdname: SDmode: msemedia: 오디오
추신. mode 라벨을 클릭하여 활성 스트림을 변경할 수 있습니다. 또는 활성화된 ui: true 로 스트림 name 클릭합니다.
가득한
모든 설정은 선택사항입니다! 필수 설정만 - url , entity 또는 streams .
유형: 'custom:webrtc-camera'url: 'rtsp://rtsp:[email protected]:554/av_stream/ch0'entity: Camera.generic_streammode: webrtc,webrtc/tcp,mse,hls,mjpeg # 스트림 기술 , 기본값은 모두media: video,audio # 비디오 또는 오디오 트랙만 선택, 기본값은 모두server: http://192.168.1.123:1984/ # 사용자 정의 go2rtc 서버 주소, 기본값 비어 있음: true # 사용자 정의 비디오 제어, 기본값 falsedigital_ptz: # 마우스/터치를 통한 디지털 줌 및 팬, 기본값: mouse_drag_pan: 참 mouse_wheel_zoom: 참 mouse_double_click_zoom: 참 touch_drag_pan: 참 touch_pinch_zoom: 참 touch_tap_drag_zoom: 참 persist: true # 확대/축소 요소 및 뷰포트 위치 유지 page reloads# digital_ptz: false # 모든 마우스/터치 디지털 확대/축소 및 팬타이틀을 비활성화합니다: 내 슈퍼 카메라 # 선택적 카드 titleposter: https://home-assistant.io/images/cast/ Splash.png # 스트림이 로드 중일 때 정지 이미지muted: true # 초기 음소거 토글 상태, 기본값은 false입니다(음소거 해제)intersection: 0.75 # 비디오 요소의 75% 미만이 화면, 기본적으로 50% background: true # 표시되지 않을 때 스트림을 실행합니다(예: 빠른 비디오 로딩을 위해), 기본 falseshortcuts: # 사용자 정의 단축키, 기본값 none- name: Record 아이콘: mdi:레코드-원-개요 서비스: 스위치.토글 service_data:entity_id: 스위치.카메라_레코드
팬, 틸트, 줌 제어: PTZ 구성 예.
기본적으로 일시중지됨
유형: custom:webrtc-cameraposter: dahua1-snap # go2rtc.yaml의 스트림 이름(http-snapshot)streams: - url: '' # URL이 비어 있으므로 포스터만 표시됩니다. - url: dahua1 # go2rtc.yaml의 스트림 이름(rtsp-stream)
비디오 종횡비 문제
스타일: "비디오 {가로세로 비율: 16/9; 개체 맞춤: 채우기;}"비디오 회전
클라이언트(무료 CPU):
스타일: '비디오 {변형: 회전(90deg); 종횡비: 1}'서버에서 - FFmpeg 트랜스코딩(높은 CPU 비용)
모드 라벨 숨기기
스타일: '.mode {디스플레이: 없음}'전체 화면 버튼 숨기기
스타일: '.fullscreen {디스플레이: 없음}'스크린샷 버튼 숨기기
스타일: '.screenshot {디스플레이: 없음}'PIP 버튼 숨기기
스타일: '.pictureinpicture {디스플레이: 없음}'바로가기 위치
스타일: ".shortcuts {왼쪽: 설정되지 않음; 위쪽: 25px; 오른쪽: 5px; 디스플레이: 플렉스; 플렉스 방향: 열}"PTZ 위치
스타일: ".ptz {오른쪽: 설정 해제; 왼쪽: 10px}"모드 라벨 위치
스타일: '.header {bottom: 6px} .mode {위치: 절대; 하단: 0px}'헤더 줄 위치
스타일: '.header {top: unset; 하단: 6px}'v3.6.0의 새로운 기능.
카드 옵션 shortcuts , style 및 ptz JavaScript 템플릿을 지원합니다.
shortcuts 및 style 에서는 states 관련 템플릿을 사용할 수 있습니다.
ptz 에서는 streamName / streamID 관련 템플릿을 사용할 수 있습니다(여러 템플릿이 있는 카드에 유용함)
단축키:
- 이름: Barn Lighticon: ${ states['light.yeelight_lamp'].state === 'on' ? 'mdi:outdoor-lamp':'mdi:lamp' }서비스: light.toggleservice_data: 엔터티_id: light.yeelight_lamp ptz: 서비스: 통지.지속_통지
data_left:message: ${ this.streamName }에 대한 왼쪽 클릭
data_right:message: ${ this.streamID }에 대한 권한이 클릭됨v3.4.0의 새로운 기능.
go2rtc에서 지원되는 소스에만 해당
HTTPS 액세스가 가능한 Hass의 경우에만 이 제한은 브라우저에서 발생합니다.
WebRTC 모드에만 해당
Hass Mobile App에서는 HTTPS도 중요합니다!
media 매개변수에 microphone 추가해야 합니다. 두 개의 스트림을 사용할 수 있습니다. 하나는 마이크가 있고 다른 하나는 마이크가 없습니다.
유형: 'custom:webrtc-camera'스트림: - URL: go2rtc_stream - URL: go2rtc_streammode: webrtcmedia: 비디오, 오디오, 마이크
추신. Hass Mobile 앱의 경우 내장된 Assist와 함께 마이크를 사용할 수 있는지 확인하세요.
더 읽어보세요
Google Cast Chromecast 장치(Android TV 및 Google 스마트 스크린 포함)로의 스트리밍을 지원하는 구성 요소입니다. 위키에서 더 읽어보세요.
또한 홈어시스턴트에 대한 액세스를 공유하지 않고 스트림에 대한 임시 또는 영구 링크 생성을 지원하는 구성 요소입니다. 위키에서 더 읽어보세요.
v3.1.0의 새로운 기능.
go2rtc는 양방향 오디오를 지원하는 카메라에서 오디오 파일(예: 음악 또는 TTS) 및 라이브 스트림(예: 라디오)을 재생하도록 지원합니다. 다음을 수행해야 합니다.
카메라가 양방향 오디오 소스를 지원하는지 확인하세요.
go2rtc.yaml 구성에서 카메라 스트림 설정
카메라가 지원하는 오디오 코덱을 확인하세요.
configuration.yaml 에서 카메라용 가상 미디어 플레이어를 생성합니다.
media_player: - 플랫폼: webrtcname: Dahua Camerastream: dahuaaudio: pcmu/48000 - 플랫폼: webrtcname: Tapo Camerastream: tapoaudio: pcma
Q. WebRTC를 통한 외부 접근이 작동하지 않습니다
A. 자세한 내용을 읽고 새로운 문제를 만들지 마십시오.
Q. 오디오가 작동하지 않습니다
A. 카메라가 출력하는 오디오 코덱을 확인하세요. 그리고 비디오를 보기 위해 어떤 기술을 사용하시나요? 다양한 기술은 다양한 코덱을 지원합니다.
configuration.yaml 에 추가합니다.
로거: 기본값: 경고 로그:custom_comComponents.webrtc: 디버그
| 상표 | 모델 | 논평 |
|---|---|---|
| 액티브캠 | AC-D2121IR3 | |
| 액티브캠 | AC-D7121IR1W | 지원 사운드 |
| 기계적 인조 인간 | IP 웹캠 프로 | 지원 사운드, rtsp://192.168.1.123:8080/h264_ulaw.sdp |
| C-트로닉스 | CTIPC-690C | 지원 사운드, 기본: rtsp://username:[email protected]:554/11 또는 onvif://username:[email protected]:8080?subtype=MainStreamProfileToken |
| 다후아 | DH-IPC-HDPW1431FP-AS-0280B, VTO2211G-P | 지원 사운드 |
| 다후아 | VTO2202F-P-S2 | 더 읽어보세요 |
| EZVIZ | C3S | rtsp://admin:[email protected]:554/h264/ch01/main/av_stream 및 /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 |
| 포스캠 | C1 | rtsp://user:[email protected]:554/videoMain |
| 포스캠 | C2M, R2M | rtsp://user:[email protected]:88/videoMain |
| GW 보안 | GW5088IP | rtsp://192.168.1.123:554/mpeg4cif?username=admin&password=123456 |
| GW 보안 | GW5078IP | rtsp://192.168.1.123:554/stream0?username=admin&password=123456 |
| GW 보안 | GW5071IP | 아직 작동하지 않습니다. rtsp://admin:[email protected]:554/live/main 또는 rtsp://192.168.0.207:554/live/main?username=admin&password=123456 과 유사합니다. |
| 하이크비전 | DS-2CD2T47G1-L, DS-2CD1321-I, DS-2CD2143G0-IS | rtsp://user:[email protected]:554/ISAPI/Streaming/Channels/102 |
| 하이크비전 | IPC-HDW3849H-AS-PV, IPC-EW5531-AS | 맞춤형 구성 요소를 사용하여 nvr DHI-NVR2108HS-8P-I에 연결됨 |
| 이모우 | IPC-F42-B2E3(총알 2C 4MP) | rtsp://admin:[email protected]:554/cam/realmonitor?channel=1&subtype=0 |
| 큐냅 | QUSBCam2 | rtsp://username:[email protected]:554/channel1 문서 |
| 라즈베리 파이 | PiCam | 더 읽어보세요 |
| 리오링크 | RLC-410, RLC-410W, RLC-510WA, E1 Pro, E1 줌, 4505MP | RLC-510WA는 사운드 지원, E1 Zoom 지원 사운드, PTZ 및 줌 지원 |
| 리오링크 | E1 | rtsp://admin:[email protected]:554/h264Preview_01_main |
| 소노프 | GK-200MP2-B | 사운드 및 PTZ 지원, rtsp://rtsp:[email protected]:554/av_stream/ch0 및 /av_stream/ch1 |
| 스리홈 | SH035 | rtsp://192.168.xxx.xxx:8554/profile0 및 /profile1 및 /profile2 |
| 톱비코 | rtsp://192.168.1.123:8554/stream0 또는 rtsp://192.168.1.123:554/ch0_0.264 | |
| TP-링크 | 타포 C100/C200/C210/C220/C310 | rtsp://user:[email protected]:554/stream1 및 /stream2 |
| TVT/시큐텍 | NVR-0808B2-8P | rtsp://user:[email protected]:554/chID=1&streamType=main 및 chID=2&streamType=main |
| TVT/시큐텍 | IPC5-DF28SN | rtsp://user:[email protected]:554/profile1 및 /profile2 |
| 유니파이 | G4 돔, G4 초인종, G3 Bullet, G3 Flex | Unifi Protect의 카메라 설정에서 rtsps 링크를 복사합니다. 단, 링크를 rstp:// (기본값은 rstps://)로 변경하고, 포트를 7447 로 변경하고, 쿼리 매개변수를 모두 제거하세요. |
| 와이즈 | 캠 v2/v3, 캠 팬 v1/v2 | 지원 사운드 |
| 샤오미 | 다팡 | 해킹으로 rtsp://192.168.1.123:8554/unicast비디오: H264, 크기: 1920x1080, 비트 전송률: 1000, 형식: VBR, 프레임 속도: 10 오디오: PCMU, 입력 속도: 8000, 출력 속도: 44100 |
| 예일 대학 | SV-4CFDVR-2 | rtsp://admin:[email protected]/cam/realmonitor?channel=1&subtype=0 |
| 이 | Hi3518e 칩셋 | 해킹으로 |
| 이 | MStar 인피니티 칩셋 | 해킹으로 |
