Emulated Sensors and Features

Tip

The widgets visibility in the right tool bar will vary depending on the virtual device display window size and your screen resolution. To display all the available widgets, click on top of the tool bar.

To simulate various behaviors of your application according to specific use cases, Genymotion Desktop provides easy-to-use widgets which emulate the following sensors and features:

Capture Battery GPS Media injection Remote control Android Controls Identifiers Disk IO Network Phone Open GApps Sound Control Rotate Screen Pixel Perfect Navigation Power Settings

Capture

The Capture widget allows you to take a screenshot or screencast of virtual devices. This way, you can share images or videos of your applications.

To open the capture window, click , then:

• Click to take a screenshot.
• Click to record a screencast. Click again to stop.
• Click to browse the recorded screenshots and/or screencasts folder.

Tip

The default folder can be changed in Genymotion > Settings > Device.

Battery

The Battery widget allows you to test how your application reacts with different battery charge levels and states of charge. To use the Battery widget:

1. Click
2. Modify the charge level using the slider or enter a value in the Charge level field.

3. Modify the state of charge by using the State switch:

   • Power supply is plugged in and the battery is charging.
   • Power supply is unplugged and the battery is discharging.

GPS

Click to open the GPS widget Window:

Single position

To use the GPS widget and set a single position:

1. Switch Activate GPS emulation on to activate the GPS emulation.
2. Set the following fields:

Field	Description	Value range
Latitude	The latitude value you wish to simulate.	-90° to 90°
Longitude	The longitude value you wish to simulate.	-180° to 180°
Altitude	The altitude value you wish to simulate.	-10000m to 10000m
Speed	Set a speed in meters per second.	0m/s to 99999.99m/s
Accuracy	Use the slider or enter a value to set the accuracy.	0m to 200m
Bearing	Use the compass or enter a value to set the bearing.	0° to 359.99°

You can also define a location using the built-in map.

Note

Many applications do not rely on the GPS orientation, but use the device accelerometer or gyroscope to determine the bearing of the device. This is not emulated yet, but you can use the remote control widget to use a real device with accelerometer and/or gyroscope.

Simulate routes

3.3.0 - Paying

It is also possible to simulate routes by uploading a track file.

1. Generate a GPX track file with your favourite application, such as GoogleEarth.

   Requirements/Limitations

   • This feature only supports GPX trace format for the moment. More formats may be added in the future.
   • Your GPX file must at least contain latitude and logitude data, for example:

   <trkpt lat="46.0538" lon="6.6692"><ele>1410.734375</ele><time>2020-02-21T13:51:25Z</time></trkpt>
   

   • If elevation is missing, it will default to 0.
   • If timestamp is missing from a data point, it will default to the previous data point timestamp plus 1 second.
   • If the data points are not in chronological order, they will be sorted before being played.
   • If your GPX file contains more than one track, only the first track will be played.

2. If it is not already enabled, switch Activate GPS emulation on.

3. Switch the Replay a GPS trace feature on:

   

4. Click Open to upload your GPX.

5. Click to start or pause the route simulation:

   

6. Change play speed by selecting a replay speed in the drop-down menu.

Camera and Media Injection

3.3.0 - Paying

With this widget, you can select your host webcams, microphones, videos, images or audio files as the device camera and audio input source.

To open the widget window, click

Host physical camera

Your host physical camera devices are listed in the Cameras box:

You can assign them to the virtual device front and/or back cameras in the Video section.

Media inputs

You can use image, video and audio files as audio and/or video inputs for the device.

Warning

Genymotion Desktop does not include any codecs. Most media files should work "out of the box" on Linux and macOS but you may need to install Codec packs on Windows.

We recommend the use of K-Lite Codec Pack Full for Windows systems.

1. In the Media files box, click OPEN MEDIA FOLDER:

   

2. Copy your media files to the opened folder. The files you added should appear in the Media files box.

Note

Genymotion Desktop media folder is located at the following path:

WindowsLinuxmacOS

%LOCALAPPDATA%\Genymobile\Genymotion\media

$HOME/.Genymobile/Genymotion/media

$HOME/Applications/Genymotion.app/Contents/MacOS/media

When done, you can:

• click to play your media files.
• select an audio file as Microphone input.
• select a video or image file as front and/or back Camera input.

Remote control

With the Remote control widget, you can take control of a virtual device from a physical device (any phone or tablet running Android version 2.2/API level 8/Froyo or above). This widget works with a specific Android application that runs on the physical device and forwards touch inputs and accelerometer events to Genymotion Desktop. As a result, you can test your application as if you were holding a device in your hands.

