---
title: Puntos finales de control de visualización de rDWS
slug: develop/es/puntos-finales-de-control-de-visualizacion-de-rdws
docTags: 
createdAt: 2025-03-11T07:03:32.132Z
---

:::hint{type="info"}
Estas APIs de control de pantalla solo se pueden utilizar en pantallas Moka que tienen reproductores BrightSign integrados y solo están disponibles en BOS 9.0.189 y versiones posteriores.
:::

URL base para estos endpoints:  ***https\://ws.bsn.cloud/rest/***

*\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_*

## GET /v1/display-control/ 

Devuelve todas las configuraciones de control para una pantalla que está conectada a un reproductor BrightSign.

**Ejemplo de solicitud**

```text
GET /rest/v1/display-control/?destinationType=player&destinationName={{playerSerial}} HTTP/1.1
Host: ws.bsn.cloud
Authorization: Bearer {{UserAccessToken}}
Accept: application/json, application/vnd.bsn.error+json
```

**Cuerpo de la respuesta**

<font color="#15803D">200</font>: Esto devuelve la configuración de control de la pantalla, como se muestra en el siguiente ejemplo.

**Ejemplo de respuesta**

```json
{
  "data": {
    "result": {
      "tvInfo": {
        "macAddress": "ff:ff:ff:ff:ff:ff",
        "wifiMacAddress": "ff:ff:ff:ff:ff:ff",
        "serialNo": "1234567890",
        "osVersion": "V8-AM963BS-0020015",
        "hwRevision": 1
      },
      "whiteBalance": {
        "redBalance": 120,
        "greenBalance": 120,
        "blueBalance": 120
      },
      "volume": 50,
      "brightness": 50,
      "contrast": 50,
      "idleStandbyTimeout": 50,
      "powerSetting": "on",
      "videoOutput": "HDMI1",
      "sdConnection": "brightsign",
      "alwaysConnectedEnabled": true
    }
  }
}
```

## GET /v1/display-control/brightness/ 

Devuelve la configuración de brillo para una pantalla que está conectada a un reproductor BrightSign.

**Ejemplo de solicitud**

```text
GET /rest/v1/display-control/brightness/?destinationType=player&destinationName={{playerSerial}} HTTP/1.1
Host: ws.bsn.cloud
Authorization: Bearer {{UserAccessToken}}
Accept: application/json, application/vnd.bsn.error+json
```

**Cuerpo de la respuesta**

<font color="#15803D">200</font>: Esto devuelve la configuración de brillo para la pantalla, como se muestra en el siguiente ejemplo.

**Ejemplo de respuesta**

```json
{
  "data": {
    "result": {
      "brightness": 100
    }
  }
}
```

## PUT /v1/display-control/brightness/  

Cambia la configuración de brillo de una pantalla conectada a un reproductor BrightSign.

**Ejemplo de solicitud**

```text
PUT /rest/v1/display-control/brightness/?destinationType=player&destinationName={{playerSerial}} HTTP/1.1
Host: ws.bsn.cloud
Authorization: Bearer {{UserAccessToken}}
Accept: application/json, application/vnd.bsn.error+json
Content-Type: application/json
Content-Length: 14
```

Este es el cuerpo de solicitud de ejemplo:

```json
{
  "data": {
    "brightness": 100
  }
}
```

**Cuerpo de la respuesta**

<font color="#15803D">200</font>: Esto devuelve la configuración de brillo actualizada para la pantalla, como se muestra en el siguiente ejemplo.

**Ejemplo de respuesta**

```json
{
  "data": {
    "result": {
      "success": true,
      "brightness": 100
    }
  }
}
```

## GET /v1/display-control/contrast/ 

Devuelve la configuración de contraste para una pantalla que está conectada a un reproductor BrightSign.

**Ejemplo de solicitud**

```text
GET /rest/v1/display-control/contrast/?destinationType=player&destinationName={{playerSerial}} HTTP/1.1
Host: ws.bsn.cloud
Authorization: Bearer {{UserAccessToken}}
Accept: application/json, application/vnd.bsn.error+json
```

**Cuerpo de la respuesta**

<font color="#15803D">200</font>: Esto devuelve la configuración de contraste para la pantalla, como se muestra en el siguiente ejemplo.

**Ejemplo de respuesta**

