Fornisce le funzionalità chiave per inizializzare l'API di Steamworks e accedervi.

Tutti i tipi qui elencati sono definizioni globali e non sono associate ad API specifiche.

Funzioni

Queste sono funzioni globali che non richiedono un'interfaccia per essere impostate. Ulteriori informazioni su queste funzioni sono disponibili qui: Panoramica sull'API di Steamworks.

SteamAPI_Init

Avvia l'API di Steamworks.

Per ulteriori informazioni, vedi Inizializzazione e arresto.

Restituisce: bool
true indica che tutte le interfacce richieste sono state acquisite e sono accessibili.
false indica una delle seguente condizioni:

• Il client di Steam non è in esecuzione. Per l'implementazione delle varie interfacce di Steamworks è necessario che sia presente un client di Steam in esecuzione.
  
• Il client di Steam non è riuscito a determinare l'appID del gioco. Se stai eseguendo la tua applicazione direttamente dall'eseguibile o dal debugger, devi avere un file steam_appid.txt vicino all'eseguibile nella directory del gioco. Il file deve contenere solamente l'appID del gioco. Steam cercherà questo file nella directory di lavoro attuale. Se stai lanciando l'eseguibile da una directory diversa, potresti dover spostare il file steam_appid.txt.
  
• La tua applicazione è in esecuzione in un contesto utente del sistema operativo diverso del client di Steam (ad esempio un utente diverso o diversi livelli di permesso).
  
• Assicurati di avere una licenza per l'appID sull'account di Steam attualmente attivo. Il tuo gioco deve apparire sulla tua Libreria di Steam.
  
• Il tuo appID non è interamente configurato. Ad esempio Stato di rilascio: non disponibile o mancano dei pacchetti predefiniti.

Esempio:

SteamAPI_ReleaseCurrentThreadMemory

Libera la memoria interna dell'API di Steamworks associate al processo che ha effettuato la chiamata.

La maggior parte delle funzioni dell'API di Steamworks riserva per i suoi parametri un piccolo ammontare di memoria dei processi locali. Questa chiamata libererà quella memoria. Questa funzione viene chiamata automaticamente da SteamAPI_RunCallbacks, quindi un programma che accede all'API di Steamworks da un singolo processo non dovrà mai chiamarla esplicitamente.

SteamAPI_RestartAppIfNecessary

Nome	Tipo	Descrizione
unOwnAppID	uint32	L'appID di questo titolo.

Verifica se l'eseguibile è stato lanciato tramite Steam. Se non lo è stato, lo lancia tramite Steam.

Per ulteriori informazioni, vedi Inizializzazione e arresto.

Restituisce: bool
Se viene restituito true, si avvierà il client di Steam, se necessario, e il tuo gioco sarà lanciato nuovamente attraverso di esso. Arresta il tuo processo il più presto possibile. Questa funzione esegue steam://run/<AppId> e potrebbe non lanciare nuovamente lo stesso eseguibile che ha eseguito la chiamata, poiché lancerà la versione installata nella tua cartella della Libreria di Steam.

In caso contrario, se viene restituito false, il tuo gioco è stato lanciato tramite il client di Steam e non sono necessarie ulteriori azioni. L'unica eccezione si verifica qualora sia presente un file steam_appid.txt. In questo caso, verrà sempre restituito false. Ciò ti permette di sviluppare e testare senza dover lanciare il tuo gioco tramite il client di Steam. Assicurati di rimuovere il file steam_appid.txt quando carichi il gioco sul tuo depot di Steam!

Esempio:

SteamAPI_RunCallbacks

Distribuisce callback e risultati di chiamata a tutti gli ascoltatori registrati.

È bene effettuare questa chiamata a >10Hz, poiché maggiore è l'intervallo di tempo tra le chiamate, maggiore sarà la potenziale latenza fra gli eventi o i risultati ottenuti dall'API di Steamworks. La maggior parte dei giochi effettua questa chiamata una volta per ogni frame renderizzato. Tutte funzioni registrate in ascolto saranno invocate durante questa chiamata, nel contesto dei processi del caller.

SteamAPI_RunCallbacks può essere chiamata in sicurezza da diversi processi contemporaneamente ma, se decidi di farlo, il codice della callback potrebbe essere eseguito su uno qualunque dei processi. In alternativa, puoi chiamare SteamAPI_RunCallbacks solo dal processo principale e chiamare regolarmente SteamAPI_ReleaseCurrentThreadMemory sugli altri processi.

SteamAPI_SetMiniDumpComment

Nome	Tipo	Descrizione
pchMsg	const char *	Il messaggio da allegare al mini-dump. Deve terminare con NULL.

Allega un commento arbitrario da incorporare nel mini-dump.

Alcuni esempi che potresti volere includere sono: quale livello stava giocando l'utente, quanti giocatori sono presenti sul server, quanta memoria è disponibile, ecc.
Questa chiamata va effettuata prima di quella a SteamAPI_WriteMiniDump.

SteamAPI_Shutdown

Arresta l'API di Steamworks, rilascia i puntatori e libera la memoria.

Se possibile, questa chiamata dovrebbe essere effettuata mentre il processo viene arrestato.

Farlo non libererà l'Overlay di Steam dal tuo gioco, poiché non è possibile sapere se l'API di rendering ha finito di usarlo.

SteamAPI_WriteMiniDump

Nome	Tipo	Descrizione
uStructuredExceptionCode	uint32	Il codice di eccezione strutturato.
pvExceptionInfo	void*	Gli EXCEPTION_POINTERS che contengono le informazioni di eccezione effettive.
uBuildID	uint32	Un ID di una build per rilevare quale versione dell'app ha inviato questo mini-dump. Non sarà lo stesso ID di build di Steam e viene usato solo per segnalare crash.

Scrive e carica un mini-dump per segnalare crash.

Consulta Segnalazione degli errori di Steam per maggiori informazioni.

Puoi aggiungere un commento opzionale chiamando SteamAPI_SetMiniDumpComment prima di chiamare questa funzione.
Esempio:

Strutture

Queste sono strutture con cui steam_api può interagire o che può restituire.

CGameID

L'identificatore unico globale per i giochi di Steam.

CSteamID

