Uh oh! We couldn’t find any match.

Please try other search keywords.

Bixby Developer Center

Guides

The Device Simulator

Bixby Developer Studio includes a built-in device simulator that lets you test both natural language and aligned NL queries on a variety of simulated Bixby-compatible devices. It lets you set the user's location and timezone, manage OAuth sessions, and apply learning models, as well as letting you launch the Debug Console to analyze the execution graph of the last-run query.

Launch the Simulator with the View > Open Simulator menu command, or by clicking the Simulator button at the top of the sidebar in the Files view.

Simulator button

The Simulator Window

Simulator window

The simulator has its own set of application tabs running down its left side, similar to the main editor window. Like the main window, these affect the view in the simulator's sidebar. From the top, going down:

  • The Input view lets you set the capsule and target device being tested and enter queries. In addition, you can use the settings at the bottom to set the simulated user's location ("Geo") and their time zone and current time ("Time"). Depending on the device, you can also enable or disable Bixby's hands-free mode.
  • The User view lets you enable or disable Selection Learning, reset Selection Learning for the capsule, and manage open OAuth sessions.
  • The Settings view lets you choose which Bixby device to test against.

Note that the sidebar in the simulator can be collapsed, either by clicking the "X" icon in the sidebar's top right corner or by clicking the application tab icon for the currently-open view. When the sidebar is collapsed, click any of the application tab icons to open it again.

Using the Simulator

To test a query, use the Input view.

  • Check to make sure the simulator is set to run the capsule and target you plan to test, e.g.: "viv.dice". You can click on the capsule and target name to change them.
  • Enter a query in the input window. The query can be either natural language or aligned NL.
  • Click Run to execute the query.

You can load a previous query and result screen by clicking the "˿" button. Click Reset to reset the simulator and erase the query history stack.

If Bixby's NL model is out of date because you have edited models or code in your capsule that might affect the execution plans for your training, the Run button will be disabled and a Compile button will appear in the simulator window next to the capsule name:

Compile

Once a query is run, the Debug button will be enabled:

Debug Button

Click the Debug button to open the Debug Console with the current query preloaded.

Hands-Free Testing

The simulator can be put in hands-free mode by clicking the speaker icon button (to the right of the Reset button).

User View

The User view lets you change data returned to your capsule about the user, letting you simulate different locations and time zones, as well as control selection learning.

User View

Use the Geo tab to change the location reported to the capsule in the simulator. You can enter a specific latitude and longitude or enter a city in the Location field. Recently-used cities will be remembered in the dropdown. You can also specify "My Current Location" to have the simulator geolocate you, and specify "No GPS Available" to test your capsule's performance on a device where GPS does not exist or is turned off.

Use the Time tab to specify the time zone the simulator reports to the capsule, as well as the time and date. If you have specified a custom time and date, click Clear to return to reporting the current time.

The Selection Learning checkbox controls whether the simulator will let capsules use learned selection preferences stored for the user. If this is disabled, capsules will still be able to use selection rules. Use the Reset button to clear selection learning data saved in the simulator.

You can also view bootstrapped preferences here. These are a subset of learned preferences whose values are specified in the capsule to accelerate or bypass the learning process for those values.

Settings View

This view simply lets you specify the device to simulate. Use the dropdown to select the device from a preset list.

The primary effect in the simulator is to specify display resolution. If you choose a device that does not have a display, hands-free mode will automatically be enabled.