---
title: "Controles de cámara"
source: /es/gcxone/api/camera-controls
locale: es
updated: 2026-09-04
---
Operaciones sobre recursos de controles de cámara. 6 puntos finales, cada uno relativo a `https://api.nxgen.cloud/api/v1` y autenticado según lo descrito en [Autenticación](/gcxone/api/authentication).

## GET /cameraControls/clipInfo

obtener clipinfo para la línea de tiempo

### Parámetros

| Nombre | En | Tipo | Obligatorio | Descripción |
| --- | --- | --- | --- | --- |
| id | query | string | yes | identificador de cámara |
| startDate | query | string | yes | tiempo epoch |
| endDate | consulta | cadena | sí | tiempo epoch |

### Respuestas

| Estado | Descripción | Cuerpo |
| --- | --- | --- |
| 200 | Éxito |  |
| 204 | Sin contenido |  |
| 401 | No autorizado |  |
| 403 | Prohibido |  |
| 404 | No Encontrado |  |

## GET /cameraControls/getSnapshot

Obtener detalle de instantánea del sensor

### Parámetros

| Nombre | En | Tipo | Obligatorio | Descripción |
| --- | --- | --- | --- | --- |
| sensorUniqueId | query | cadena | sí | identificador único del sensor |
| deviceUniqueId | query | cadena | sí | identificador único del dispositivo |
| fechaHora | query | cadena | no | fecha hora |

### Respuestas

| Estado | Descripción | Cuerpo |
| --- | --- | --- |
| 200 | Éxito |  |
| 401 | No autorizado |  |
| 403 | Prohibido |  |
| 404 | No Encontrado |  |

## GET /cameraControls/getStream

Obtener detalle de transmisión del sensor

### Parámetros

| Nombre | En | Tipo | Obligatorio | Descripción |
| --- | --- | --- | --- | --- |
| sensorId | query | cadena | sí | identificador del sensor |
| channelId | query | cadena | no | identificador del canal |
| startTime | query | cadena | no | hora de inicio de la transmisión |
| Hora de finalización | query | cadena | no | hora de finalización de la transmisión |

### Respuestas

| Estado | Descripción | Cuerpo |
| --- | --- | --- |
| 200 | Éxito |  |
| 401 | No autorizado |  |
| 403 | Prohibido |  |
| 404 | No Encontrado |  |

## PUT /cameraControls/isolate

para aislar cámara

### Cuerpo de la solicitud

Aislar

```json
[
  {
    "id": "sensor uniqueId",
    "isIsolate": "boolean",
    "startTime": "Epoch time in milliseconds",
    "duration": "Time in minutes"
  }
]
```

### Respuestas

| Estado | Descripción | Cuerpo |
| --- | --- | --- |
| 200 | Éxito |  |
| 204 | Sin contenido |  |
| 401 | No autorizado |  |
| 403 | Prohibido |  |
| 404 | No Encontrado |  |

## GET /cameraControls/playAudio?deviceId={deviceId}&language={language}&audioFile={audioFile}

Reproducir archivo de audio

### Parámetros

| Nombre | En | Tipo | Obligatorio | Descripción |
| --- | --- | --- | --- | --- |
| deviceId | query | string | sí |  |
| idioma | consulta | cadena | sí |  |
| archivo de audio | consulta | cadena | sí |  |

### Respuestas

| Estado | Descripción | Cuerpo |
| --- | --- | --- |
| 200 | Éxito |  |
| 204 | Sin contenido |  |
| 401 | No autorizado |  |
| 403 | Prohibido |  |
| 404 | No Encontrado |  |

## GET /cameraControls/presetPTZ

ejecutar PTZ / preajuste

### Parámetros

| Nombre | En | Tipo | Obligatorio | Descripción |
| --- | --- | --- | --- | --- |
| id | query | string | yes |  |
| action | query | "R" \| "R\_STOP" \| "L" \| "L\_STOP" \| "U" \| "U\_STOP" \| "D" \| "D\_STOP" \| "Z+" \| "Z+\_STOP" \| "1" \| "2" \| "3" \| "4" \| "5" \| "6" \| "7" \| "8" \| "9" \| "10" | yes | Seleccione cualquier valor del 1 al 10 para preset, los demás para PTZ |
| commandType | query | "ptz" \| "preset" | yes |  |
| webSocketPort | query | string | no | requerido para tipo de dispositivo heitel |
| momentSpeed | query | string | no | Velocidad PTZ |

### Respuestas

| Estado | Descripción | Cuerpo |
| --- | --- | --- |
| 200 | Éxito |  |
| 204 | Sin contenido |  |
| 401 | No autorizado |  |
| 403 | Prohibido |  |
| 404 | No Encontrado |  |