From b62b0230d5fa6c9784814ee1290270c2b53dd2e1 Mon Sep 17 00:00:00 2001 From: "J. Nick Koston" Date: Sat, 27 May 2023 00:30:30 -0500 Subject: [PATCH] Add note about some cameras needing to seek to get a valid snapshot (#27542) * Add note about some cameras needing to seek to get a valid snapshot * Update source/_integrations/onvif.markdown * Apply suggestions from code review --- source/_integrations/onvif.markdown | 9 +++++++++ 1 file changed, 9 insertions(+) diff --git a/source/_integrations/onvif.markdown b/source/_integrations/onvif.markdown index 794f01e3a98..1e4922b221b 100644 --- a/source/_integrations/onvif.markdown +++ b/source/_integrations/onvif.markdown @@ -46,6 +46,15 @@ You can configure specific FFmpeg options through the integration options flow b | Extra FFmpeg arguments | Extra options to pass to `ffmpeg`, e.g., image quality or video filter options. More details in [`ffmpeg` integration](/integrations/ffmpeg). | | Use wallclock as timestamps | ([Advanced Mode](/blog/2019/07/17/release-96/#advanced-mode) only) Rewrite the camera timestamps. This may help with playback or crashing issues from Wi-Fi cameras or cameras of certain brands (e.g., EZVIZ). | +#### Snapshots + +Some cameras will not produce usable snapshots with larger stream sizes. + +By default, the integration will only enable the camera entity for the first H264 profile. If you are unable to get a working snapshot: + +- If additional camera entities are available for other profiles, try enabling those entities. +- Set the `Extra FFmpeg arguments` to `-pred 1 -ss 00:00:05 -frames:v 1` to cause the snapshot to be taken 5 seconds into the stream. + ### Supported Sensors This integration uses the ONVIF pullpoint subscription API to process events into sensors that will be automatically added to Home Assistant. Below is a list of currently supported event topics along with the entities they create.