Runtime environment notes

System properties

Table 81: 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 InputStream. Streaming from InputStream is not supported at the moment, therefore value of streamable.contents is null.

This is not related to network streaming (e.g. RTSP and HTTP)

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. From S60 3rd Edition onwards, the MMAPI security model is based on Mobile Service Architecture Specification 1.00 (JSR-248).

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

Table 82: 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. In the case of a MIDlet taking a snapshot using the camera, the security warning appears after the snapshot sound and flash. It is intentionally implemented this way so that the user does not miss the moment he wants to take a snapshot of.

Multimedia-specific settings for S60 and Series 40 platforms:

Table 83: Default permissions

Function group

Identified Third Party Protection Domain

Unidentified Third Party Protection Domain

Multimedia recording

Default: Session

Other: Blanket, Oneshot, No

Default setting: Oneshot

Other: Session, No

Read User Data Access

Default: Oneshot

Other: Blanket, Session, No

Default: Oneshot

Other: No

Write User Data Access

Default: Oneshot

Other: Blanket, Session, No

Default: Oneshot

Other: No