UnifiVideo

Connect to UnifiVideo NVR and manage CCTV cameras! This integration allows you to fetch motion recording events as incidents. The integration commands also allow downloading snapshots, recordings and controlling the camera infra-red capabilities.

IT Services · UnifiVideo NVR

Details

IDUnifiVideo
ProviderUbiquiti
CategoryIT Services
From Version6.0.0
Docker Imagedemisto/unifi-video:1.0.0.9094740
Supported ModulesAgentix XSIAM

README

unifivideo-get-camera-list


Gets the list of cameras bound with the NVR.

Base Command

unifivideo-get-camera-list

Input

There are no input arguments for this command.

Context Output

Path Type Description
UnifiVideo.Cameras Unknown The camera list.

unifivideo-get-snapshot


The name of the camera to take the snapshot from. If empty then all camera snapshots will be taken.

Base Command

unifivideo-get-snapshot

Input

Argument Name Description Required
camera_name The name of the camera. Required

Context Output

There is no context output for this command.

unifivideo-get-recording


Download a recording to file.

Base Command

unifivideo-get-recording

Input

Argument Name Description Required
recording_id The id of the recording. Required

Context Output

Path Type Description
UnifiVideo.Recordings Unknown The recording list.

unifivideo-set-recording-settings


Set the recording settings.

Base Command

unifivideo-set-recording-settings

Input

Argument Name Description Required
camera_name The camera name. Required
rec_set Recording setting, motion,fulltime or disable. Possible values are: fulltime, motion, disable. Default is motion. Required

Context Output

There is no context output for this command.

unifivideo-ir-leds


Turn ON or OFF the camera Infra-Red LED.

Base Command

unifivideo-ir-leds

Input

Argument Name Description Required
camera_name The camera name. Required
ir_leds The Infra-Red LED mode. Possible values are: auto, on, off. Default is auto. Required

Context Output

There is no context output for this command.

unifivideo-get-recording-list


Get the list of all recordings.

Base Command

unifivideo-get-recording-list

Input

There are no input arguments for this command.

Context Output

There is no context output for this command.

unifivideo-get-snapshot-at-frame


Get a snapshot from video file based on the frame number.

Base Command

unifivideo-get-snapshot-at-frame

Input

Argument Name Description Required
entryid File entryID of the video file. Required
frame Frame to take from the video. Required

Context Output

There is no context output for this command.

unifivideo-get-recording-snapshot


Get the recording snapshot (at frame) based on the recording id.

Base Command

unifivideo-get-recording-snapshot

Input

Argument Name Description Required
frame The frame to snapshot. Default is 150. Required
recording_id the ubnt_id of the recording. Required

Context Output

There is no context output for this command.

unifivideo-get-recording-motion-snapshot


Gets the frame snapshot that has triggered the motion event.

Base Command

unifivideo-get-recording-motion-snapshot

Input

Argument Name Description Required
recording_id the ubnt_id of the recording. Required

Context Output

There is no context output for this command.

Configuration parameters

  • api_key — API Key (required)
  • addr — IP address or hostname (required)
  • port — Port number
  • schema — Schema
  • verify_cert — Verify CA cert
  • isFetch — Fetch incidents
  • incidentType — Incident type
  • incidentFetchInterval — Incidents Fetch Interval
  • fetch_time — First fetch timestamp (<number> <time unit>, e.g., 12 hours, 7 days, 3 months, 1 year)
  • fetch_limit — Fetch Limit (unlimited=0)

Commands (9)

  • unifivideo-get-camera-list

    Gets the list of cameras bound with the NVR.

  • unifivideo-get-recording

    Download a recording to file.

  • unifivideo-get-recording-list

    Get the list of all recordings.

  • unifivideo-get-recording-motion-snapshot

    Gets the frame snapshot that has triggered the motion event.

  • unifivideo-get-recording-snapshot

    Get the recording snapshot (at frame) based on the recording id.

  • unifivideo-get-snapshot

    The name of the camera to take the snapshot from. If empty then all camera snapshots will be taken.

  • unifivideo-get-snapshot-at-frame

    Get a snapshot from video file based on the frame number.

  • unifivideo-ir-leds

    Turn ON or OFF the camera Infra-Red LED.

  • unifivideo-set-recording-settings

    Set the recording settings.

