Utente

Il modulo Utente fornisce la funzionalità per ottenere le informazioni del giocatore connesso corrente e il Token. Se il gioco non richiede l'accesso per provare tutte le funzionalità, non è necessario utilizzare questo modulo; in caso contrario, è necessario invocare le interfacce correlate per implementare la funzionalità richiesta.

Dopo aver letto la sezione relativa al vostro motore di gioco nella pagina Introduzione a JOGOS_SDK, potete utilizzare le funzionalità nel seguente modo:

window.JOGOS_SDK.user;

Ottenere le informazioni dell'utente corrente

Potete recuperare le informazioni del giocatore corrente con i seguenti metodi:

try {
  const user = await window.JOGOS_SDK.user.getUser();
  console.log('Get user result', user);
} catch (err) {
  // Gestire l'eccezione
  console.error(err);
}

Se il giocatore corrente non è registrato o non ha effettuato l'accesso, il sistema aprirà automaticamente una finestra di dialogo per la registrazione/accesso, richiedendo all'utente di registrarsi o accedere con successo prima di continuare a giocare; in caso contrario, restituirà l'eccezione 401 Non autorizzato, si prega di effettuare nuovamente l'accesso.

Se l'account del giocatore corrente è stato congelato o cancellato, verrà restituita l'informazione di eccezione corrispondente.

La struttura dell'oggetto giocatore restituito con successo è la seguente:

// Informazioni utente
export interface UserInfo {
  // Id utente
  userId: string;
  // Nome utente
  username: string;
  // URL avatar
  profilePictureUrl: string;
  // Id gioco
  gameId: number;
}

Il nome utente in JOGOS_SDK deve essere di 6-20 caratteri e può contenere lettere, numeri, punti e underscore.

Nota: Giochi con più personaggi su un unico account

L'UserId di JOGOS_SDK corrisponde uno-a-uno con l'account del giocatore; se il vostro gioco consente di creare più personaggi o cambiare personaggi su più server, il vostro server deve gestire questa logica per evitare che i giocatori perdano personaggi o non possano cambiare.

Ottenere il token utente (richiede integrazione con il vostro server)

• Se avete un server, dovete integrarvi!
• Il token utente contiene le informazioni relative al giocatore attualmente connesso. Dovete inviarlo al vostro server, verificarlo/decodificarlo lì per estrarre le informazioni rilevanti e collegarlo al vostro sistema utenti, assicurando la sicurezza dei dati durante il processo.

Il vostro client può recuperare il token utente con i seguenti metodi:

try {
  const token = await window.JOGOS_SDK.user.getUserToken();
  console.log('Get token result', token);
} catch (err) {
  // Gestire l'eccezione
  console.error(err);
}

La validità del token è di 1 ora. Consigliamo di non memorizzare il Token e di invocare sempre questo metodo quando serve.

Se il giocatore corrente non è registrato o non ha effettuato l'accesso, il sistema aprirà automaticamente una finestra di dialogo per la registrazione/accesso, richiedendo all'utente di registrarsi o accedere con successo prima di continuare a giocare; in caso contrario, restituirà l'eccezione 401 Non autorizzato, si prega di effettuare nuovamente l'accesso.

Se l'account del giocatore corrente è stato congelato o cancellato, verrà restituita l'informazione di eccezione corrispondente.

Il token restituito può essere decodificato e testato su jwt.io.

Le informazioni del token restituito con successo contengono i seguenti dati 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
}

Non decrittare il token sul client

Per favore, non decrittare il token utente sul client; è insicuro e deve essere gestito dal vostro server.

Quando dovete autenticare le richieste con il vostro server, dovreste inviare il token al vostro server, quindi decodificarlo e verificarlo. Potete utilizzare questa chiave pubblica del token utente https://www.jogos.com/publicKey.json per verificare il token. Consigliamo di ottenere la chiave ogni volta che verificate, poiché potrebbe cambiare.

Prossimo passo: verifica, gestita dal server

Per le API relative al server, consultare la pagina API di integrazione del server.

Test locale

Durante il test locale, le interfacce del modulo Utente restituiscono solo dati simulati.