---
title: Puntos finales de Remoteview de rDWS
slug: develop/es/puntos-finales-de-remoteview-de-rdws
docTags: 
createdAt: 2025-03-11T07:03:33.433Z
---

Estas APIs se exponen en el servidor WebSocket pero son un conjunto independiente de APIs. Con Remoteview, puede controlar el reproductor de forma remota a través del canal WebSocket. Esta es una ruta entre cada reproductor configurado y la red BSN.

Para usar estas APIs, debe haber confirmado el acceso a un servidor de señalización WebRTC y el acceso a ese servidor mediante un navegador para que pueda usar los endpoints URL necesarios. También debe estar autenticado con el servidor BSN necesario y el reproductor debe estar registrado con esa misma red.

:::hint{type="info"}
El servidor web debe proporcionar su contenido a través de una conexión HTTPS (esto forma parte de la especificación WebRTC). Si no tiene acceso a dicho servicio, puede usar un proxy para un servidor local (que no sea HTTPS) mediante un servicio remoto. Este servicio no forma parte de BSN.Cloud.
:::

## Establecimiento de una conexión de reproductor Remoteview

1. Obtenga una accessURL para un servicio de rendezvous que se utilizará con Remoteview.
2. Agregue la accessURL a la configuración del reproductor en BSN.Cloud:
   -  `PUT /remoteview/config` 
3. Confirme la configuración:
   -  `Punto de conexión GET /remoteview/config`.
4. Inicie una sesión:
   - `POST /remoteview/{:source}/view`
5. Vaya a un navegador Chrome e introduzca la dirección de reenvío de rendezvous y agregue webrtc\_client.html al final de la dirección (por ejemplo: 7a24dceefaa4.ngrok.io/webrtc\_client.html)
6. Introduzca el número de serie del reproductor que desea visualizar.
7. Asegúrese de que todo esté funcionando. El siguiente comando debería devolver un id de sesión:
   - `GET /remoteview/{:source}/view`
8. Elimine una sesión:
   - `ELIMINAR /remoteview/{:source}/view/{:id}` 

## GET  /remoteview/config/ 

Use el endpoint PUT para configurar el reproductor con una URL de acceso. Luego puede usar este endpoint para comprobar que la configuración es correcta.

\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_

**Cuerpo de respuesta exitosa**

<font color="#15803D">200</font>: Esto devolverá la URL de acceso

**Ejemplo**

```json
{“accessURL”: “http://test-server-url/”}
```

**Respuesta de error**

<font color="#B91C1C">400</font>: La solicitud está malformada y, por lo tanto, no es válida

<font color="#B91C1C">401</font>: El token de acceso no es válido o no se especificó

<font color="#B91C1C">5XX</font>: Cualquier código 500 es un error interno del servidor

## PUT  /remoteview/config/ 

Configura el reproductor con la URL de acceso

**Cuerpo de la solicitud**

- `accessURL` <font color="#704ae0">string: </font>La URL del servidor de vista remota

\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_

**Ejemplo de solicitud**

```text
{"data": {“accessURL”: “http://test-server-url/”}}
```

\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_

**Cuerpo de respuesta exitosa**

<font color="#15803D">200</font>: Esto devuelve la URL de acceso, el mismo valor que pasó en el cuerpo de la solicitud al reproductor

**Respuesta de error**

<font color="#B91C1C">400</font>: La solicitud o el cuerpo de la solicitud están malformados y, por lo tanto, no son válidos

<font color="#B91C1C">401</font>: El token de acceso no es válido o no se especificó

<font color="#B91C1C">5XX</font>: Cualquier código 500 es un error interno del servidor

## GET  /remoteview/\{:source}/view/ 

Devuelve la información sobre todas las sesiones activas de vista remota.

**Cuerpo de la solicitud**

- `fuente` <font color="#704ae0">string: </font>Este valor siempre será `"escritorio"`

\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_

**Cuerpo de la respuesta exitosa**

<font color="#15803D">200</font>: Devuelve un array de objetos de sesión. Cada objeto contiene los siguientes parámetros:

