Runtime environment notes

System properties

The following table describes the system properties used in AMMS API.

All retuned values are Strings. In cases where more than one value are returned, the values are delimited by one whitespace (Unicode U+0020).

Table: AMMS API system properties

Name

Description

Values

microedition.amms.version

Returns the version of the AMMS specification that is implemented on the device.

1.1

supports.mediacapabilities

Specifies the supported media capabilities.

The return values are chosen from the following list depending on device support:

  • audio3d

  • music

  • camera

  • imageencoding

  • imagepostprocessing

  • tuner

audio3d.simultaneouslocations

Specifies the maximum number of SoundSource3D modules that the application is recommended to have active simultaneously. Note that this limit is not enforced as its function is to serve as guideline rather than a strict limit.

No resources are used until a Player is attached to the sound source at which point resource unavailability might cause Player operations to fail (with MediaException being thrown).

4

Note: This is not actually enforced. The return value is meant to serve as a guideline rather than a strict limit.

audio.samplerates

Specifies the supported audio sampling rates in hertzs.

16000, 32000 or 48000

camera.orientations

Returns the orientation of the camera on the device. This property helps you make the distinction between cameras that are directed outwards from the device and cameras that are directed inwards, towards the user.

Multiple cameras are differentiated by their locator names. For more information, see section Recording sound and video.

[locator_name] [direction]

Possible return values for [direction] are:

  • inwards - the camera is pointing towards the user when the device is held in a natural way

  • outwards - the camera is pointing away from the user when the device is held in a natural way

  • unknown - the pointing direction of the camera is user configurable or cannot be known for some other reason

camera.resolutions

A list of camera device sensor resolutions.

[locator_name] [width]x[height]

For example:

capture://devcam0 640x480

tuner.modulations

Specifies the supported tuner modulation settings for which a Player can be created.

  • fm

  • am