1 <?xml version="1.0" encoding="utf-8"?> |
1 <?xml version="1.0" encoding="UTF-8"?> |
2 <!-- Copyright (c) 2007-2010 Nokia Corporation and/or its subsidiary(-ies) All rights reserved. --> |
2 <!--Arbortext, Inc., 1988-2008, v.4002--> |
3 <!-- This component and the accompanying materials are made available under the terms of the License |
3 <!DOCTYPE concept PUBLIC "-//OASIS//DTD DITA Concept//EN" |
4 "Eclipse Public License v1.0" which accompanies this distribution, |
4 "concept.dtd"> |
5 and is available at the URL "http://www.eclipse.org/legal/epl-v10.html". --> |
5 <concept id="GUID-581A8E4B-12BE-41C0-A20E-3087A80FEECF" xml:lang="en"><?Pub |
6 <!-- Initial Contributors: |
6 Caret1?> |
7 Nokia Corporation - initial contribution. |
7 <title>Tactile feedback</title> |
8 Contributors: |
8 <prolog> |
9 --> |
9 <metadata><keywords></keywords></metadata> |
10 <!DOCTYPE concept |
10 </prolog> |
11 PUBLIC "-//OASIS//DTD DITA Concept//EN" "concept.dtd"> |
11 <conbody> |
12 <concept id="GUID-581A8E4B-12BE-41C0-A20E-3087A80FEECF" xml:lang="en"><title>Tactile |
12 <p>There are two cases where vibration or audio of the device is used |
13 feedback</title><prolog><metadata><keywords/></metadata></prolog><conbody> |
13 as an output method:</p> |
14 <p>There are two cases where vibration or audio of the device is used as an |
|
15 output method:</p> |
|
16 <ul> |
14 <ul> |
17 <li><p>As a <i>tacticon</i> to inform users through physical feedback, that |
15 <li><p>As a <i>tacticon</i> to inform users through physical feedback, |
18 an important event is occurring in the device. For example, when a new message |
16 that an important event is occurring in the device. For example, when |
19 arrives or a warning note is displayed.</p></li> |
17 a new message arrives or a warning note is displayed.</p></li> |
20 <li><p>As <i>tactile feedback</i> to indicate to the user that an interaction |
18 <li><p>As <i>tactile feedback</i> to indicate to the user that an |
21 event has been made. For example, users receive tactile feedback when they |
19 interaction event has been made. For example, users receive tactile |
22 press a button on the touch screen.</p></li> |
20 feedback when they press a button on the touch screen.</p></li> |
23 </ul> |
21 </ul> |
24 <p>As with sounds, tactile feedback must be used carefully so as not to desensitize |
22 <p>As with sounds, tactile feedback must be used carefully so as not |
25 the user to the vibration; the attention grabbing quality remains and functions |
23 to desensitize the user to the vibration; the attention grabbing quality |
26 so long as the feedback is not too frequent.</p> |
24 remains and functions so long as the feedback is not too frequent.</p> |
27 <p>Tactile feedback is enabled for all the Symbian platform UI components. |
25 <p>Tactile feedback is enabled for all the Symbian platform UI components. |
28 Tactile feedback can be disabled for the common UI components in an application. |
26 Tactile feedback can be disabled for the common UI components in an |
29 However, this is acceptable only if tactile feedback causes interference with |
27 application. However, this is acceptable only if tactile feedback |
30 other device functions.</p> |
28 causes interference with other device functions.</p> |
31 <p>The user can choose the level of tactile feedback and turn tacticons ON |
29 <p>The user can choose the level of tactile feedback and turn tacticons |
32 and OFF.</p> |
30 ON and OFF.</p> |
33 <p>The following table lists the tactile feedback effects:</p> |
31 <p>The following table lists the tactile feedback effects:</p> |
34 <p><table id="GUID-4969AEA7-3BE4-4644-8232-1FA26D49010B"><title>Tactile feedback |
32 <p><table id="GUID-4969AEA7-3BE4-4644-8232-1FA26D49010B"> |
35 effects</title> |
33 <title>Tactile feedback effects</title> |
36 <tgroup cols="2"><colspec colname="col1" colwidth="0.40*"/><colspec colname="col2" colwidth="1.60*"/> |
34 <tgroup cols="2"><colspec colname="col1" colwidth="0.40*"/><colspec |
|
35 colname="col2" colwidth="1.60*"/> |
37 <thead> |
36 <thead> |
38 <row> |
37 <row> |
39 <entry valign="top"><p>Effects</p></entry> |
38 <entry valign="top"><p>Effects</p></entry> |
40 <entry valign="top"><p>Description</p></entry> |
39 <entry valign="top"><p>Description</p></entry> |
41 </row> |
40 </row> |
42 </thead> |
41 </thead> |
43 <tbody> |
42 <tbody> |
44 <row> |
43 <row> |
45 <entry><p><b>Sensitive button</b></p></entry> |
44 <entry><p><b>Sensitive button</b></p></entry> |
46 <entry><p>Provides single pulse effect on repeated key presses with buttons. |
45 <entry><p>Provides single pulse effect on repeated key presses with |
47 It is also possible with other similar components.</p></entry> |
46 buttons. It is also possible with other similar components.</p></entry> |
48 </row> |
47 </row> |
49 <row> |
48 <row> |
50 <entry><p><b>Basic button</b></p></entry> |
49 <entry><p><b>Basic button</b></p></entry> |
51 <entry><p>Provides stronger single pulse effect to buttons. It is also possible |
50 <entry><p>Provides stronger single pulse effect to buttons. It is |
52 with other similar components.</p></entry> |
51 also possible with other similar components.</p></entry> |
53 </row> |
52 </row> |
54 <row> |
53 <row> |
55 <entry><p><b>Sensitive list</b></p></entry> |
54 <entry><p><b>Sensitive list</b></p></entry> |
56 <entry><p>Provides single pulse effect to lists and grids. Effect is used |
55 <entry><p>Provides single pulse effect to lists and grids. Effect |
57 with move (drag and flick) when new item appears on the screen.</p></entry> |
56 is used with move (drag and flick) when new item appears on the screen.</p |
|
57 ></entry> |
58 </row> |
58 </row> |
59 <row> |
59 <row> |
60 <entry><p><b>Basic list</b></p></entry> |
60 <entry><p><b>Basic list</b></p></entry> |
61 <entry><p>Provides stronger single pulse effect to lists and grids. Effect |
61 <entry><p>Provides stronger single pulse effect to lists and grids. |
62 is used with touch down and release when tap makes an action. </p><p>In hierarchical |
62 Effect is used with touch down and release when tap makes an action. </p |
63 list, collapsing/expanding item provides basic list effect with touch down |
63 ><p>In hierarchical list, collapsing/expanding item provides basic |
|
64 list effect with touch down and release.</p></entry> |
|
65 </row> |
|
66 <row> |
|
67 <entry><p><b>Bounce effect</b></p></entry> |
|
68 <entry><p>Provides pulse effect when list returns to its normal state |
|
69 after boundary effect.</p></entry> |
|
70 </row> |
|
71 <row> |
|
72 <entry><p><b>Sensitive slider</b></p></entry> |
|
73 <entry><p>Provides pulse effect with scrollbar and slider thumbs. |
|
74 Effect is provided with touch down and release in thumb area.</p></entry> |
|
75 </row> |
|
76 <row> |
|
77 <entry><p><b>Smooth slider</b></p></entry> |
|
78 <entry><p>Provides continuous smooth feedback when dragging scrollbar |
|
79 or slider thumb. This can also be increasing or decreasing depending |
|
80 of the slider type.</p></entry> |
|
81 </row> |
|
82 <row> |
|
83 <entry><p><b>Hold slider</b></p></entry> |
|
84 <entry><p>Provides sensitive pulse effect when touch down and hold |
|
85 on the slider or scrollbar area. Slider thumb starts moving step by |
|
86 step towards the touch point. Every step gives one sensitive pulse. |
|
87 If slider thumb moves directly to the touch point, then basic slider |
|
88 effect is provided.</p></entry> |
|
89 </row> |
|
90 <row> |
|
91 <entry><p><b>Pop-up</b></p></entry> |
|
92 <entry><p>Provides sensitive pulse effect when pop-up is opened or |
|
93 closed. If the theme animations are ON, then pop-up effect is used |
|
94 with opening event after increasing long touch effect. In this scenario, |
|
95 there is no pop-up effect . <note> All pop-ups do not have theme animation.</note |
|
96 ></p></entry> |
|
97 </row> |
|
98 <row> |
|
99 <entry><p><b>Pop-up close</b></p></entry> |
|
100 <entry><p>Provides decreasing smooth feedback a pop-up and when theme |
|
101 animations are ON.</p></entry> |
|
102 </row> |
|
103 <row> |
|
104 <entry><p><b>Increasing long touch</b></p></entry> |
|
105 <entry><p>Provides increasing smooth feedback. This can be used with |
|
106 either long tap animation or pop-up opening theme effects. If the |
|
107 theme effects are ON and long tap opens a pop-up, then feedback is |
|
108 provided only with long tap. This is followed by pop-up.</p></entry> |
|
109 </row> |
|
110 <row> |
|
111 <entry><p><b>Basic tab</b></p></entry> |
|
112 <entry><p>Provides strong pulse effect with touch down event in tab |
|
113 area.</p></entry> |
|
114 </row> |
|
115 <row> |
|
116 <entry><p><b>Smooth flick</b></p></entry> |
|
117 <entry><p>Provides smooth feedback with drag when horizontal movement |
|
118 is possible.</p></entry> |
|
119 </row> |
|
120 <row> |
|
121 <entry><p><b>Sensitive flick</b></p></entry> |
|
122 <entry><p>Provides sensitive pulse effect with touch release when |
|
123 horizontal movement is possible.</p></entry> |
|
124 </row> |
|
125 <row> |
|
126 <entry><p><b>Sensitive edit</b></p></entry> |
|
127 <entry><p>Provides sensitive pulse effect in editors with touch down |
64 and release.</p></entry> |
128 and release.</p></entry> |
65 </row> |
129 </row> |
66 <row> |
130 <row> |
67 <entry><p><b>Bounce effect</b></p></entry> |
|
68 <entry><p>Provides pulse effect when list returns to its normal state after |
|
69 boundary effect.</p></entry> |
|
70 </row> |
|
71 <row> |
|
72 <entry><p><b>Sensitive slider</b></p></entry> |
|
73 <entry><p>Provides pulse effect with scrollbar and slider thumbs. Effect is |
|
74 provided with touch down and release in thumb area.</p></entry> |
|
75 </row> |
|
76 <row> |
|
77 <entry><p><b>Smooth slider</b></p></entry> |
|
78 <entry><p>Provides continuous smooth feedback when dragging scrollbar or slider |
|
79 thumb. This can also be increasing or decreasing depending of the slider type.</p></entry> |
|
80 </row> |
|
81 <row> |
|
82 <entry><p><b>Hold slider</b></p></entry> |
|
83 <entry><p>Provides sensitive pulse effect when touch down and hold on the |
|
84 slider or scrollbar area. Slider thumb starts moving step by step towards |
|
85 the touch point. Every step gives one sensitive pulse. If slider thumb moves |
|
86 directly to the touch point, then basic slider effect is provided.</p></entry> |
|
87 </row> |
|
88 <row> |
|
89 <entry><p><b>Pop-up</b></p></entry> |
|
90 <entry><p>Provides sensitive pulse effect when pop-up is opened or closed. |
|
91 If the theme animations are ON, then pop-up effect is used with opening event |
|
92 after increasing long touch effect. In this scenario, there is no pop-up effect |
|
93 . <note> All pop-ups do not have theme animation.</note></p></entry> |
|
94 </row> |
|
95 <row> |
|
96 <entry><p><b>Pop-up close</b></p></entry> |
|
97 <entry><p>Provides decreasing smooth feedback a pop-up and when theme animations |
|
98 are ON.</p></entry> |
|
99 </row> |
|
100 <row> |
|
101 <entry><p><b>Increasing long touch</b></p></entry> |
|
102 <entry><p>Provides increasing smooth feedback. This can be used with either |
|
103 long tap animation or pop-up opening theme effects. If the theme effects are |
|
104 ON and long tap opens a pop-up, then feedback is provided only with long tap. |
|
105 This is followed by pop-up.</p></entry> |
|
106 </row> |
|
107 <row> |
|
108 <entry><p><b>Basic tab</b></p></entry> |
|
109 <entry><p>Provides strong pulse effect with touch down event in tab area.</p></entry> |
|
110 </row> |
|
111 <row> |
|
112 <entry><p><b>Smooth flick</b></p></entry> |
|
113 <entry><p>Provides smooth feedback with drag when horizontal movement is possible.</p></entry> |
|
114 </row> |
|
115 <row> |
|
116 <entry><p><b>Sensitive flick</b></p></entry> |
|
117 <entry><p>Provides sensitive pulse effect with touch release when horizontal |
|
118 movement is possible.</p></entry> |
|
119 </row> |
|
120 <row> |
|
121 <entry><p><b>Sensitive edit</b></p></entry> |
|
122 <entry><p>Provides sensitive pulse effect in editors with touch down and release.</p></entry> |
|
123 </row> |
|
124 <row> |
|
125 <entry><p><b>Text edit</b></p></entry> |
131 <entry><p><b>Text edit</b></p></entry> |
126 <entry><p>Provides pulse effect when painting the text. Effect is provided |
132 <entry><p>Provides pulse effect when painting the text. Effect is |
127 with every character while painting the text.</p></entry> |
133 provided with every character while painting the text.</p></entry> |
128 </row> |
134 </row> |
129 <row> |
135 <row> |
130 <entry><p><b>Blank edit</b></p></entry> |
136 <entry><p><b>Blank edit</b></p></entry> |
131 <entry><p>Provides pulse effect when painting blank character. By default, |
137 <entry><p>Provides pulse effect when painting blank character. By |
132 it is none.</p></entry> |
138 default, it is none.</p></entry> |
133 </row> |
139 </row> |
134 <row> |
140 <row> |
135 <entry><p><b>Line edit</b></p></entry> |
141 <entry><p><b>Line edit</b></p></entry> |
136 <entry><p>Provides pulse effect when painting a line.</p></entry> |
142 <entry><p>Provides pulse effect when painting a line.</p></entry> |
137 </row> |
143 </row> |
138 <row> |
144 <row> |
139 <entry><p><b>Empty line</b></p></entry> |
145 <entry><p><b>Empty line</b></p></entry> |
140 <entry><p>Provides pulse effect when painting an empty line. By default, it |
146 <entry><p>Provides pulse effect when painting an empty line. By default, |
141 is none.</p></entry> |
147 it is none.</p></entry> |
142 </row> |
148 </row> |
143 <row> |
149 <row> |
144 <entry><p><b>Check box</b></p></entry> |
150 <entry><p><b>Check box</b></p></entry> |
145 <entry><p>Provides pulse effect when marking/unmarking a check box.</p></entry> |
151 <entry><p>Provides pulse effect when marking/unmarking a check box.</p |
146 </row> |
152 ></entry> |
147 <row> |
153 </row> |
148 <entry><p><b>Multi-touch recognition</b></p></entry> |
154 <row> |
149 <entry><p>Provides double pulse (sensitive + sensitive) effect when multi-touch |
155 <entry><p><b>Multiple touch recognition</b></p></entry> |
150 is recognized (generally, when second finger is touched down).</p></entry> |
156 <entry><p>Provides double pulse (sensitive + sensitive) effect when |
|
157 multiple touch is recognized (generally, when second finger is touched |
|
158 down).</p></entry> |
151 </row> |
159 </row> |
152 <row> |
160 <row> |
153 <entry><p><b>Smooth pinch</b></p></entry> |
161 <entry><p><b>Smooth pinch</b></p></entry> |
154 <entry><p>Provides smooth continuous feedback while moving fingers in multi-touch |
162 <entry><p>Provides smooth continuous feedback while moving fingers |
155 pinch situation.</p></entry> |
163 in multiple touch pinch situation.</p></entry> |
156 </row> |
164 </row> |
157 <row> |
165 <row> |
158 <entry><p><b>Smooth rotate</b></p></entry> |
166 <entry><p><b>Smooth rotate</b></p></entry> |
159 <entry><p>Provides smooth continuous feedback while moving fingers in multi-touch |
167 <entry><p>Provides smooth continuous feedback while moving fingers |
160 rotate situation.</p></entry> |
168 in multiple touch rotate situation.</p></entry> |
161 </row> |
169 </row> |
162 </tbody> |
170 </tbody> |
163 </tgroup> |
171 </tgroup> |
164 </table></p> |
172 </table></p> |
165 <section id="GUID-1EB54408-100B-4E4F-8D56-E13C26CA3B96"><title>Haptics concept</title><p>The different senses associated |
173 <section id="GUID-1EB54408-100B-4E4F-8D56-E13C26CA3B96"><title>Haptics |
166 to the skin are called cutaneous senses. These senses are temperature, pressure |
174 concept</title><p>The different senses associated to the skin are |
167 (touch itself), pain, tickle, itch and vibration senses. We can characterize |
175 called cutaneous senses. These senses are temperature, pressure (touch |
168 touch as passive or active. Passive touch means the sense of touch itself, |
176 itself), pain, tickle, itch and vibration senses. We can characterize |
169 whereas active touch means the touch action.</p><p>To communicate through |
177 touch as passive or active. Passive touch means the sense of touch |
170 the sense of touch, we have to stimulate some of the cutaneous senses or the |
178 itself, whereas active touch means the touch action.</p><p>To communicate |
171 movement sense. The stimulation of the cutaneous senses or one of them by |
179 through the sense of touch, we have to stimulate some of the cutaneous |
172 a product is called tactile stimulation. Respectively, the stimulation of |
180 senses or the movement sense. The stimulation of the cutaneous senses |
173 the movement sense by a product is called haptic stimulation or just haptics. |
181 or one of them by a product is called tactile stimulation. Respectively, |
174 Haptics is also used as general term for all issues related to sense of touch, |
182 the stimulation of the movement sense by a product is called haptic |
175 both human and machine.</p><p>Haptic feedback, often referred to as "Haptics", |
183 stimulation or just haptics. Haptics is also used as general term |
176 is the use of the sense of touch in a user interface design to provide information |
184 for all issues related to sense of touch, both human and machine.</p |
177 to an end user. In mobile phones, this generally means the use of vibrations |
185 ><p>Haptic feedback, often referred to as "Haptics", is the use of |
178 from the device's vibration alarm to denote that a touch screen button has |
186 the sense of touch in a user interface design to provide information |
179 been pressed. In this particular example, the phone would vibrate slightly |
187 to an end user. In mobile phones, this generally means the use of |
180 in response to the user's activation of an on-screen control, making up for |
188 vibrations from the device's vibration alarm to denote that a touch |
181 the lack of a normal tactile response that the user would experience when |
189 screen button has been pressed. In this particular example, the phone |
182 pressing a physical button.</p></section> |
190 would vibrate slightly in response to the user's activation of an |
|
191 on-screen control, making up for the lack of a normal tactile response |
|
192 that the user would experience when pressing a physical button.</p |
|
193 ></section> |
183 <section id="GUID-B9A35CA3-B830-4D97-9B0A-E22DC4A3CDA1"><title>Characteristics |
194 <section id="GUID-B9A35CA3-B830-4D97-9B0A-E22DC4A3CDA1"><title>Characteristics |
184 of haptics related APIs</title><p>You can use the following APIs to create |
195 of haptics related APIs</title><p>You can use the following APIs |
185 haptic effects:</p><ul> |
196 to create haptic effects:</p><ul> |
186 <li><p><xref href="GUID-8661A7E0-F19A-41F8-9062-FBFAE70CF658.dita">Tactile Feedback |
197 <li><p><xref href="GUID-8661A7E0-F19A-41F8-9062-FBFAE70CF658.dita" |
187 Client API</xref></p><ul> |
198 >Tactile Feedback Client API</xref></p><ul> |
188 <li><p>Available from S60 5th Edition onwards.</p></li> |
199 <li><p>Available from S60 5th Edition onwards.</p></li> |
189 <li><p>It can be used on all S60 5th Edition or later mobile devices. However, |
200 <li><p>It can be used on all S60 5th Edition or later mobile devices. |
190 the feedback is played only on touch enabled layouts.</p></li> |
201 However, the feedback is played only on touch enabled layouts.</p |
191 <li><p>Provides simple functions for triggering various predefined tactile |
202 ></li> |
192 feedback (vibration or audio) effects.</p></li> |
203 <li><p>Provides simple functions for triggering various predefined |
193 <li><p>Enables a consistent user experience in all applications of the mobile |
204 tactile feedback (vibration or audio) effects.</p></li> |
194 device (an application gives a logical feedback type as an input and the actual |
205 <li><p>Enables a consistent user experience in all applications of |
195 physical effect depends on the mobile device configuration and end user settings).</p></li> |
206 the mobile device (an application gives a logical feedback type as |
196 <li><p>When the area feedback is used, latency is low for the feedback triggering |
207 an input and the actual physical effect depends on the mobile device |
197 (a tactile feedback can already be triggered at the window server level prior |
208 configuration and end user settings).</p></li> |
198 to the corresponding pointer event being delivered to the visible application).</p></li> |
209 <li><p>When the area feedback is used, latency is low for the feedback |
199 <li><p>Direct feedback can be easily integrated into <xref href="GUID-B06F99BD-F032-3B87-AB26-5DD6EBE8C160.dita#GUID-B06F99BD-F032-3B87-AB26-5DD6EBE8C160/GUID-5CF90E7A-4A91-36FF-BB3F-CF7CF687DED2"><apiname>CCoeControl::HandlePointerEventL()</apiname></xref>. </p></li> |
210 triggering (a tactile feedback can already be triggered at the window |
200 <li><p>An application can select the logical tactile feedback from certain |
211 server level prior to the corresponding pointer event being delivered |
201 types. The produced effect may be different on various mobile devices.</p></li> |
212 to the visible application).</p></li> |
|
213 <li><p>Direct feedback can be easily integrated into <xref |
|
214 href="GUID-B06F99BD-F032-3B87-AB26-5DD6EBE8C160.dita#GUID-B06F99BD-F032-3B87-AB26-5DD6EBE8C160/GUID-5CF90E7A-4A91-36FF-BB3F-CF7CF687DED2" |
|
215 ><apiname>CCoeControl::HandlePointerEventL()</apiname></xref>. </p |
|
216 ></li> |
|
217 <li><p>An application can select the logical tactile feedback from |
|
218 certain types. The produced effect may be different on various mobile |
|
219 devices.</p></li> |
202 </ul></li> |
220 </ul></li> |
203 <li><p><xref href="jar:GUID-558A5A9B-811E-4A87-B3DD-AE734C9AA966.jar!/public_specs/GuidesA/Haptics_API_Specification/Haptics_API_Specification.html" format="application/java-archive">Haptics |
221 <li><p><xref format="application/java-archive" |
204 API</xref></p><ul> |
222 href="jar:GUID-558A5A9B-811E-4A87-B3DD-AE734C9AA966.jar!/public_specs/GuidesA/Haptics_API_Specification/Haptics_API_Specification.html" |
|
223 >Haptics API</xref></p><ul> |
205 <li><p>Available from S60 5th Edition, FP2 onwards.</p></li> |
224 <li><p>Available from S60 5th Edition, FP2 onwards.</p></li> |
206 <li><p>It can be used in touch and hybrid mobile devices.</p></li> |
225 <li><p>It can be used in touch and hybrid mobile devices.</p></li> |
207 <li><p>Provides an interface for accessing Haptics player that can control |
226 <li><p>Provides an interface for accessing Haptics player that can |
208 different actuator types.</p></li> |
227 control different actuator types.</p></li> |
209 <li><p>Enables producing of complex vibrator effects, such as an explosion |
228 <li><p>Enables producing of complex vibrator effects, such as an explosion |
210 or machine gun effect in a game, bass boost for a music player, advanced ringing |
229 or machine gun effect in a game, bass boost for a music player, advanced |
211 tone vibration, and so on.</p></li> |
230 ringing tone vibration, and so on.</p></li> |
212 <li><p>Enables simultaneous playing of different kinds of basis effects and |
231 <li><p>Enables simultaneous playing of different kinds of basis effects |
213 modifying them when played. </p></li> |
232 and modifying them when played. </p></li> |
214 <li><p>Allows the design of complex effects (using a separate PC application) |
233 <li><p>Allows the design of complex effects (using a separate PC application) |
215 that can be loaded on Haptics player for playing.</p></li> |
234 that can be loaded on Haptics player for playing.</p></li> |
216 <li><p>It may require a special license key for third-party applications |
235 <li><p>It may require a special license key for third-party applications |
217 (to be set at runtime) to enable the Haptics player functionality.</p></li> |
236 (to be set at runtime) to enable the Haptics player functionality.</p |
|
237 ></li> |
218 </ul></li> |
238 </ul></li> |
219 <li><p><xref href="GUID-D53A00E4-CF37-5F11-8D15-C5ECCCE64597.dita">Vibra API</xref></p><ul> |
239 <li><p><xref href="GUID-D53A00E4-CF37-5F11-8D15-C5ECCCE64597.dita" |
|
240 >Vibra API</xref></p><ul> |
220 <li><p>Available from S60 3.0 onwards.</p></li> |
241 <li><p>Available from S60 3.0 onwards.</p></li> |
221 <li><p>It can be used for running device vibrator with given intensity for |
242 <li><p>It can be used for running device vibrator with given intensity |
222 a given period of time.</p></li> |
243 for a given period of time.</p></li> |
223 <li><p>It can be used by a privileged client application to play pulse effects, |
244 <li><p>It can be used by a privileged client application to play pulse |
224 which have a very short duration (as the ones used for tactile feedback).</p></li> |
245 effects, which have a very short duration (as the ones used for tactile |
|
246 feedback).</p></li> |
225 </ul></li> |
247 </ul></li> |
226 </ul></section> |
248 </ul></section> |
227 <section id="GUID-428F693C-1CA8-4588-9A7D-C4265D2AED91"><title>When to use |
249 <section id="GUID-428F693C-1CA8-4588-9A7D-C4265D2AED91"><title>When |
228 Tactile Feedback Client API, Haptics API, and Vibra API</title><p><ul> |
250 to use Tactile Feedback Client API, Haptics API, and Vibra API</title |
229 <li><p>Tactile Feedback Client API for providing tactile feedback in custom |
251 ><p><ul> |
230 controls (grids, lists, and so on), which will comply with the style of Core |
252 <li><p>Tactile Feedback Client API for providing tactile feedback |
231 UI components to ensure a uniform user experience among applications.</p></li> |
253 in custom controls (grids, lists, and so on), which will comply with |
232 <li><p>Haptics API on touch and hybrid mobile devices for producing complex |
254 the style of Core UI components to ensure a uniform user experience |
233 vibration feedback, which cannot be achieved with Tactile Framework (games, |
255 among applications.</p></li> |
234 simulations, demos, and so on).</p></li> |
256 <li><p>Haptics API on touch and hybrid mobile devices for producing |
235 <li><p>Vibra API for producing haptic effects such as ringing tone vibration |
257 complex vibration feedback, which cannot be achieved with Tactile |
236 in those mobile devices where Haptics API is not available or functional.</p></li> |
258 Framework (games, simulations, demos, and so on).</p></li> |
|
259 <li><p>Vibra API for producing haptic effects such as ringing tone |
|
260 vibration in those mobile devices where Haptics API is not available |
|
261 or functional.</p></li> |
237 </ul></p></section> |
262 </ul></p></section> |
238 <section id="GUID-8334E102-8F04-4726-9CD2-1D8004A417E1"><title>Using |
263 <section id="GUID-8334E102-8F04-4726-9CD2-1D8004A417E1"><title>Using |
239 tactile feedback in applications</title><p>The API to use for tactile feedback |
264 tactile feedback in applications</title><p>The API to use for tactile |
240 is the <xref href="GUID-8661A7E0-F19A-41F8-9062-FBFAE70CF658.dita">Tactile feedback |
265 feedback is the <xref |
|
266 href="GUID-8661A7E0-F19A-41F8-9062-FBFAE70CF658.dita">Tactile feedback |
241 client API</xref>.</p><p>The Symbian platform includes a tactile feedback |
267 client API</xref>.</p><p>The Symbian platform includes a tactile feedback |
242 interface to add, modify and remove feedback areas in the registry. There |
268 interface to add, modify and remove feedback areas in the registry. |
243 is also an option to trigger direct feedback and bypass the registry. <xref href="GUID-766333D1-8D66-3B81-9B5D-8C4245F78298.dita#GUID-766333D1-8D66-3B81-9B5D-8C4245F78298/GUID-962B6543-9A59-3E72-893D-F775FEC54ACB"><apiname>MTouchFeedback::Instance()</apiname></xref> is |
269 There is also an option to trigger direct feedback and bypass the |
244 used for acquiring a pointer to a touch feedback instance. When touch feedback |
270 registry. <xref |
245 is activated, the mobile device users get a slight vibration when the control |
271 href="GUID-766333D1-8D66-3B81-9B5D-8C4245F78298.dita#GUID-766333D1-8D66-3B81-9B5D-8C4245F78298/GUID-962B6543-9A59-3E72-893D-F775FEC54ACB" |
246 with the feedback interface is touched. </p><note><p>Tactile feedback can |
272 ><apiname>MTouchFeedback::Instance()</apiname></xref> is used for |
247 be set and disabled in a client application or a mobile device in some scenarios, |
273 acquiring a pointer to a touch feedback instance. When touch feedback |
248 for example, during phone calls.</p></note><p>Client applications cannot determine |
274 is activated, the mobile device users get a slight vibration when |
249 the actual physical feedback that is generated. It depends on device configuration |
275 the control with the feedback interface is touched. </p><note><p>Tactile |
250 and current settings. In current devices, the user changeable settings include |
276 feedback can be set and disabled in a client application or a mobile |
|
277 device in some scenarios, for example, during phone calls.</p></note |
|
278 ><p>Client applications cannot determine the actual physical feedback |
|
279 that is generated. It depends on device configuration and current |
|
280 settings. In current devices, the user changeable settings include |
251 vibration and audio feedback intensity level.</p><p>For more information, |
281 vibration and audio feedback intensity level.</p><p>For more information, |
252 see <xref href="GUID-21DAC50D-7737-42B6-BBDA-E12E8779741B.dita">Feedback</xref>.</p></section> |
282 see <xref href="GUID-21DAC50D-7737-42B6-BBDA-E12E8779741B.dita">Feedback</xref |
253 </conbody></concept> |
283 >.</p></section> |
|
284 </conbody> |
|
285 </concept> |
|
286 <?Pub *0000013047?> |