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
- Rotate Screen
- Full-screen
- Install Apps
- File Upload
- Clipboard
- Camera
- Battery
- GPS
- Capture
- Screen Record
- Identifiers
- Network
- Baseband
- Phone
- Disk I/O
- Biometrics
- Navigation Widgets
- Power
Sound Volume
- The Sound Volume widget allows you to control the volume emitted by your virtual device.
Rotate Screen
- The Rotate Screen widget allows you to rotate the screen of your virtual device.
Full-screen
- The Full-screen widget allows you to turn the full-screen mode on or off.
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.
- To install Google Play Store, install the Open GApps package by clicking INSTALL GAPPS and following the instructions. For more details, refer to Basic Steps - Installing Open GApps.
- Drag and drop an .apk file to deploy.
- Browse your computer to upload an .apk file. The file will be automatically deployed.
- The Open GApps package can be installed to enable Google Play Store.
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 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
- 1. Click the clipboard widget to open the clipboard input.
- Paste your text into the clipboard text field.
- Click COPY TO DEVICE.
- On the device display, hold the left mouse button and select Paste as on a real Android device.
- The copied content appears in the clipboard window and can be pasted to the virtual device.
Copy from the virtual device
- 1. On the device display, select the text you wish to copy, hold the left mouse button and select Copy.
- Click the clipboard widget to view the copied content in the clipboard text window.
- Copy the content to your computer clipboard.
Camera
- The Camera injection widget allows you to send a video stream from a virtual device to the Android system.
- The default video stream is a simple video placeholder.
- You can also use a video stream from a real webcam connected to or integrated into your computer.
- To toggle the Camera injection widget, click the Camera icon 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 the Battery icon.
- Modify the charge level using the slider or by 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 the GPS icon to open the GPS widget.
- Set a value for each parameter:
- Latitude: -90° to 90°
- Longitude: -180° to 180°
- Altitude: -10000 m to 10000 m
- Accuracy: 0 m to 200 m
- Bearing: 0° to 359.99°
- Speed: 0 m/s to 399.99 m/s
- 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 must allow your browser to access your location.
- Click APPLY to set the values.
Capture
- The Capture widget allows you to take a screenshot of the virtual device display.
- Click the Capture button 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 the Record button to start recording, and click it 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 rebooting your virtual device.
- Click the ID to open the Identifiers widget.
- 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, then 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 | 0 | | 2G GSM | 14Kb/s | 14Kb/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, Name
- SIM Operator: MCC/MNC, MSIN, Name, Phone Number
- 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 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 amounts 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 200 MiB per second.
- Mid-range device: Read speed limit 100 MiB per second.
- Low-end device: Read speed limit 50 MiB per second.
- Custom device: Enter the read speed limit you wish to emulate in MiB.
- Click APPLY to apply the change.
- When switching device profiles, the disk cache is automatically cleared. You can also clear 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 the Biometrics icon to open the widget window.
- The icons become available when fingerprint enrollment starts in Android. At that moment, Biometric authentication required will turn to Yes.
- You can click one of the icons to simulate:
- 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 too fast to be recognized.
- You can toggle Automatic biometric authentication to automatically respond to a fingerprint enrollment with the Recognized scenario.
- Important Note: To use this widget in any application asking for Fingerprint authentication, you need to configure one fingerprint in Android.
- Follow the steps in Android Settings to add a fingerprint and use the Biometric widget accordingly.
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 resume the previous one.
Power
- The Power Widget simulates a real device power button:
- Sleep mode: Click the power button 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 shut down the virtual device may not shut the instance completely and can cause unwanted extra charges. See Stopping a virtual device for safer methods.