Browser Emulator Help Guide

Published 2014-10-27 | (Compatible with SDK 5.0)

This document explains how to install Browser Emulator and how to use it (Version 5.0)

Contents

Introduction

Samsung SmartTV Browser Emulator is a system that provides Browser Emulator function for normal user and server management function for administrator.

The Browser Emulator provides the following functions to administrator:

  • Account management to both admin user and normal users
  • Network setting: IP setting, proxy setting
  • Server management: power off, reboot
  • System performance: memory, CPU usage

The Browser Emulator provides the following functions to normal user:

  • Smart Apps Management (download, upload, share/unshared, installation)
  • SEditor: Simply editor for Smart App codes
  • Account Management: Sign in, Sign up, retrieve password by security question
  • Key Mapping: Map remote controller key with keys on keyboard
  • Log panel & Inspector

Purpose

This document is designed to introduce how to deploy and Use Samsung SmartTV Browser Emulator. This document covers the detail introductions of functions and user interface (UI) of the Browser Emulator.

Scope

This paper is easy to understand even if you don’t have experience of programming.

Administrator is suggested to read Introduction and Guide for Administrator.

Normal User is suggested to read Introduction and Guide for Normal Users.

System Requirement

Hardware Requirements

Component Item Detail
Browser Emulator Processor CPU @3.30GHz x 2 or higher
RAM 4GB or higher
Screen resolution 1440 x 960 or higher
Video memory 256MB or higher

Software Requirements

Component Item Detail
Browser Emulator VirtualBox 4.24 or higher https://www.virtualbox.org/wiki/Downloads
Chrome version v.30 or higher https://www.google.com/intl/en/chrome/browser/

Prerequisites

  • Network connection type of Virtual Box must be Bridged
  • Only Administrator can sign in from VirtualBox.
  • Default Administrator Account: username:”admin”, password:”123456”.
  • Network Access Address: http://YourNetworkIPSetbyAdminstor/WebServer/

Guide for Administrator

Install Browser Emulator

Before install Browser Emulator, VirtualBox must be installed first. To access Admin Tools Module in Browser Emulator, Chrome should be installed.

Download latest ova from http://www.samsungdforum.com/, double click the ova file and load the ova to VirtualBox as guide. Allocate more CPUs or set bigger memories to get better performance.

VirtualBox Network Settings

After setup, you must make sure the network connection type of VirtualBox is Bridged.

You can set the network connection type of VirtualBox as followed steps:

Exit the Browser Emulator program. Open the VirtualBox.

Right click on the left item “Browser Emulator”, and click the item “Settings”.

Click on the left item “Network”, and you will “see connection type” on the right, then choose the type of “Bridged”.

Normally, after VirtualBox network setting is over, change other parameters if necessary (such as MAC address). Then, start Browser Emulator in VirtualBox. After a few seconds the Browser Emulator starts successfully and shows the interfaces.

Sign in use default username:”admin”, password:”123456”. Then login to the User Management page, click the NAV to “Network”->”IP Setting” on the page and jump to IP Setting page. Input your configuration of network and click “Confirm” Button” and finish network setting.

Getting Started with Browser Emulator for Administrator

Please use chrome to visit the Admin Tools module. The available address will be “http://NetworkIP/WebServer/”.

Note

Please use the network IP which you have set. If you don’t remember, please login to Admin Tools module inside VirtualBox and see your current IP at “Network”->”IP Setting” page.

Administrator Account Management

Sign in Browser Emulator

Run the Browser Emulator program, the login page will show as followings.

Fill the form with default user name (admin) and password (123456), choose “Remember me for one week” if you want to login Browser Emulator without inputting username and password again in one week. Click the Sign in button, and then you will get the Browser Emulator default page.

Change administrator’s password

Move over “Welcome Admin”, choose the drop menu item “Change Password”.

Click “Change Password”, then a popup will appear. Fill the form with your old password, new password and confirm password, make sure the password has 6-20 characters and only contains letters and numbers. Click the “OK” button to submit.

If change password successful, the notice message will appear as follow.

Logout Browser Emulator

Move over “Welcome Admin” and choose the drop menu item “Log Out”.

After click, you will logout to the login page. When your account login on another site, you are forced to logout.

User Account Management

User list

After login or choose “User Management” of the menu, the User Management page will show. First it has no user in User List. In the user list, admin can delete Browser Emulator users. Online users cannot be deleted.

Delete user

Click delete user icon, then a popup will appear to reconfirm you.

System Information

Click the “System Information” tab of the menu. You can get CPU usage, memory usage and online user member of the server as follow.

Network setting

IP setting

Move over “Network” tab and click the drop menu item “IP setting”.

