Extension Libraries

The following questions are related to implementing additional features with the available extension libraries.

Extension libraries contain additional features which are supported by Samsung Smart TVs. You can use them to further enhance your application.

The available extension libraries include Smart View SDK, Native Client (NaCl), CAPH, and TOAST.

   #library    #feature

The Smart View SDK allows you to integrate Android™ devices, iOS devices, and Web browsers with Samsung TV applications. For more information, see Smart View SDK.

Smart View-enabled applications are registered in the Samsung Apps TV Seller Office separately from other Samsung TV applications. For more information, see Smart View Enabled App Registration.

   #smart view sdk    #registration    #publication    #seller office

The Smart View SDK does not support smart watch applications.

However, you can use the Websocket API to implement communication between various Tizen devices, such as Samsung Smart TVs and Samsung Gear smart watches.

   #smart view sdk    #smart watch    #samsung gear    #websocket

To restore a hidden application to the foreground using the Smart View SDK, use the start(Result) method of the Application class. For more information, see the Smart View SDK API References.

   #smart view sdk    #restore    #foreground    #show

Yes, you can test your Smart View-enabled application before registering it in the Samsung Apps TV Seller Office. Implement the mobile application to launch the TV application using the TV application package ID. The package ID is defined in the TV application "config.xml" file, within the tizen:application element.

After you register the TV application in the Seller Office, in the mobile application, make sure you replace the TV application package ID with the application ID from the Seller Office. For more information, see How to manage multi app IDs.

   #smart view sdk    #application id    #testing

Check that the TV has not prevented your mobile device from connecting:

On the TV, open the mobile device manager:

For 2016 and later models, select "Menu > Network > Expert Settings > Mobile Device Manager > Mobile Device List"

For 2015 models, select "Menu > Network > Multimedia Device Manager"

If your mobile device appears on the device list, make sure its switch is set to "Allow".

If you are developing your mobile application in JavaScript, WebView does not support multicast requests, which are crucial for device discovery. As a workaround, the Smart View SDK performs device discovery by checking the IP host identifiers sequentially (from 1 to 255) for the first available network interface. Consequently, if the TV's IP address is near the end of the host range, the device discovery attempt can time out before reaching it. Alternatively, if device discovery is not the focus of your application, you can define the TV IP address using the msf.remote() method.

   #smart view sdk    #device discovery

SSDP is supported on 2012 to 2014 TV models. On 2015 and later models, use the Smart View SDK.

   #smart view sdk    #ssdp    #device discovery

Yes. To play multichannel streams with the NaCl Player, define the ChannelLayout property value in the AudioElementaryStream object. You can select from various multichannel layout values, such as CHANNEL_LAYOUT_5_1 and CHANNEL_LAYOUT_7_1.

   #native client    #nacl player    #elementary stream    #multichannel audio    #channel layout

You can try to export and reimport the project to the Tizen Studio:

In the Tizen Studio, build and export your NaCl project to a ".wgt" package.

Import the ".wgt" package as a Tizen project:

Since importing a project does not allow you to change the project name, rename the original project.

In the Tizen Studio menu, select "File > Import > Tizen > Tizen project".

Select "Select archive file" and navigate to the ".wgt" package.

Select the target TV platform, and click "Finish".

Launch the application on the TV from the new project.

   #native client    #nacl    #launch

Because a NaCl application is run in a sandbox environment, it can only access files that are within its own directory. NaCl applications cannot access the system certificates directory on the TV.

If you want to use CA certificates in a NaCl application, you must place the certificates in the application directory.

   #native client    #nacl    #ca certificate    #error

To improve your application UI, you can take advantage of CAPH 3.0, a Web UI framework, based on HTML5, that is optimized for Samsung TVs.

   #user interface    #ui    #caph

Although the CAPH Web UI framework is based on HTML5, it is only guaranteed to work with Samsung Smart TVs. For more information, see CAPH 3.0.

   #caph

Yes, you can implement scrollable lists using CAPH for AngularJS or CAPH for JQuery.

   #scrollable list    #ui    #caph    #user interface

It is not possible to create scrollable items directly using the CAPH library. However, since you can control CAPH UI elements using HTML and CSS, you can manually add the scrollable functionality with CSS. For more information, see CSS overflow property.

   #caph    #scrollable    #css

To make sure the scrollable list moves to show the focused item, you can trigger the "reload" event, which updates all item views.

You can also use the select() method instead of the focus() method, which selects the item in addition to moving focus to it.

   #caph    #focus    #scrollable    #angularjs

The icons defined in the "config.xml" file for a TOAST application have the following size requirements:

Table 1. TOAST application icon sizes IconSize ThumbIcon106x87 px

BigThumbIcon115x95 px

ListIcon85x70 px BigListIcon95x78 px

   #config xml    #toast    #application icon    #icon