ISteamMusic 인터페이스(Steamworks 문서)

Steamworks 문서

ISteamMusic 인터페이스

Steamworks 문서 > Steamworks API 참고자료 > ISteamMusic 인터페이스

Steam 클라이언트에서 음악 재생을 제어하는 함수입니다.

이 함수를 통해 중요한 장면이 표시될 때 음악을 일시 정지하거나 음량을 낮춘 뒤 다시 재생되도록 할 수 있습니다.

자세한 내용은 features/music_player 문서를 참조하세요.

멤버 함수

ISteamMusic의 멤버 함수는 전역 접근자 함수 SteamMusic()을 통해 호출됩니다.

BIsEnabled

bool BIsEnabled();

Steam 음악이 활성화되어 있는지 확인하세요.

반환값: bool
? 활성화된 경우 true, 그렇지 않으면 false를 반환합니다.

BIsPlaying

bool BIsPlaying();

Steam 음악이 활성화되어 있는지 확인하세요. 음악이 반드시 재생 중일 필요는 없으며 일시 정지될 수도 있습니다.

보다 미세한 제어가 필요한 경우 GetPlaybackStatus를 사용하세요.

반환값: bool
? 현재 음악이 재생 중, 일시 정지 또는 재생 목록에 포함된 상태인 경우 true를, 그렇지 않으면 false를 반환합니다.

GetPlaybackStatus

AudioPlayback_Status GetPlaybackStatus();

Steam 음악 플레이어의 현재 상태를 가져옵니다.

반환값: AudioPlayback_Status

GetVolume

float GetVolume();

Steam 음악 플레이어의 현재 음량을 가져옵니다.

반환값: float
음량은 0.0과 1.0 사이의 백분율로 반환됩니다.

일시 정지

void Pause();

Steam 음악 플레이어를 일시 정지합니다.

재생

void Play();

Steam 음악 플레이어를 재생합니다.

PlayNext

void PlayNext();

Steam 음악 플레이어가 다음 곡으로 건너뛰게 합니다.

PlayPrevious

void PlayPrevious();

Steam 음악 플레이어가 이전 곡을 재생하도록 합니다.

SetVolume

void SetVolume( float flVolume );

이름	유형	설명
flVolume	float	0.0에서 1.0 사이로 음량 백분율을 설정하세요.

Steam 음악 플레이어의 음량을 설정합니다.

콜백

다음은 SteamAPI_RunCallbacks를 호출하여 실행할 수 있는 콜백입니다. 이들 중 대부분은 ISteamMusic의 멤버 함수에 대한 응답으로 직접 실행할 수 있습니다.

PlaybackStatusHasChanged_t

이 콜백에는 필드가 없습니다.

VolumeHasChanged_t

이름	유형	설명
m_flNewVolume	float

열거형

ISteamMusic 인터페이스에서 사용할 수 있도록 정의된 열거형입니다.

AudioPlayback_Status

현재 재생 상태를 지정합니다.

이름	값	설명
AudioPlayback_Undefined	0	Steam 음악 인터페이스가 활성화되어있지 않았을 가능성이 높습니다.
AudioPlayback_Playing	1	Steam 음악이 현재 재생 중입니다.
AudioPlayback_Paused	2	Steam 음악이 현재 일시 정지 중입니다.
AudioPlayback_Idle	3	Steam 음악이 현재 중지 상태입니다.

상수

ISteamMusi과 함께 사용하기 위해 정의된 상수입니다.

이름	유형	값	설명
STEAMMUSIC_INTERFACE_VERSION	const char *	"STEAMMUSIC_INTERFACE_VERSION001"