Features and Emulated Sensors¶
To simulate various behaviors of your application according to specific use cases, Genymotion provides easy-to-use widgets which emulate the following sensors and features:
Sound volume¶
You can control the volume of the sound emitted by your virtual device by clicking or
Rotate screen¶
You can rotate the screen of your virtual device by clicking
Full-screen¶
You can turn the full-screen mode on or off by clicking
Install Apps¶
The Install Apps widget allows you to upload and install .apk
files, or install Google Play Store from the Open GApps package.
Click to open the widget:
Then, you can either:
- Install the Open GApps package to get Google Play Store. To do so, click INSTALL GAPPS and follow the instructions. For more details, please refer to Basic Steps - Installing Open GApps.
- Drag'n drop an
.apk
file. The file will be automatically deployed. - Browse your computer to upload an
.apk
file. The file will be automatically deployed.
File upload¶
Installing an .apk
or uploading any files from your computer to the virtual device can be achieved with the File Upload widget.
Click to open the Widget:
Click BROWSE to browse for the file you wish to upload.
Info
.apk
files will be automatically installed..zip
files will be automatically flashed.- Any other file type will just be uploaded to the device
sdcard/Download
folder. - You may have to restart your virtual device to see a newly uploaded file.
Clipboard¶
The Clipboard widget allows you to copy and paste text to and from the virtual device.
Copy to the virtual device¶
- Click to open the clipboard widget:
- Paste your text into the clipboard text field.
- Click COPY TO DEVICE
- On the device display, hold the mouse left button and select Paste as on a real Android device:
Copy from the virtual device¶
- On the device display, select the text you wish to copy, hold the left mouse button and select Copy:
- Click , the copied text is displayed in the clipboard text window:
- Copy the content of the clipboard widget to your computer clipboard.
Camera¶
The Camera injection widget allows you to send a video stream from a virtual device to the Android system. With this widget, you can test an Android application that uses Android built-in cameras.
The default video stream is a simple video placeholder - you can also use the video stream from a real physical webcam connected or integrated into your computer.
To toggle the Camera injection widget, click in the right toolbar.
Make sure your camera is allowed to access the virtual 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
Then, you can:
- Modify the charge level using the slider or entering a value in the Charge level section.
- Toggle the State of charge.
GPS¶
The GPS widget allows real-time activation and modifications of a position, accuracy and bearing.
Click to open the GPS widget:
Set a value for each parameter:
Value range | |
---|---|
Latitude | -90° to 90° |
Longitude | -180° to 180° |
Altitude | -10000m to 10000m |
Accuracy | 0m to 200m |
Bearing | 0° to 359.99° |
Speed | 0 m/s to 399.99 m/s |
Many applications do not rely on GPS orientation, but use the device accelerometer or gyroscope to determine the device bearing instead. These features are not supported yet.
You can also:
- Click MAP to open the built-in map and select a location.
-
Click SET TO MY POSITION to get your current position (as returned by your browser).
You have to allow your browser to access your location.
Then, click APPLY to set the values.
Capture¶
The Capture widget allows you to take a screenshot of the virtual device display.
Click to take a screenshot and save it on your computer.
Screen record¶
The Screen record widget allows you to record the virtual device display.
Click to start recording, and click again to stop and save the screen record on your computer.
Identifiers¶
The Identifiers widget shows Android ID and Device ID/IMEI/MEID. You can view or edit these values, without having to reboot your virtual device.
Click to open the Identifiers widget:
Input values, or click to generate random values.
Click APPLY to set the values.
Info
- You cannot set an empty Android ID.
- By default, a new virtual device is deployed with device ID "000000000000000".
- Valid characters for setting device ID/IMEI/MEID are lower-case and upper-case letters
[a-z, A-Z]
, digits[0-9]
, dots[ . ]
, dashes[ - ]
and underscores[ _ ]
.
Network¶
The Network widget allows you to test how your application reacts with different network quality and performance types.
This feature is no longer available for Android 8.1 and below
Click to open the widget:
By default, Wifi is enabled. To simulate Mobile Data transfer speed, toggle Wifi off, select a Network Type and a Signal Strength from the drop-down lists.
Network profiles and their corresponding values with max Signal strength (Great) are listed in the table below:
Download speed | Upload speed | Upload/Download delay (in ms) | Upload/Download packet loss | |
---|---|---|---|---|
Unlimited | No Limit | No Limit | No Limit | 0 |
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 |
Baseband¶
SIM data (Baseband) is only simulated: it is not possible to send or receive calls or messages to/from physical phones or tablets.
Baseband emulation allows you to test different mobile network operators with different SIM operators.
Click to open the widget window:
Fill the fields with the desired values:
Network Operator | |
---|---|
MCC/MNC | Enter a Mobile Country Code for the Network operator. |
Name | Enter a name for the Network Operator. |
SIM Operator | |
---|---|
MCC/MNC | Enter a Mobile Country Code for the SIM operator. |
MSIN | Enter a mobile subscription identification number used by the SIM operator. |
Name | Enter a name for the SIM operator. |
Phone Number | Enter the phone number corresponding to the SIM. |
Click APPLY to set the values.
Phone¶
It is not possible to send or receive calls or text messages to/from real phones or tablets.
The Phone widget allows you to simulate phone calls and text messages to test applications relying on telephony features and monitor their behavior.
Click to open the Phone widget:
Enter a fictitious incoming phone number and:
- Click CALL to simulate an incoming call
- Enter some text and click SEND MESSAGE to simulate a text message.
Text messages are displayed in the virtual device via a notification, but they can also be read in the Messaging application.
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 game apps that load large files.
Click to open the widget:
From the Profile drop-down list, select a type of device:
- High-end device: Read speed limit 200MiB per second.
- Mid-range device: Read speed limit 100MiB per second.
- Low-end device: Read speed limit 50MiB per second.
- Custom device: Enter the read speed limit you wish to emulate in MiB.
Click APPLY to apply the change.
When switching from a device profile to another, the disk cache is automatically cleared. However, you can force clearing the cache by clicking CLEAR.
Biometrics¶
This feature is only available for Android 13 and 14 for the moment.
The Biometrics widget allows you to simulate fingerprint recognition.
Click to open the widget window:
The icons will only become available when fingerprint enrollment starts in Android. At this moment, Biometric authentication required will turn to Yes:
Then, you will be able to click on one of the icons to simulate the following scenarios:
- Recognized: the fingerprint is matched and recognized.
- Unrecognized: the fingerprint is not matched nor recognized.
- Dirty: the fingerprint is dirty.
- Partial: only part of the fingerprint is matched.
- Insufficient: the fingerprint quality is not good enough to be recognized.
- Too fast: the fingerprint capture has been made too fast to be recognized.
You can also toggle Automatic biometric authentication to automatically respond to a fingerprint enrollment with the Recognized scenario.
Important Note
In order to use this widget in any application asking for Fingerprint authentication, you need to configure one fingerprint in Android.
Follow these step, in Android:
- Go to "Settings".
- Then "Security".
- Then "Fingerprint".
- Then click on "Add fingerprint" and use the Biometric widget to configure one finger.
Navigation Widgets¶
The navigation widgets emulate Android navigation buttons:
- : List recently accessed activities and tasks.
- : Navigate to Android Home page.
- : Kill the current activity and resumes the previous one.
Power¶
The Power Widget simulates a real device power button:
- Sleep mode: Click to put the device to sleep.
- Power Off / Reboot: Click and hold the mouse button to show the Android power off menu (reboot, shutdown, etc.).
Using the power off button to shutdown the virtual device may not shutdown the instance completely and cause unwanted extra charges. See Stopping a virtual device for safer methods.