Interfaccia ISiteLicenseService (Documentazione di Steamworks)

Documentazione di Steamworks

Interfaccia ISiteLicenseService

Fornisce l'accesso ai servizi legati ai locali attivi che partecipano al programma di licenza per locali pubblici di Steam.

GetCurrentClientConnections

GET https://api.steampowered.com/ISiteLicenseService/GetCurrentClientConnections/v1/

Nome	Tipo	Richiesto	Descrizione
key	string	✔	Chiave di autenticazione dell'editore per l'API web di Steamworks.
siteid	uint64		ID locale da visualizzare; zero per tutti i locali

Visualizza l'attività attuale di uno o più locali.

La risposta avrà la struttura seguente:

Nome	Tipo	Descrizione
sites	vedi sotto	Una lista dei dettagli dei locali
game_names	vedi sotto	Lista mappata dei nomi dei giochi

game_names ha la struttura seguente:

Nome	Tipo	Descrizione
id	uint32	ID del valore; fa riferimento alle informazioni sul locale sotto riportate
name	stringa	Nome del gioco

sites ha la struttura seguente:

Nome	Tipo	Descrizione
siteid	uint64	ID a 64 bit del locale
site_name	string	Il nome che hai assegnato al locale
clients	vedi sotto	Lista dei client attivi nel locale

clients ha la struttura seguente:

Nome	Tipo	Descrizione
ip_address	string	Indirizzo IP del computer client
hostname	string	Nome del computer client
games	vedi sotto	Lista di sessioni di gioco attive sul computer client

games ha la struttura seguente:

Nome	Tipo	Descrizione
id	uint32	ID del gioco nella sezione `game_names` della risposta
start_time	string	L'orario di inizio di questa sessione di gioco (in formato UTC RFC 3339)
license_type	string	vedi sotto

license_type può avere uno dei valori seguenti:

Valore	Descrizione
user	L'utente possiede una licenza per il gioco
commercial	L'utente sta giocando con una licenza commerciale a pagamento applicata al locale
free	L'utente sta giocando con una licenza commerciale gratuita applicata al locale

GET https://api.steampowered.com/ISiteLicenseService/GetTotalPlaytime/v1/

Nome	Tipo	Richiesto	Descrizione
key	string	✔	Chiave di autenticazione dell'editore per l'API web di Steamworks.
start_time	string	✔	Report delle attività che iniziano a quest'ora o successivamente. Formato UTC RFC 3339.
end_time	string	✔	Report delle attività che iniziano prima di quest'ora. Formato UTC RFC 3339.
siteid	uint64		ID locale da visualizzare; zero per tutti i locali

Ottiene i tempi di gioco totali per tutti i giochi in un dato periodo di tempo, per uno o tutti i locali.

La risposta avrà la struttura seguente:

Nome	Tipo	Descrizione
sites	vedi sotto	Una lista dei dettagli dei locali
game_names	vedi sotto	Lista mappata dei nomi dei giochi

game_names ha la struttura seguente:

Nome	Tipo	Descrizione
id	uint32	ID del valore; fa riferimento alle informazioni sul locale sotto riportate
name	string	Nome del gioco

sites ha la struttura seguente:

Nome	Tipo	Descrizione
siteid	uint64	ID a 64 bit del locale
site_name	string	Il nome che hai assegnato al locale
games	vedi sotto	Lista di tutti i titoli giocati

games ha la struttura seguente:

Nome	Tipo	Descrizione
id	uint32	ID del gioco nella sezione `game_names` della risposta
license_type	string	Il tempo di gioco viene suddiviso tra ciascun titolo in base al tipo di licenza utilizzata. Vedi la sezione GetCurrentClientConnections in alto per l'elenco completo.
playtime_seconds	uint32	Tempo di gioco totale per questo gioco e tipo di licenza, in secondi, per il periodo richiesto.