VIVOTEK VORTEX Tailgating Detection

info

This feature is in early release. Please talk to your account manager to join the program.

Kisi admins can set up Tailgating Detection to monitor and identify unauthorized entry attempts by detecting line-crossing incidents through connected cameras.

info

This is a Kisi-built integration, maintained and supported by Kisi.

Camera requirements

To implement tailgating detection, you will need a supported VORTEX camera model. The FE931-EHV (12 MP Fisheye) is the recommended model for this setup. Additionally, ensure that both the camera and the Kisi controller are properly connected to the network to facilitate communication between devices.

Camera installation and setup

Proper installation and configuration of your VORTEX camera are crucial for effective tailgating detection. Follow the guidelines below to set up your camera correctly.

Positioning of the camera

Install the camera under the roof, directly in front of the door you wish to monitor. The optimal distance between the camera and the door should be between 1 to 1.5 meters. This placement ensures that the camera captures clear images of individuals entering and exiting through the door.

Installation height

Mount the camera at a height ranging from 2.7 meters to 8 meters from the floor. This height provides a comprehensive field of view while minimizing blind spots and ensuring that the detection algorithms function effectively.

Avoiding misdetections

To prevent false alarms and ensure optimal performance, consider the following:

• Field of view: Do not set the detection region or line too close to the edges of the camera’s field of view. Keeping the detection area within the central portion minimizes potential algorithm errors.
• Reflections: Be mindful of reflective surfaces such as mirrors or water puddles near the detection area. Reflections can cause the system to misinterpret images, leading to false detections.
• Bright light sources: Avoid positioning the camera where direct light sources or surface reflections can obscure or distort the images. Adjust the camera angle if necessary to reduce the impact of bright light.

Setting up line-crossing detection and obtaining coordinates

When adding the VORTEX camera to the Kisi platform, you will need to provide line-crossing coordinates. These coordinates inform the system where to monitor for line crossings. The following steps guide you through setting up line-crossing detection and obtaining the necessary coordinates.

Configuring line-crossing detection

1. Log in to the VORTEX Portal.
2. From the left-side menu, navigate to DeepSearch and click Add Rule to create a new scene search rule.
3. Select Line Crossing Detection from the available options.
4. Set up a V-shaped detection line with the direction set to "Out -> In". Ensure that the detection line spans the entire entrance and that the V-shape points toward the inside of the building.
5. After configuring the detection line, click Save.
6. Perform a search by clicking the Search button. If detection results appear, your setup is successfully completed for this step.

Obtaining the line-crossing coordinates

To retrieve the line-crossing coordinates:

1. Open your browser’s Developer Tools (e.g., in Chrome, go to View > Developer > Developer Tools).
2. Switch to the Network tab within the Developer Tools.
3. Return to the VORTEX Portal and perform the search again.
4. In the Network tab, look for an entry labeled "deepsearch" with the type "fetch".
5. Click on the "deepsearch" entry and navigate to the Payload tab.
6. Locate the Line field within the "LineCrossingDetection" result under "re".
7. Copy the coordinates listed, which should resemble the following format:

   [
     { "x": 3534, "y": 3867 },
     { "x": 4075, "y": 4553 },
     { "x": 3514, "y": 5301 }
   ]
8. Save these coordinates for use in the next setup step.

Adding the VORTEX integration to Kisi

With the coordinates obtained, you can now integrate the VORTEX camera with the Kisi system.

Steps to add the integration

1. Log in to the Kisi web app.
2. Navigate to the Integrations page, which can be found under the cogwheel icon on the left-hand menu.
3. Click on Add Integration.
4. Enter a custom name for your integration and select VORTEX as the integration type.
5. Click the Add button. You will be redirected to the sign-in page to enter your VORTEX account credentials.
6. If you encounter issues during sign-in, ensure that your VORTEX account is properly set up.

Configuring the integration