After loading this page, you can see the current IP information of the server.

If you want to set new IP information, you can fill them in the form and click confirm bottom if you want to change.

After setting, you should re login Browser Emulator by new IP address.

Network proxy

Move over “Network” and click the drop menu item “Network Proxy”.

After loading this page, you can see the current network Proxy of the server. If the current proxy method is none, the page will show as follow.

You can set network Proxy by three methods: none, manual, automatic. Choose the method you want and click confirm button to store.

Method: None

Method: Manual

Method: Automatic

Note

Once you have set up the proxy, you may not use the default browser inside Browser Emulator to access Admin Tools Module. Error like “Unable to load page” will happen.

If you want to use the browser inside VirtualBox to access Admin Tools, please set the proxy the “NONE” mode or use the proper proxy and restart Browser Emulator.

System Management

Power off

Move over “Turn Off” and click the drop menu item “Power Off” to exit Browser Emulator.

It will reconfirm you again, make sure you want to turn off.

Reboot

Move over “Turn Off”, click the drop menu item “Reboot” to reboot Browser Emulator.

It will reconfirm you again, make sure you want to reboot.

Guide for Normal Users

Getting Started with Browser Emulator

Only after administrator has installed Browser Emulator and finished setting up environment, users can access it with “http://NetworkIP/WebServer/”.

For example, if the Browser Emulator IP address is: “10.0.2.2”, then the address will be “http://10.0.2.2/WebServer”.

Access to main page

Input the address you can access to main page as following page:

Create your account

New User need sign up a new account. The username must contains no more than 20 numbers (0~9) or symbols (A~Za~z). The password must contains 6~20 numbers (0~9) or symbols (A~Za~z).

If password is forgotten, answer the verification question can reset the password.

Smart Apps Management

Smart App Manager will replace the Smart Hub in Browser Emulator, which have three categories:

My Apps
Apps which users can debug with Emulator, edit with S Editor. Users can upload local Apps with zip format; can install Apps from Shared Apps or Sample Apps.
Shared Apps
Apps which are shared by team members, this help to enhance the team work.
Sample Apps
Apps which are released at SDF (Samsung Developer Forum http://www.samsungdforum.com/)

Upload local apps

Sign the Browser Emulator to access the Smart App Manager page. Click upload button at “My Apps” and a file selector will be popped and choose a valid App with zip format.

Note

Use “Back” function on browser will immediately cancel uploading.

Download apps

When the mouse focuses on one App at any categories, users can click the download button to download the App.

Share / Unshare apps

When the mouse focuses on one App at “My Apps”, user can click the share button to share your App. Then team members can see the shared App at “Shared Apps”.

Once you have shared your App, the button will become unshared, you can clicked it to unshare the App.

Note

The owner of shared App cannot see the shared Apps inside “Shared Apps”, but in “My Apps” the shared Apps will marked as “Shared”.

Install / Update app

When the mouse focuses on one App at “Shared Apps” or “Sample Apps”, user can click the install button to install the selected App to “My Apps”, and then user can run the App, also can read/modify the codes.

Once you have installed the App, the button will become updated, you can click it to update the App.

Note

When you update the installed App, the App in “My Apps” and all the code which you modified will be overwritten.

S Editor

S Editor provides online editor function for the Apps at “My Apps” as following figure.

Note

If you access from Smart App Manager, you can edit the codes of any Apps at “My Apps”.

If you access after launching one Apps, the running Apps will be listed at the top view.

You can only open 10 editor pages at one time

Online debug

User can ONLY debug the Apps at “My Apps”. When user clicks one App at “My Apps”, the App will be launched.

Browser Emulator provide S Editor, Instance Log and Web Inspector, three type Remote Controls and Key Mapping functions to help user debug his Apps with rapid and high efficient way.

Instance Log & Web Inspector

When user launched one App, the instance log of App output will be showed at log panel.

Web inspector can help to debug Apps. Click the “Inspector” tab to switch to inspector. Then click the target page which needs to be inspected.

Click “Elements” tab to inspect html elements. Edit the elements or css to see the changes.

Key mapping

Key Mapping enables user to map the remote control key to the key on keyboard which is a very efficient way to emulate App.

Combination keys are not supported. The valid key scope on the keyboard which can be mapped is showed as the following picture.

To set a mapping key:

  1. Click the “Setting” button when begins emulation.
  2. Setting panel will be popped and five default key can been seen at the right side mapping list.
  3. If you want to set other keys on the remote control, just double click the key on the remote control. Then the related key will be added into the setting list.
  4. Choose a key in the setting list and type a key on the keyboard. Click “OK” button will save your mappings.