Symbian3/SDK/Source/GUID-AE979B97-5610-42F3-99A7-5A3D66D3C2E6.dita
author Dominic Pinkman <Dominic.Pinkman@Nokia.com>
Wed, 31 Mar 2010 11:11:55 +0100
changeset 7 51a74ef9ed63
permissions -rw-r--r--
Week 12 contribution of API Specs and fix SDK submission

<?xml version="1.0" encoding="utf-8"?>
<!-- Copyright (c) 2007-2010 Nokia Corporation and/or its subsidiary(-ies) All rights reserved. -->
<!-- This component and the accompanying materials are made available under the terms of the License 
"Eclipse Public License v1.0" which accompanies this distribution, 
and is available at the URL "http://www.eclipse.org/legal/epl-v10.html". -->
<!-- Initial Contributors:
    Nokia Corporation - initial contribution.
Contributors: 
-->
<!DOCTYPE concept
  PUBLIC "-//OASIS//DTD DITA Concept//EN" "concept.dtd">
<concept id="GUID-AE979B97-5610-42F3-99A7-5A3D66D3C2E6" xml:lang="en"><title>Sensor
interaction</title><prolog><metadata><keywords/></metadata></prolog><conbody>
<p>The following types of interaction are enabled by using the sensors on
the device:</p>
<ol>
<li id="GUID-3EA00C46-70FB-4C6F-8B9D-B766FA8C0692"><p>Tapping the device (for
example, double tap) to perform a given function.<note> Tapping interaction
is not recommended for touch devices since the tap might also be interpreted
as a touch action if you tap on the touch screen area.</note></p></li>
<li id="GUID-BB715BEE-CB95-4F0E-9676-8CDE8D525C02"><p>Changing the screen
orientation on the device from portrait to landscape as the device is rotated.</p></li>
<li id="GUID-69332FF5-EDD2-4EA9-8569-A72BE7DA9961"><p>Silencing an incoming
call when the device orientation is changed from screen down (for example
on a table) to screen up and back again).</p></li>
<li id="GUID-FF0D8D87-D2A9-4206-A6A4-98EDE1A0BAA0"><p>Changing application
settings based on the ambient light conditions, e.g. bright sunshine or night
time.</p></li>
<li id="GUID-D3B06257-1088-43A5-9D2E-513971297EAE"><p>In a map application,
changing the orientation of a map based on the device's compass orientation.</p></li>
<li id="GUID-2414DEDE-D503-4798-AA6C-B5F8D85BB147"><p>Allowing movement gestures,
such as device rotation, to trigger an action.</p></li>
<li id="GUID-1B8F18AC-08C3-4F6D-8A91-7EAE8CFADD5B"><p>Trigger an action when
the device comes in close proximity to the user's hand or head.</p></li>
</ol>
<p>The supported sensor interactions are configurable on the device. The users
should be given the option to set their desired interactions.</p>
<p>Apart from sensing actions, the device can give tactile (vibrating) feedback
to acknowledge that the interaction has been successful.</p>
<section id="GUID-4C7164D8-5EAB-45D1-AD32-1DAD8B1F8AC0"><title>Using
sensor interaction in C++ applications</title><p>The APIs to use for sensor
interaction are the Sensor channel API and the Sensor definitions API. </p><p>For
implementation information and description of the APIs, see the <xref href="GUID-2F3883C4-7286-42E4-9196-2F3304298405.dita">API specification</xref> for
the sensor APIs.</p><p>Sensors channels come in three types based on the kind
of data that is delivered on the sensor channel: event, status, and continuous
data. For more information, see <xref href="GUID-7A487E17-8772-4037-8234-A99929476ED7.dita">Definitions
for the sensor APIs</xref>.</p></section>
</conbody></concept>