```json
{
  "data": {
    "result": {
      "contrast": 45
    }
  }
}
```

## PUT /v1/display-control/contrast/  

Cambia el contraste de una pantalla conectada a un reproductor BrightSign.

**Ejemplo de solicitud**

```text
PUT /rest/v1/display-control/contrast/?destinationType=player&destinationName={{playerSerial}} HTTP/1.1
Host: ws.bsn.cloud
Authorization: Bearer {{UserAccessToken}}
Accept: application/json, application/vnd.bsn.error+json
Content-Type: application/json
Content-Length: 22
```

Este es el cuerpo de solicitud de ejemplo:

```json
{
  "data": {
    "contrast": 45
  }
}
```

**Cuerpo de la respuesta**

<font color="#15803D">200</font>: Esto devuelve la configuración de contraste actualizada para la pantalla, como se muestra en el siguiente ejemplo.

**Ejemplo de respuesta**

```json
{
  "data": {
    "result": {
      "success": true,
      "contrast": 45
    }
  }
}
```

## GET /v1/display-control/always-connected/ 

Devuelve la configuración de conexión para una pantalla conectada a un reproductor BrightSign.

**Ejemplo de solicitud**

```text
GET /rest/v1/display-control/always-connected/?destinationType=player&destinationName={{playerSerial}} HTTP/1.1
Host: ws.bsn.cloud
Authorization: Bearer {{UserAccessToken}}
Accept: application/json, application/vnd.bsn.error+json
```

**Cuerpo de la respuesta**

<font color="#15803D">200</font>: Esto devuelve la configuración de conexión para la pantalla, como se muestra en el siguiente ejemplo.

**Ejemplo de respuesta**

```json
{
  "data": {
    "result": {
      "enabled": true
    }
  }
}
```

## PUT /v1/display-control/always-connected/  

Cambia la configuración de conexión de una pantalla conectada a un reproductor BrightSign.

**Ejemplo de solicitud**

```text
PUT /rest/v1/display-control/always-connected/?destinationType=player&destinationName={{playerSerial}} HTTP/1.1
Host: ws.bsn.cloud
Authorization: Bearer {{UserAccessToken}}
Accept: application/json, application/vnd.bsn.error+json
Content-Type: application/json
Content-Length: 23
```

Este es el cuerpo de solicitud de ejemplo:

```json
{
  "data": {
    "enable": true
  }
}
```

**Cuerpo de la respuesta**

<font color="#15803D">200</font>: Devuelve la configuración de conexión para la pantalla como `verdadero`, como se muestra en el siguiente ejemplo.

**Ejemplo de respuesta**

```json
{
  "data": {
    "result": {
      "success": true,
      "enable": true
    }
  }
}
```

## GET /v1/display-control/always-on/ 

Devuelve una configuración de conexión (si está siempre activada o no) para una pantalla conectada a BrightSign. Consulte [esta página](docId\:H7HTRo-84LYoUgQrax_NV) para obtener una explicación de esta configuración.

**Ejemplo de solicitud**

```text
GET /rest/v1/display-control/always-on/?destinationType=player&destinationName={{playerSerial}} HTTP/1.1
Host: ws.bsn.cloud
Authorization: Bearer {{UserAccessToken}}
Accept: application/json, application/vnd.bsn.error+json
```

**Cuerpo de la respuesta**

<font color="#15803D">200</font>: Esto devuelve la configuración de conexión para la pantalla, como se muestra en el siguiente ejemplo.

**Ejemplo de respuesta**

```json
{
  "data": {
    "result": {
      "enabled": true
    }
  }
}
```

## PUT /v1/display-control/always-on/  

Le permite configurar la conexión de la pantalla para que esté siempre activada. Consulte [esta página](docId\:H7HTRo-84LYoUgQrax_NV) para obtener una explicación de esta configuración.

**Ejemplo de solicitud**

```text
PUT /rest/v1/display-control/always-on/?destinationType=player&destinationName={{playerSerial}} HTTP/1.1
Host: ws.bsn.cloud
Authorization: Bearer {{UserAccessToken}}
Accept: application/json, application/vnd.bsn.error+json
Content-Type: application/json
Content-Length: 23
```

Este es el cuerpo de solicitud de ejemplo:

```json
{
  "data": {
    "enable": true
  }
}
```

**Cuerpo de la respuesta**

