Archived:Camera shutter key (EKeyCamera events) cannot be used in 3rd party applications (Known Issue)

Comments

Stolik - Belle needs CaptureKeyUpAndDowns

In Belle capturing up and down of focus/shutter keys is needed for avoiding start of built-in camera app. see:

http://www.developer.nokia.com/Community/Wiki/Camera_key_handling_in_Symbian_Belle

stolik 12:46, 16 February 2012 (EET)

Log in or Join to leave comments.

Archived: This article is archived because it is not considered relevant for third-party developers creating commercial solutions today. If you think this article is still relevant, let us know by adding the template {{ReviewForRemovalFromArchive|user=~~~~|write your reason here}}.

The camera shutter key cannot be used for capturing images, because it is reserved for the system camera application.

Article Metadata

---

Tested with

Devices(s): All devices that have a camera shutter key (e.g., Nokia N70, Nokia N90)
Devices without AutoFocus capability

---

Compatibility

Platform(s): S60 2nd Edition
S60 3rd Edition

---

Article

Keywords: EKeyCamera

Created: User:Technical writer 1 (25 Jan 2007)

Last edited: hamishwillee (18 Jun 2012)

Description

The SDK header eikon.hrh lists the key code for the camera shutter key (EKeyCamera). However, key events from EKeyCamera are consumed and sent to the system camera application only, and cannot be captured by 3rd parties.

Solution

No solution available (for EKeyCamera events).

Devices with AutoFocus capability:

Devices that have a camera with AutoFocus capability use a different key code for the shutter key. Events from this key can be captured if the application has SwEvent capability.

#define EKeyCameraShutter 0xf883
#define EKeyCameraShutter2 0xf849 // S60 3rd Ed, FP2

Events from this key need to be explicitly requested from the window server:

// Capture events from the camera shutter key
// (SwEvent capability required)
iCameraKeyHandle =
iCoeEnv->RootWin().CaptureKey( EKeyCameraShutter, 0, 0 );

The return value iCameraKeyHandle (TInt32) is used for canceling the key capture request, typically when exiting the application:

if ( iCameraKeyHandle >= 0 )
    {
    iCoeEnv->RootWin().CancelCaptureKey(iCameraKeyHandle);
    }

Focus key events:

Pressing the shutter key halfway down generates separate key events. EEventKeyDown and EEventKeyUp events from this key can be detected with the following scan code:

#define EStdKeyCameraFocus 0xe2
#define EStdKeyCameraFocus2 0xeb // S60 3rd Ed, FP2