L'identificatore unico globale per tutti gli account di Steam, i gruppi di Steam, le lobby e le chat.
Vedi EAccountType e EUniverse.

Enum

Queste sono le enumerazioni definite per l'utilizzo con steam_api.

EAccountType

Tipi di account di Steam. Usata internamente in CSteamID.

Nome	Valore	Descrizione
k_EAccountTypeInvalid	0	Usata per gli ID di Steam non validi.
k_EAccountTypeIndividual	1	Regolare account da utente.
k_EAccountTypeMultiseat	2	Account collegato a più postazioni (ad esempio in un cybercafè).
k_EAccountTypeGameServer	3	Account di un server di gioco persistente (non anonimo).
k_EAccountTypeAnonGameServer	4	Account di un server di gioco anonimo.
k_EAccountTypePending	5	In sospeso.
k_EAccountTypeContentServer	6	Account del server di contenuti interno di Valve.
k_EAccountTypeClan	7	Gruppo di Steam (clan).
k_EAccountTypeChat	8	Chat di gruppo o lobby di Steam.
k_EAccountTypeConsoleUser	9	Finto ID di Steam per account PSN locali su PS3, account Live su 360, ecc.
k_EAccountTypeAnonUser	10	Account utente anonimo. Usato per creare un account o reimpostare una password.
k_EAccountTypeMax	11	Non più di 16 elementi in questo campo.

EAppOwnershipFlags

Contrassegni che rappresentano le informazioni sulla proprietà di un appID. Solo per uso interno di Steam.

Nome	Valore	Descrizione
k_EAppOwnershipFlags_None	0x0000	Sconosciuto.
k_EAppOwnershipFlags_OwnsLicense	0x0001	È in possesso di una licenza per questa app.
k_EAppOwnershipFlags_FreeLicense	0x0002	L'utente non ha effettuato il pagamento per l'app.
k_EAppOwnershipFlags_RegionRestricted	0x0004	È in possesso dell'app ma non può usarla nella regione corrente.
k_EAppOwnershipFlags_LowViolence	0x0008	È in possesso solo di una versione a violenza ridotta.
k_EAppOwnershipFlags_InvalidPlatform	0x0010	L'app non è supportata dalla piattaforma corrente.
k_EAppOwnershipFlags_SharedLicense	0x0020	La licenza è stata condivisa con un dispositivo autorizzato attraverso la condivisione familiare di Steam.
k_EAppOwnershipFlags_FreeWeekend	0x0040	Proprietà ottenuta tramite una licenza di un weekend gratis.
k_EAppOwnershipFlags_RetailLicense	0x0080	È in possesso di una licenza per il gioco (codice prodotto, ecc.). Non più in uso.
k_EAppOwnershipFlags_LicenseLocked	0x0100	La licenza condivisa è bloccata (già in uso) da un altro utente.
k_EAppOwnershipFlags_LicensePending	0x0200	È in possesso dell'app, ma la transazione è ancora in sospeso. Non può ancora installarla o giocarci.
k_EAppOwnershipFlags_LicenseExpired	0x0400	Non è in più possesso dell'app poiché la licenza è scaduta.
k_EAppOwnershipFlags_LicensePermanent	0x0800	Licenza permanente, non condivisa, non ospite, non derivante da un weekend gratis, ecc.
k_EAppOwnershipFlags_LicenseRecurring	0x1000	Licenza ricorrente, l'utente effettua pagamenti periodici.
k_EAppOwnershipFlags_LicenseCanceled	0x2000	Segnalata come annullata, ma potrebbe essere ancora attiva se ricorrente.
k_EAppOwnershipFlags_AutoGrant	0x4000	La proprietà è basata su un qualunque tipo di licenza automatica.
k_EAppOwnershipFlags_PendingGift	0x8000	L'utente ha un dono in sospeso da riscattare.
k_EAppOwnershipFlags_RentalNotActivated	0x10000	Il noleggio non è stato ancora attivato.
k_EAppOwnershipFlags_Rental	0x20000	A noleggio.
k_EAppOwnershipFlags_SiteLicense	0x40000	Proviene da un sito di licenze.

EAppReleaseState

Stato di rilascio di un appID. Solo per uso interno di Steam.

Nome	Valore	Descrizione
k_EAppReleaseState_Unknown	0	Sconosciuto, impossibile ottenere informazioni sull'applicazione, o non sono disponibili informazioni sulla licenza.
k_EAppReleaseState_Unavailable	1	Anche se l'utente ne è in possesso, non sono in grado di visualizzare il gioco.
k_EAppReleaseState_Prerelease	2	Può essere acquistato ed è visibile nella lista dei giochi, nient'altro.
k_EAppReleaseState_PreloadOnly	3	Il proprietario può scaricare in anticipo l'app, ma non giocarla.
k_EAppReleaseState_Released	4	L'utente può scaricare l'app e giocarci.

EAppType

Il tipo di appID. Maggiori informazioni sono disponibili su Tipi di applicazioni. Solo per uso interno di Steam.

Nome	Valore	Descrizione
k_EAppType_Invalid	0x000	Sconosciuto / non valido.
k_EAppType_Game	0x001	Titolo giocabile, tipo predefinito.
k_EAppType_Application	0x002	Applicazione software.
k_EAppType_Tool	0x004	SDK, editor e server dedicati.
k_EAppType_Demo	0x008	Demo di gioco.
k_EAppType_Media_DEPRECATED	0x010	Legacy. Usata per trailer di gioco, che ora sono semplicemente video su internet.
k_EAppType_DLC	0x020	Contenuto scaricabile.
k_EAppType_Guide	0x040	Guida al gioco, PDF, ecc.
k_EAppType_Driver	0x080	Strumento di aggiornamento di driver hardware (ATI, Razor, ecc.).
k_EAppType_Config	0x100	App nascosta usata per configurare le funzionalità di Steam (zaino, sconti, ecc.).
k_EAppType_Hardware	0x200	Dispositivo hardware di Steam (Steam Machine, Steam Controller, Steam Link, ecc.).
k_EAppType_Franchise	0x400	Un hub per le collezioni di diverse app, come film, telefilm, giochi.
k_EAppType_Video	0x800	Una componente video di un film o un telefilm (come uno speciale, un episodio, un anteprima, un video dietro le quinte, ecc.).
k_EAppType_Plugin	0x1000	Tipi di plug-in per altre app.
k_EAppType_Music	0x2000	File musicali.
k_EAppType_Series	0x4000	App contenitore per serie di video.
k_EAppType_Shortcut	0x40000000	Una semplice scorciatoia, solo sul lato client.
k_EAppType_DepotOnly	0x80000000	Temporanea, dato che i depot e le app condividono lo stesso spazio di nomenclatura.