- `identificación` <font color="#704ae0">string</font>: El id de la sesión
- `mediaSource` <font color="#704ae0">string</font>: El valor siempre es `"escritorio"`
- `disponible` <font color="#704ae0">bool</font>: Este valor siempre es `verdadero` cuando la sesión está activa.
- `visualización` <font color="#704ae0">bool</font>: Esto indica que la sesión está activa. El valor siempre será `verdadero`.

**Ejemplo**

```json
{
      id: "9e61ac20-2014-11ee-a14d-73a9c31db7cd", 
      mediaSource: "desktop", 
      available: true,
      viewing: true
}
```

**Respuesta de error**

<font color="#B91C1C">400</font>: La solicitud está malformada y, por lo tanto, no es válida

<font color="#B91C1C">401</font>: El token de acceso no es válido o no se especificó

<font color="#B91C1C">5XX</font>: Cualquier código 500 es un error interno del servidor

## GET  /remoteview/\{:source}/view/\:id/ 

Devuelve información sobre la sesión de vista remota especificada usando su id de sesión

**Cuerpo de la solicitud**

- `fuente` <font color="#704ae0">string: </font>Este valor siempre será `"escritorio"`
- `identificación` <font color="#704ae0">string: </font>El identificador único de la sesión

\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_

**Cuerpo de la respuesta exitosa**

<font color="#15803D">200</font>: Devuelve el siguiente objeto de sesión especificado:

- `identificación` <font color="#704ae0">string</font>: El id de la sesión
- `mediaSource` <font color="#704ae0">string</font>: El valor siempre es `"escritorio"`
- `disponible` <font color="#704ae0">bool</font>: Este valor siempre es `verdadero` cuando la sesión está activa.
- `visualización` <font color="#704ae0">bool</font>: Esto indica que la sesión está activa. El valor siempre será `verdadero`.

**Ejemplo**

```json
{
      id: "9e61ac20-2014-11ee-a14d-73a9c31db7cd", 
      mediaSource: "desktop", 
      available: true,
      viewing: true
}
```

**Respuesta de error**

<font color="#B91C1C">400</font>: La solicitud está malformada y, por lo tanto, no es válida

<font color="#B91C1C">401</font>: El token de acceso no es válido o no se especificó

<font color="#B91C1C">404</font>: No se encontró el id de sesión especificado

<font color="#B91C1C">5XX</font>: Cualquier código 500 es un error interno del servidor

## POST  /remoteview/\{:source}/view/ 

Inicia una nueva sesión y devuelve un id para la sesión (en este punto, el servidor de señalización se ha inicializado y ha realizado una conexión WebSocket con el reproductor)

**Cuerpo de la solicitud**

- `fuente` <font color="#704ae0">string: </font>Este valor siempre será `"escritorio"`

\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_

**Cuerpo de la respuesta exitosa**

<font color="#15803D">200</font>: Una respuesta exitosa devuelve el id de sesión.

**Ejemplo**

```json
{sessionID: "9e61ac20-2014-11ee-a14d-73a9c31db7cd"}
```

**Respuesta de error**

<font color="#B91C1C">400</font>: La solicitud o el cuerpo de la solicitud tienen un formato incorrecto y, por lo tanto, no son válidos

<font color="#B91C1C">401</font>: El token de acceso no es válido o no se especificó

<font color="#B91C1C">5XX</font>: Cualquier código 500 es un error interno del servidor

## DELETE  /remoteview/\{:source}/view/\:id/ 

Detiene la sesión de vista remota especificada usando su id de sesión

**Cuerpo de la solicitud**

- `fuente` <font color="#704ae0">string: </font>Este valor siempre será `"escritorio"`
- `identificación` <font color="#704ae0">string: </font>El identificador único de la sesión que desea detener

\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_

**Cuerpo de la respuesta exitosa**

<font color="#15803D">200</font>: La sesión especificada se detuvo

**Ejemplo**

```json
{ stopped : true }
```

**Respuesta de error**

<font color="#B91C1C">400</font>: La solicitud tiene un formato incorrecto y, por lo tanto, no es válida

<font color="#B91C1C">401</font>: El token de acceso no es válido o no se especificó

<font color="#B91C1C">404</font>: No se encontró el id de sesión especificado

<font color="#B91C1C">5XX</font>: Cualquier código 500 es un error interno del servidor