Usuario

El módulo Usuario proporciona la funcionalidad para obtener la información del jugador conectado actual y el Token. Si el juego no requiere inicio de sesión para disfrutar de todas sus funciones, no es necesario utilizar este módulo; de lo contrario, deberá invocar las interfaces correspondientes para implementar la funcionalidad requerida.

Tras leer la sección correspondiente a su motor de juego en la página de Introducción a JOGOS_SDK, puede utilizar las funciones de la siguiente manera:

window.JOGOS_SDK.user;

Obtener información del usuario actual

Puede recuperar la información del jugador actual con los siguientes métodos:

try {
  const user = await window.JOGOS_SDK.user.getUser();
  console.log('Get user result', user);
} catch (err) {
  // Manejar excepción
  console.error(err);
}

Si el jugador actual no está registrado o no ha iniciado sesión, el sistema abrirá automáticamente un diálogo de registro/inicio de sesión, obligando al usuario a registrarse o iniciar sesión antes de continuar; de lo contrario, devolverá la excepción 401 No autorizado, por favor vuelva a iniciar sesión.

Si la cuenta del jugador actual ha sido congelada o eliminada, también se devolverá la información de excepción correspondiente.

La estructura del objeto de jugador devuelto con éxito es la siguiente:

// Información del usuario
export interface UserInfo {
  // Id del usuario
  userId: string;
  // Nombre de usuario
  username: string;
  // URL del avatar
  profilePictureUrl: string;
  // Id del juego
  gameId: number;
}

El nombre de usuario en JOGOS_SDK debe tener entre 6 y 20 caracteres y puede contener letras, números, puntos y guiones bajos.

Nota: Juegos con múltiples personajes en una sola cuenta

El UserId de JOGOS_SDK se corresponde uno a uno con la cuenta del jugador; si su juego permite crear varios personajes o cambiar entre servidores, su servidor debe gestionar esta lógica para evitar que los jugadores pierdan personajes o no puedan cambiar.

Obtener token de usuario (requiere integración con su servidor)

• ¡Si tiene servidor, necesita integrarse!
• El token de usuario contiene información relacionada con el jugador conectado actual. Debe enviarlo a su servidor, verificar/decodificarlo allí para extraer la información relevante y vincularlo con su sistema de usuarios, asegurando la seguridad de los datos durante el proceso.

Su cliente puede recuperar el token de usuario con los siguientes métodos:

try {
  const token = await window.JOGOS_SDK.user.getUserToken();
  console.log('Get token result', token);
} catch (err) {
  // Manejar excepción
  console.error(err);
}

La vigencia del token es de 1 hora. Recomendamos no almacenar el Token y llamar a este método siempre que se necesite.

Si el jugador actual no está registrado o no ha iniciado sesión, el sistema abrirá automáticamente un diálogo de registro/inicio de sesión, obligando al usuario a registrarse o iniciar sesión antes de continuar; de lo contrario, devolverá la excepción 401 No autorizado, por favor vuelva a iniciar sesión.

Si la cuenta del jugador actual ha sido congelada o eliminada, también se devolverá la información de excepción correspondiente.

El token devuelto puede decodificarse y probarse en jwt.io.

La información del token devuelto con éxito contiene los siguientes datos JSON:

{
  "jti": "1899405772252258304",
  "sub": "{\"profilePictureUrl\":\"a33bf366e34d48e984a094fc923d7b06.png\",\"gameId\":\"1\",\"profileDefaultAvatar\":\"default-avatar.png\",\"userId\":\"88E1B72FED537C6943C85C28F639BE0B\",\"username\":\"55895999999999999999\"}",
  "iss": "com:jogos:sdk",
  "iat": 1741688600,
  "exp": 1745288600
}

No descifrar el token en el cliente

Por favor, no descifre el token de usuario en el cliente; es inseguro y debe ser gestionado por su servidor.

Cuando necesite autenticar solicitudes con su servidor, debe enviar el token a su servidor, luego decodificarlo y verificarlo. Puede usar esta clave pública del token de usuario https://www.jogos.com/publicKey.json para verificar el token. Recomendamos obtener la clave cada vez que verifique, ya que puede cambiar.

Próximo paso: verificación, gestionada por el servidor

Para APIs relacionadas con el servidor, consulte la página de API de integración del servidor.

Prueba local

Durante la prueba local, las interfaces del módulo Usuario solo devuelven datos simulados.