EAuthSessionResponse

Valori di ritorno della callback ValidateAuthTicketResponse_t inviata come risposta a ISteamUser::BeginAuthSession e ISteamGameServer::BeginAuthSession.

Nome	Valore	Descrizione
k_EAuthSessionResponseOK	0	Steam ha verificato che l'utente è online e che il ticket è valido e non è stato riutilizzato.
k_EAuthSessionResponseUserNotConnectedToSteam	1	L'utente in questione non ha effettuato l'accesso a Steam.
k_EAuthSessionResponseNoLicenseOrExpired	2	L'utente non ha una licenza per quest'appID o il ticket è scaduto.
k_EAuthSessionResponseVACBanned	3	L'utente ha ricevuto un ban del VAC per questo gioco.
k_EAuthSessionResponseLoggedInElseWhere	4	L'utente ha effettuato l'accesso da un'altra postazione e la sessione contenente l'istanza di gioco è stata disconnessa.
k_EAuthSessionResponseVACCheckTimedOut	5	Il VAC non è stato in grado di effettuare la verifica anti-trucchi per questo giocatore.
k_EAuthSessionResponseAuthTicketCanceled	6	Il ticket è stato annullato dall'emittente.
k_EAuthSessionResponseAuthTicketInvalidAlreadyUsed	7	Il ticket è stato già usato, non è valido.
k_EAuthSessionResponseAuthTicketInvalid	8	Questo ticket non proviene da un'istanza utente al momento connessa a Steam.
k_EAuthSessionResponsePublisherIssuedBan	9	L'utente è stato bandito da questo gioco. Il ban proviene dall'API web e non dal VAC.

EBeginAuthSessionResult

Risultati restituiti da ISteamUser::BeginAuthSession e ISteamGameServer::BeginAuthSession.

Nome	Valore	Descrizione
k_EBeginAuthSessionResultOK	0	Il ticket è valido per questo gioco e per questo ID di Steam.
k_EBeginAuthSessionResultInvalidTicket	1	Il ticket non è valido.
k_EBeginAuthSessionResultDuplicateRequest	2	Un ticket per questo ID di Steam è stato già inviato.
k_EBeginAuthSessionResultInvalidVersion	3	Il ticket appartiene a una versione incompatibile dell'interfaccia.
k_EBeginAuthSessionResultGameMismatch	4	Il ticket non appartiene a questo gioco.
k_EBeginAuthSessionResultExpiredTicket	5	Il ticket è scaduto.

EBroadcastUploadResult

Il risultato del caricamento della trasmissione da BroadcastUploadStop_t.

Nome	Valore	Descrizione
k_EBroadcastUploadResultNone	0	Stato della trasmissione sconosciuto.
k_EBroadcastUploadResultOK	1	Nessun problema con la trasmissione.
k_EBroadcastUploadResultInitFailed	2	Avvio della trasmissione non riuscito.
k_EBroadcastUploadResultFrameFailed	3	Caricamento del riquadro della tramissione non riuscito.
k_EBroadcastUploadResultTimeout	4	Tempo scaduto per il caricamento della trasmissione.
k_EBroadcastUploadResultBandwidthExceeded	5	La trasmissione sta inviando troppi dati.
k_EBroadcastUploadResultLowFPS	6	Gli FPS della trasmissione sono troppo bassi.
k_EBroadcastUploadResultMissingKeyFrames	7	La trasmissione non sta inviando abbastanza fotogrammi chiave.
k_EBroadcastUploadResultNoConnection	8	Il client di trasmissione non è riuscito a connettersi al relè.
k_EBroadcastUploadResultRelayFailed	9	Il relè ha smesso di effettuare il caricamento.
k_EBroadcastUploadResultSettingsChanged	10	Il client ha modificato le impostazioni della trasmissione.
k_EBroadcastUploadResultMissingAudio	11	Invio di dati audio da parte del client fallito.
k_EBroadcastUploadResultTooFarBehind	12	Il client ha impiegato troppo tempo per il caricamento.
k_EBroadcastUploadResultTranscodeBehind	13	Il server non è riuscito a seguire la transcodifica.

EChatEntryType

Tipi di attività della chat.

Restituiti da ISteamFriends::GetFriendMessage, ISteamFriends::GetClanChatMessage e ISteamMatchmaking::GetLobbyChatEntry.

Nome	Valore	Descrizione
k_EChatEntryTypeInvalid	0	Non valido.
k_EChatEntryTypeChatMsg	1	Un normale messaggio di testo da parte di un altro utente.
k_EChatEntryTypeTyping	2	L'altro utente sta digitando. Non viene usato in chat con più di due utenti.
k_EChatEntryTypeInviteGame	3	Invito da parte di un altro utente al gioco in esecuzione dall'utente corrente.
k_EChatEntryTypeEmote	4	Messaggio di testo con un'emoticon (non più in uso, da trattare come ChatMsg).
k_EChatEntryTypeLeftConversation	6	Un utente ha lasciato la conversazione (ha chiuso la finestra di chat).
k_EChatEntryTypeEntered	7	L'utente è entrato nella conversazione. Utilizzato in chat con più di 2 utenti e chat di gruppo.
k_EChatEntryTypeWasKicked	8	L'utente è stato espulso (dati: ID di Steam dell'utente che ha inflitto l'espulsione).
k_EChatEntryTypeWasBanned	9	L'utente è stato bandito (dati: l'ID di Steam dell'utente che ha inflitto il ban).
k_EChatEntryTypeDisconnected	10	L'utente si è disconnesso.
k_EChatEntryTypeHistoricalChat	11	Un messaggio di chat dalla cronologia dell'utente o un messaggio offline.
k_EChatEntryTypeLinkBlocked	14	Un link è stato rimosso dal filtro della chat.