1. After successfully adding the integration, return to the Integrations page. Your newly created VORTEX integration should appear in the list; click on it to open.
2. Click on Configure Integration and then select Add Camera.
3. Under Select Device, choose your VORTEX by VIVOTEK camera.
4. In Select Place, choose the Kisi location where the camera is installed.
5. Under Search Doors, select the door you wish to link to the camera.
6. Paste the line-crossing coordinates you obtained earlier into the Line Crossing field.
   • Note: Ensure that the coordinates include quotation marks around both "x" and "y" values. You may need to add these manually if they are missing.
   • If the Line Crossing field is not visible during this step, you may need to enable the line-crossing detection feature in your account settings.

Optional: adjusting snapshot duration

After adding the camera, you have the option to adjust the snapshot duration:

1. Navigate to Settings within the integration.
2. Select Clip Duration.
3. Choose your preferred duration: 10, 15, or 30 seconds.

Setting up the tailgating detection trigger

To ensure that the Kisi API can successfully query line-crossing detections, you need to set up a trigger that notifies the API when to perform queries.

Configuring the trigger in the VORTEX portal

1. In the VORTEX Portal, select the installed camera under Device.
2. Navigate to Video Content Analysis from the left-hand menu under Detection.
3. Click on Add Line Crossing Detection.
4. Configure the crossing_in trigger: Make sure the settings here closely align with the line crossing drawn in the DeepSearch settings to avoid misdetections.

Setting up the webhook

1. Navigate to System > Alarm Management in the VORTEX Portal and select Add Alarm.
2. In the first step, select Video Content Analysis events as the alarm source.
3. Choose the installed camera as the source device.
4. Proceed to set up actions:
   • Select Webhook as the action type.
   • Click on Configure Webhooks and enter the following URL: https://marketplace.kisi.io/trpc/vortex.webhook
   • This URL is standardized and remains the same across all organizations.
   • Include the following JSON payload:

       {
       "organizationName": "{{.OrganizationName}}",
       "organizationId": "{{.OrganizationId}}",
       "eventType": "{{.EventType}}",
       "eventName": "{{.EventName}}",
       "eventId": "{{.EventId}}",
       "deviceName": "{{.DeviceName}}",
       "deviceId": "{{.DeviceId}}",
       "deviceGroupName": "{{.DeviceGroupName}}",
       "deviceGroupId": "{{.DeviceGroupID}}",
       "localTime": {{.LocalTime}},
       "timezone": "{{.Timezone}}"
       }
   • For more detailed information about configuring webhooks, refer to the Vivotek documentation
5. After setting up the webhook, select it from the list of configured webhooks and proceed to the next step.
6. Adjust the alarm schedule according to your requirements (e.g., set it to an all-day schedule).
7. Review the summary and click Save to finalize the alarm configuration.

Setting up the incident policy

With the tailgating detection system installed, the final step is to configure the Incident Policy to effectively monitor and respond to incidents.

Configuring the incident policy

1. In the Kisi web app, navigate to the Incident section and select Incident Policies.
2. Click on Add Incident Policy.
3. Choose Tailgating as the incident type.
4. Configure the severity level based on your organization’s needs.
5. Select the appropriate users or groups as the audience who will receive incident notifications.
6. Save the policy configuration.

Once the Incident Policy is set up, you will receive notifications whenever a tailgating incident occurs, complete with detailed event information and attached camera snapshots.

Incident occurrences for the same subject are grouped into a single, continuous incident. If an open incident already exists for the same subject, no new incident will be created. Instead, the existing record will be updated to indicate an additional occurrence of the issue.

Note: Administrators will not receive new notifications until the ongoing incident is closed. To trigger notifications for subsequent occurrences, close the current incident first.

Notes and limitations

• To enhance the accuracy of the detection algorithm, the tailgating detection pipeline operates in near-real-time.
• An incident report is generated 15 minutes after detection if no valid unlock or line-crossing events occur at the door during that period.

Conclusion

Your tailgating detection system is now fully configured and operational. By following the steps outlined in this guide, you have integrated your VORTEX camera with Kisi and set up the necessary triggers and policies to monitor for tailgating incidents effectively. If you encounter any issues or have questions during the setup process, please consult the Kisi support resources or the Vivotek documentation for additional assistance.