Para desarrolladores - Probar AcuSeek desde ISAPI

Paso 1 - Habilitar AcuSeek y AcuSerch en el dispositivo

Paso 2 - Vincular canal de cámara con AcuSeek y AcuSearch

AcuSeek:

AcuSearch:

Paso 3 - Introduce las palabras clave para buscar en la página de AcuSeek y consulta los resultados.

Revisa los resultados

Llamando a las API

a. Genera un ID de tarea para la búsqueda de texto llamando a

Método: POST
Url: /ISAPI/ContentMgmt/AsynSearchByTextTask?format=json
Body:
{
  "startTime": "2025-07-30T00:00:00 08:00",
  "endTime": "2025-07-30T23:59:59 08:00",
  "channelList": [],
  "text": "Person Wearing a Black Tops",
  "similarity": 60
}

Respuesta

{
  "taskID": "ab044f71-c755-4273-937f-f6095be"
}

b. Obten el resultado de la tarea de texto llamando a

Método: POST
Url: /ISAPI/ContentMgmt/SearchTextTaskStatus?format=json
Body: 
{
  "taskID": "ab044f71-c755-4273-937f-f6095be",
  "searchResultPosition": 1,
  "maxResults": 18,
  "similarity": 40
}

Respuesta

{
  "taskID": " ab044f71-c755-4273-937f-f6095be",
  "runStatus": "completed",
  "numOfMatches": 18,
  "totalMatches": 29,
  "startTime": "2025-07-30T00:00:00Z",
  "endTime": "2025-07-30T14:09:51Z",
  "progress": 100,
  "matchResults": [
    {
      "id": 1,
      "time": "2025-07-30T14:04:25+08:00",
      "channelID": 1,
      "targetType": "human",
      "similarity": 80,
      "imageUUID": "5885059075965423616",
      "image": {
        "filePathType": "URL",
        "filePath": "http://10.9.96.162:80/picture/Streaming/tracks/103/?name=ch00001_020006900393822c00002fe200003875801051abee0c7b1b9000&amp;size=196128"
      },
      "targetImage": {
        "filePathType": "URL",
        "filePath": "http://10.9.96.162:80/picture/Streaming/tracks/103/?name=ch00001_020006900393b20e0000088380000893801051abee0c7b1b9000&;size=34872"
      },
      "targetRect": {
        "height": 0.485075,
        "width": 0.259955,
        "x": 0.357011,
        "y": 0.445429
      }
    }
  ]
}

Los datos devueltos incluyen el ID del canal, la marca de tiempo, el tipo de destino y las imágenes coincidentes.

La URL de la imagen coincidente se puede consultar directamente en el navegador web.

Imágen:

Objetivo de la imágen:

Paso 4 - Buscar videos

Llamar a:

Método: POST
Url: /ISAPI/ContentMgmt/search
Body: 
<CMSearchDescription>
    <searchID>6218E25F-2610-4C14-8BCD-F6A9DCF2D80A</searchID>
    <trackList>
        <trackID>101</trackID>
    </trackList>
    <timeSpanList>
        <timeSpan>
            <startTime>2025-07-30T14:04:15Z</startTime>
            <endTime>2025-07-30T14:04:35Z</endTime>
        </timeSpan>
    </timeSpanList>
    <maxResults>100</maxResults>
    <searchResultPostion>0</searchResultPostion>
</CMSearchDescription>

En el ejemplo anterior, el criterio de búsqueda es un videoclip de 20 segundos que consta de 10 segundos antes y después de la marca de tiempo de la imagen)

Respuesta

<CMSearchResult version="2.0" xmlns="http://www.isapi.org/ver20/XMLSchema">
    <searchID>{6218e25f-2610-4c14-8bcd-f6a9dcf2d80a}</searchID>
    <responseStatus>true</responseStatus>
    <responseStatusStrg>OK</responseStatusStrg>
    <totalMatches>1</totalMatches>
    <numOfMatches>1</numOfMatches>
    <matchList>
        <searchMatchItem>
            <sourceID>{00000000-0000-0000-0000-000000000000}</sourceID>
            <trackID>101</trackID>
            <timeSpan>
                <startTime>2025-07-30T14:00:36Z</startTime>
                <endTime>2025-07-30T14:26:10Z</endTime>
            </timeSpan>
            <mediaSegmentDescriptor>
                <contentType>video</contentType>
                <codecType>H.264-BP</codecType>
                <playbackURI>rtsp://10.9.96.162:554/Streaming/tracks/101/?starttime=20250730T140036Z&amp;endtime=20250730T142610Z&amp;name=0001000273400020000&amp;size=172418788</playbackURI>
                <lockStatus>unlock</lockStatus>
                <name>0001000273400020000</name>
            </mediaSegmentDescriptor>
            <metadataMatches>
                <metadataDescriptor>recordType.meta.hikvision.com/timing</metadataDescriptor>
                <associatedMetadataUrlList>
                    <associatedMetadataUrl>
                        <metadataType>video</metadataType>
                        <channelID>101</channelID>
                    </associatedMetadataUrl>
                </associatedMetadataUrlList>
            </metadataMatches>
        </searchMatchItem>
    </matchList>
</CMSearchResult>

Los datos de respuesta incluyen la URL RTSP del metraje de vídeo.