Interfaccia che fornisce accesso a diverse utility.
Funzioni membro
Le funzioni membro di
ISteamUtils
vengono chiamate tramite la funzione globale di accesso
SteamUtils()
.
BOverlayNeedsPresent
bool BOverlayNeedsPresent();
Controlla se l'Overlay necessita di una chiamata a Present. Richiesto solo se si utilizzano aggiornamenti rendering guidati dagli eventi.
Di solito questa chiamata non è necessaria se il tuo gioco, come nella maggior parte dei casi, esegue un loop dei fotogrammi continuo che chiama le API D3D Present o OGL SwapBuffers a ogni fotogramma. Tuttavia, se il tuo gioco aggiorna lo schermo in base agli eventi, l'Overlay può venire corrotto poiché usa le tue chiamate Present/SwapBuffers per guidare il proprio loop interno dei fotogrammi e potrebbe anche aver bisogno di trasmettere Present() allo schermo ogni volta che si attiva una notifica o quando l'Overlay viene attivato nel gioco da un utente. Puoi usare questa API per chiedere all'Overlay se necessita di una chiamata a Present in un determinato momento, per poi verificare periodicamente questa necessità (consigliamo una frequenza di 33 Hz) assicurandoti di aggiornare lo schermo con Present o SwapBuffers per consentire all'Overlay di funzionare.
Restituisce: bool
true se l'Overlay richiede l'aggiornamento della schermata. Altrimenti,
false.
CheckFileSignature
SteamAPICall_t CheckFileSignature( const char *szFileName );
Nome | Tipo | Descrizione |
szFileName | const char * | . |
Non più in utilizzo.
Restituisce: SteamAPICall_t da utilizzare con un risultato di chiamata
CheckFileSignature_t.
GetAPICallFailureReason
ESteamAPICallFailure GetAPICallFailureReason( SteamAPICall_t hSteamAPICall );
Nome | Tipo | Descrizione |
hSteamAPICall | SteamAPICall_t | L'handle della chiamata all'API di Steam di cui verificare il fallimento. |
Utilizzata per ottenere il motivo per cui si è verificato un errore con un risultato di chiamata.
L'utilizzo principale di questa funzione è il debugging. Solitamente le motivazioni di un errore sono al di fuori del tuo controllo e non molto importanti. Continua ad effettuare la chiamata API finché non funziona.
Restituisce: ESteamAPICallFailure[type]ESteamAPICallFailure[/type]
Vedi anche: IsAPICallCompleted,
GetAPICallResultEsempio:void CHTMLSurface::OnBrowserReady( HTML_BrowserReady_t *pBrowserReady, bool bIOFailure )
{
if ( bIOFailure ) {
SteamUtils()->GetAPICallFailureReason( handle ); // l'handle deve essere salvato separatamente.
return;
}
}
GetAPICallResult
bool GetAPICallResult( SteamAPICall_t hSteamAPICall, void *pCallback, int cubCallback, int iCallbackExpected, bool *pbFailed );
Nome | Tipo | Descrizione |
hSteamAPICall | SteamAPICall_t | L'handle della chiamata API. |
pCallback | void * | Restituisce la callback nella memoria preallocata fornita. |
cubCallback | int | Le dimensioni della pCallback che stai inviando. |
iCallbackExpected | int | Il numero della k_iCallback associato alla callback. |
pbFailed | bool * | Restituita se la chiamata API non è andata a buon fine. |
Ottiene i contenuti di una chiamata API completata. Fornita per il wrapper CallResult sul lato back-end.
Non è consigliabile usare questa funzione manualmente.
Restituisce: bool
true in caso di esito positivo, se la chiamata API è valida ed è stata completata. Altrimenti,
false.
Se la chiamata ha esito positivo, copia la callback in
pCallback
e restituisce gli errori in
pbFailed
.
Vedi anche: IsAPICallCompleted,
GetAPICallFailureReasonGetAppID
uint32 GetAppID();
Ottiene l'appID del processo corrente.
Restituisce: uint32Restituisce l'appID.
GetConnectedUniverse
EUniverse GetConnectedUniverse();
Ottiene l'universo a cui si sta connettendo il client corrente. Solo per uso di Valve.
Restituisce: EUniverse[type]EUniverse[/type]
GetCSERIPPort
bool GetCSERIPPort( uint32 *unIP, uint16 *usPort );
Nome | Tipo | Descrizione |
unIP | uint32 * | Restituisce l'IP a cui è connesso il client. |
usPort | uint16 * | Restituisce la porta a cui è connesso il client. |
Ottiene per Valve l'IP del server che sta inviando informazioni. Al momento è usato solo per i giochi che fanno uso del Source Engine.
Restituisce: bool
Restituisce
true se l'utente è al momento connesso, altrimenti
false.
GetCurrentBatteryPower
uint8 GetCurrentBatteryPower();
Ottiene la carica corrente della batteria del computer.
Restituisce: uint8La carica corrente della batteria, compresa nell'intervallo [0..100]%. Quando il computer è collegato alla corrente, restituisce 255.
GetEnteredGamepadTextInput
bool GetEnteredGamepadTextInput( char *pchText, uint32 cchText );
Nome | Tipo | Descrizione |
pchText | char * | Un buffer preallocato in cui copiare la stringa di testo di input. |
cchText | uint32 | Le dimensioni del buffer pchText . |
Ottiene l'input di testo del gamepad dall'Overlay della modalità Big Picture.
Deve venire chiamata all'interno della callback
GamepadTextInputDismissed_t e solamente se
GamepadTextInputDismissed_t.m_bSubmitted
è "true".
Fornisce l'input di testo in formato UTF-8.
Restituisce: bool
true se era presente del testo da ricevere e
cchText
ha le stesse dimensioni di GamepadTextInputDismissed_t.m_unSubmittedText. Altrimenti,
false.
Vedi anche: ShowGamepadTextInput,
GetEnteredGamepadTextLengthEsempio:void OnGamepadTextInputDismissed_t( GamepadTextInputDismissed_t* pCallback )
{
// L'utente ha annullato,
if ( !pCallback.m_bSubmitted )
return;
// Usa una lunghezza massima di input che abbiamo passato a ShowGamepadTextInput, +1 per il terminatore null.
const uint32 MAX_INPUT_LENGTH = 64 + 1;
uint32 length = SteamUtils()->GetEnteredGamepadTextLength();
char* szTextInput[MAX_INPUT_LENGTH];
bool success = SteamUtils()->GetEnteredGamepadTextInput( szTextInput, length );
if ( !success )
{
// Registra un errore. Dovrebbe succedere solo se la lunghezza è > MaxInputLength
return;
}
// Mostra la stringa aggiornata
}
GetEnteredGamepadTextLength
uint32 GetEnteredGamepadTextLength();
Ottiene la lunghezza del testo del gamepad dall'Overlay della modalità Big Picture.
Deve venire chiamata all'interno della callback
GamepadTextInputDismissed_t e solamente se
GamepadTextInputDismissed_t.m_bSubmitted
è "true".
Restituisce: uint32Vedi anche: ShowGamepadTextInput,
GetEnteredGamepadTextInputEsempio:void OnGamepadTextInputDismissed_t( GamepadTextInputDismissed_t* pCallback )
{
// L'utente ha annullato,
if ( !pCallback.m_bSubmitted )
return;
// Usa una lunghezza massima di input che abbiamo passato a ShowGamepadTextInput, +1 per il terminatore null.
const uint32 MAX_INPUT_LENGTH = 64 + 1;
uint32 length = SteamUtils()->GetEnteredGamepadTextLength();
const char* szTextInput[MAX_INPUT_LENGTH];
bool success = SteamUtils()->GetEnteredGamepadTextInput( szTextInput, length );
if ( !success )
{
// Registra un errore. Dovrebbe succedere solo se la lunghezza è > MaxInputLength
return;
}
// Mostra la stringa aggiornata
}
GetImageRGBA
bool GetImageRGBA( int iImage, uint8 *pubDest, int nDestBufferSize );
Nome | Tipo | Descrizione |
iImage | int | L'handle dell'immagine ottenuta. |
pubDest | uint8 * | Il buffer che sarà riempito. |
nDestBufferSize | int | Le dimensioni totali del buffer pubDest . |
Ottiene i byte dell'immagine da un relativo handle.
Prima di effettuare questa chiamata, devi ottenere le dimensioni dell'immagine chiamando
GetImageSize, in modo da poter ottenere un buffer delle dimensioni appropriate. Potrai quindi allocare il tuo buffer con la larghezza e l'altezza indicate come: width * height * 4. L'immagine viene fornita in formato RGBA. Questa chiamata è abbastanza esigente, poiché converte l'immagine dal formato compresso (JPG, PNG, TGA) e non fornisce cache interna per il buffer restituito. Consigliamo dunque di chiamarla solo una volta per handle e di memorizzarne il risultato nella cache. Questa funzione viene usata solo per le immagini degli avatar e degli achievement di Steam, che non cambiano durante il gioco.
Restituisce: bool
true in caso di esito positivo, se l'handle dell'immagine è valido e il buffer è stato riempito. Altrimenti,
false.
Vedi anche: ISteamFriends::GetSmallFriendAvatar,
ISteamFriends::GetMediumFriendAvatar,
ISteamFriends::GetLargeFriendAvatar,
ISteamUserStats::GetAchievementIconEsempio:HGAMETEXTURE GetSteamImageAsTexture( int iImage )
{
HGAMETEXTURE hTexture = 0;
// Dovresti prima controllare se hai già questa immagine in cache usando qualcosa come un dizionario/mappa
// con iImage come chiave e restituisce l'handle della texture associato, se esiste.
// Se non esiste, vai avanti e aggiungi la texture alla mappa prima di tornare alla fine della funzione.
// Se dobbiamo controllare la dimensione dell'immagine.
uint32 uAvatarWidth, uAvatarHeight;
bool success = SteamUtils()->GetImageSize( iImage, &uAvatarWidth, &uAvatarHeight );
if ( !success ) {
// Registra un messaggio di avviso.
return hTexture;
}
// Ottieni i dati grezzi effettivi RGBA da Steam e trasformali in texture per il motore di gioco
const int uImageSizeInBytes = uAvatarWidth * uAvatarHeight * 4;
uint8 *pAvatarRGBA = new uint8[uImageSizeInBytes];
success = SteamUtils()->GetImageRGBA( iImage, pAvatarRGBA, uImageSizeInBytes );
if( !success )
{
// Esegue qualcosa per convertire la texture RGBA nel tuo formato interno di texture per la visualizzazione.
// hTexture = m_pGameEngine->HCreateTexture( pAvatarRGBA, uAvatarWidth, uAvatarHeight );
// E aggiunge la texture alla cache
}
// Ricordati di liberare la memoria!
delete[] pAvatarRGBA;
return hTexture;
}
GetImageSize
bool GetImageSize( int iImage, uint32 *pnWidth, uint32 *pnHeight );
Nome | Tipo | Descrizione |
iImage | int | L'handle dell'immagine di cui ottenere le dimensioni. |
pnWidth | uint32 * | Restituisce la larghezza dell'immagine. |
pnHeight | uint32 * | Restituisce l'altezza dell'immagine. |
Ottiene le dimensioni dell'handle di un'immagine di Steam.
Questa chiamata deve venire effettuata prima di chiamare
GetImageRGBA, in modo da creare un buffer dalle dimensioni appropriate che verrà riempito con i dati non elaborati dell'immagine.
Restituisce: bool
true in caso di esito positivo, se l'handle dell'immagine è valido e le dimensioni sono state indicate. Altrimenti,
false.
Vedi anche: ISteamFriends::GetSmallFriendAvatar,
ISteamFriends::GetMediumFriendAvatar,
ISteamFriends::GetLargeFriendAvatar,
ISteamUserStats::GetAchievementIconGetIPCCallCount
uint32 GetIPCCallCount();
Restituisce il numero di chiamate IPC (Inter-Process Communication) effettuate dall'ultima volta in cui questa funzione è stata chiamata.
Utilizzata per il debugging delle prestazioni, in modo da poter determinare quante chiamate IPC il tuo gioco effettua a ogni fotogramma.
Ogni chiamata IPC è almeno un cambiamento del contesto di un processo, ma può anche essere un processo stesso, quindi vorrai verificare la frequenza con cui le effettui.
Restituisce: uint32GetIPCountry
const char * GetIPCountry();
Restituisce il codice nazionale del Paese in cui il client è in esecuzione (due caratteri nel formato ISO 31661-1-alpha-2), ad esempio "US" o "UK".
Viene trovato tramite un database di corrispondenze tra IP e paesi.
Restituisce: const char *
GetSecondsSinceAppActive
uint32 GetSecondsSinceAppActive();
Restituisce il numero di secondi dal momento in cui è stata lanciata l'applicazione.
Restituisce: uint32GetSecondsSinceComputerActive
uint32 GetSecondsSinceComputerActive();
Restituisce il numero di secondi a partire dall'ultima volta in cui l'utente ha mosso il mouse.
Restituisce: uint32GetServerRealTime
uint32 GetServerRealTime();
Restituisce l'orario del server di Steam in formato epoch Unix (in secondi a partire dal 1 gennaio 1970 UTC).
Restituisce: uint32GetSteamUILanguage
const char * GetSteamUILanguage();
Restituisce la lingua scelta per il client di Steam.
Questa funzione si usa solo in casi molto particolari, di solito è preferibile usare
ISteamApps::GetCurrentGameLanguage.
Per una lista completa delle lingue, vedi le
lingue supportate.
Restituisce: const char *
Vedi anche: ISteamApps::GetCurrentGameLanguage,
ISteamApps::GetAvailableGameLanguagesIsAPICallCompleted
bool IsAPICallCompleted( SteamAPICall_t hSteamAPICall, bool *pbFailed );
Nome | Tipo | Descrizione |
hSteamAPICall | SteamAPICall_t | L'handle della chiamata API da verificare. |
pbFailed | bool * | Indica se la chiamata API ha riscontrato un errore (true) o meno (false). |
Verifica se una chiamata API è stata completata. Fornisce il wrapper CallResult sul lato back-end.
Non è consigliabile che sia tu stesso a usare questa funzione.
Restituisce: bool
true se la chiamata API è valida ed è stata completata. Altrimenti,
false.
Vedi anche: GetAPICallResult,
GetAPICallFailureReasonIsOverlayEnabled
bool IsOverlayEnabled();
Verifica se
l'overlay di Steam è in esecuzione e se l'utente può accedervi.
Il processo dell'overlay potrebbe richiedere alcuni secondi per avviarsi ed eseguire la procedura di hooking del processo di gioco, pertanto inizialmente (durante il caricamento dell'Overlay) la funzione restituirà "false".
Restituisce: bool
IsSteamChinaLauncher
bool IsSteamChinaLauncher();
Indica se il launcher corrente è un launcher Steam China. Puoi far sì che il client si comporti come il launcher Steam China aggiungendo
-dev -steamchina alla riga di comando quando lanci Steam.
InitFilterText
bool InitFilterText();
Avvia il filtraggio del testo e il caricamento del dizionario nella lingua in cui si sta eseguendo il gioco.
Gli utenti possono personalizzare le impostazioni di filtraggio del testo nelle loro
preferenze dell'account di Steam.
Restituisce: bool
true se avviato con successo,
false se il filtraggio non è disponibile nella lingua del gioco, in qual caso
FilterText() farà da passthrough.
Vedi anche: FilterTextFilterText
int FilterText( ETextFilteringContext eContext, CSteamID sourceSteamID, const char *pchInputMessage, char *pchOutFilteredText, uint32 nByteSizeOutFilteredText );
Nome | Tipo | Descrizione |
eContext | ETextFilteringContext | Il tipo di contenuto nella stringa di input. |
sourceSteamID | CSteamID | L'ID di Steam fonte della stringa di input (ad esempio del giocatore con il nome offensivo o di chi ha detto la parola offensiva nella chat). |
pchInputText | const char* | La stringa in input da filtrare, in ASCII o UTF-8. |
pchOutFilteredText | char* | Dove verrà collocato l'output, anche in assenza di filtraggio. |
nByteSizeOutFilteredText | uint32 | Le dimensioni (in byte) di pchOutFilteredText, almeno pari a strlen(pchInputText)+1. |
Filtra il messaggio di input fornito e inserisce in risultato filtrato in pchOutFilteredText. I filtri richiesti per legge vengono sempre applicati. Potrebbero essere applicati ulteriori filtri, in base al contesto e alle impostazioni dell'utente.
Restituisce: int
Restituisce il numero di caratteri (non byte) filtrati.
Vedi anche: InitFilterTextIsSteamInBigPictureMode
bool IsSteamInBigPictureMode();
Verifica se Steam e l'Overlay di Steam sono in esecuzione in modalità Big Picture.
Per abilitare l'Overlay della modalità Big Picture, i giochi devono essere lanciati dal client di Steam.
Durante lo sviluppo, un gioco non di Steam può essere aggiunto alla Libreria dello sviluppatore per testare questa funzionalità.
Restituisce: bool
true se l'Overlay della modalità Big Picture è disponibile, altrimenti
false.
Restituirà sempre
false se il
tipo dell'applicazione non è "gioco".
IsSteamRunningInVR
bool IsSteamRunningInVR();
Verifica se Steam è in esecuzione in modalità VR.
Restituisce: bool
true se Steam è in esecuzione in modalità VR, altrimenti
false.
IsVRHeadsetStreamingEnabled
bool IsVRHeadsetStreamingEnabled();
Controlla se la vista del visore viene trasmessa tramite Steam Remote Play.
Restituisce: bool
true se la VR è abilitata e la vista del visore sta venendo trasmessa. Altrimenti,
false.
Vedi anche: SetVRHeadsetStreamingEnabledIsSteamRunningOnSteamDeck
bool IsSteamRunningOnSteamDeck();
Controlla se Steam è in esecuzione su un dispositivo Steam Deck.
Restituisce: bool
true se Steam è in esecuzione su un dispositivo Steam Deck, altrimenti
false.
SetOverlayNotificationInset
void SetOverlayNotificationInset( int nHorizontalInset, int nVerticalInset );
Nome | Tipo | Descrizione |
nHorizontalInset | int | La distanza orizzontale (da sinistra a destra) in pixel dall'angolo. |
nVerticalInset | int | La distanza verticale (dall'alto al basso) in pixel dall'angolo. |
Imposta la posizione della notifica dell'Overlay rispetto all'angolo, come specificato da
SetOverlayNotificationPosition.
Un valore di (0,0) resetta la posizione nell'angolo.
Questa posizione varia di gioco in gioco e si resetta a ogni avvio.
SetOverlayNotificationPosition
void SetOverlayNotificationPosition( ENotificationPosition eNotificationPosition );
Imposta in quale angolo verrà mostrata la finestra di notifica dell'Overlay di Steam.
Puoi anche impostare la distanza dall'angolo specificato usando
SetOverlayNotificationInset.
Questa posizione varia di gioco in gioco e si resetta a ogni avvio.
SetVRHeadsetStreamingEnabled
void SetVRHeadsetStreamingEnabled( bool bEnabled );
Nome | Tipo | Descrizione |
bEnabled | bool | Attiva (true) o disattiva (false) la trasmissione del visore VR. |
Imposta se i contenuti del visore saranno trasmessi tramite Steam Remote Play.
Se questa funzione è attiva, la scena nel visore VR verrà trasmessa e non saranno consentiti input remoti. In caso contrario, verrà trasmessa la finestra dell'applicazione e saranno consentiti input remoti. La funzione è abilitata nei giochi VR per impostazione predefinita, a meno che "VRHeadsetStreaming" "0" sia nelle informazioni estese sull'applicazione.
Utile per giochi con gameplay multigiocatore asimmetrico.
Vedi anche: IsVRHeadsetStreamingEnabledSetWarningMessageHook
void SetWarningMessageHook( SteamAPIWarningMessageHook_t pFunction );
Nome | Tipo | Descrizione |
pFunction | SteamAPIWarningMessageHook_t | Puntatore alla funzione di callback. |
Imposta un hook a un messaggio di avviso per ricevere avvisi e messaggi informativi da SteamAPI in una funzione di callback.
Il prototipo della funzione deve corrispondere alla definizione presente in SteamAPIWarningMessageHook_t. Include il collegamento extern "C" e la convenzione di chiamata __cdecl.
"int nSeverity" è il livello di gravità; 0 per i messaggi, 1 per gli avvisi. Se l'esecuzione avviene tramite un debugger, verranno inviati solo avvisi. Se si aggiunge -debug_steamapi alla riga di comando, verranno inviati anche messaggi informativi.
'const char * pchDebugText' è il testo del messaggio.
Le callback avverranno direttamente dopo la chiamata della funzione API che ha generato l'avviso o il messaggio.
L'hook può essere rimosso passando NULL.
Esempio:extern "C" void __cdecl SteamAPIDebugTextHook( int nSeverity, const char *pchDebugText )
{
::OutputDebugString( pchDebugText );
if ( nSeverity >= 1 )
{
// posizione in cui impostare un breakpoint per rilevare gli errori dell'API
int x = 3;
x = x;
}
}
void EnableWarningMessageHook()
{
SteamUtils()->SetWarningMessageHook( &SteamAPIDebugTextHook );
}
ShowGamepadTextInput
bool ShowGamepadTextInput( EGamepadTextInputMode eInputMode, EGamepadTextInputLineMode eLineInputMode, const char *pchDescription, uint32 unCharMax, const char *pchExistingText );
Nome | Tipo | Descrizione |
eInputMode | EGamepadTextInputMode | Seleziona la modalità di input da usare, normale o password (testo nascosto). |
eLineInputMode | EGamepadTextInputLineMode | Determina l'utilizzo di input a riga singola o multipla. |
pchDescription | const char * | Imposta la descrizione che dovrebbe informare l'utente sulla funzione della finestra di input. |
unCharMax | uint32 | Il numero massimo di caratteri che un utente può immettere. |
pchExistingText | const char * | Imposta il testo già esistente che l'utente può modificare. |
Attiva la finestra di dialogo per l'input in modalità Big Picture, che supporta solo input tramite gamepad.
Restituisce: bool
true se l'Overlay della modalità Big Picture è in esecuzione, altrimenti
false.
Vedi anche: GetEnteredGamepadTextLength,
GetEnteredGamepadTextInputShowFloatingGamepadTextInput
bool ShowFloatingGamepadTextInput( EFloatingGamepadTextInputMode eKeyboardMode, int nTextFieldXPosition, int nTextFieldYPosition, int nTextFieldWidth, int nTextFieldHeight );
Nome | Tipo | Descrizione |
eKeyboardMode | EFloatingGamepadTextInputMode | Seleziona la tipologia di tastiera da utilizzare. |
nTextFieldXPosition | int | Il valore della coordinata X del campo di testo che non dovrebbe essere oscurata dalla tastiera mobile |
nTextFieldYPosition | int | Il valore della coordinata Y del campo di testo che non dovrebbe essere oscurata dalla tastiera mobile |
nTextFieldWidth | int | L'ampiezza del campo di testo che non dovrebbe essere oscurata dalla tastiera mobile |
nTextFieldHeight | int | L'altezza del campo di testo che non dovrebbe essere oscurata dalla tastiera mobile |
Apre una tastiera mobile sui contenuti di gioco e invia l'input dei tasti del sistema operativo direttamente al gioco.
La posizione del campo testuale viene espressa in pixel rispetto all'origine della finestra di gioco e viene usata per collocare la tastiera mobile in modo che non si sovrapponga al campo testuale.
Restituisce: bool
true se la tastiera mobile è stata mostrata. Altrimenti,
false.
Vedi anche: FloatingGamepadTextInputDismissed_tStartVRDashboard
void StartVRDashboard();
Chiede a Steam di creare e renderizzare la dashboard OpenVR.
SetGameLauncherMode
void SetGameLauncherMode( bool bLauncherMode);
Nome | Tipo | Descrizione |
bLauncherMode | bool | Specifica se un launcher è attivo o meno. |
Questa funzione può essere chiamata nei launcher di gioco senza compatibilità con i controller per far sì che Steam Input traduca l'input del controller in input di mouse e tastiera e poter così navigare nel launcher.
Callback
Queste sono callback che possono essere attivate chiamando
SteamAPI_RunCallbacks. Molte di esse saranno attivate direttamente in risposta alle funzioni membro di
ISteamUtils
.
CheckFileSignature_t
Risultato di chiamata per
CheckFileSignature.
Funzioni associate: CheckFileSignatureGamepadTextInputDismissed_t
Chiamata quando l'input di testo per il gamepad in modalità Big Picture è stato chiuso.
Nome | Tipo | Descrizione |
m_bSubmitted | bool | true se l'utente ha inserito e confermato il testo (chiama GetEnteredGamepadTextInput per ricevere il testo), false se l'input è stato annullato. |
m_unSubmittedText | uint32 | Contiene la lunghezza in byte del testo, se è stato inviato. |
FloatingGamepadTextInputDismissed_t
Chiamata alla chiusura della tastiera mobile generata con
ShowFloatingGamepadTextInput.
IPCountry_t
Chiamata quando il Paese dell'utente è cambiato. Il Paese deve essere aggiornato con
GetIPCountry.
Questa callback non ha campi.
LowBatteryPower_t
Chiamata in caso di esecuzione su laptop quando alla batteria rimangono meno di 10 minuti di autonomia; poi si attiva ogni minuto.
Nome | Tipo | Descrizione |
m_nMinutesBatteryLeft | uint8 | Una stima dei minuti di autonomia rimanenti per la batteria. |
SteamAPICallCompleted_t
Chiamata al completamento (con esito positivo o negativo) di una SteamPICall_t.
Nome | Tipo | Descrizione |
m_hAsyncCall | SteamAPICall_t | L'handle della chiamata API di Steam che è stata completata. |
m_iCallback | int | Si tratta della costante k_iCallback che identifica in maniera univoca la callback completata. |
m_cubParam | uint32 | Le dimensioni in byte della callback completata. |
AppResumingFromSuspend_t
Inviata quando il dispositivo ritorna dalla modalità standby/sospensione.
Questa callback non ha campi.
SteamShutdown_t
Chiamata quando Steam vuole arrestarsi.
Questa callback non ha campi.
Enumerazioni
Queste sono le enumerazioni definite per l'utilizzo con ISteamUtils.
ECheckFileSignature
Il risultato di una chiamata a
CheckFileSignature Nome | Valore | Descrizione |
k_ECheckFileSignatureInvalidSignature | 0 | |
k_ECheckFileSignatureValidSignature | 1 | |
k_ECheckFileSignatureFileNotFound | 2 | |
k_ECheckFileSignatureNoSignaturesFoundForThisApp | 3 | |
k_ECheckFileSignatureNoSignaturesFoundForThisFile | 4 | |
EGamepadTextInputLineMode
Controlla il numero di righe consentite nell'input di testo tramite gamepad in modalità Big Picture.
Nome | Valore | Descrizione |
k_EGamepadTextInputLineModeSingleLine | 0 | |
k_EGamepadTextInputLineModeMultipleLines | 1 | |
EGamepadTextInputMode
Modalità di input per il testo inserito tramite gamepad in modalità Big Picture
Nome | Valore | Descrizione |
k_EGamepadTextInputModeNormal | 0 | |
k_EGamepadTextInputModePassword | 1 | |
EFloatingGamepadTextInputMode
Controlla la modalità della tastiera mobile
Nome | Valore | Descrizione |
k_EFloatingGamepadTextInputModeModeSingleLine | 0 | Il tasto Invio chiude la tastiera |
k_EFloatingGamepadTextInputModeModeMultipleLines | 1 | L'utente deve chiudere la tastiera in modo esplicito |
k_EFloatingGamepadTextInputModeModeEmail | 2 | La tastiera viene mostrata in una modalità speciale che facilita l'inserimento degli indirizzi e-mail |
k_EFloatingGamepadTextInputModeModeNumeric | 3 | Viene mostrata una tastiera numerica |
ESteamAPICallFailure
Risultati di chiamate dell'API di Steam fallite, restituiti da
GetAPICallFailureReason.
Nome | Valore | Descrizione |
k_ESteamAPICallFailureNone | -1 | Nessun errore. |
k_ESteamAPICallFailureSteamGone | 0 | Il processo locale di Steam ha smesso di rispondere. Potrebbe essere stato arrestato o potrebbe essere bloccato. |
k_ESteamAPICallFailureNetworkFailure | 1 | La connessione di rete ai server di Steam è stata persa o era già interrotta. Più o meno allo stesso momento, verrà inviata una callback SteamServersDisconnected_t, seguita da una callback SteamServersConnected_t quando il client sarà nuovamente in grado di comunicare con i server di Steam. |
k_ESteamAPICallFailureInvalidHandle | 2 | L'handle SteamAPICall_t passato non esiste più. |
k_ESteamAPICallFailureMismatchedCallback | 3 | GetAPICallResult è stata chiamata con il tipo di callback sbagliato. |
Costanti
Questo sono costanti definite per l'utilizzo con ISteamUtils.
Nome | Tipo | Valore | Descrizione |
STEAMUTILS_INTERFACE_VERSION | const char * | "SteamUtils009" | |