#include <SFBSoundPlayer.h.hpp>

class SFBSoundPlayer : public SFBBase;

SFMTYPEDEFWRAPPER(SFBSoundPlayer)

[ public ]
Void FastForward(
    UInt32 time   // this function issues a command to fast-forward the current MIDI/MP3 playback
);

[ public ]
SFCError GetInfo(
    AEESoundPlayerInfo* info   // audio source of SFBSoundPlayer
);

[ public ]
Void GetTotalTime(Void);

[ public ]
Void GetVolume(Void);

[ public, static ]
SFBSoundPlayerSmp NewInstance(
    SFCErrorPtr exception = null   // Error
);

[ public, static ]
SFBSoundPlayerSmp NewInstance(
    AEECLSID id                    // Class ID
    SFCErrorPtr exception = null   // Error
);

[ public ]
Void Pause(Void);

[ public ]
Void Play(Void);

[ public ]
Void RegisterNotify(
    PFNSOUNDPLAYERSTATUS notify   // pointer to the user callback (null to deregister)
    VoidPtr data = null           // user data for unique correlation/identification of the transaction.
                                  // this piece of information is not retrieved or processed by SFBSoundPlayer 
                                  // and can be null if no identifying data is required. 
                                  // this same data pointer is passed back to the client along with status callback to correlate the transactions
);

[ public ]
SFCError ResetInfo(Void);

[ public ]
Void Resume(Void);

[ public ]
Void Rewind(
    UInt32 time   // amount of time, in milliseconds, to rewind the current playback
);

[ public ]
Void Set(
    AEESoundPlayerInput input   // source type of Data
                                // the values below are supported:
                                // SDT_FILE   : The specified data is file name.
                                // SDT_BUFFER : The specified data is unprocessed buffer
    VoidPtr data                // pointer to the data of specified type
);

[ public ]
Void Set(
    AEESoundPlayerInput input   // source type of Data
                                // the values below are supported:
                                // SDT_FILE   : The specified data is file name.
                                // SDT_BUFFER : The specified data is unprocessed buffer
    SFXBufferPtr data           // pointer to the data of specified type,
                                // if null, return null as user data
);

[ public ]
SFCError SetInfo(
    AEESoundPlayerInfo* info   // audio source of SFBSoundPlayer
);

[ public ]
Void SetSoundDevice(
    AEESoundDevice device   // audio device to be connected
    AEESoundMuteCtl ear     // mute or unmute the ear piece
    AEESoundMuteCtl mic     // mute or unmute the microphone
);

[ public ]
Void SetStream(
    SFBAStreamSmpConstRef s   // SFBAStream class
                              // pointer to the instance of SFBFile interface or SFBSocket class
);

[ public ]
SFCError SetStream(
    SFXStorageConstRef storage   // storage class
);

[ public ]
Void SetTempo(
    UInt32 factor   // this parameter is used to modify the playback tempo as a percentage of the normal playback tempo.
                    // possibly, playback is not active or another command is active. 
                    // a dwTempoFactor of 50 means half of the normal playback tempo. 
                    // the maximum supported tempo factor is 500% or five times of the normal playback tempo. 
                    // the minimum tempo factor is 1% of the normal playback tempo. 
                    // the tempo factor is initially 100% when the SFBSoundPlayer::Play() function is called
);

[ public ]
Void SetTune(
    UInt08 step   // this parameter is used to modify the tune of the playback in half-step increments. 
		// 0 indicates normal playback. 
		// -1 indicates 1 half-step lower than the normal playback. 
		// +1 indicates 1 half-step higher than the normal playback.
		// -12 indicates 12 half-steps, or 1 octave lower than the normal playback. 
		// +12 indicates 12 half-steps, or 1 octave higher than the normal playback
);

[ public ]
Void SetVolume(
    UInt16 volume   // new volume level for device/method
);

[ public ]
Void Stop(Void);

[ public ]
Void UnregisterNotify(Void);