Funzioni che forniscono informazioni sulle sessioni di Steam Remote Play, che trasmette i contenuti del tuo gioco a un altro computer, all'app di Steam Link o un altro hardware.
Per ulteriori informazioni, consulta
Steam Remote Play.
Funzioni membro
Le funzioni membro per
ISteamRemotePlay
vengono chiamate attraverso la funzione globale di accesso
SteamRemotePlay()
.
GetSessionCount
uint32 GetSessionCount();
Ottiene il numero di sessioni di Steam Remote Play attualmente connesse.
Restituisce: uint32Il numero di sessioni di Steam Remote Play attualmente connesse.
Esempio:bool BSteamRemotePlayActive()
{
uint32 unSessionCount = SteamRemotePlay()->GetSessionCount();
for ( uint32 iIndex = 0; iIndex < unSessionCount; iIndex++ )
{
RemotePlaySessionID_t unSessionID = SteamRemotePlay()->GetSessionID( iIndex );
if ( !unSessionID )
{
continue;
}
return true;
}
return false;
}
GetSessionID
uint32 GetSessionID( int iSessionIndex );
Nome | Tipo | Descrizione |
iSessionIndex | int | L'indice della sessione specificata |
Ottiene l'ID della sessione di Steam Remote Play attualmente connessa all'indice specificato.
Restituisce: uint32
L'ID della sessione all'indice specificato, oppure 0 se l'indice è inferiore a 0 o maggiore o uguale a
GetSessionCount().
GetSessionSteamID
CSteamID GetSessionSteamID( uint32 unSessionID );
Nome | Tipo | Descrizione |
unSessionID | uint32 | L'ID della sessione per cui ottenere informazioni. |
Ottiene l'ID di Steam dell'utente connesso.
Restituisce: CSteamIDL'ID di Steam dell'utente associato alla sessione di Remote Play. Di solito è l'utente che ha effettuato l'accesso o, nel caso di Remote Play Together, di un amico.
GetSessionClientName
const char *GetSessionClientName( uint32 unSessionID );
Nome | Tipo | Descrizione |
unSessionID | uint32 | L'ID della sessione per cui ottenere informazioni. |
Ottiene il nome del dispositivo della sessione del client.
Restituisce: const char *
Il nome del dispositivo associato con la sessione di Remote Play, oppure NULL se l'ID della sessione non è valido.
GetSessionClientFormFactor
ESteamDeviceFormFactor GetSessionClientFormFactor( uint32 unSessionID );
Nome | Tipo | Descrizione |
unSessionID | uint32 | L'ID della sessione per cui ottenere informazioni. |
Ottiene il fattore di forma del dispositivo della sessione del client.
Restituisce: ESteamDeviceFormFactorIl fattore di forma del dispositivo associato alla sessione di Remote Play, oppure
k_ESteamDeviceFormFactorUnknown
se l'ID della sessione non è valido.
Esempio:bool BSteamRemotePlayToPhone()
{
uint32 unSessionCount = SteamRemotePlay()->GetSessionCount();
for ( uint32 iIndex = 0; iIndex < unSessionCount; iIndex++ )
{
RemotePlaySessionID_t unSessionID = SteamRemotePlay()->GetSessionID( iIndex );
if ( !unSessionID )
{
continue;
}
ESteamDeviceFormFactor eFormFactor = SteamRemotePlay()->GetSessionClientFormFactor( unSessionID );
if ( eFormFactor == k_ESteamDeviceFormFactorPhone )
{
return true;
}
}
return false;
}
BGetSessionClientResolution
bool BGetSessionClientResolution( uint32 unSessionID, int *pnResolutionX, int *pnResolutionY );
Nome | Tipo | Descrizione |
unSessionID | uint32 | L'ID della sessione per cui ottenere informazioni. |
pnResolutionX | int | Un puntatore a una variabile da riempire con la larghezza della risoluzione del dispositivo. |
pnResolutionY | int | Un puntatore a una variabile da riempire con l'altezza della risoluzione del dispositivo. |
Ottiene la risoluzione in pixel del dispositivo della sessione del client. Viene impostato su 0x0 se la risoluzione non è disponibile.
Restituisce: bool
true se l'ID della sessione è valido, altrimenti
false.
Esempio:// Può restituire "false" se il dispositivo remoto non fornisce informazioni sulla risoluzione del dispositivo
bool BGetSteamRemotePlayResolution( int *pnX, int *pnY )
{
int nMaxResolutionX = 0, nMaxResolutionY = 0;
uint32 unSessionCount = SteamRemotePlay()->GetSessionCount();
for ( uint32 iIndex = 0; iIndex < unSessionCount; iIndex++ )
{
RemotePlaySessionID_t unSessionID = SteamRemotePlay()->GetSessionID( iIndex );
if ( !unSessionID )
{
continue;
}
int nResolutionX = 0, nResolutionY = 0;
SteamRemotePlay()->BGetSessionClientResolution( unSessionID, &nResolutionX, &nResolutionY );
if ( nResolutionX > nMaxResolutionX )
{
nMaxResolutionX = nResolutionX;
nMaxResolutionY = nResolutionY;
}
}
if ( pnX )
{
*pnX = nMaxResolutionX;
}
if ( pnY )
{
*pnY = nMaxResolutionY;
}
return ( nMaxResolutionX > 0 && nMaxResolutionY > 0 );
}
SteamRemotePlaySessionConnected_t
bool BSendRemotePlayTogetherInvite( CSteamID steamIDFriend );
Nome | Tipo | Descrizione |
steamIDFriend | CSteamID | L'ID di Steam dell'amico che vuoi invitare |
Invita un amico a unirsi al gioco utilizzando Remote Play Together
Restituisce: bool
true se l'invito è stato inviato con successo, altrimenti
false.
Callback
Queste sono callback che possono essere attivate chiamando
SteamAPI_RunCallbacks.
SteamRemotePlaySessionConnected_t
Nome | Tipo | Descrizione |
m_unSessionID | uint32 | L'ID della sessione che si è appena connessa |
SteamRemotePlaySessionDisconnected_t
Nome | Tipo | Descrizione |
m_unSessionID | uint32 | L'ID della sessione che si è appena disconnessa |
Enums
Queste sono enumerazioni definite per l'utilizzo con ISteamRemotePlay.
ESteamDeviceFormFactor
Il fattore di forma del dispositivo.
Nome | Valore | Descrizione |
k_ESteamDeviceFormFactorUnknown | 0 | Il fattore di forma del dispositivo non è disponibile. |
k_ESteamDeviceFormFactorPhone | 1 | Il dispositivo è un telefono o un altro piccolo dispositivo mobile dotato di touchscreen. |
k_ESteamDeviceFormFactorTablet | 2 | Il dispositivo è un tablet o un altro dispositivo mobile di grosse dimensioni dotato di touchscreen. |
k_ESteamDeviceFormFactorComputer | 3 | Il dispositivo è un computer desktop o un laptop. |
k_ESteamDeviceFormFactorTV | 4 | Il dispositivo è una TV. |