Documentazione di Steamworks
Interfaccia di ISteamUser
Funzioni per controllare la riproduzione di musica nel client di Steam.

Queste funzioni consentono ai giochi di eseguire azioni come mettere in pausa la musica o abbassare il volume quando viene mostrata una cinematica importante e di riavviare la riproduzione subito dopo.

Per ulteriori informazioni, consulta features/music_player.

Funzioni membro

Le funzioni membro per ISteamMusic vengono chiamate tramite la funzione globale di accesso ISteamMusic().

BIsEnabled

bool BIsEnabled();
Controlla se Steam Music è abilitato.

Restituisce: bool
true se è abilitato, altrimenti restituisce false.

BIsPlaying

bool BIsPlaying();
Controlla se Steam Music è attivo. Questo non significa necessariamente che un brano sia in esecuzione, può anche essere in pausa.

Per un controllo più granulare, usa GetPlaybackStatus.

Restituisce: bool
true se un brano è in esecuzione, in pausa o nella coda di riproduzione, altrimenti restituisce false.

GetPlaybackStatus

AudioPlayback_Status GetPlaybackStatus();
Ottiene lo stato corrente del riproduttore Steam Music.

Restituisce: AudioPlayback_Status

GetVolume

float GetVolume();
Ottiene il volume corrente del riproduttore Steam Music.

Restituisce: float
Il volume viene restituito sotto forma di percentuale compresa tra 0,0 e 1,0.

Pause

void Pause();
Mette in pausa il riproduttore Steam Music.

Play

void Play();
Fa in modo che il riproduttore Steam Music riprenda l'esecuzione.

PlayNext

void PlayNext();
Fa in modo che il riproduttore Steam Music salti al brano successivo.

PlayPrevious

void PlayPrevious();
Fa in modo che il riproduttore Steam Music riproduca il brano precedente.

SetVolume

void SetVolume( float flVolume );
NomeTipoDescrizione
flVolumefloatLa percentuale di volume da impostare tra 0,0 e 1,0.

Imposta il volume del riproduttore Steam Music.

Callback

Queste sono callback che possono essere attivate chiamando SteamAPI_RunCallbacks. Molte di esse saranno attivate direttamente in risposta alle funzioni membro di ISteamMusic.

PlaybackStatusHasChanged_t


Questa callback non ha campi.

VolumeHasChanged_t



NomeTipoDescrizione
m_flNewVolumefloat

Enumerazioni

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

AudioPlayback_Status

Specifica lo stato di riproduzione corrente.

NomeValoreDescrizione
AudioPlayback_Undefined0Probabilmente l'interfaccia di Steam Music non è abilitata.
AudioPlayback_Playing1Steam Music è attualmente in riproduzione.
AudioPlayback_Paused2Steam Music è attualmente in pausa.
AudioPlayback_Idle3Steam Music è attualmente interrotto.

Costanti

Queste sono costanti definite per l'utilizzo con ISteamMusic.

NomeTipoValoreDescrizione
STEAMMUSIC_INTERFACE_VERSIONconst char *"STEAMMUSIC_INTERFACE_VERSION001"