<font color="#15803D">200</font>: Devuelve la configuración de conexión para la pantalla como `verdadero`, como se muestra en el siguiente ejemplo.

**Ejemplo de respuesta**

```json
{
  "data": {
    "result": {
      "success": true,
      "enable": true
    }
  }
}
```

## PUT /v1/display-control/firmware/  

Cambia la configuración del firmware para una pantalla conectada a un reproductor BrightSign.

**Ejemplo de solicitud**

```text
PUT /rest/v1/display-control/firmware/?destinationType=player&destinationName={{playerSerial}} HTTP/1.1
Host: ws.bsn.cloud
Authorization: Bearer {{UserAccessToken}}
Accept: application/json, application/vnd.bsn.error+json
Content-Type: application/json
Content-Length: 105
```

El cuerpo de la solicitud de ejemplo puede ser `filepath` o `url`:

```json
{
  "data": {
    "filepath": "path/to/firmware/relative/to/sd"
  }
}
```

```json
{
  "data": {
    "url": "https://example.com/tv-firmware.zip"
  }
}
```

**Cuerpo de la respuesta**

<font color="#15803D">202</font>: Esto actualiza el firmware y reinicia el reproductor, como se muestra en el siguiente ejemplo.

**Ejemplo de respuesta**

```json
{
  "data": {
    "result": {
      "success": true,
      "reboot": true
    }
  }
}
```

## GET /v1/display-control/info/ 

Devuelve la configuración del reproductor BrightSign que está conectado a una pantalla

**Ejemplo de solicitud**

```text
GET /rest/v1/display-control/info/?destinationType=player&destinationName={{playerSerial}} HTTP/1.1
Host: ws.bsn.cloud
Authorization: Bearer {{UserAccessToken}}
Accept: application/json, application/vnd.bsn.error+json
```

**Cuerpo de la respuesta**

<font color="#15803D">200</font>: Esto devuelve información sobre una pantalla que está conectada a un reproductor BrightSign, como se muestra en el siguiente ejemplo.

**Ejemplo de respuesta**

```json
{
  "data": {
    "result": {
      "macAddress": "ff:ff:ff:ff:ff:ff",
      "serialNo": "1234567890",
      "osVersion": "V8-AM963BS-0020015",
      "hwRevision": 2,
      "wifiMacAddress": "ff:ff:ff:ff:ff:ff"
    }
  }
}
```

## GET /v1/display-control/power-settings/ 

Devuelve la configuración de energía para una pantalla que está conectada a un reproductor BrightSign.

**Ejemplo de solicitud**

```text
GET /rest/v1/display-control/power-settings/?destinationType=player&destinationName={{playerSerial}} HTTP/1.1
Host: ws.bsn.cloud
Authorization: Bearer {{UserAccessToken}}
Accept: application/json, application/vnd.bsn.error+json
```

**Cuerpo de la respuesta**

<font color="#15803D">200</font>: Esto devuelve la configuración de energía para la pantalla, como se muestra en el siguiente ejemplo.

**Ejemplo de respuesta**

```json
{
  "data": {
    "result": {
      "setting": "on"
    }
  }
}
```

## PUT /v1/display-control/power-settings/  

Cambia la configuración de energía para una pantalla conectada a un reproductor BrightSign.

**Ejemplo de solicitud**

```text
PUT /rest/v1/display-control/power-settings/?destinationType=player&destinationName={{playerSerial}} HTTP/1.1
Host: ws.bsn.cloud
Authorization: Bearer {{UserAccessToken}}
Accept: application/json, application/vnd.bsn.error+json
Content-Type: application/json
Content-Length: 38
```

Este es el cuerpo de la solicitud de ejemplo:

```json
{
  "data": {
    "setting": "standby"
  }
}
```

**Cuerpo de la respuesta**

<font color="#15803D">200</font>: Esto devuelve la configuración de energía actualizada para la pantalla, como se muestra en el siguiente ejemplo.

**Ejemplo de respuesta**

```json
{
  "data": {
    "result": {
      "success": true,
      "setting": "standby"
    }
  }
}
```

## GET /v1/display-control/standby-timeout/ 

Devuelve la configuración de standby/timeout para una pantalla conectada a un reproductor BrightSign.

**Ejemplo de solicitud**

