Управляет проигрыванием музыки в клиенте Steam.

Функции данного интерфейса дают возможность, к примеру, приостановить воспроизведение музыки или снизить громкость звука, когда в игре показывается важная заставка, а затем снова запустить воспроизведение.

Подробно эти функции описаны в разделе features/music_player.

Функции-члены

Функции-члены ISteamMusic вызываются с помощью глобальной функции доступа SteamMusic().

BIsEnabled

Проверяет, включён ли проигрыватель.

Возвращаемые значения: bool
true если включён, в противном случае false.

BIsPlaying

Проверяет, активен ли проигрыватель. Это необязательно означает, что композиция проигрывается, она может стоять на паузе.

Более точные значения можно получить в GetPlaybackStatus.

Возвращаемые значения: bool
true если песня проигрывается, поставлена на паузу или в очереди, в противном случае false.

GetPlaybackStatus

Получает текущее состояние проигрывателя Steam.

Возвращает: AudioPlayback_Status

GetVolume

Получает текущую громкость проигрывателя Steam.

Возвращаемые значения: float
Громкость возвращается как значение между 0.0 и 1.0.

Pause

Ставит проигрыватель на паузу.

Play

Сообщает проигрывателю возобновить воспроизведение.

PlayNext

Сообщает проигрывателю пропустить следующую композицию.

PlayPrevious

Сообщает проигрывателю воспроизвести предыдущую композицию.

SetVolume

Название	Тип	Описание
flVolume	float	Громкость в диапазоне 0.0 и 1.0.

Задаёт текущую громкость проигрывателя Steam.

Обратные вызовы

Далее приведён список обратных вызовов, которые могут быть получены при вызове SteamAPI_RunCallbacks. Многие из них могут быть получены сразу в ответ на функции-члены ISteamMusic.

PlaybackStatusHasChanged_t

У данного обратного вызова отсутствуют поля.

VolumeHasChanged_t

Название	Тип	Описание
m_flNewVolume	float

Перечисления

Далее приведён список перечислений, которые определены для использования с ISteamMusic.

AudioPlayback_Status

Указывает текущее состояние воспроизведения.

Название	Значение	Описание
AudioPlayback_Undefined	0	Проигрыватель, вероятно, выключен.
AudioPlayback_Playing	1	Проигрыватель в данный момент воспроизводит музыку.
AudioPlayback_Paused	2	Проигрыватель в данный момент поставлен на паузу.
AudioPlayback_Idle	3	Проигрыватель в данный момент остановлен.

Константы

Далее приведён список констант, которые определены для использования с ISteamMusic.

Название	Тип	Значение	Описание
STEAMMUSIC_INTERFACE_VERSION	const char *	"STEAMMUSIC_INTERFACE_VERSION001"