User Interaction Q&A
The following questions are related to user interaction features provided by a keyboard, mouse, or pointer.
To disable the pointer and mouse functionality in your application, make sure the "config.xml" file contains the following elements:
<tizen:setting pointing-device-support='disable'/>
<tizen:profile name="tv-samsung"/>
For more information, see Mouse.
#pointer #mouse #disable #air pointer #pointing device
Even if your application does not support a keyboard, there are some hidden keys that work with a keyboard. The following hidden keys must be mapped to the remote control keys.
Hidden Key | Remote Control Key | Hidden Key | Remote Control Key |
---|---|---|---|
Esc | Return | F5 | Smart Hub |
Number Keys | Channel number | F6 | Source |
Windows key | Menu | F7 | Channel List |
Arrow keys | Move focus (cursor) | F8 | Volume Mute |
Enter | Enter | F9 | Volume Down |
F1 | Color Key A | F10 | Volume Up |
F2 | Color Key B | F11 | Channel Down |
F3 | Color Key C | F12 | Channel Up |
F4 | Color Key D | Number pad input | Channel number |
Table 1. Hidden key mapping
#key #mapping #remote control #hidden key #keyboard event
No, it is not possible to disable the keyboard.
Since some keyboard keys have the same code as the remote controls key, they cannot be disabled. For other keyboard keys, implement a default action to make sure the application does not respond when they are pressed. For more information, see Keyboard/IME.
#disable #keyboard #key #ime
The Samsung policy requires that the "Exit" key allows the user to exit the application and return to the live broadcast channel immediately from anywhere within the application.
However, there is no Samsung API method that you can use to manually implement this behavior for the "Exit" key. To follow the policy, unregister the "Exit" key and do not handle it in your application. The key's default behavior implements the policy.
In contexts other than the "Exit" key click, you can close the application and all its content by calling the getCurrentApplication().exit()
method. For example, a "Return" key click opens a popup with "Yes" and "No" buttons, and selecting the "Yes" button calls the getCurrentApplication().exit()
method.
#exit key #broadcast channel #show channel #application exit #closing application
To customize the IME to show the number pad only, in the input
element, set the type
attribute to number
. This disables all the letter keys and prediction in the IME.
For more information on the IME, see Keyboard/IME.
#IME #customize #keyboard #number pad #number input type #num pad
To block a key event, register the key:
tizen.tvinputdevice.registerKey(keys[i]);
The registration blocks the key's default functionality.
#block #key #register #event #disable #prevent
If you register an event for a function key but do not add code to handle the event, the key no longer works. The default function of the key stops working when you register the key event in your application.
#smart hub #power #key #broken #not working
Some Samsung TV remote control keys have separate functionalities for normal and long presses, while others only recognize a normal key press. For information on which keys support long presses, see Remote Control.
#long press #key #remote control #different key function #smart remote
No, it is not possible to make the remote control special keys, such as the color or playback control keys, work in the Web browser. The Web browser does not have access to the Samsung Product and Tizen APIs.
#remote control #special key #color key #playback control key #web browser #key mapping
Yes. To set the maximum length for an input
element, define the length in characters using the maxlength
attribute.
#html #input element #maximum length #text entry
From your application home screen, you can implement the "Return" key to terminate or hide the application. For more information, see Terminating Applications.
#return key #hide #terminate #policy #key mapping #exit
The Samsung IME supports the standard keyboard characters, such as upper and lower case letters, numbers, punctuation, and symbols.
#input method editor #ime #character #number #letter #punctuation #symbol #keyboard
Each remote control key has a key name and corresponding numerical code value. Since keyCode
values can differ depending on the TV model and platform version, it is recommended to implement key input using the key names whenever possible.
If you implement keyboard input, the keyboard keys also have key codes.
#remote control #key name #key code #keyboard #key mapping
The IME does not display correctly in the emulator. This is a known issue.
#input method editor #ime #emulator #keyboard #tv device
The getCurrentApplication().exit()
method of the Application API closes the application and all its content. For example, a "Return" key click opens a popup with "Yes" and "No" buttons, and selecting the "Yes" button calls the getCurrentApplication().exit()
method. For more information, see Terminating Applications.
Use the getCurrentApplication().hide()
method when you do not want to close the application, but only hide it in the background. For more information, see Multitasking.
#return key #hide #exit #terminate #multitasking #application api
To avoid issues with keyboard key presses preventing HTML input
elements from working properly, do not implement the preventDefault()
method within your keydown
and keypress
event listeners.
#html #input element #keyboard #preventdefault #keydown #keypress #no input
The pointer is a feature on the remote control included with 2015 Samsung Smart TV models. The feature allows the user to move the mouse cursor by gesturing with the remote control. To enable pointer support in your application, implement mouse support.
#pointer #gesture #remote control #mouse #air pointer
No. Since keyCode
values for keyboard keys can differ depending on the TV model and platform version, event handling for specific letter keys is not supported. For more information on handling keyboard and IME input, see Keyboard/IME.
#ime #input method editor #keyboard #keycode #letter key #key event