The Remote control widget requires to have ADB installed and setup on your computer.

To use the Remote control widget:

1. Connect your physical device either by wire or with Wi-Fi. To connect with Wi-Fi, your physical device must support ADB over network.
2. On your physical device, go to Settings → Developer options. If you haven't unlocked the Developer options menu yet, go to Settings → About and click several times on Build number until you get a message saying that Developer options are now available.
3. Check Android debugging and then ADB over network.
4. Connect your physical device to the Wi-Fi and retrieve its IP address from the Wi-Fi menu.

5. Open a terminal or command prompt and enter:

   adb connect {your_device_IP}
   

6. Click

   

7. Activate remote control emulation. Genymotion Desktop tries to detect any connected Android device.

8. Select your device from the Available devices drop-down box and click

   If the device is connected to ADB and not visible in the list, restart the widget.

9. Check the desired options:

   Enable preview

   Enables previewing your Genymotion Desktop screen on your physical device.

   Enable touch screen

   Allows your physical device to send touch events to Genymotion Desktop.

   Enable accelerometer

   Allows your physical device to send accelerometer events to Genymotion Desktop.

The Remote control widget automatically stops when you disconnect your device.

Android Controls

3.3.0 - Paying

With this widget, you can emulate the following Android controls:

• Directional pad
• Volume
• Calls
• Media controls

To open the widget, click

Identifiers

The Identifiers widget shows Android ID and Device ID/IMEI/MEID values. You can view and edit these values at any time, without having to reboot your virtual device.

To open the identifiers window, click and enter a value for each identifier or click  to generate random values:

Note

• You cannot set an empty Android ID.
• On Android 8.0 and above, the Android ID has a different value for each application on the device. This is not the case in Genymotion: the Android ID remains the same for all applications.
• By default, a new virtual device is deployed with the default Device ID number 000000000000000.

Disk I/O

The Disk I/O widget allows you to emulate devices with slow internal storage. It can be very handy if your app requires reading large amount of data from the disk such as gallery apps that load locally stored images or games that load large assets.

To simulate high or low disk performance:

1. Click
2. Enable disk I/O emulation.

3. From the Profile drop-down box, select a type of device:

   • High-end device 200 MiB per second.
   • Mid-range device 100 MiB per second.
   • Low-end device 50 MiB per second.
   • Custom device Enter the read speed limit you wish to emulate in MiB.

Note

When switching from a device profile to another, the disk cache is automatically cleared. You can force clearing the cache by clicking Clear Cache.

Network

3.3.0 - Paying

Android 8.0Android 7.1

The Network widget allows you to test your application with different network interfaces, network types and signal strength.

Click to open the network widget:

Wifi

When Wifi is enabled, your applications will behave as if you're connected on a Wifi network. Wifi is the interface enabled by default.

Mobile data

Info

Mobile data is only simulated via the host machine local network. Therefore, baseband (SIM data connection) is not emulated and it is not possible to call or send text messages to other mobile devices from Genymotion.

To use this feature:

1. Disable Wifi
2. Enable Mobile data

3. Select a Network type from drop-down list:

   Profile	Download speed	Upload speed	Upload/Download delay (in ms)	Upload/Download packet loss
   Unlimited	N/A	N/A	N/A	N/A
   2G GSM	14Kb/s	14 Kb/s	500	0
   2G GPRS	57Kb/s	28Kb/s	300	0
   2G Edge	236Kb/s	236Kb/s	75	0
   3G UMTS	384Kb/s	384Kb/s	75	0
   3G HDSPA	13.98Mb/s	5.76Mb/s	10%	0
   4G LTE	173Mb/s	58Mb/s	5	0
   5G	1174Mb/s	211Mb/s	5	0

4. Select a Signal strength from the drop-down list. Available values are: Great, Good, Moderate, Poor and None.

Disable all network

Simply disable Wifi and Mobile data to disable network altogether on the device.

Info

Mobile data is only simulated via the host machine local network. Therefore, baseband (SIM data connection) is not emulated and it is not possible to call or send text messages to other mobile devices from Genymotion.

The Network widget allows you to test how your application reacts with different network quality and performance types:

1. Click
2. Activate the network simulation with the switch
3. Select a network profile from the drop-down list:

