View source

[[Category:Java ME]][[Category:Series 40 6th Edition]][[Category:Advanced Multimedia Supplements (JSR-234)]]

Advanced Multimedia Supplements API (AMMS) (JSR-234) builds on the framework established in the Mobile Media API (MMAPI) (JSR-135) by adding many new Controls in javax.microedition.amms.control and it’s subpackages. In Nokia platforms, the support for AMMS has been partially enabled as subpackages. More specifically, both Series 40 (starting from Series 40 5th Edition)  and S60 (starting from S60 3rd Edition, Feature Pack 1) include support for two full Control subpackages:
*'''3D Audio''': javax.microedition.amms.control.audio3d
*'''Music''':javax.microedition.amms.control.audioeffect


==Support for Camera Capability controls in Series 40 6th Edition== 

In addition in Series 40, support for AMMS Camera Capability subpackage, javax.microedition.amms.control.camera, is introduced starting from Series 40 6th Edition. 

The support for the Camera subpackage is partial as some Series 40 6th Edition devices support two of six Camera controls, and in addition, one of the controls, ExposureControl, is excluded from Series 40 6th Edition. In addition to the controls of Camera subpackage, the support for ImageFormatControl is included for setting image format of camera images (This control is the precondition for using Camera subpackage as defined by [http://jcp.org/en/jsr/detail?id=234 JSR 234 specification]).

More specifically, support for the '''Camera subpackage in Series 40 6th Edition''' stands for:

* [http://www.forum.nokia.com/info/sw.nokia.com/id/cc48f9a1-f5cf-447b-bdba-c4d41b3d05ce/Series_40_Platform_SDKs.html Series 40 6th Edition SDK] enables building and compilation of MIDlets which use the controls of Camera subpackage


* the '''minimum set of Camera controls supported by Series 40 6th Edition devices''' includes: 
**'''CameraControl''': javax.microedition.amms.control.camera.CameraControl
**'''SnapshotControl''': javax.microedition.amms.control.camera.SnapshotControl


* the '''maximum set of Camera controls supported by Series 40 6th Edition devices''' includes: 
**'''CameraControl''': javax.microedition.amms.control.camera.CameraControl 
**'''FlashControl''': javax.microedition.amms.control.camera.FlashControl
**'''FocusControl''': javax.microedition.amms.control.camera.FocusControl
**'''SnapshotControl''': javax.microedition.amms.control.camera.SnapshotControl 
**'''ZoomControl''': javax.microedition.amms.control.camera.ZoomControl


* The supported set of Camera controls for each Series 40 6th Edition device can be checked from [http://www.forum.nokia.com/devices/matrix_s40_6ed_1.html Device Specifications on Forum.Nokia.com]. To check the support, select a device and click 'APIs' to open the API info box. For '''JSR 234 Advanced Multimedia Supplements 1.1 (camera)''' of the device, the 'Notes' row on the bottom of the 'APIs' info box defines either one of the following set of Camera controls supported by the device:
** contains CameraControl, SnapshotControl
** contains CameraControl, SnapshotControl, FlashControl, FocusControl and ZoomControl 


* support for '''ExposureControl''' (javax.microedition.amms.control.ExposureControl) is not enabled in Series 40 6th Edition



==Using Camera Capability controls in Series 40 6th Edition==

Accordingly to [http://jcp.org/en/jsr/detail?id=234 JSR 234 specification], the Camera controls can be provided by using a MMAPI Player object. For Series 40 devices, the Player object for camera capture can be created as follows:

<code java>
//NOTE: Series 40 specific locator for camera capture
Player player = Manager.createPlayer(“capture://image”); 
player.realize();
</code>

For implementing Camera controls, the related classes need to be imported for application:

<code java>
//Imports all classes for the existing Camera controls
import javax.microedition.amms.control.camera.*; 
// For controlling the setting of the image format 
import javax.microedition.amms.control.ImageFormatControl; 
</code>

The created Player object can provide supported Camera controls and ImageFormatControl by using getControl():

<code java>
CameraControl cameraCntrl = 
(CameraControl) player.getControl("javax.microedition.amms.control.camera.CameraControl");

SnapshotControl snapshotCntrl = 
(SnapshotControl) player.getControl("javax.microedition.amms.control.camera.SnapshotControl");

FlashControl flashCntrl = 
(FlashControl) player.getControl("javax.microedition.amms.control.camera.FlashControl");

FocusControl focusCntrl = 
(FocusControl) player.getControl("javax.microedition.amms.control.camera.FocusControl");

ImageFormatControl imageCntrl = 
(ImageFormatControl) player.getControl("javax.microedition.amms.control.ImageFormatControl");

ZoomControl zoomCntrl = 
(ZoomControl) player.getControl("javax.microedition.amms.control.camera.ZoomControl");
</code>

The returned Camera controls can be now used for accessing and setting control specific Camera capabilities. 

For using the Camera capabilities, please see the Javadocs of JSR-234 AMMS API in Forum Nokia Developer’s Library: http://library.forum.nokia.com/index.jsp?topic=/Java_Developers_Library/GUID-D3E35E6F-0C45-48ED-B09D-F716E14C1C02/javax/microedition/amms/control/camera/package-summary.html


==Resources==

*JSR 234 Advanced Multimedia Supplements API specification: http://jcp.org/en/jsr/detail?id=234

*Javadocs for JSR 234 AMMS API in Forum Nokia Java Developer's Library:  http://library.forum.nokia.com/index.jsp?topic=/Java_Developers_Library/GUID-D3E35E6F-0C45-48ED-B09D-F716E14C1C02/javax/microedition/amms/control/camera/package-summary.html