Integration with Network Optix

This guide shows how to integrate an Akuvox door phone with Nx Witness to enable video and audio streaming, remote door unlocking, and door phone event handling.

Before You Start

• Make sure the Akuvox door phone and the computer running Nx Witness are connected to the same IP network.

• Make sure you have administrator access to the door phone and Nx Witness.

• Check that the door phone model and firmware version are supported.

Compatible Model and Version

Integration Topology

The Akuvox door phone and the computer running Nx Witness communicate over an IP network.

Part 1: Add the Akuvox Door Phone to Nx Witness

Prepare the Door Phone

1. Use the door phone’s IP to log into its web interface with the username and password. The default is admin.

2. Go to Surveillance > ONVIF interface and enable Discoverable.

3. Then, go to Surveillance > RTSP interface. Enable the RTSP server and set the video codec to H.264 format.

4. Enable RTSP Authorization if needed. If enabled, set the Username and Password which are required when adding the door phone to the Nx Witness server.  

Add the Device Manually at the Nx Witness Server

Use this method if you want to add the door phone directly with its RTSP address.

1. Click Add Device at the main menu.

2. Enter the door phone's RTSP address using the following format:

   rtsp://{Device IP address}/live/ch00_0

3. Tick to use the default port.

4. Click Search to find the door phone option.

5. Select the desired search result.

6. Click Add All Devices.

Discover the Device Automatically

After enabling ONVIF Discoverable in the door phone, the available devices will appear in the camera list.

Part 2: Obtain Video & Audio Stream

Enable Streaming on the Door Phone

1. Use the door phone’s IP to log into its web interface with the username and password. The default is admin.

2. Go to Surveillance > RTSP interface. Enable the RTSP server and set the video codec to H.264 format. If it is R20A, you also need to enable Audio.

3. Click Submit to save the settings.

Enable Audio in Nx Witness

1. Right-click on your camera and select Camera Settings. Enable audio and click OK to save settings.

2. Drag the intercom camera stream into the layout from the device list, just like any other camera. In live view or recording, you can set the audio volume at the lower rightmost corner of Nx Witness.

Part 3: Enable Remote Door Unlocking

You can configure Nx Witness to unlock the door through the Akuvox door phone.

The basic workflow is:

Nx Witness → Camera Rule → HTTP request → Akuvox door phone → Relay activated

Enable HTTP Door Unlocking on the Door Phone

1. Go to Access Control > Relay > Open Relay Via HTTP interface.

2. Enable the feature.

3. Set the username and password for HTTP door unlocking.

The HTTP command format depends on whether High Security Mode is enabled.

When High Security Mode Is Enabled

Use one of the following formats:

http://{username}:{password}@{deviceIP}/fcgi/OpenDoor?action=OpenDoor&DoorNum=1or

http://{deviceIP}/fcgi/OpenDoor?action=OpenDoor&DoorNum=1

When High Security Mode Is Disabled

The following formats are supported:

http://{username}:{password}@{deviceIP}/fcgi/OpenDoor?action=OpenDoor&DoorNum=1

http://{deviceIP}/fcgi/OpenDoor?action=OpenDoor&DoorNum=1

http://{deviceIP}/fcgi/do?action=OpenDoor&UserName={username}&Password={password}&DoorNum=1

DoorNum refers to the relay to be triggered. For relay A, DoorNum=1; for relay B, DoorNum=2.

Note

• DoorNum=1 controls Relay A, and DoorNum=2 controls Relay B.

• If the door phone does not provide High Security Mode, use the legacy command format:

  http://{deviceIP}/fcgi/do?action=OpenDoor&UserName={username}&Password={password}&DoorNum=1

4. Click Submit to save the settings.

Create an Unlock Rule in Nx Witness

1. Right-click on the target camera and select Camera Rules.

2. Click Add to create a new rule.

3. Select Soft trigger from the When list, at Target Camera.

4. Define available roles for this event

5. Select Do HTTP request in the action list

6. Enter the HTTP unlock command.

7. Click OK to save the configuration.

Click the Open Door icon on the live view, and the door phone relay will be triggered.

Part 4: Handle Door Phone Events in Nx Witness

The event integration allows the door phone to send event information to Nx Witness. Nx Witness can then match the received event against a configured camera rule and perform the action defined in that rule.

For example, Nx Witness can display a desktop notification when a matching event is received. Other available actions can also be configured according to your requirements.

Note

This feature is currently supported on the following models.

• S535: 535.30.11.42 or later.

• X915V2: 2915.30.10.822 or later.

Configure Event Sending on the Door Phone

1. Navigate to the door phone’s IP address in a browser. Log in with the username and password(admin/admin by default).

2. Go to Surveillance > Nx Witness interface.

3. Enable Nx Witness.

4. Enter the IP address of the Nx Witness Server in Server Address.

5. Enter the Nx Witness Server port in Port. The default port is 7001.

6. Enter the Nx Witness account username and password in Username and Password.

7. Enter a device identifier in Source.

   The value configured here is used to identify the door phone when matching events in Nx Witness.

8. Under Event Trigger Details, enable the events that you want to send to Nx Witness.

9. Configure the Caption and Description for each enabled event as needed.

Note

The Source and Caption values configured on the door phone are used to identify and match the corresponding event in Nx Witness. Make sure the values configured in the Nx Witness event rule correspond to those configured on the door phone.

10. Click Submit to save the settings.

Set Up the Event Rule in Nx Witness

1. Right-click the target camera and select Camera Rules.

2. Click +Add Rule to create a new rule.

3. Under When Event, select Generic Event.

4. Under Source, select Contains keywords and enter the same value configured in the door phone's Source field.

5. Under Caption, select Contains keywords and enter the same value configured in the door phone's Caption field.

6. Under Description, select Contains keywords and enter the same value configured in the door phone's Description field.

7. Under Do Action, select the desired action and configure relevant parameters. In this example, select Show Desktop Notification to display a notification when the event occurs.

8. Select the user roles that should receive the notification.

9. Make sure the rule is enabled.

10. Click OK to save the rule.

When the configured event occurs on the door phone, Nx Witness receives the event and executes the configured action.