Feature description

The Advanced Multimedia Supplements API (AMMS) builds on the framework already established by the Mobile Media API (MMAPI) (JSR-135). The AMMS API adds many new Controls (in javax.microedition.amms.control and subpackages), as well as new extensions to the MMAPI framework (in javax.microedition.amms). The AMMS API included from S60 3rd Edition Feature Pack 1 onwards is based on JSR-234 specification, version 1.0.

Supported features

Music Capability support

The following requirements for music capability are supported from S60 3rd Edition FP 1 and Series 40 5th Edition onwards:

EqualizerControl is supported for the GlobalManager
VolumeControl is supported for the GlobalManager

3D Audio Capability support

The following Player related requirements for the 3D audio capability are supported from S60 3rd Edition FP 1 and Series 40 5th Edition FP 1 onwards:

Spectator can be created with GlobalManager.getSpectator().
SoundSource3D can be created with GlobalManager.createSoundSource3D() .
LocationControl is supported for SoundSource3D and Spectator.
OrientationControl is supported for the Spectator.
DistanceAttenuationControl is supported for SoundSource3D.
ReverbControl is supported for GlobalManager.
GlobalManager.getSupportedSoundSource3DPlayerTypes returns at least "audio/x-wav".
System property audio3d.simultaneouslocation returns at least 1.

Camera support

The following requirements for camera capability are supported from Series 40 6th Edition onwards:

CameraControl from capture://image players
SnapshotControl from capture://image players
ImageFormatControl from capture://image players

Camera support

Camera support is enabled from Java Runtime 2.3 onwards. Snapshot and exposure control are not fully supported, refer to the Excluded features section below for more information.

Excluded features

The media capabilities listed below are not supported:

Image Encoding
Image Post-Processing
Tuner Capability

The following features are not supported in the emulator environment:

Camera
PanControl is not supported in the emulator.
AMMS does not support audio mixing in the emulator environment. Thus, only one player can be added to AMMS modules (EffectModule, SoundSource3D) simultaneously. When the player in a module is closed, another player can be added to a module.

The following features are not supported on the Symbian Platform:

SnapshotControl

Calling a new SnapshotControl.start() when already a SnapshotControl.start() is being executed does not Stop() the current execution. The request for a new Start() is not taken until the ongoing execution is completed.
Maximum of 18 snapshots can be taken in burst mode. If more than 18 is specified to SnapshotControl.start(), only 18 snapshots will be taken.
Calling SnapshotControl.start(), when already a burst mode is in progress does nothing.

ExposureControl

Exposure Time (Shutter speed) is not supported and defaulted to 0 (Auto exposure).
FStop is not supported and defaulted to 0 (Auto aperture)
Exposure Value is not supported and defaulted to invalid value -100.
Different Light Metering modes are not supported and defaulted to Matrix Metering mode.

Note: All the features are dependent on platform capabilities, it is a good practice to call an API to check if a feature is supported before using it.