Defines the key events mapped to the S Pen gesture and the information to be displayed on the Air actions settings screen.
attribute:
id
Mandatory
It requires an action-specific unique ID.
Duplicate specification of the same ID is not allowed.
Only alphabet, numeric, or underscore are allowed.
label
Mandatory
Label of Action to be displayed on the S Pen Remote Setting Screen.
Only String Resource ID within the app package is allowed.
priority
Mandatory
Duplicate specification of the same priority is not allowed.
The smaller the number, the higher the priority (1: highest priority).
Version 1.0
Based on the priority, 1 is mapped to a single click gesture and 2 is mapped to a double click gesture. 3 and afterward are registered to the App action list as candidate action.
Version 1.2
The position of this action is determined in the App action list. The default gesture is determined by the preferece Tag.
trigger_key
Mandatory
Define the KeyEvent to be received by the app.
Use the symbolic name of the keycode defined in Android KeyEvent.java, but exclude the
"KEYCODE_" part
Example: KEYCODE_PAGE_UP → trigger_key="PAGE_UP"
You can define a KeyShortcut by using "+" as a delimiter.
Example 1: Combination of KEYCODE_CTRL_LEFT and KEYCODE_N
→ trigger_key="CTRL_LEFT+N"
Example 2: Combination of KEYCODE_CTRL_LEFT, KEYCODE_SHIFT_LEFT, and KEYCODE_Z
→ trigger_key="CTRL_LEFT+SHIFT_LEFT+Z"
repeatable
Optional
Set to true when this action is repeatable.
Version 1.2
repeatable_interval
Optional (Mandatory if repeatable attribute exist)
Determines the default gesture to be mapped and checks whether this action is a button press or motion gesture
attribute:
name
Should be set to "gesture", "button_only", "motion_only"
"gesture": Set the type of gesture you want to set as default
"button_only" : Provide the action only for button press
"motion_only" : Provide the action only for motion related gestures
value
if name="gesture", any or all of the following strings are valid values for this attribute.
Multiple values are separated by '|' - for example, " click| swipe_down| swipe_down ".
value
Gesture type
Description
“click”
Button
Single click
“double_click”
Button
Double click
“swipe_left”
Motion
Swipe left ←
“swipe_right”
Motion
Swipe right →
“swipe_up”
Motion
Swipe up ↑
“swipe_down”
Motion
Swipe down ↓
“circle_ccw”
Motion
Circle Counter-clock-wise
“circle_cw”
Motion
Circle Clock-wise
Note :
If the tag with name “gesture” does not exist, the is not set as default action. If name="button_only" or "motion_only", then "true" or "false" is allowed as value.
| **button\_only** | **false or not exist** | true |
| **motion\_only** | ^^ | ^^ |
-------------|---------------|---------------
| **false or not exist** | This action can be set on any action. | This action can only be set for button press (single or double click). |
| **true** | This action can only be set for motion gestures (e.g. swipe\_left or circle\_cw). | action will be ignored. |
<div class="alert alert-info" role="alert"><strong>Note</strong> : <p>If this configuration contradicts with value of “gesture”, this action will be ignored.
For example, in case that “swipe_left” is set as value of “gesture” but “button_only” is true, configuration is contradictory.
Implementation of KeyEvent-Callback
Implement KeyEvent-Callback to the activity to which RemoteActions have been declared. Since it is the same as handling an Android KeyEvent, only the simple examples of the implementation are introduced here.
Please refer to the Android developers website for detailed guidelines. It is recommended to handle the sent KeyEvent at onKeyDown.
Example :
Page Down key: Scroll ScrollView as much as +500 in Y direction
Page Up key: Scroll ScrollView as much as -500 in Y direction
We use cookies to improve your experience on our website and to show you relevant
advertising. Manage you settings for our cookies below.
Essential Cookies
These cookies are essential as they enable you to move around the website. This
category cannot be disabled.
Company
Domain
Samsung Electronics
.samsungdeveloperconference.com
Analytical/Performance Cookies
These cookies collect information about how you use our website. for example which
pages you visit most often. All information these cookies collect is used to improve
how the website works.
Company
Domain
LinkedIn
.linkedin.com
Meta (formerly Facebook)
.samsungdeveloperconference.com
Google Inc.
.samsungdeveloperconference.com
Functionality Cookies
These cookies allow our website to remember choices you make (such as your user name, language or the region your are in) and
tailor the website to provide enhanced features and content for you.
Company
Domain
LinkedIn
.ads.linkedin.com, .linkedin.com
Advertising Cookies
These cookies gather information about your browser habits. They remember that
you've visited our website and share this information with other organizations such
as advertisers.
Company
Domain
LinkedIn
.linkedin.com
Meta (formerly Facebook)
.samsungdeveloperconference.com
Google Inc.
.samsungdeveloperconference.com
Preferences Submitted
You have successfully updated your cookie preferences.