EChatRoomEnterResponse

Risposte per l'ingresso in una chat.

Nome	Valore	Descrizione
k_EChatRoomEnterResponseSuccess	1	Successo.
k_EChatRoomEnterResponseDoesntExist	2	La chat non esiste (probabilmente è stata chiusa).
k_EChatRoomEnterResponseNotAllowed	3	Permesso negato generico. Non hai i permessi per unirti alla chat.
k_EChatRoomEnterResponseFull	4	La chat ha raggiunto il suo numero di utenti massimo.
k_EChatRoomEnterResponseError	5	Errore inaspettato.
k_EChatRoomEnterResponseBanned	6	Sei bandito da questa chat e non puoi unirti.
k_EChatRoomEnterResponseLimited	7	Non puoi unirti a questa chat perché sei un utente limitato (account senza valore).
k_EChatRoomEnterResponseClanDisabled	8	Tentativo di unirsi alla chat di un clan quando il clan è bloccato o disabilitato.
k_EChatRoomEnterResponseCommunityBan	9	Tentativo di unirsi a una chat da parte di un utente con un blocco delle Comunità sul suo account.
k_EChatRoomEnterResponseMemberBlockedYou	10	Ingresso in chat non riuscito. Un utente già nella chat ha bloccato il tuo accesso.
k_EChatRoomEnterResponseYouBlockedMember	11	Ingresso in chat non riuscito. Hai bloccato un utente già presente nella chat.
k_EChatRoomEnterResponseRatelimitExceeded	15	Unione non riuscita: troppi tentativi di unione in un periodo di tempo molto breve.

EChatSteamIDInstanceFlags

Contrassegni speciali per gli account nella chat. Si trovano nei primi 8 bit dell'"istanza" dell'ID di Steam. Altri 12 bit sono riservati alle istanze effettive.

Nome	Valore	Descrizione
k_EChatAccountInstanceMask	0x00000FFF	I primi 8 bit sono contrassegni.
k_EChatInstanceFlagClan	( k_unSteamAccountInstanceMask + 1 ) >> 1	L'ID di Steam appartiene a un gruppo di Steam.
k_EChatInstanceFlagLobby	( k_unSteamAccountInstanceMask + 1 ) >> 2	L'ID di Steam appartiene a una lobby.
k_EChatInstanceFlagMMSLobby	( k_unSteamAccountInstanceMask + 1 ) >> 3	L'ID di Steam appartiene a una lobby MMS.

EDenyReason

I valori dati quando un client non riesce a unirsi o è stato espulso da un server di gioco. Ottenuti da GSClientDeny_t e GSClientKick_t.

Nome	Valore	Descrizione
k_EDenyInvalid	0	Sconosciuto.
k_EDenyInvalidVersion	1	Il client e il server non sono alla stessa versione.
k_EDenyGeneric	2	Generico.
k_EDenyNotLoggedOn	3	Il client non ha effettuato l'accesso.
k_EDenyNoLicense	4	Il client non ha una licenza per giocare a questo titolo.
k_EDenyCheater	5	Il client ha ricevuto un ban del VAC.
k_EDenyLoggedInElseWhere	6	Il client ha effettuato l'accesso su un'altra postazione.
k_EDenyUnknownText	7
k_EDenyIncompatibleAnticheat	8
k_EDenyMemoryCorruption	9
k_EDenyIncompatibleSoftware	10
k_EDenySteamConnectionLost	11	Il server ha perso la connessione a Steam.
k_EDenySteamConnectionError	12	Il server ha riscontrato un errore generico durante la connessione a Steam.
k_EDenySteamResponseTimedOut	13	Il tempo a disposizione del server per connettersi a Steam è scaduto.
k_EDenySteamValidationStalled	14	Il client non è stato ancora autenticato da Steam.
k_EDenySteamOwnerLeftGuestUser	15	Il proprietario del gioco condiviso è uscito. Viene chiamata per ogni ospite del proprietario.

EGameIDType

Utilizzata per descrivere il tipo di CGameID.

Nome	Valore	Descrizione
k_EGameIDTypeApp	0	L'ID del gioco è una normale app di Steam.
k_EGameIDTypeGameMod	1	L'ID di gioco è un mod.
k_EGameIDTypeShortcut	2	L'ID di gioco è una scorciatoia.
k_EGameIDTypeP2P	3	L'ID di gioco è un file P2P.

ELaunchOptionType

Codici per opzioni di lancio ben definite. Corrisponde a "Launch Type" nelle opzioni di lancio dell'applicazione, che possono essere consultate alla pagina Impostazioni generali di installazione.

La funzione speciale BIsVRLaunchOptionType si può usare per verificare se il tipo è una delle opzioni di lancio VR.

Nome	Valore	Descrizione
k_ELaunchOptionType_None	0	Non specificato.
k_ELaunchOptionType_Default	1	Esegue l'app in modalità predefinita.
k_ELaunchOptionType_SafeMode	2	Esegue il gioco in modalità sicura.
k_ELaunchOptionType_Multiplayer	3	Esegue il gioco in modalità multigiocatore.
k_ELaunchOptionType_Config	4	Esegue lo strumento di configurazione per questo gioco.
k_ELaunchOptionType_OpenVR	5	Esegue il gioco in modalità VR utilizzando OpenVR.
k_ELaunchOptionType_Server	6	Esegue il server dedicato per questo gioco.
k_ELaunchOptionType_Editor	7	Esegue l'editor del gioco.
k_ELaunchOptionType_Manual	8	Mostra il manuale di gioco.
k_ELaunchOptionType_Benchmark	9	Esegue il benchmark del gioco.
k_ELaunchOptionType_Option1	10	Opzione di esecuzione generica, usa il campo della descrizione per il titolo del gioco.
k_ELaunchOptionType_Option2	11	Opzione di esecuzione generica, usa il campo della descrizione per il titolo del gioco.
k_ELaunchOptionType_Option3	12	Opzione di esecuzione generica, usa il campo della descrizione per il titolo del gioco.
k_ELaunchOptionType_OculusVR	13	Esegue il gioco in modalità VR utilizzando L'SDK di Oculus.
k_ELaunchOptionType_OpenVROverlay	14	Esegue un'overlay della dashboard di OpenVR.
k_ELaunchOptionType_OSVR	15	Esegue il gioco in modalità VR utilizzando L'SDK di OSVR.
k_ELaunchOptionType_Dialog	1000	Mostra la finestra di dialogo con le opzioni di esecuzione.

