javax.microedition.amms
Interface SoundSource3D

All Superinterfaces:

javax.microedition.media.Controllable, Module

public interface SoundSource3D

extends Module

SoundSource3D represents a sound source in a virtual acoustical space. It is a logical group of Players and/or MIDI channels.

At least a LocationControl can be fetched from the SoundSource3D. Typically, also a DirectivityControl, a DistanceAttenuationControl, a DopplerControl, an ObstructionControl and a MacroscopicControl can be fetched from the SoundSource3D, if they are supported.

At least one Player (of a content type supported by SoundSource3D) can always be added to a SoundSource3D, but adding a MIDI channel or a second Player is not guaranteed to work.

Typically only mono Players would be added to a SoundSource3D. The behavior when sources with multiple channels (e.g. stereo) are added to a SoundSource3D is dependent on the implementation. Whether MacroscopicControl is enabled or not might also change the behaviour in the case of multichannel Players.

The GlobalManager is used to retrieve SoundSource3Ds.

See Also:

Spectator, EffectModule

Methods inherited from interface javax.microedition.amms.Module

addMIDIChannel, addPlayer, removeMIDIChannel, removePlayer

Methods inherited from interface javax.microedition.media.Controllable

getControl, getControls