From aaf4e0bc2c533940f5e473e8662e6bc5d5a958da Mon Sep 17 00:00:00 2001
From: fencepost-error <35447717+fencepost-error@users.noreply.github.com>
Date: Thu, 27 Nov 2025 01:20:32 +1300
Subject: [PATCH] Onvif: Clarified the need to have at least one H.264 video
 stream present (#41570)

Co-authored-by: c0ffeeca7 <38767475+c0ffeeca7@users.noreply.github.com>
---
 source/_integrations/onvif.markdown | 14 ++++++++++++++
 1 file changed, 14 insertions(+)

diff --git a/source/_integrations/onvif.markdown b/source/_integrations/onvif.markdown
index dc5c6b4381d..375d713522f 100644
--- a/source/_integrations/onvif.markdown
+++ b/source/_integrations/onvif.markdown
@@ -108,3 +108,17 @@ This integration uses the ONVIF auxiliary command and imaging service to send ce
 | IR lamp  | `ir_lamp` |  Turn infrared lamp on and off via `IrCutFilter` ONVIF imaging setting. |
 | Autofocus  | `autofocus` |  Turn autofocus on and off via `AutoFocusMode` ONVIF imaging setting. |
 | Wiper  | `wiper` |  Turn on the lens wiper on and off via the `Wiper` ONVIF auxiliary command. |
+
+## Troubleshooting
+
+### Symptom: Error message: "No usable cameras were found"
+
+The ONVIF integration shows an error message "No usable cameras were found". 
+
+#### Resolution
+
+Update the camera configuration to output at least one video stream in H.264 format rather than H.265. One option for doing this is to set a secondary stream to H.264 while leaving the primary stream at the default H.265.
+
+#### Cause 
+
+Many newer cameras, particularly those with higher resolutions that benefit from H.265's improved video coding, support H.265 (HEVC) by default, while the ONVIF integration looks for H.264 (AVC) video streams to find cameras.