Profile	Download speed	Upload speed	Upload/Download delay (in ms)	Upload/Download packet loss	DNS delay (in ms)
Unlimited	N/A	N/A	N/A	N/A	N/A
No data	0	0		100%
2G GPRS	57Kb/s	28Kb/s	300	0	1000
2G Edge	236Kb/s	236Kb/s	75	0	800
3G UMTS	384Kb/s	384Kb/s	75	0	200
4G LTE	173Mb/s	58Mb/s	5	0	100
4G (High DNS delay)	5.5Mb/s	17.9Mb/s	50	0.01%	3000
4G (High packet losses)	5.5Mb/s	17.9Mb/s	50	10%	100

Phone

Warning

Baseband (SIM data connection) is not emulated. It is not possible to call, receive or send text messages to real phones or tablets.

The Phone widget allows you to test applications relying on telephony features and observe their behavior when receiving a call or a text message.

To use the Phone widget:

1. Click
2. Enter an incoming phone number
3. Click Call or enter a text message and click Send message

Tip

Text messages are displayed in the virtual device via a notification, but they can also be read in the Messaging application.

Open GApps

The application you are developing or testing may require an interaction with Google Play Services (e.g.: in-app purchasing, advertising, etc.). The Open GApps widget allows you to install a minimum package of those services, also containing an application store.

Disclaimer

GENYMOBILE SAS assumes no liability whatsoever resulting from the download, install and use of Google Play Services within your virtual devices. You are solely responsible for the use and assume all liability related thereto. Moreover, GENYMOBILE SAS disclaims any warranties of any kind, either express or implied, including, without limitation, implied warranties of merchantability, or fitness for a particular purpose regarding the compatibility of the Open GApps packages with any version of Genymotion. In no event shall GENYMOBILE SAS or its affiliates, or their respective officers, directors, employees, or agents be liable with respect to your download or use of the Google Play Services and you release GENYMOBILE SAS from any liability related thereto. You agree to defend, indemnify and hold harmless GENYMOBILE SAS for any claims or costs related to your use or download of the Google Play Services.

To install the package:

1. Click , or and Install Open GApps.
2. Read the Disclaimer carefully and click Accept if you agree with the terms. The Open GAPPs package will be automatically downloaded and flashed.
3. Reboot the virtual device when prompted. The device will reboot and, meanwhile, you will be redirected to Open GAPPS website.

To launch Google Play Store, hold the left mouse button and slide up from the bottom of the device display. Then, click Google Play:

Your device isn't compatible with this version

If the application cannot be found, or if Play Store displays the "Your device isn't compatible with this version" error message, it may mean that your application has been compiled for ARM only.

Please refer to Deploy an Application for possible solutions.

Sound Control

You can control the volume of the sound emitted by your virtual device by clicking or

Rotate Screen

3.3.0

Click to rotate the screen 90° to the left, or click to rotate the screen 90° to the right.

Pixel Perfect

With Pixel Perfect, you can be highly precise in the development of your user interface and ensure every pixel of your application really looks as it should. One pixel of the virtual device is displayed using one pixel of your computer screen.

Click to enable or disable Pixel Perfect.

Note

If the virtual device screen size is larger than your computer screen size, the virtual device window will be maximized and you will be able to use scrollbars to move inside the screen.

Navigation Widgets

The navigation widgets simulate a real device navigation buttons:

• Click to bring the Android Recent Screen and list recently accessed activities and tasks.
• Click to navigate to Android Home page.
• Click to simulate the Back button of a real device.

Power

The power widget simulates a real device power button:

• Click to put the virtual device to sleep.
• Click and hold your mouse button to simulate a power button hold (reset/power off).

Settings

3.3.0

Click to open the extra settings window:

Information

In this section, you can find information related to Genymotion and your virtual device:

• Emulator version: Genymotion version.
• Android version: the Android version of the virtual device.
• ADB serial: the ADB serial (local IP and port) of the virtual device.

Toolbar

Tip

You can click in the right-side toolbar to reach this feature.

With this feature, you can:

• Select which widgets to display in the right-side toolbar by checking them.
• Drag'n drop the widgets to change their order in the right-side toolbar.
• Click to reset to default.

Shortcuts

This feature allows you to change the default virtual device shortcuts and add custom shortcuts:

1. Click on a feature to create or edit a shorcut:

   

2. Press a key sequence (for example, Ctrl+A) and click SET to confirm.

Tip

Click to restore the default value.

Licenses

Displays the licenses of Genymotion open-source components:

Click COPY to copy the full text of the license.