EMarketingMessageFlags

Contrassegni di messaggi di marketing interni a Steam che modificano il modo in cui un client dovrebbe gestirli.

Nome	Valore	Descrizione
k_EMarketingMessageFlagsNone	0
k_EMarketingMessageFlagsHighPriority	1 << 0
k_EMarketingMessageFlagsPlatformWindows	1 << 1
k_EMarketingMessageFlagsPlatformMac	1 << 2
k_EMarketingMessageFlagsPlatformLinux	1 << 3
k_EMarketingMessageFlagsPlatformRestrictions	=	contrassegni aggregati

ENotificationPosition

Le possibili posizioni in cui l'overlay può fare apparire le notifiche. Utilizzata con ISteamUtils::SetOverlayNotificationPosition.

Nome	Valore	Descrizione
k_EPositionTopLeft	0	Nell'angolo in alto a sinistra.
k_EPositionTopRight	1	Nell'angolo in alto a destra.
k_EPositionBottomLeft	2	Nell'angolo in basso a sinistra.
k_EPositionBottomRight	3	Nell'angolo in basso a destra.

EResult

Codici di errore di Steam.

Vengono spesso restituiti da funzioni, callback e risultati di chiamata provenienti sia dall'API di Steamworks che dall'API web. Un'API potrebbe restituire codici Eresult arbitrari. Per vedere cosa potrebbe essere restituito nel contesto di una determinata chiamata API o di una callback, consulta le loro documentazioni specifiche.
Simile al tipo HRESULT di Win32 o l'errno POSIX.

