Axxon Next

FindFace Multi integration with Axxon Next allows you to detect and identify objects in video streams from an Axxon-based security system.

Integration with Axxon Next is implemented via the ffsecurity_axxon plugin.

To configure the FindFace Multi integration with Axxon Next in Ubuntu, do the following:

  1. Activate the plugin by uncommenting the INSTALLED_APPS.append(‘ffsecurity_axxon’) line in the /etc/findface-security/config.py configuration file.

    sudo vi /etc/findface-security/config.py
    
    ...
    
    # ==============================================================================
    # FINDFACE SECURITY PLUGINS
    # ==============================================================================
    # Uncomment lines below to enable plugins. Please consult documentation for
    # a plugin specific settings.
    
    # =============== Axxon ================
    INSTALLED_APPS.append('ffsecurity_axxon')
    
  2. Uncomment the AXXON section in the configuration file. Fill it out by analogy with the example below. In the api parameter, specify the IP address and API port of the Axxon Next server that will provide FindFace Multi with Axxon API and HLS-archive streams. In the rtsp parameter, specify the common segment of Axxon video stream addresses. name, user, password: the Axxon Next server name and credentials to access it.

    =============== Axxon ================
     INSTALLED_APPS.append('ffsecurity_axxon')
    
     AXXON = [
         {
             'name': 'my_axxon',
             'api': 'http://192.168.0.2:8000',
             'rtsp': 'rtsp://192.168.0.2:50554/',
             'user': 'cinderella',
             'password': '1@love$ocean8',
         }
     ]
    

    Note

    You can establish connections to several Axxon Next servers by multiplying the AXXON section content as follows:

    AXXON = [
         {
             'name': 'my_axxon1',
             'api': 'http://192.168.0.2:8000',
             'rtsp': 'rtsp://192.168.0.2:50554/',
             'user': 'user1',
             'password': 'password1',
         },
         {
             'name': 'my_axxon2',
             'api': 'http://192.168.0.3:8000',
             'rtsp': 'rtsp://192.168.0.3:50554/',
             'user': 'user2',
             'password': 'password2',
         },
         {
             'name': 'my_axxon3',
             'api': 'http://192.168.0.4:8000',
             'rtsp': 'rtsp://192.168.0.4:50554/',
             'user': 'user3',
             'password': 'password3',
         }
     ]
    
  3. Create representations of Axxon Next cameras in FindFace Multi (see Camera Management and Video Recording). A camera representation URL must be specified in the format <server>:<friendlyNameLong>, where server is the Axxon Next server name specified on the previous step in the name parameter, `friendlyNameLong is a camera name on the Axxon Next server. You can find out the camera name in the Axxon user interface, or via Axxon API by executing:

    curl http://user:password@127.0.0.1/video-origins/
    
    {
       "OLOLOE-DEV/DeviceIpint.vhod_1/SourceEndpoint.video:0:0" : {
          "friendlyNameLong" : "vhod_1.Vhod_1",
          "friendlyNameShort" : "Vhod_1",
          "origin" : "OLOLOE-DEV/DeviceIpint.vhod_1/SourceEndpoint.video:0:0",
          "state" : "signal_restored"
       }
    }
    

    For the camera from our example, URL will specified as my_axxon:vhod_1.Vhod_1.

The configuration is now finished. If the integration is properly configured, FindFace Multi will be detecting and identifying objects in Axxon Next video streams, and recognition events will be featuring video clips from Axxon Next (upon relevant settings).