Integración domótica PlayStation Network, gratuita y de código abierto

Siga presencia, juegos, tiempo de juego y trofeos de PSN, y sus consolas PS4/PS5.
Siga en Gladys quién juega en PlayStation, a qué juego, cuánto tiempo hoy, los trofeos de su cuenta, y si su PS4 o PS5 está encendida, en reposo o apagada.
Integración no oficial, sin relación con Sony. Sony no ofrece una API pública: la integración lee los mismos datos que la PlayStation App.
Antes de empezar
Necesita:
- una cuenta de PlayStation Network (la cuenta cuyos juegos y trofeos quiere seguir);
- un ordenador con un navegador web, para obtener una vez el token NPSSO;
- para las consolas (opcional): una PS4 o PS5 en la misma red que Gladys.
Obtener su token NPSSO
El NPSSO es un código de 64 caracteres que demuestra que ha iniciado sesión en su cuenta de Sony. La integración lo usa para iniciar sesión como lo hace la PlayStation App.
- En su navegador, vaya a playstation.com e inicie sesión con su cuenta de PlayStation Network.
- En el mismo navegador, abra https://ca.account.sony.com/api/v1/ssocookie.
- La página muestra algo como
{"npsso":"Ab12...xyz"}. Copie el valor de 64 caracteres entre las comillas (copiar toda la línea también funciona: la integración encuentra el valor).
Si la página muestra un error, no ha iniciado sesión: vuelva al paso 1.
Mantenga este token en secreto. Quien lo tenga puede usar su cuenta. Gladys lo guarda en un campo secreto y la integración nunca lo escribe en el disco ni en los registros. Si cree que se ha filtrado, cierre la sesión en todos los dispositivos desde los ajustes de su cuenta PlayStation y obtenga uno nuevo.
El token dura unos dos meses. Cuando caduca, la pantalla de configuración de la integración lo indica: obtenga uno nuevo de la misma forma y péguelo.
Configuración
- Abra la pestaña Configuración de la integración.
- Pegue el token en Token NPSSO.
- Amigos a seguir (opcional): sus ID en línea, separados por comas, 10 como máximo. Su configuración de privacidad debe permitirle ver su estado en línea.
- Dirección IP de la consola (opcional): solo si «Buscar mis consolas» no encuentra su consola (vea más abajo).
- Intervalo de actualización: frecuencia de lectura de PlayStation Network, 120 segundos por defecto (60 como mínimo: Sony limita el número de solicitudes).
- Zona horaria: «Jugado hoy» vuelve a cero a medianoche en esta zona horaria
(
Europe/Parispor defecto). - Guarde y haga clic en Probar la conexión: muestra su ID en línea, su estado, sus trofeos y el estado de cada amigo.
- Abra la pestaña Descubrimiento y añada los dispositivos que quiera.
Los dispositivos
Su cuenta PSN
Las características llegan a Gladys con su nombre en inglés (entre paréntesis abajo): puede renombrarlas al añadir el dispositivo.
| Característica | Valor |
|---|---|
| En línea (Online) | 1 cuando está en línea en una consola, 0 si no |
| Jugando (In game) | 1 cuando hay un juego en marcha |
| Juego actual (Current game) | el nombre del juego, - si no hay ninguno |
| Plataforma (Platform) | PS5, PS4… |
| Sesión actual (Current session) | minutos desde que empezó el juego actual |
| Jugado hoy (Played today) | minutos de juego desde medianoche |
| Nivel trofeos (Trophy level) | su nivel de trofeos |
| Trofeos | número de trofeos de platino, oro, plata y bronce |
Los trofeos se leen cada 15 minutos y al final de cada partida.
Amigos
Cada amigo seguido es un dispositivo con las mismas características que su cuenta, salvo los trofeos.
Consolas
Cada consola encontrada es un dispositivo con una característica Alimentación (Power): 1 cuando está encendida, 0 en reposo o apagada.
Las consolas en la red local
Una PS4 o PS5 indica en la red local si está encendida o en reposo. Para ello:
- PS5: Ajustes → Sistema → Ahorro de energía → Funciones disponibles en modo de reposo → active Permanecer conectado a Internet y Habilitar el encendido de la PS5 desde la red;
- PS4: Ajustes → Ajustes de ahorro de energía → Establecer funciones disponibles en modo de reposo → active Permanecer conectado a Internet y Habilitar el encendido del sistema PS4 desde la red.
Haga clic después en Buscar mis consolas en la configuración: Gladys envía la solicitud de descubrimiento de PlayStation en su red y muestra lo que respondió. Abra la pestaña Descubrimiento para añadir la consola.
Si nada responde (otra red, un router que filtra el broadcast), dé a su consola una dirección IP fija en su router, escríbala en Dirección IP de la consola y haga clic de nuevo en Buscar mis consolas.
Local o nube
Gladys muestra una insignia local o nube en la consola:
- local: el estado viene de la propia consola, en su red;
- nube: el estado viene de su presencia en PSN (en línea en la misma plataforma = encendida).
El interruptor Preferir la conexión local de la configuración elige cuál va primero. Cuando el preferido no dice nada, se usa el otro y la insignia muestra un punto naranja con el motivo. Sin la red local, el reposo y el apagado no se distinguen, y una consola usada por otra cuenta se ve apagada.
La integración no puede encender una consola ni controlarla: solo lee su estado.
Escenas
Disparadores
- Un juego ha empezado: su cuenta o un amigo seguido inició un juego. Variables: ID en línea, juego, ID del título, plataforma.
- Un juego ha terminado: el juego terminó u otro lo reemplazó. Mismas variables, más la duración de la sesión en minutos.
- Se ha conseguido un trofeo: su cuenta consiguió nuevos trofeos. Filtro por categoría (platino, oro, plata, bronce). Variables: categoría, número de trofeos nuevos, total de esta categoría, nivel de trofeos.
Las características de los dispositivos también funcionan con los disparadores estándar de Gladys. Ejemplos:
- cuando «Played today» de la cuenta de mi hijo supere 120, envíame un mensaje;
- cuando «Power» de la PS5 pase a 1 después de las 22 h, apaga las luces del salón.
Acciones
- Leer el estado de un jugador: lee PlayStation Network ahora y devuelve en línea, jugando, juego, plataforma, sesión actual y jugado hoy, para las acciones siguientes de la escena (p. ej. una condición «solo si está jugando»).
- Leer el estado de una consola: encendida, en reposo (
standby) o apagada, leído ahora.
Widget del panel
Añada el widget PlayStation Network a un panel. Muestra:
- el tiempo jugado hoy y la sesión actual, y para su cuenta el nivel de trofeos y el número de platinos;
- quién juega a qué, con los iconos de los juegos (o el icono de su juego si no sigue a ningún amigo);
- su estado, plataforma y juego, y el estado de las consolas;
- un botón Actualizar.
En los ajustes del widget, Jugador elige de quién es la tarjeta (su cuenta por defecto).
Solución de problemas
- «El token NPSSO caducó o es incorrecto»: obtenga uno nuevo (vea arriba). También ocurre tras cambiar la contraseña o cerrar la sesión en todos los dispositivos.
- «Demasiadas solicitudes a PlayStation Network»: aumente el intervalo de actualización.
- Un amigo está «oculto»: su configuración de privacidad no le permite ver su estado, o ya no son amigos.
- Un amigo tiene «ninguna cuenta con este nombre»: compruebe el ID en línea (letras,
cifras,
-y_, de 3 a 16 caracteres). - No se encuentra la consola: compruebe los ajustes de ahorro de energía de arriba, y que está enchufada (totalmente apagada, nunca responde).
- «Jugado hoy» parece bajo: el tiempo se cuenta entre dos actualizaciones. Cuando Gladys o PlayStation Network estuvieron inaccesibles mucho tiempo, se cuenta como máximo el doble del intervalo de actualización para el hueco.
Parámetros de configuración
Estos son los parámetros que PlayStation Network te pide en su pantalla de configuración en Gladys.
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
| Primeros pasos | section | No | Sony no ofrece una API pública: la integración inicia sesión como la PlayStation App, con un token NPSSO. 1) Inicie sesión en playstation.com con su cuenta. 2) En el mismo navegador, abra el enlace «Obtener mi NPSSO» de abajo. 3) Copie el valor de 64 caracteres de «npsso» (o toda la página) y péguelo abajo. El token es una llave de su cuenta: manténgalo en secreto. Dura unos dos meses; la integración le avisa cuando hay que renovarlo. |
| Token NPSSO | secret | Sí | El valor de 64 caracteres que muestra la página «Obtener mi NPSSO». |
| Amigos a seguir | string | No | ID en línea separados por comas, 10 como máximo. Cada uno se convierte en un dispositivo con su presencia y juego actual (su configuración de privacidad debe permitirlo). |
| Consolas en la red local | section | No | Una PS4 o PS5 indica en la red local si está encendida o en reposo, si «Permanecer conectado a Internet» está activado en sus ajustes de ahorro de energía (PS5: también «Habilitar el encendido de la PS5 desde la red»). Use «Buscar mis consolas» abajo, o escriba la dirección IP de la consola si la búsqueda no la encuentra. Sin la red local, el estado de la consola sigue su presencia en PSN. |
| Dirección IP de la consola (opcional) | string | No | |
| Avanzado | section | No | |
| Intervalo de actualización (s) | number | No | Frecuencia de lectura de PlayStation Network, en segundos (un minuto como mínimo: Sony limita el número de solicitudes). |
| Zona horaria | string | No | «Jugado hoy» vuelve a cero a medianoche en esta zona horaria. |
Cómo instalar PlayStation Network en Gladys
- En Gladys, abre Integraciones: PlayStation Network aparece en el catálogo junto a las integraciones nativas, con una insignia de comunidad.
- Haz clic en Instalar. Gladys descarga la imagen Docker (
ghcr.io/prohand/gladys-playstationnetwork:0.0.1), la ejecuta en un entorno aislado del núcleo y genera la interfaz de la integración (dispositivos, descubrimiento y configuración). - Abre la pantalla de Configuración de la integración, rellena los parámetros y guarda.
- También puedes instalarla directamente desde la URL de su repositorio: https://github.com/prohand/gladys-playstationnetwork.
PlayStation Network requiere Gladys >=5.1.0. El catálogo de Gladys se actualiza cada hora, así que una nueva versión está disponible como máximo una hora después de publicarse.
¿Todavía no usas Gladys? Es gratuito y de código abierto: sigue la guía de instalación para empezar.
Sobre las integraciones externas
PlayStation Network es una integración externa: una integración comunitaria empaquetada como contenedor Docker y publicada en GitHub. Gladys la instala con un clic y la ejecuta en un entorno aislado del núcleo. La publica y mantiene prohand, no el equipo principal de Gladys.
- Explorar todas las integraciones, nativas y de la comunidad
- Crear y publicar tu propia integración externa
- Código fuente en GitHub — fuente de esta documentación