category: IT Services
sectionorder:
- Connect
- Collect
provider: Ubiquiti
commonfields:
  id: UnifiVideo
  version: -1
configuration:
- display: API Key
  name: api_key
  required: true
  type: 4
  section: Connect
- display: IP address or hostname
  name: addr
  required: true
  type: 0
  section: Connect
- defaultvalue: '7080'
  display: Port number
  name: port
  type: 0
  required: false
  section: Connect
- defaultvalue: http
  display: Schema
  name: schema
  options:
  - http
  - https
  type: 15
  required: false
  section: Connect
- defaultvalue: 'true'
  display: Verify CA cert
  name: verify_cert
  type: 8
  required: false
  section: Connect
- display: Fetch incidents
  name: isFetch
  type: 8
  required: false
  section: Collect
- display: Incident type
  name: incidentType
  type: 13
  required: false
  section: Collect
- display: Incidents Fetch Interval
  name: incidentFetchInterval
  defaultvalue: '1'
  required: false
  type: 19
  advanced: true
  section: Collect
- defaultvalue: 10 minutes
  display: First fetch timestamp (<number> <time unit>, e.g., 12 hours, 7 days, 3 months, 1 year)
  name: fetch_time
  type: 0
  required: false
  section: Collect
- defaultvalue: '50'
  display: Fetch Limit (unlimited=0)
  name: fetch_limit
  type: 0
  required: false
  section: Collect
description: |-
  Connect to UnifiVideo NVR and manage CCTV cameras!

  This integration allows you to fetch motion recording events as incidents.

  The integration commands also allow downloading snapshots, recordings and controlling the camera infra-red capabilities.
display: UnifiVideo
name: UnifiVideo
script:
  commands:
  - description: Gets the list of cameras bound with the NVR.
    name: unifivideo-get-camera-list
    outputs:
    - contextPath: UnifiVideo.Cameras
      description: The camera list.
      type: Unknown
  - arguments:
    - description: The name of the camera.
      name: camera_name
      required: true
    description: The name of the camera to take the snapshot from. If empty then all camera snapshots will be taken.
    name: unifivideo-get-snapshot
  - arguments:
    - description: The id of the recording.
      name: recording_id
      required: true
    description: Download a recording to file.
    name: unifivideo-get-recording
    outputs:
    - contextPath: UnifiVideo.Recordings
      description: The recording list.
      type: Unknown
  - arguments:
    - description: The camera name.
      name: camera_name
      required: true
    - auto: PREDEFINED
      defaultValue: motion
      description: Recording setting, motion,fulltime or disable.
      name: rec_set
      predefined:
      - fulltime
      - motion
      - disable
      required: true
    description: Set the recording settings.
    execution: true
    name: unifivideo-set-recording-settings
  - arguments:
    - description: The camera name.
      name: camera_name
      required: true
    - auto: PREDEFINED
      defaultValue: auto
      description: The Infra-Red LED mode.
      name: ir_leds
      predefined:
      - auto
      - 'on'
      - 'off'
      required: true
    description: Turn ON or OFF the camera Infra-Red LED.
    execution: true
    name: unifivideo-ir-leds
  - description: Get the list of all recordings.
    execution: true
    name: unifivideo-get-recording-list
  - arguments:
    - description: File entryID of the video file.
      name: entryid
      required: true
    - description: Frame to take from the video.
      name: frame
      required: true
    description: Get a snapshot from video file based on the frame number.
    name: unifivideo-get-snapshot-at-frame
  - arguments:
    - defaultValue: '150'
      description: The frame to snapshot.
      name: frame
      required: true
    - description: the ubnt_id of the recording.
      name: recording_id
      required: true
    description: Get the recording snapshot (at frame) based on the recording id.
    name: unifivideo-get-recording-snapshot
  - arguments:
    - description: the ubnt_id of the recording.
      name: recording_id
      required: true
    description: Gets the frame snapshot that has triggered the motion event.
    name: unifivideo-get-recording-motion-snapshot
  dockerimage: demisto/unifi-video:1.0.0.9094740
  isfetch: true
  runonce: true
  script: '-'
  subtype: python3
  type: python
tests:
- No tests (auto formatted)
fromversion: 6.0.0