Feedback API
For more information on the Feedback features, see Feedback Guide.
Since: 3.0
Table of Contents
- 1. Type Definitions
- 1.1. FeedbackType
- 1.2. FeedbackPattern
- 2. Interfaces
- 2.1. FeedbackManagerObject
- 2.2. FeedbackManager
- 3. Full WebIDL
Summary of Interfaces and Methods
Interface | Method |
---|---|
FeedbackManagerObject | |
FeedbackManager |
void stop ()
|
1. Type Definitions
1.1. FeedbackType
enum FeedbackType { "TYPE_SOUND", "TYPE_VIBRATION" };
Since: 3.0
The states defined by this enumerator are:
- TYPE_SOUND - Feedback type for sound
- TYPE_VIBRATION - Feedback type for vibration
1.2. FeedbackPattern
enum FeedbackPattern { "TAP", "SIP", "KEY0", "KEY1", "KEY2", "KEY3", "KEY4", "KEY5", "KEY6", "KEY7", "KEY8", "KEY9", "KEY_STAR", "KEY_SHARP", "KEY_BACK", "HOLD", "HW_TAP", "HW_HOLD", "MESSAGE", "EMAIL", "WAKEUP", "SCHEDULE", "TIMER", "GENERAL", "POWERON", "POWEROFF", "CHARGERCONN", "CHARGING_ERROR", "FULLCHARGED", "LOWBATT", "LOCK", "UNLOCK", "VIBRATION_ON", "SILENT_OFF", "BT_CONNECTED", "BT_DISCONNECTED", "LIST_REORDER", "LIST_SLIDER", "VOLUME_KEY" };
Since: 3.0
Each feedback pattern can have a separate media file for each feedback type. However, depending on vendor design, a pattern may not have any media file.
The following values are supported:
- TAP - general touch
- SIP - text key touch
- KEY0 - numeric 0 key touch
- KEY1 - numeric 1 key touch
- KEY2 - numeric 2 key touch
- KEY3 - numeric 3 key touch
- KEY4 - numeric 4 key touch
- KEY5 - numeric 5 key touch
- KEY6 - numeric 6 key touch
- KEY7 - numeric 7 key touch
- KEY8 - numeric 8 key touch
- KEY9 - numeric 9 key touch
- KEY_STAR - star key touch
- KEY_SHARP - sharp key touch
- KEY_BACK - backspace key touch
- HOLD - hold key touch
- HW_TAP - hardware key press
- HW_HOLD - hardware key holding press
- MESSAGE - new message notification
- EMAIL - new email notification
- WAKEUP - wake up alert
- SCHEDULE - scheduled alarm alert
- TIMER - timer alert
- GENERAL - general event alert
- POWERON - power on
- POWEROFF - power off
- CHARGERCONN - charger connection
- CHARGING_ERROR - charging error occurrence
- FULLCHARGED - fully charged
- LOWBATT - low battery
- LOCK - lock
- UNLOCK - unlock
- VIBRATION_ON - vibration mode enable
- SILENT_OFF - silent mode disable
- BT_CONNECTED - bluetooth connection
- BT_DISCONNECTED - bluetooth disconnection
- LIST_REORDER - list reorder
- LIST_SLIDER - list slider sweep
- VOLUME_KEY - volume key press
2. Interfaces
2.1. FeedbackManagerObject
[NoInterfaceObject] interface FeedbackManagerObject { readonly attribute FeedbackManager feedback; };
Tizen implements FeedbackManagerObject;
Since: 3.0
The tizen.feedback object allows access to the Feedback API functionality.
Attributes
-
readonly
FeedbackManager feedbackObject representing a feedback manager.
Since: 3.0
2.2. FeedbackManager
[NoInterfaceObject] interface FeedbackManager { void play(FeedbackPattern pattern, optional FeedbackType? type) raises(WebAPIException); void stop() raises(WebAPIException); boolean isPatternSupported(FeedbackPattern pattern, FeedbackType type) raises(WebAPIException); };
Since: 3.0
Methods
-
play
-
Plays various types of reactions that are predefined.
void play(FeedbackPattern pattern, optional FeedbackType? type);
Since: 3.0
This function can be used to react to predefined actions. It plays various types of system predefined media or vibration patterns. Currently, there are two types of reactions: sound and vibration. Depending on the settings, some types cause no action. For example, when set to silent mode, the device does not produce any sound. If this method is called without the type value, the type of played feedback pattern depends on device settings.
Parameters:
- pattern: The predefined pattern.
- type [optional] [nullable]: The pattern type.
Exceptions:
- WebAPIException
with error type NotSupportedError, if feature is not supported.
with error type TypeMismatchError, if any input parameter is not compatible with the expected type for that parameter.
with error type AbortError, if the system operation was aborted.
Code example:
try { tizen.feedback.play("CHARGERCONN", "TYPE_SOUND"); } catch (err) { console.log(err.name + ": " + err.message); }
-
stop
-
Stops various of vibration patterns.
void stop();
Since: 3.0
This function can be used to stop various types of vibration reactions that are predefined.
Remark: This function does not support stopping media sound actions. If an attempt to stop a media sound action is made, stop operation is ignored.
Exceptions:
- WebAPIException
with error type AbortError, if the system operation was aborted.
Code example:
try { tizen.feedback.play("BT_CONNECTED", "TYPE_VIBRATION"); tizen.feedback.stop(); } catch (err) { console.log(err.name + ": " + err.message); }
- WebAPIException
-
isPatternSupported
-
Checks if a pattern is supported.
boolean isPatternSupported(FeedbackPattern pattern, FeedbackType type);
Since: 3.0
Parameters:
- pattern: The predefined pattern.
- type: The pattern type.
Return value:
-
boolean:
true if the pattern is supported, false otherwise.
Exceptions:
- WebAPIException
with error type NotSupportedError, if this feature is not supported.
with error type TypeMismatchError, if any input parameter is not compatible with the expected type for that parameter.
Code example:
var pattern = "BT_CONNECTED", type = "TYPE_SOUND"; var isPatternSupported = tizen.feedback.isPatternSupported(pattern, type); var isSupported = ""; if (!isPatternSupported) { isSupported = " not"; } console.log("Pattern " + pattern + " is" + isSupported + " supported");
Output example:
Pattern BT_CONNECTED is supported
3. Full WebIDL
module Feedback { enum FeedbackType { "TYPE_SOUND", "TYPE_VIBRATION" }; enum FeedbackPattern { "TAP", "SIP", "KEY0", "KEY1", "KEY2", "KEY3", "KEY4", "KEY5", "KEY6", "KEY7", "KEY8", "KEY9", "KEY_STAR", "KEY_SHARP", "KEY_BACK", "HOLD", "HW_TAP", "HW_HOLD", "MESSAGE", "EMAIL", "WAKEUP", "SCHEDULE", "TIMER", "GENERAL", "POWERON", "POWEROFF", "CHARGERCONN", "CHARGING_ERROR", "FULLCHARGED", "LOWBATT", "LOCK", "UNLOCK", "VIBRATION_ON", "SILENT_OFF", "BT_CONNECTED", "BT_DISCONNECTED", "LIST_REORDER", "LIST_SLIDER", "VOLUME_KEY" }; Tizen implements FeedbackManagerObject; [NoInterfaceObject] interface FeedbackManagerObject { readonly attribute FeedbackManager feedback; }; [NoInterfaceObject] interface FeedbackManager { void play(FeedbackPattern pattern, optional FeedbackType? type) raises(WebAPIException); void stop() raises(WebAPIException); boolean isPatternSupported(FeedbackPattern pattern, FeedbackType type) raises(WebAPIException); }; };