Nome	Valore	Descrizione
k_EResultOK	1	Successo.
k_EResultFail	2	Fallimento generico.
k_EResultNoConnection	3	Il tuo client di Steam non è connesso al back-end.
k_EResultInvalidPassword	5	La password/il ticket non sono validi.
k_EResultLoggedInElsewhere	6	L'utente ha effettuato l'accesso su un'altra postazione.
k_EResultInvalidProtocolVer	7	La versione del protocollo non è corretta.
k_EResultInvalidParam	8	Uno dei parametri non è corretto.
k_EResultFileNotFound	9	Il file non è stato trovato.
k_EResultBusy	10	Il metodo di chiamata è occupato, nessuna azione effettuata.
k_EResultInvalidState	11	L'oggetto chiamato si trovava in uno stato non valido.
k_EResultInvalidName	12	Il nome non era valido.
k_EResultInvalidEmail	13	L'e-mail non era valida.
k_EResultDuplicateName	14	Il nome non è unico.
k_EResultAccessDenied	15	Accesso negato.
k_EResultTimeout	16	Tempo per l'operazione scaduto.
k_EResultBanned	17	L'utente è bandito dal VAC2.
k_EResultAccountNotFound	18	Account non trovato.
k_EResultInvalidSteamID	19	L'ID di Steam non era valido.
k_EResultServiceUnavailable	20	Il servizio richiesto non è al momento disponibile.
k_EResultNotLoggedOn	21	L'utente non ha effettuato l'accesso.
k_EResultPending	22	La richiesta è in sospeso, potrebbe essere in fase di elaborazione o in attesa di una terza parte.
k_EResultEncryptionFailure	23	Codifica o decodifica fallite.
k_EResultInsufficientPrivilege	24	Privilegi insufficienti.
k_EResultLimitExceeded	25	Limite superato.
k_EResultRevoked	26	L'accesso è stato revocato (usato per pass ospiti revocati).
k_EResultExpired	27	La licenza/il pass ospite a cui l'utente sta cercando di accedere è scaduto.
k_EResultAlreadyRedeemed	28	Il pass ospite è stato già riscattato dall'account e non può essere utilizzato di nuovo.
k_EResultDuplicateRequest	29	La richiesta è un duplicato e l'azione è già avvenuta in passato. Ignora questa volta.
k_EResultAlreadyOwned	30	Tutti i giochi richiesti riscattando questo pass ospite sono già in possesso dell'utente.
k_EResultIPNotFound	31	Indirizzo IP non trovato.
k_EResultPersistFailed	32	Impossibile scrivere la modifica nell'archivio dei dati.
k_EResultLockingFailed	33	Impossibile acquisire il blocco all'accesso per questa operazione.
k_EResultLogonSessionReplaced	34	La sessione di accesso è stata sostituita.
k_EResultConnectFailed	35	Impossibile connettersi.
k_EResultHandshakeFailed	36	L'handshake di autenticazione è fallito.
k_EResultIOFailure	37	Fallimento generico in entrata o in uscita.
k_EResultRemoteDisconnect	38	Il server remoto si è disconnesso.
k_EResultShoppingCartNotFound	39	Impossibile trovare il carrello richiesto.
k_EResultBlocked	40	Un utente ha bloccato l'azione.
k_EResultIgnored	41	Il destinatario sta ignorando il mittente.
k_EResultNoMatch	42	Nessuna corrispondenza con la richiesta.
k_EResultAccountDisabled	43	L'account è disabilitato.
k_EResultServiceReadOnly	44	Questo servizio al momento non accetta cambi nel contenuto.
k_EResultAccountNotFeatured	45	L'account non ha valore, quindi questa funzionalità non è disponibile.
k_EResultAdministratorOK	46	È possibile effettuare questa azione, ma solo perché il richiedente è un amministratore.
k_EResultContentVersion	47	Mancata corrispondenza del contenuto trasmesso all'interno del protocollo di Steam.
k_EResultTryAnotherCM	48	La CM corrente non può assecondare la richiesta dell'utente, l'utente dovrebbe provarne un'altra.
k_EResultPasswordRequiredToKickSession	49	Hai già effettuato l'accesso da un'altra postazione. Accesso con queste credenziali memorizzate fallito.
k_EResultAlreadyLoggedInElsewhere	50	L'utente ha effettuato l'accesso su un'altra postazione. Usa k_EResultLoggedInElsewhere invece!
k_EResultSuspended	51	Un'operazione dalla lunga durata è stata sospesa/messa in pausa (ad esempio il download dei contenuti).
k_EResultCancelled	52	L'operazione è stata annullata, di solito dall'utente (ad esempio il download dei contenuti).
k_EResultDataCorruption	53	Operazione annullata: i dati sono corrotti o impossibili da recuperare.
k_EResultDiskFull	54	Operazione annullata: spazio sul disco insufficiente.
k_EResultRemoteCallFailed	55	Chiamata remota o IPC fallite.
k_EResultPasswordUnset	56	La password non è impostata sul lato server, impossibile verificarla.
k_EResultExternalAccountUnlinked	57	L'account esterno (PSN, Facebook, ecc.) non è connesso a un account di Steam.
k_EResultPSNTicketInvalid	58	Ticket PSN non valido.
k_EResultExternalAccountAlreadyLinked	59	L'account esterno (PSN, Facebook, ecc.) è già connesso a un altro account. È necessario prima richiedere esplicitamente di rimpiazzare/annullare la connessione.
k_EResultRemoteFileConflict	60	Impossibile riprendere la sincronizzazione: conflitto tra i file locali e quelli remoti.
k_EResultIllegalPassword	61	La nuova password richiesta non è consentita.
k_EResultSameAsPreviousValue	62	Il nuovo valore è uguale a quello precedente. Usato per la domanda segreta e la relativa risposta.
k_EResultAccountLogonDenied	63	Accesso negato: autenticazione in due passaggi non riuscita.
k_EResultCannotUseOldPassword	64	La nuova password richiesta non è legale.
k_EResultInvalidLoginAuthCode	65	Accesso negato: il codice di autenticazione non è valido.
k_EResultAccountLogonDeniedNoMail	66	Accesso negato: autenticazione in due passaggi non riuscita e non è stata inviata una e-mail.
k_EResultHardwareNotCapableOfIPT	67	L'hardware dell'utente non supporta la tecnologia di protezione dell'identità di Intel (IPT).
k_EResultIPTInitError	68	Errore nell'avvio della tecnologia di protezione dell'identità di Intel (IPT).
k_EResultParentalControlRestricted	69	Operazione fallita per via di restrizioni del controllo familiare per l'utente corrente.
k_EResultFacebookQueryError	70	La richiesta di Facebook ha restituito un errore.
k_EResultExpiredLoginAuthCode	71	Accesso all'account negato: codice di autorizzazione scaduto.
k_EResultIPLoginRestrictionFailed	72	Accesso non riuscito per via di un restrizione all'indirizzo IP.
k_EResultAccountLockedDown	73	L'account dell'utente corrente al momento è bloccato dall'uso. La probabile causa è un furto di account e la relativa verifica di proprietà in sospeso.
k_EResultAccountLogonDeniedVerifiedEmailRequired	74	Accesso fallito: l'e-mail collegata all'account non è stata verificata.
k_EResultNoMatchingURL	75	Nessun URL corrisponde ai valori forniti.
k_EResultBadResponse	76	Risposta non valida a causa di un fallimento nell'analisi, un campo mancante, ecc.
k_EResultRequirePasswordReEntry	77	L'utente non può completare l'operazione finché non reimmette la sua password.
k_EResultValueOutOfRange	78	Il valore inserito è al di fuori dell'intervallo accettabile.
k_EResultUnexpectedError	79	È successo qualcosa che non pensavamo sarebbe mai successo.
k_EResultDisabled	80	Il servizio richiesto è stato configurato in modo tale da non essere disponibile.
k_EResultInvalidCEGSubmission	81	I file inviati al server CEG non sono validi.
k_EResultRestrictedDevice	82	Al dispositivo in uso non è consentito effettuare questa azione.
k_EResultRegionLocked	83	Impossibile completare l'azione: uso ristretto nella regione.
k_EResultRateLimitExceeded	84	Superato il limite temporaneo di banda, ritenta più tardi. Diverso da k_EResultLimitExceeded, che potrebbe essere permanente.
k_EResultAccountLoginDeniedNeedTwoFactor	85	Per effettuare l'accesso è necessaria l'autenticazione a due passaggi.
k_EResultItemDeleted	86	L'elemento a cui stiamo cercando di accedere è stato eliminato.
k_EResultAccountLoginDeniedThrottle	87	Tentativo di accesso non riuscito, prova a inviare la risposta a un possibile hacker.
k_EResultTwoFactorCodeMismatch	88	Codice di autenticazione a due passaggi (Steam Guard) incorretto.
k_EResultTwoFactorActivationCodeMismatch	89	Il codice di attivazione per l'autenticazione a due passaggi (Steam Guard) non corrisponde.
k_EResultAccountAssociatedToMultiplePartners	90	L'account corrente è stato associato a più partner.
k_EResultNotModified	91	I dati non sono stati modificati.
k_EResultNoMobileDevice	92	L'account non ha un dispositivo mobile associato.
k_EResultTimeNotSynced	93	L'orario presentato è al di fuori dell'intervallo consentito.
k_EResultSmsCodeFailed	94	Codice SMS fallito: nessuna corrispondenza, nessuna in sospeso, ecc.
k_EResultAccountLimitExceeded	95	Troppi account accedono a questa risorsa.
k_EResultAccountActivityLimitExceeded	96	Troppi cambiamenti a questo account.
k_EResultPhoneActivityLimitExceeded	97	Troppi cambiamenti a questo telefono.
k_EResultRefundToWallet	98	Impossibile effettuare il rimborso sul metodo di pagamento, va usato il Portafoglio.
k_EResultEmailSendFailure	99	Impossibile inviare un'e-mail.
k_EResultNotSettled	100	Impossibile eseguire l'operazione fino alla conferma del pagamento.
k_EResultNeedCaptcha	101	L'utente deve immettere un captcha valido.
k_EResultGSLTDenied	102	Un token di accesso al server di gioco in possesso dell'proprietario di questo token è stato bandito.
k_EResultGSOwnerDenied	103	Il proprietario del server di gioco non è consentito per altre ragioni, come un blocco dell'account, un ban della Comunità, un ban del VAC, un numero di telefono mancante, ecc.
k_EResultInvalidItemType	104	Il tipo di elemento su cui ci è stato richiesto di operare non è valido.
k_EResultIPBanned	105	L'indirizzo IP è stato bandito dall'eseguire questa azione.
k_EResultGSLTExpired	106	Questo token per l'accesso al server di gioco (GSLT) è scaduto per inutilizzo. Può essere reimpostato per l'utilizzo.
k_EResultInsufficientFunds	107	L'utente non ha abbastanza fondi nel Portafoglio per completare questa operazione.
k_EResultTooManyPending	108	Ci sono già troppi elementi in sospeso.

