Articles in this section

TestCamera: IP Camera Emulator

Avatar
Nx Support
  • Updated
Follow

What is TestCamera?

TestCamera is an experimental application that allows users to stream a looped video file to Nx Witness as an emulated camera. TestCamera is launched using a command-line interface (i.e., Terminal, CMD, etc.). 

It solves several problems:

  • Development: Developers are able to work on integrations without hardware devices (cameras, network gear, etc).
  • Debugging: Create a predictable and replicable video stream for testing and debugging video analytics solutions
  • Performance testing: Create hundreds of “cameras” to test hardware and software performance and reliability
  • Demonstrations: Create a mobile software-only “camera” set to use in demos

Installing and Using TestCamera

<filePath>/testcamera <option> <cameraSet>;<cameraSet2>

  • <option> – the below options
    • -I – limit discoverability of testcameras to a specified network interface (for example, to limit the testcameras to your machine: -I=127.0.0.1). See Known Testcamera Limitations below for more information.
    • -S – create a separate TestCamera per primary video file
  • <cameraSet> – at least one set of semi-colon separated parameters, such as below
    • files="" – a comma-separated list of video-files for hi-quality/primary streams
    • secondary-files="" – a comma-separated list of video-files for low-quality/secondary streams (optional)
    • count – number of TestCameras to create, if more than one is needed (for example, count=5)

Example - Create one TestCamera that can only be discovered by your machine:

C:/testcamera -I=127.0.0.1 files="C:/hq.mkv";secondary-files"lq.mkv";

NOTE: Run the testcamera command with no parameters to access the help function and see the full list of commands.

Windows

TestCamera is available to download as a separate application on the Integrations Marketplace. 

  1. Create a folder in the directory of your choice and name it test_camera (for example, C:\test_camera)
  2. Download the Testcamera package and extract it to C:\test_camera
  3. Place any video files you plan on using into C:\test_camera
  4. Open CMD and navigate to the TestCamera folder:
    cd C:/test_camera
  5. Run the testcamera command with your desired parameters and values.

Example 1

Create 100 identical cameras for performance testing and prevent the TestCameras from being discovered by other computers on the network

testcamera -I=127.0.0.1 files="hq1.mkv";secondary-files="lq1.mkv";count=100

Example 2

Create three TestCameras from three different source files

testcamera -S files="hq1.mkv,hq2.mkv,hq3.mkv";secondary-files="lq1.mkv,lq2.mkv,lq3.mkv"

Example 3

Create three TestCameras from three different source files and prevent the TestCameras from being discovered by other computers on the network

testcamera -S -I=127.0.0.1 files="hq1.mkv,hq2.mkv,hq3.mkv";secondary-files="lq1.mkv,lq2.mkv,lq3.mkv"

Ubuntu

TestCamera is included in the server package for all Ubuntu installations.

  1. Using admin permissions, place any video files you plan on using into /opt/networkoptix/bin/

    Note: If you do not have admin permissions to place video files in the same folder as the TestCamera program, you will have to use the full file path of the videos in the cameraSet.

  2. Open Terminal and navigate to the TestCamera folder:
    cd /opt/networkoptix/bin/testcamera
  3. Run the ./testcamera command with your desired parameters and values.

Example 1

Create 100 identical cameras for performance testing and prevent the TestCameras from being discovered by other computers on the network

./testcamera -I=127.0.0.1 files="hq1.mkv";secondary-files="lq1.mkv";count=100

Example 2

Create three TestCameras from three different source files

./testcamera -S files="hq1.mkv,hq2.mkv,hq3.mkv";secondary-files="lq1.mkv,lq2.mkv,lq3.mkv"

Example 3

Create three TestCameras from three different source files and prevent the TestCameras from being discovered by other computers on the network

./testcamera -S -I=127.0.0.1 files="hq1.mkv,hq2.mkv,hq3.mkv";secondary-files="lq1.mkv,lq2.mkv,lq3.mkv"

Best Practices

Use Relevant Files

Create and utilize video files that are similar to the conditions you would like to replicate. The easiest way to get such a sample is to set the real camera to record in Nx Witness, then export a part of the archive.

Adjusting the Frame Rate (FPS)

If you want to change camera frame-per-second (fps) rate, you can modify the frame rate using camera settings in Nx Witness Desktop:

Just select all TestCameras you want to modify (drag across cameras in Nx Witness Desktop to select multiple), open the Camera Settings Dialog, and adjust the recording schedule to the desired FPS and save to apply the changes.

Quick start

We highly recommended creating an executable script (.bat for Windows, .sh for Linux) for starting TestCamera quickly.

Known TestCamera Limitations

  • TestCamera loads every file to memory, so using it with a lot of different files requires additional memory.
  • TestCamera uses only the first 100 MB of a file
  • TestCamera is only compatible with the same version server
  • Please, be careful when using TestCamera in a network with several Nx Witness Servers running on the same LAN subnet will discover the TestCamera “cameras” and add them to their databases. Use -I  key to limit availability by network.

A Few Sample Files

Some files to get you started quickly:

Related articles

Comments

0 comments

Article is closed for comments.