add agent_dvr (#12333)

Co-Authored-By: Franck Nijhof <frenck@frenck.nl>

source/_integrations/agent_dvr.markdown

@@ -0,0 +1,68 @@
+---
+title: Agent DVR
+description: Access and control Agent DVR from Home Assistant.
+ha_category:
+  - Camera
+ha_config_flow: true
+ha_release: "0.110"
+ha_iot_class: Local Pull
+ha_codeowners:
+  - '@ispysoftware'
+ha_domain: agent_dvr
+---
+
+[Agent DVR](https://www.ispyconnect.com/download.aspx/) is a free* software DVR solution for windows 10, Mac and Linux. Agent DVR runs as a service or console application and can access and control a huge range of third party cameras with advanced motion detection, including YOLO integration for object recognition. The iSpyConnect website provides secured (SSL) remote access without port forwarding needed.
+
+You can add Agent DVR via integrations using the IP address and port of the server, e.g.,: `http://192.168.1.3:8090/`.
+
+
+## Configuration
+
+For configuration, go to the `Integrations panel` on your Home Assistant instance. Click on the + symbol and pick 'Agent DVR' from the list and enter your Agent DVR server address and port. You can then setup your devices using the Home Assistant UI.
+
+<div class='note'>
+  Please ensure you are using Agent DVR v2.6.1.0 +
+</div>
+
+## Services
+
+Once loaded, the `agent_dvr` integration will expose services that can be called to perform various actions. The `entity_id` service attribute can specify one or more specific cameras.
+
+Available services:
+`enable_alerts`, `disable_alerts`,
+`start_recording`, `stop_recording`,
+`turn_on`, `turn_off`, `toggle`, `enable_motion_detection`,`disable_motion_detection`
+
+#### Service `enable_alerts`/`disable_alerts`
+
+These services enable or disable the device's alert events within Agent DVR.
+
+Service data attribute | Optional | Description
+-|-|-
+`entity_id` | no | Name(s) of entities, e.g., `camera.living_room_camera`.
+
+#### Service `start_recording`/`stop_recording`
+
+These services start or stop the device recording.
+
+Service data attribute | Optional | Description
+-|-|-
+`entity_id` | no | Name(s) of entities, e.g., `camera.living_room_camera`.
+
+#### Service `turn_on`/`turn_off`/`toggle`
+
+These services turn on, off or toggle the device enabled state within Agent DVR
+
+Service data attribute | Optional | Description
+-|-|-
+`entity_id` | no | Name(s) of entities, e.g., `camera.living_room_camera`.
+
+
+## IFrame
+ - Using the Webpage Card you can embed the Agent DVR viewer directly in Home Assistant. Just point it to https://www.ispyconnect.com/app/
+
+<p class='img'>
+<img src='/images/screenshots/agent_dvr.jpg' />
+</p>
+
+*Agent offers additional services like secured remote access (without port forwarding) and cloud uploads via a subscription service.