```text
GET /rest/v1/display-control/standby-timeout/?destinationType=player&destinationName={{playerSerial}} HTTP/1.1
Host: ws.bsn.cloud
Authorization: Bearer {{UserAccessToken}}
Accept: application/json, application/vnd.bsn.error+json
```

**Cuerpo de la respuesta**

<font color="#15803D">200</font>: Esto devuelve la configuración de standby/timeout para la pantalla, como se muestra en el ejemplo a continuación.

**Ejemplo de respuesta**

```json
{
  "data": {
    "result": {
      "seconds": 60
    }
  }
}
```

## PUT /v1/display-control/standby-timeout/  

Cambia la configuración de standby/timeout de una pantalla conectada a un reproductor BrightSign.

**Ejemplo de solicitud**

```text
PUT /rest/v1/display-control/standby-timeout/?destinationType=player&destinationName={{playerSerial}} HTTP/1.1
Host: ws.bsn.cloud
Authorization: Bearer {{UserAccessToken}}
Accept: application/json, application/vnd.bsn.error+json
Content-Type: application/json
Content-Length: 19
```

Este es el cuerpo de solicitud de ejemplo:

```json
{
  "data": {
    "seconds": 60
  }
}
```

**Cuerpo de la respuesta**

<font color="#15803D">200</font>: Esto devuelve la configuración de standby/timeout actualizada para la pantalla, como se muestra en el ejemplo a continuación.

**Ejemplo de respuesta**

```json
{
  "data": {
    "result": {
      "success": true,
      "seconds": 60
    }
  }
}
```

## GET /v1/display-control/sd-connection/ 

Devuelve la configuración de conexión SD para una pantalla conectada a un reproductor BrightSign.

**Ejemplo de solicitud**

```text
GET /rest/v1/display-control/sd-connection/?destinationType=player&destinationName={{playerSerial}} HTTP/1.1
Host: ws.bsn.cloud
Authorization: Bearer {{UserAccessToken}}
Accept: application/json, application/vnd.bsn.error+json
```

**Cuerpo de la respuesta**

<font color="#15803D">200</font>: Esto devuelve la configuración de conexión SD para la pantalla, como se muestra en el ejemplo a continuación.

**Ejemplo de respuesta**

```json
{
  "data": {
    "result": {
      "connection": "brightsign"
    }
  }
}
```

## PUT /v1/display-control/sd-connection/  

Cambia la configuración de conexión SD de una pantalla conectada a un reproductor BrightSign. El control de la tarjeta SD se transfiere ya sea a la pantalla (`pantalla`) o al reproductor BrightSign (`brightsign`)

**Ejemplo de solicitud**

```text
PUT /rest/v1/display-control/sd-connection/?destinationType=player&destinationName={{playerSerial}} HTTP/1.1
Host: ws.bsn.cloud
Authorization: Bearer {{UserAccessToken}}
Accept: application/json, application/vnd.bsn.error+json
Content-Type: application/json
Content-Length: 19
```

Este es el cuerpo de solicitud de ejemplo:

```json
{
  "data": {
    "connection": "display"
  }
}
```

**Cuerpo de la respuesta**

<font color="#15803D">200</font>: Esto devuelve la configuración de conexión SD actualizada para la pantalla, como se muestra en el ejemplo a continuación.

**Ejemplo de respuesta**

```json
{
  "data": {
    "result": {
      "success": true,
      "connection": "display"
    }
  }
}
```

## GET /v1/display-control/video-output/ 

Devuelve la configuración de salida de video para una pantalla conectada a un reproductor BrightSign.

**Ejemplo de solicitud**

```text
GET /rest/v1/display-control/video-output/?destinationType=player&destinationName={{playerSerial}} HTTP/1.1
Host: ws.bsn.cloud
Authorization: Bearer {{UserAccessToken}}
Accept: application/json, application/vnd.bsn.error+json
```

**Cuerpo de la respuesta**

<font color="#15803D">200</font>: Esto devuelve la configuración de salida de video para la pantalla, como se muestra en el ejemplo a continuación.

**Ejemplo de respuesta**

```json
{
  "data": {
    "result": {
      "output": "HDMI1"
    }
  }
}
```

## PUT /v1/display-control/video-output/  

Cambia la configuración de salida de video de una pantalla conectada a un reproductor BrightSign.

**Ejemplo de solicitud**