ESteamUserStatType

Campi usati internamente per memorizzare statistiche degli utenti.

Nome	Valore	Descrizione
k_ESteamUserStatTypeINVALID	0	Non valida.
k_ESteamUserStatTypeINT	1	Statistica intera a 32 bit.
k_ESteamUserStatTypeFLOAT	2	Statistica a virgola mobile a 32 bit.
k_ESteamUserStatTypeAVGRATE	3	Leggi come a virgola mobile, imposta con lunghezza o conteggio delle sessioni.
k_ESteamUserStatTypeACHIEVEMENTS	4	Normale achievement dell'utente.
k_ESteamUserStatTypeGROUPACHIEVEMENTS	5	Non più in uso.
k_ESteamUserStatTypeMAX	6	Numero totale dei tipi di statistiche dell'utente, utilizzato per verifiche di correttezza.

ETextFilteringContext

Parametro per ISteamUtils::FilterText.

Nome	Valore	Descrizione
k_ETextFilteringContextUnknown	0	Contesto sconosciuto.
k_ETextFilteringContextGameContent	1	Contenuto di gioco. Viene eseguito solo il filtraggio richiesto legalmente.
k_ETextFilteringContextChat	2	Chat da un altro giocatore.
k_ETextFilteringContextName	3	Nome del personaggio o dell'oggetto.

EUniverse

Universi di Steam. Ogni universo è un'istanza di Steam autocontenuta.

Nome	Valore	Descrizione
k_EUniverseInvalid	0	Non valido.
k_EUniversePublic	1	L'universo pubblico standard.
k_EUniverseBeta	2	Universo beta utilizzato internamente da Valve.
k_EUniverseInternal	3	Universo interno utilizzato internamente da Valve.
k_EUniverseDev	4	Universo da sviluppatore utilizzato internamente da Valve.
k_EUniverseMax	5	Numero totale degli universi, utilizzato per verifiche di correttezza.

EUserHasLicenseForAppResult

Risultato di ISteamUser::UserHasLicenseForApp.

Nome	Valore	Descrizione
k_EUserHasLicenseResultHasLicense	0	L'utente ha una licenza per l'applicazione specificata.
k_EUserHasLicenseResultDoesNotHaveLicense	1	L'utente non ha una licenza per l'app specificata.
k_EUserHasLicenseResultNoAuth	2	L'utente non è stato autenticato.

EVoiceResult

Risultati da utilizzare con le funzioni Steam Voice.

Nome	Valore	Descrizione
k_EVoiceResultOK	0	La chiamata è stata completata con successo.
k_EVoiceResultNotInitialized	1	L'interfaccia della chat vocale di Steam non è stata avviata.
k_EVoiceResultNotRecording	2	La chat vocale di Steam non sta registrando.
k_EVoiceResultNoData	3	Nessun dato sulla chat vocale disponibile.
k_EVoiceResultBufferTooSmall	4	Il buffer fornito è troppo piccolo per ricevere i dati.
k_EVoiceResultDataCorrupted	5	I dati sulla chat vocale sono stati corrotti.
k_EVoiceResultRestricted	6	All'utente non è consentito accedere alla chat.
k_EVoiceResultUnsupportedCodec	7	Non più in uso.
k_EVoiceResultReceiverOutOfDate	8	Non più in uso.
k_EVoiceResultReceiverDidNotAnswer	9	Non più in uso.

EVRHMDType

Punti di codice per modelli e distributori di visori VR. Per cercare un marchio specifico utilizza le funzioni speciali BIsOculusHMD e BIsViveHMD.

Nome	Valore	Descrizione
k_eEVRHMDType_None	-1	Produttore e modello sconosciuti.
k_eEVRHMDType_Unknown	0	Produttore e modello sconosciuti.
k_eEVRHMDType_HTC_Dev	1	Kit da sviluppatore HTC originale.
k_eEVRHMDType_HTC_VivePre	2	Kit da sviluppatore HTC Vive Pro.
k_eEVRHMDType_HTC_Vive	3	Versione per il cliente di HTC Vive.
k_eEVRHMDType_HTC_Unknown	20	Visore HTC sconosciuto.
k_eEVRHMDType_Oculus_DK1	21	Kit da sviluppatore Oculus Rift 1.
k_eEVRHMDType_Oculus_DK2	22	Kit da sviluppatore Oculus Rift 2.
k_eEVRHMDType_Oculus_Rift	23	Versione per il cliente di Oculus Rift 1.
k_eEVRHMDType_Oculus_Unknown	40	Visore Oculus sconosciuto.

Typedefs

Queste sono le definizioni del tipo definite per l'utilizzo con steam_api.

