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¶
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:
- Click
- Modify the charge level using the slider or enter a value in the Charge level field.
-
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:
- Switch Activate GPS emulation on to activate the GPS emulation.
- 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.
-
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.
-
If it is not already enabled, switch Activate GPS emulation on.
-
Switch the Replay a GPS trace feature on:
-
Click Open to upload your GPX.
-
Click to start or pause the route simulation:
-
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.
-
In the Media files box, click OPEN MEDIA FOLDER:
-
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:
%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.
- resize the video or image. Available resize profiles are
Crop
,Keep aspect
andResize
:
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:
- Connect your physical device either by wire or with Wi-Fi. To connect with Wi-Fi, your physical device must support ADB over network.
- 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.
- Check Android debugging and then ADB over network.
- Connect your physical device to the Wi-Fi and retrieve its IP address from the Wi-Fi menu.
-
Open a terminal or command prompt and enter:
adb connect {your_device_IP}
-
Click
-
Activate remote control emulation. Genymotion Desktop tries to detect any connected Android device.
-
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.
-
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:
- Click
- Enable disk I/O emulation.
-
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
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:
- Disable Wifi
- Enable Mobile data
-
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 HSDPA 13.98Mb/s 5.76Mb/s 10% 0 4G LTE 173Mb/s 58Mb/s 5 0 5G 1174Mb/s 211Mb/s 5 0 -
Select a Signal strength from the drop-down list. Available values are:
Great
,Good
,Moderate
,Poor
andNone
.
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:
- Click
- Activate the network simulation with the switch
- 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:
- Click
- Enter an incoming phone number
- 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:
- Click , or and Install Open GApps.
- Read the Disclaimer carefully and click Accept if you agree with the terms. The Open GAPPs package will be automatically downloaded and flashed.
- 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¶
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¶
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:
-
Click on a feature to create or edit a shorcut:
-
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.