```text
PUT /rest/v1/display-control/video-output/?destinationType=player&destinationName={{playerSerial}} HTTP/1.1
Host: ws.bsn.cloud
Authorization: Bearer {{UserAccessToken}}
Accept: application/json, application/vnd.bsn.error+json
Content-Type: application/json
Content-Length: 18
```

Este es el cuerpo de solicitud de ejemplo:

```json
{
  "data": {
    "output": "HDMI2"
  }
}
```

**Cuerpo de la respuesta**

<font color="#15803D">200</font>: Esto devuelve la configuración actualizada de la conexión de salida de video para la pantalla, como se muestra en el ejemplo a continuación.

**Ejemplo de respuesta**

```json
{
  "data": {
    "result": {
      "success": true,
      "output": "HDMI2"
    }
  }
}
```

## GET /v1/display-control/volume/ 

Devuelve la configuración de volumen para una pantalla conectada a un reproductor BrightSign.

**Ejemplo de solicitud**

```text
GET /rest/v1/display-control/volume/?destinationType=player&destinationName={{playerSerial}} HTTP/1.1
Host: ws.bsn.cloud
Authorization: Bearer {{UserAccessToken}}
Accept: application/json, application/vnd.bsn.error+json
```

**Cuerpo de la respuesta**

<font color="#15803D">200</font>: Esto devuelve la configuración de volumen para la pantalla, como se muestra en el ejemplo a continuación.

**Ejemplo de respuesta**

```json
{
  "data": {
    "result": {
      "volume": 50
    }
  }
}
```

## PUT /v1/display-control/volume/  

Cambia el volumen de una pantalla conectada a un reproductor BrightSign.

**Ejemplo de solicitud**

```text
PUT /rest/v1/display-control/volume/?destinationType=player&destinationName={{playerSerial}} HTTP/1.1
Host: ws.bsn.cloud
Authorization: Bearer {{UserAccessToken}}
Accept: application/json, application/vnd.bsn.error+json
Content-Type: application/json
Content-Length: 16
```

Este es el cuerpo de solicitud de ejemplo:

```json
{
  "data": {
    "volume": 100
  }
}
```

**Cuerpo de la respuesta**

<font color="#15803D">200</font>: Esto devuelve la configuración de volumen actualizada para la pantalla, como se muestra en el ejemplo a continuación.

**Ejemplo de respuesta**

```json
{
  "data": {
    "result": {
      "success": true,
      "volume": 100
    }
  }
}
```

## GET /v1/display-control/white-balance/ 

Devuelve la configuración de balance de blancos para una pantalla conectada a un reproductor BrightSign.

**Ejemplo de solicitud**

```text
GET /rest/v1/display-control/white-balance/?destinationType=player&destinationName={{playerSerial}} HTTP/1.1
Host: ws.bsn.cloud
Authorization: Bearer {{UserAccessToken}}
Accept: application/json, application/vnd.bsn.error+json
```

**Cuerpo de la respuesta**

<font color="#15803D">200</font>: Esto devuelve la configuración de balance de blancos para la pantalla, como se muestra en el ejemplo a continuación.

**Ejemplo de respuesta**

```json
{
  "data": {
    "result": {
      "redBalance": 120,
      "greenBalance": 120,
      "blueBalance": 120
    }
  }
}
```

## PUT /v1/display-control/white-balance/  

Cambia el balance de blancos de una pantalla conectada a un reproductor BrightSign.

**Ejemplo de solicitud**

```text
PUT /rest/v1/display-control/white-balance/?destinationType=player&destinationName={{playerSerial}} HTTP/1.1
Host: ws.bsn.cloud
Authorization: Bearer {{UserAccessToken}}
Accept: application/json, application/vnd.bsn.error+json
Content-Type: application/json
Content-Length: 58
```

Este es el cuerpo de solicitud de ejemplo:

```json
{
  "data": {
    "redBalance": 120,
    "greenBalance": 120,
    "blueBalance": 120
  }
}
```

**Cuerpo de la respuesta**

<font color="#15803D">200</font>: Esto devuelve la configuración actualizada del balance de blancos para la pantalla, como se muestra en el siguiente ejemplo.

**Ejemplo de respuesta**

```json
{
  "data": {
    "result": {
      "success": true,
      "redBalance": 120,
      "greenBalance": 120,
      "blueBalance": 120
    }
  }
}
```