Puntos finales de Remoteview de rDWS

9 min

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 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 obtenga una accessurl para un servicio de rendezvous que se utilizará con remoteview agregue la accessurl a la configuración del reproductor en bsn cloud put /remoteview/config confirme la configuración punto de conexión get /remoteview/config inicie una sesión post /remoteview/{\ source}/view 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) introduzca el número de serie del reproductor que desea visualizar asegúrese de que todo esté funcionando el siguiente comando debería devolver un id de sesión get /remoteview/{\ source}/view 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 \200\ esto devolverá la url de acceso ejemplo {“accessurl” “http //test server url/”} respuesta de error \400\ la solicitud está malformada y, por lo tanto, no es válida \401\ el token de acceso no es válido o no se especificó \5xx\ 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 \string \ la url del servidor de vista remota ejemplo de solicitud {"data" {“accessurl” “http //test server url/”}} cuerpo de respuesta exitosa \200\ esto devuelve la url de acceso, el mismo valor que pasó en el cuerpo de la solicitud al reproductor respuesta de error \400\ la solicitud o el cuerpo de la solicitud están malformados y, por lo tanto, no son válidos \401\ el token de acceso no es válido o no se especificó \5xx\ 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 \string \ este valor siempre será "escritorio" cuerpo de la respuesta exitosa \200\ devuelve un array de objetos de sesión cada objeto contiene los siguientes parámetros identificación \string\ el id de la sesión mediasource \string\ el valor siempre es "escritorio" disponible \bool\ este valor siempre es verdadero cuando la sesión está activa visualización \bool\ esto indica que la sesión está activa el valor siempre será verdadero ejemplo { id "9e61ac20 2014 11ee a14d 73a9c31db7cd", mediasource "desktop", available true, viewing true } respuesta de error \400\ la solicitud está malformada y, por lo tanto, no es válida \401\ el token de acceso no es válido o no se especificó \5xx\ 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 \string \ este valor siempre será "escritorio" identificación \string \ el identificador único de la sesión cuerpo de la respuesta exitosa \200\ devuelve el siguiente objeto de sesión especificado identificación \string\ el id de la sesión mediasource \string\ el valor siempre es "escritorio" disponible \bool\ este valor siempre es verdadero cuando la sesión está activa visualización \bool\ esto indica que la sesión está activa el valor siempre será verdadero ejemplo { id "9e61ac20 2014 11ee a14d 73a9c31db7cd", mediasource "desktop", available true, viewing true } respuesta de error \400\ la solicitud está malformada y, por lo tanto, no es válida \401\ el token de acceso no es válido o no se especificó \404\ no se encontró el id de sesión especificado \5xx\ 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 \string \ este valor siempre será "escritorio" cuerpo de la respuesta exitosa \200\ una respuesta exitosa devuelve el id de sesión ejemplo {sessionid "9e61ac20 2014 11ee a14d 73a9c31db7cd"} respuesta de error \400\ la solicitud o el cuerpo de la solicitud tienen un formato incorrecto y, por lo tanto, no son válidos \401\ el token de acceso no es válido o no se especificó \5xx\ 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 \string \ este valor siempre será "escritorio" identificación \string \ el identificador único de la sesión que desea detener cuerpo de la respuesta exitosa \200\ la sesión especificada se detuvo ejemplo { stopped true } respuesta de error \400\ la solicitud tiene un formato incorrecto y, por lo tanto, no es válida \401\ el token de acceso no es válido o no se especificó \404\ no se encontró el id de sesión especificado \5xx\ cualquier código 500 es un error interno del servidor