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

TV,
HTV

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

TV,
HTV

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

TV,
HTV

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

TV,
HTV

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

TV,
HTV

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

TV,
HTV

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

TV,
HTV

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

TV,
HTV

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

TV,
HTV

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

TV,
HTV

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

TV,
HTV

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

TV,
HTV

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

TV,
HTV

The IME does not display correctly in the emulator. This is a known issue.

#input method editor #ime #emulator #keyboard #tv device

TV

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

TV,
HTV

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

TV,
HTV

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

TV,
HTV

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

TV,
HTV