Runtime environment notes

System properties

Table 66: Mobile Media API system properties

String

Description

microedition.media.version

If the API is supported, a version of JSR-135 specification is returned. For example: 1.1.

supports.mixing

A query for whether audio mixing is supported. The string returned is either "true" or "false". If mixing is supported, the following conditions are true:

  • At least two tones can be played with Manager.playTone simultaneously.

  • Manager.playTone can be used at the same time when at least one Player is playing back audio.

  • At least two Players can be used to play back audio simultaneously.

supports.audio.capture

A query for whether audio capture is supported. The string returned is either "true" or "false".

supports.video.capture

A query for whether video capture is supported. The string returned is either "true" or "false".

supports.recording

A query for whether recording is supported. The string returned is either "true" or "false".

audio.encodings

The string returned specifies the supported capture audio formats. Each format is specified in a special syntax. The formats are delimited by at least one space. For example, "encoding=audio/wav".

video.encodings

The string returned specifies the supported capture video formats. Each format is specified in a special syntax. The formats are delimited by at least one space. For example, "encoding=video/3gpp".

video.snapshot.encodings

Supported video snapshot formats for the getSnapshot method in VideoControl. The string returned specifies the supported capture image formats. Each format is specified in a special syntax. The formats are delimited by at least one space. For example, "encoding=png".

streamable.contents

Returns formats that can be streamed from an InputStream. Returns null if streamable formats do not exist. No formats support InputStream streaming at the moment.

Security settings

The MMAPI security model implemented in the Java platform for S60 is based on MIDP 2.0 Recommended Security Policy, JTWI 1.0 and MMAPI 1.1 addendum: Multimedia Security v1.0 JSR135.

Permissions are required for recording, network access, and access to local data stores. Permissions are granted based on the following function groups:

Table 67: User settings

Function group

Needed for

Network Access

Access to media on http, https and rtsp locators

Multimedia recording

Recording audio and video, video snapshots

Read User Data Access

Access media in local file system

Write User Data Access

Save a recording into local file system

A security dialog is presented to the user if the relevant function group setting does not explicitly deny or permit access to the feature in question. If the required permission is not granted, then a SecurityException is thrown.

Multimedia-specific settings for S60 and Series 40 platforms:

Table 68: Default permissions

Function group

Trusted 3rd Party domain

Untrusted domain

Manufacturer domain

Operator domain

Multimedia recording

Default: Ask first time

Other settings: Always allowed, Not allowed

Default: Ask every time

Other settings: Ask first time, Not allowed

Always allowed

Always allowed