Nome	Tipo base	Descrizione
AccountID_t	uint32	Utilizzata internamente in CSteamID per rappresentare uno specifico account utente, senza considerare di quale universo di Steam faccia parte.
AppId_t	uint32	Identificatore unico per un'app. Per ulteriori informazioni consulta la documentazione Applicazioni.
AssetClassId_t	uint64	Per uso interno di Steam.
BREAKPAD_HANDLE	void *	Utilizzato dalle interfacce degli handler dei crash interne di Steam per fare riferimento a specifici handler di crash installati.
BundleId_t	uint32	Identificatore unico per un bundle. Solo per uso interno di Steam.
CellID_t	uint32	Solo per uso interno di Steam.
DepotId_t	uint32	Identificatore unico per un depot.
GID_t	uint64	Solo per uso interno di Steam.
HAuthTicket	uint32	Handle per un ticket di autenticazione dell'utente. Tipo restituito da ISteamUser::GetAuthSessionTicket.
int16	short	La versione di Steam di un integrale a 16 bit, equivalente a int16_t.
int32	int	La versione di Steam di un integrale a 32 bit, equivalente a int32_t.
int64	long long	La versione di Steam di un integrale a 64 bit, equivalente a int64_t.
int8	signed char	La versione di Steam di un integrale a 8 bit, equivalente a int8_t.
intp	int/long long	La versione di Steam di un tipo che può contenere un puntatore, equivalente a intptr_t. Solo per uso interno di Steam.
JobID_t	uint64	Solo per uso interno di Steam.
lint64	long int	Solo per uso interno di Steam.
ManifestId_t	uint64	Solo per uso interno di Steam.
PackageId_t	uint32	Solo per uso interno di Steam.
PartnerId_t	uint32	Solo per uso interno di Steam.
PhysicalItemId_t	uint32	Solo per uso interno di Steam.
RTime32	uint32	La versione di Steam dell'orario in formato epoch Unix. Offre una risoluzione di 1 secondo a partire dall'epoch, 1970-01-01 00:00:00 +0000 (UTC).
SteamAPICall_t	uint64	Handle unico a una chiamata all'API di Steam. Se la funzione ne restituisce uno, dovrai rintracciare il suo stato utilizzando il sistema dei risultati di chiamata.
TxnID_t	GID_t	Solo per uso interno di Steam.
uint16	unsigned short	La versione di Steam di un integrale non firmato a 16 bit, equivalente a uint16_t.
uint32	unsigned int	La versione di Steam di un integrale non firmato a 32 bit, equivalente a uint32_t.
uint64	unsigned long long	La versione di Steam di un integrale non firmato a 64 bit, equivalente a uint64_t.
uint8	unsigned char	La versione di Steam di un integrale non firmato a 8 bit, equivalente a uint8_t.
uintp	unsigned int/unsigned long long	La versione di Steam di un tipo non firmato che può contenere un puntatore, equivalente a uintptr_t. Solo per uso interno di Steam.
ulint64	unsigned long int	Solo per uso interno di Steam.

Costanti

Queste sono costanti definite per l'uso con steam_api.

Nome	Tipo	Valore	Descrizione
BREAKPAD_INVALID_HANDLE	int	(BREAKPAD_HANDLE)0
k_cchGameExtraInfoMax	int	64	Le dimensioni massime (in byte UTF-8, incluso il terminatore null) del parametro pchExtraInfo di ISteamUser::TrackAppUsageEvent.
k_cubSaltSize	int	8	Solo per uso interno di Steam.
k_GIDNil	GID_t	0xffffffffffffffffull	Solo per uso interno di Steam.
k_HAuthTicketInvalid	HAuthTicket	0	Un ticket di autenticazione utente non valido.
k_JobIDNil	JobID_t	0xffffffffffffffffull	Solo per uso interno di Steam.
k_steamIDLanModeGS	int	CSteamID(	L'ID di Steam proviene dalla connessione del gioco dell'utente a un server di gioco sv_lan.
k_steamIDNil	int	CSteamID()	CSteamID generico non valido.
k_steamIDNonSteamGS	int	CSteamID(	L'ID di Steam potrebbe provenire da una connessione del gioco dell'utente a un server di gioco che non utilizza il sistema di autenticazione di Steam ma che vuole lo stesso supportare l'opzione "Unisciti al gioco" nella lista degli amici.
k_steamIDNotInitYetGS	int	CSteamID(	L'ID di Steam potrebbe provenire da una connessione del gioco dell'utente a un server di gioco che si è appena avviato ma che non ha ancora avviato la sua componente steam3 e non ha iniziato a effettuare l'accesso.
k_steamIDOutofDateGS	int	CSteamID(	L'ID di Steam proviene da una connessione del gioco dell'utente a un server di gioco non aggiornato che non ha implementato il protocollo per fornire il suo ID di Steam.
k_TxnIDNil	GID_t	k_GIDNil	Solo per uso interno di Steam.
k_TxnIDUnknown	GID_t	0	Solo per uso interno di Steam.
k_uAPICallInvalid	SteamAPICall_t	0x0	Un handle non valido a una chiamata all'API di Steam.
k_uAppIdInvalid	AppId_t	0x0	Un appID non valido.
k_uBundleIdInvalid	BundleId_t	0	Solo per uso interno di Steam.
k_uCellIDInvalid	CellID_t	0xFFFFFFFF	Solo per uso interno di Steam.
k_uDepotIdInvalid	DepotId_t	0x0	Un ID di un depot non valido.
k_ulAssetClassIdInvalid	AssetClassId_t	0x0	Solo per uso interno di Steam.
k_uManifestIdInvalid	ManifestId_t	0	Solo per uso interno di Steam.
k_unSteamAccountIDMask	unsigned int	0xFFFFFFFF	Utilizzato in CSteamID per mascherare AccountID_t.
k_unSteamAccountInstanceMask	unsigned int	0x000FFFFF	Utilizzato in CSteamID per mascherare l'istanza dell'account.
k_unSteamUserConsoleInstance	unsigned int	2	Utilizzato da CSteamID per identificare gli utenti che hanno effettuato l'accesso da una console.
k_unSteamUserDesktopInstance	unsigned int	1	Utilizzato da CSteamID per identificare gli utenti che hanno effettuato l'accesso dal client desktop.
k_unSteamUserWebInstance	unsigned int	4	Utilizzato da CSteamID per identificare gli utenti che hanno effettuato l'accesso sul web.
k_uPackageIdFreeSub	PackageId_t	0x0	Solo per uso interno di Steam.
k_uPackageIdInvalid	PackageId_t	0xFFFFFFFF	Solo per uso interno di Steam.
k_uPartnerIdInvalid	PartnerId_t	0	Solo per uso interno di Steam.
k_uPhysicalItemIdInvalid	PhysicalItemId_t	0x0	Solo per uso interno di Steam.
QUERY_PORT_ERROR	int	0xFFFE	Non siamo stati in grado di ottenere la porta di richiesta per questo server.
QUERY_PORT_NOT_INITIALIZED	int	0xFFFF	----------------------------------------------------------------------------- Costanti usate per le porte di richiesta. ----------------------------------------------------------------------------- Non abbiamo ancora chiesto al server il valore effettivo della porta di richiesta.