package android.emulation.control
Get desktop application:
View/edit binary Protocol Buffers messages
An EmulatorController service lets you control the emulator. Note that this is currently an experimental feature, and that the service definition might change without notice. Use at your own risk! We use the following rough conventions: streamXXX --> streams values XXX (usually for emulator lifetime). Values are updated as soon as they become available. getXXX --> gets a single value XXX setXXX --> sets a single value XXX, does not returning state, these usually have an observable lasting side effect. sendXXX --> send a single event XXX, possibly returning state information. android usually responds to these events.
rpc streamSensor (, stream )
emulator_controller.proto:66Set the sensor data
Get the sensor data
Stream the sensor data
Set the physical model, this is likely the one you are looking for when you wish to modify the device state.
Get the physical model
rpc streamPhysicalModel (, stream )
emulator_controller.proto:78Stream the physical model
Atomically set the current primary clipboard data.
Atomically get the current primary clipboard data.
rpc streamClipboard (, stream )
emulator_controller.proto:92Streams the current data on the clipboard. This will immediately produce a result with the current state of the clipboard after which the stream will block and wait until a new clip event is available from the guest. Calling the setClipboard method above will not result in generating a clip event. It is possible to lose clipboard events if the clipboard updates very rapidly.
Set the battery to the given state.
Get the battery to the given state.
rpc setGps (, )
emulator_controller.proto:109Set the state of the gps, gps support will only work properly if: - no location ui is active. That is the emulator is launched in headless mode (-no-window) or the location ui is disabled (-no-location-ui). - the passiveUpdate is set to false. Setting this to false will disable/break the LocationUI. Keep in mind that android usually only samples the gps at 1 hz.
rpc getGps (, )
emulator_controller.proto:116Gets the latest gps state as delivered by the setGps call, or location ui if active. Note: this is not necessarily the actual gps coordinate visible at the time, due to gps sample frequency (usually 1hz).
Simulate a touch event on the finger print sensor.
message
emulator_controller.proto:694bool isTouching = 1
True when the fingprint is touched.
int32 touchId = 2
The identifier of the registered fingerprint.
rpc sendKey (, )
emulator_controller.proto:122Send a keyboard event. Translating the event.
message
emulator_controller.proto:606KeyboardEvent objects describe a user interaction with the keyboard; each event describes a single interaction between the user and a key (or combination of a key with modifier keys) on the keyboard. This follows the pattern as set by (javascript)[https://developer.mozilla.org/en-US/docs/Web/API/KeyboardEvent] Note: that only keyCode, key, or text can be set and that the semantics will slightly vary.
KeyboardEvent.KeyCodeType codeType = 1
Type of keycode contained in the keyCode field.
KeyboardEvent.KeyEventType eventType = 2
The type of keyboard event that should be sent to the emulator
int32 keyCode = 3
This property represents a physical key on the keyboard (as opposed to the character generated by pressing the key). In other words, this property is a value which isn't altered by keyboard layout or the state of the modifier keys. This value will be interpreted by the emulator depending on the KeyCodeType. The incoming key code will be translated to an evdev code type and send to the emulator. The values in key and text will be ignored.
string key = 4
The value of the key pressed by the user, taking into consideration the state of modifier keys such as Shift as well as the keyboard locale and layout. This follows the w3c standard used in browsers. You can find an accurate description of valid values [here](https://developer.mozilla.org/en-US/docs/Web/API/KeyboardEvent/key/Key_Values) Note that some keys can result in multiple evdev events that are delivered to the emulator. for example the Key "A" will result in a sequence: ["Shift", "a"] -> [0x2a, 0x1e] whereas "a" results in ["a"] -> [0x1e]. Not all documented keys are understood by android, and only printable ASCII [32-127) characters are properly translated. Keep in mind that there are a set of key values that result in android specific behavior [see](https://developer.mozilla.org/en-US/docs/Web/API/KeyboardEvent/key/Key_Values#Phone_keys): - "AppSwitch": Behaves as the "Overview" button in android. - "GoBack": The Back button. - "GoHome": The Home button, which takes the user to the phone's main screen (usually an application launcher). - "Power": The Power button.
string text = 5
Series of utf8 encoded characters to send to the emulator. An attempt will be made to translate every character will an EvDev event type and send to the emulator as a keypress event. The values in keyCode, eventType, codeType and key will be ignored. Note that most printable ASCII characters (range [32-127) can be send individually with the "key" param. Do not expect arbitrary UTF symbols to arrive in the emulator (most will be ignored). Note that it is possible to overrun the keyboard buffer by slamming this endpoint with large quantities of text (>1kb). The clipboard api is better suited for transferring large quantities of text.
Send touch events. Note that mouse events can be simulated by touch events.
message
emulator_controller.proto:564A TouchEvent contains a list of Touch objects that are in contact with the touch surface. Touch events are delivered in sequence as specified in the touchList. TouchEvents are delivered to the emulated devices using ["Protocol B"](https://www.kernel.org/doc/Documentation/input/multi-touch-protocol.txt)
repeated touches = 1
The list of Touch objects, note that these do not need to be unique
int32 display = 2
The display device where the touch event occurred. Omitting or using the value 0 indicates the main display. Touch events cannot be send to displays other than 0, due to https://issuetracker.google.com/issues/150699691
Send mouse events.
message
emulator_controller.proto:578The MouseEvent interface represents events that occur due to the user interacting with a pointing device (such as a mouse).
int32 x = 1
The horizontal coordinate. This is the physical location on the screen For example 0 indicates the leftmost coordinate.
int32 y = 2
The vertical coordinate. This is the physical location on the screen For example 0 indicates the top left coordinate.
int32 buttons = 3
Indicates which buttons are pressed. 0: No button was pressed 1: Primary button (left) 2: Secondary button (right)
int32 display = 4
The display device where the mouse event occurred. Omitting or using the value 0 indicates the main display.
Make a phone call.
message
emulator_controller.proto:899PhoneCall.Operation operation = 1
string number = 2
rpc sendSms (, )
emulator_controller.proto:133Sends an sms message to the emulator.
message
emulator_controller.proto:983string srcAddress = 1
The source address where this message came from. The address should be a valid GSM-formatted address as specified by 3GPP 23.040 Sec 9.1.2.5. For example: +3106225412 or (650) 555-1221
string text = 2
A utf8 encoded text message that should be delivered.
Retrieve the status of the emulator. This will contain general hardware information, and whether the device has booted or not.
message
emulator_controller.proto:934string version = 1
The emulator version string.
uint64 uptime = 2
The time the emulator has been active in .ms
bool booted = 3
True if the device has completed booting. For P and later this information will accurate, for older images we rely on adb.
optional vmConfig = 4
The current vm configuration
optional hardwareConfig = 5
The hardware configuration of the running emulator as key valure pairs.
Gets an individual screenshot in the desired format. The image will be scaled to the desired ImageFormat, while maintaining the aspect ratio. The returned image will never exceed the provided width and height. Not setting the width or height (i.e. they are 0) will result in using the device width and height. The resulting image will be properly oriented and can be displayed directly without post processing. For example, if the device has a 1080x1920 screen and is in landscape mode and called with no width or height parameter, it will return an 1920x1080 image. This method will return an empty image if the display is not visible.
rpc streamScreenshot (, stream )
emulator_controller.proto:162Streams a series of screenshots in the desired format. A new frame will be delivered whenever the device produces a new frame. (Beware that this can produce a significant amount of data, and that certain translations are (png transform) can be costly). If the requested display is not visible it will send a single empty image and wait start producing images once the display becomes active, again producing a single empty image when the display becomes inactive.
rpc streamAudio (, stream )
emulator_controller.proto:171Streams a series of audio packets in the desired format. A new frame will be delivered whenever the emulated device produces a new audio frame. You can expect packets to be delivered in intervals of 20-30ms. Be aware that this can block when the emulator does not produce any audio whatsoever!
rpc injectAudio (stream , )
emulator_controller.proto:185Injects a series of audio packets to the android microphone. A new frame will be delivered whenever the emulated device requests a new audio frame. Audio is usually delivered at a rate that the emulator is requesting frames. Audio will be stored in a temporary buffer that can hold 500ms of audio. Note: Currently the emulator will downsample to 16khz. - INVALID_ARGUMENT (code 3) The sampling rate was too high - INVALID_ARGUMENT (code 3) The audio packet was too large to handle. - FAILED_PRECONDITION (code 9) If there was a microphone registered already.
Returns the last 128Kb of logcat output from the emulator Note that parsed logcat messages are only available after L (Api >23). it is possible that the logcat buffer gets overwritten, or falls behind.
rpc streamLogcat (, stream )
emulator_controller.proto:196Streams the logcat output from the emulator. The first call can retrieve up to 128Kb. This call will not return. Note that parsed logcat messages are only available after L (Api >23) it is possible that the logcat buffer gets overwritten, or falls behind.
Transition the virtual machine to the desired state. Note that some states are only observable. For example you cannot transition to the error state.
Gets the state of the virtual machine.
Atomically changes the current multi-display configuration. After this call the given display configurations will be activated. You can only update secondary displays. Displays with id 0 will be ignored. This call can result in the removal or addition of secondary displays, the final display state can be observed by the returned configuration. The following gRPC error codes can be returned: - FAILED_PRECONDITION (code 9) if the AVD does not support a configurable secondary display. - INVALID_ARGUMENT (code 3) if: - The same display id is defined multiple times. - The display configurations are outside valid ranges (see DisplayConfiguration) - INTERNAL (code 13) if there was an internal emulator failure.
Returns all currently valid logical displays. The gRPC error code FAILED_PRECONDITION (code 9) is returned if the AVD does not support a configurable secondary display.
rpc streamNotification (, stream )
emulator_controller.proto:239Notifies client of the following changes: - Virtual scene camera status change. - Display configuration changes from extended ui. This will only be fired if the user makes modifications the extended displays through the extended control tab. Note that this method will send the initial virtual scene state immediately.
message
emulator_controller.proto:1092Notification.EventType event = 1
RotationRadian is relative to the camera's current orientation.
message
emulator_controller.proto:1107float x = 1
x axis is horizontal and orthogonal to the view direction.
float y = 2
y axis points up and is perpendicular to the floor.
float z = 3
z axis is the view direction and is set to 0.0 in
Velocity is absolute
message
emulator_controller.proto:1114float x = 1
x axis is horizontal and orthogonal to the view direction.
float y = 2
y axis points up and is perpendicular to the floor.
float z = 3
z axis is the view direction
Set foldable posture
message
emulator_controller.proto:1121must follow the definition in "external/qemu/android/hw-sensors.h"
Posture.PostureValue value = 3
The SnapshotService enables you to list, insert, store, and retrieve snapshots. Currently there are two types of snapshots: - Local (default): These are snapshots that are created locally. They are stored internally inside qcow2 files and are very efficient. These are the snapshots usually created by interacting with the UI. - Remote: These are snapshots that have been exported at a certain point. an exported snapshot is normalized (completely self contained) and can be imported into an emulator with a similar hardware configuration. Currently the emulator has limited support for importing snapshots: - Once an imported snapshot has been loaded into an emulator it is no longer possible to create new snapshots. - The hardware configuration of the emulator your are pushing a snapshot to must match (or be very similar) to the one you pulled the snapshot from. For example do not expect to be able to restore a snapshot on created on an Intel cpu on an AMD cpu.
Lists all the snapshots, filtered by the given query, that are stored locally for the currently running avd. This includes all the snapshots that were imported (pushed) into this emulator. Returns a list of snapshot_id's and associated details that describes the hardware configuration, logical name, etc of the snapshot.
message
snapshot_service.proto:192A snapshot filter can be used to filter the results produced by ListSnapshots
SnapshotFilter.LoadStatus statusFilter = 1
Filter snapshots by load status.
message
snapshot_service.proto:258A list of on snapshot details.
repeated snapshots = 1
rpc PullSnapshot (, stream )
snapshot_service.proto:95Pulls down the snapshot stored inside the AVD as a tar.gz/tar stream This will normalize the snapshot, all relevant data to push a snapshot into a similar emulator will be placed inside the tar file. Pulling down a snapshot will pause the emulator until the snapshots are rebased and ready for exporting. Once the snapshot is rebased the emulator will continue and downloading should commence. Note that pulling .gz stream is slow. You must provide the snapshot_id and (desired) format. If SnapshotPackage.path is set, the gRPC service will directly write the exported snapshot to SnapshotPackage.path without streaming, which is usually significantly faster. It would require emulator to have direct access to SnapshotPackage.path, which usually means it can only be used when pulling from a local emulator.
rpc PushSnapshot (stream , )
snapshot_service.proto:113Push a tar.gz stream contain the snapshot. The tar file should be a snapshot that was exported through the PullSnapshot in the past. The emulator will try to import the snapshot. The hardware configuration of the current emulator should match the one used for pulling. A detailed description of the snapshot (emulator_snapshot.Snapshot) is stored in the snapshot.pb file inside the tar. You must provide the snapshot_id and format in the first message. Will return success and a possible error message when a failure occurs. If SnapshotPackage.path is set, the gRPC service will directly unzip the exported snapshot from SnapshotPackage.path without streaming, which is usually significantly faster. It would require emulator to have direct access to SnapshotPackage.path, which usually means it can only be used when pushing to a local emulator.
Loads the given snapshot inside the emulator and activates it. The device will be in the state as it was when the snapshot was created. You will no longer be able to call Save if this was an imported snapshot that was pushed into this emulator. You must provide the snapshot_id to indicate which snapshot to load Will return success and a possible error message when a failure occurs.
Creates as a snapshot of the current state of the emulator. You can only save a snapshot if you never activated (Load) an imported snapshot (Push). For example: - PushSnapshot("some_snap.tar.gz"); - LoadSnapshot("some_snap"); - SaveSnapshot("same_newer_snap"); // <--- Will currently fail. You can provide the snapshot_id to indicate the name used for storing. Will return success and a possible error message when a failure occurs.
Deletes the snapshot with the given snapshot_id from the avd. You must provide the snapshot_id to indicate which snapshot to delete. Will return success and a possible error message when a failure occurs.
Tracks the given process for automated snapshot creation in case of assert failures. Will return success and a possible error message when a failure occurs. The snapshot_id field will contain the name of the snapshot that will be created. The pid field will contain the process id that is being tracked.
message
snapshot_service.proto:262int64 pid = 1
This is the process id to attach to, if this value is not set (0) The process name will be used instead.
string package_name = 2
The process name to attach to if any, if this is not set the pid will be used. This is usually the application name of your application under test, that is passed in to the am instrument command. It is likely what you will find in your AndroidManifest.xml
string snapshot_id = 3
The name of the snapshot that icebox will create if a snapshot is generated.
bool failed = 4
[Output Only] True if icebox failed to track the given target.
string err = 5
[Output Only] Detailed error message that might provide more information.
int32 max_snapshot_number = 6
Maximum number of snapshots the emulator can take during one Icebox run. Set to -1 for unlimited number of snapshots.
message
emulator_controller.proto:954Used as request type in: EmulatorController.streamAudio
Used as field type in:
uint64 samplingRate = 1
Sampling rate to use, defaulting to 44100 if this is not set. Note, that android devices typically will not use a sampling rate higher than 48kHz. See https://developer.android.com/ndk/guides/audio.
AudioFormat.Channels channels = 2
AudioFormat.SampleFormat format = 3
Used in:
Mono = 0
Stereo = 1
Used in:
AUD_FMT_U8 = 0
Unsigned 8 bit
AUD_FMT_S16 = 1
Signed 16 bit (little endian)
message
emulator_controller.proto:973Used as request type in: EmulatorController.injectAudio
Used as response type in: EmulatorController.streamAudio
optional format = 1
uint64 timestamp = 2
Unix epoch in us when this frame was captured.
bytes audio = 3
Contains a sample in the given audio format.
message
emulator_controller.proto:735Used as request type in: EmulatorController.setBattery
Used as response type in: EmulatorController.getBattery
bool hasBattery = 1
bool isPresent = 2
BatteryState.BatteryCharger charger = 3
int32 chargeLevel = 4
BatteryState.BatteryHealth health = 5
BatteryState.BatteryStatus status = 6
Used in:
NONE = 0
AC = 1
USB = 2
WIRELESS = 3
Used in:
GOOD = 0
FAILED = 1
DEAD = 2
OVERVOLTAGE = 3
OVERHEATED = 4
Used in:
UNKNOWN = 0
CHARGING = 1
DISCHARGING = 2
NOT_CHARGING = 3
FULL = 4
message
emulator_controller.proto:491Representation of a clipped data object on the clipboard.
Used as request type in: EmulatorController.setClipboard
Used as response type in: EmulatorController.getClipboard, EmulatorController.streamClipboard
string text = 1
UTF-8 Encoded text.
message
emulator_controller.proto:1011A DisplayConfiguration describes a primary or secondary display available to the emulator. The screen aspect ratio cannot be longer (or wider) than 21:9 (or 9:21). Screen sizes larger than 4k will be rejected. Common configurations (w x h) are: - 480p (480x720) 142 dpi - 720p (720x1280) 213 dpi - 1080p (1080x1920) 320 dpi - 4K (2160x3840) 320 dpi - 4K (2160x3840) 640 dpi (upscaled) The behavior of the virtual display depends on the flags that are provided to this method. By default, virtual displays are created to be private, non-presentation and unsecure.
Used in:
uint32 width = 1
The width of the display, restricted to: 320 * (dpi / 160) <= width
uint32 height = 2
The heigh of the display, restricted to: * 320 * (dpi / 160) <= height
uint32 dpi = 3
The pixel density (dpi). See https://developer.android.com/training/multiscreen/screendensities for details. This value should be in the range [120, ..., 640]
uint32 flags = 4
A combination of virtual display flags. These flags can be constructed by combining the DisplayFlags enum described above. The behavior of the virtual display depends on the flags. By default virtual displays are created to be private, non-presentation and unsecure.
uint32 display = 5
The id of the display. The primary (default) display has the display ID of 0. A secondary display has a display ID not 0. The id can be used to get or stream a screenshot.
These are the set of known android flags and their respective values. you can combine the int values to (de)construct the flags field below.
DISPLAYFLAGS_UNSPECIFIED = 0
VIRTUAL_DISPLAY_FLAG_PUBLIC = 1
When this flag is set, the virtual display is public. A public virtual display behaves just like most any other display that is connected to the system such as an external or wireless display. Applications can open windows on the display and the system may mirror the contents of other displays onto it. see: https://developer.android.com/reference/android/hardware/display/DisplayManager#VIRTUAL_DISPLAY_FLAG_PUBLIC
VIRTUAL_DISPLAY_FLAG_PRESENTATION = 2
When this flag is set, the virtual display is registered as a presentation display in the presentation display category. Applications may automatically project their content to presentation displays to provide richer second screen experiences. https://developer.android.com/reference/android/hardware/display/DisplayManager#VIRTUAL_DISPLAY_FLAG_PRESENTATION
VIRTUAL_DISPLAY_FLAG_SECURE = 4
When this flag is set, the virtual display is considered secure as defined by the Display#FLAG_SECURE display flag. The caller promises to take reasonable measures, such as over-the-air encryption, to prevent the contents of the display from being intercepted or recorded on a persistent medium. see: https://developer.android.com/reference/android/hardware/display/DisplayManager#VIRTUAL_DISPLAY_FLAG_SECURE
VIRTUAL_DISPLAY_FLAG_OWN_CONTENT_ONLY = 8
This flag is used in conjunction with VIRTUAL_DISPLAY_FLAG_PUBLIC. Ordinarily public virtual displays will automatically mirror the content of the default display if they have no windows of their own. When this flag is specified, the virtual display will only ever show its own content and will be blanked instead if it has no windows. See https://developer.android.com/reference/android/hardware/display/DisplayManager#VIRTUAL_DISPLAY_FLAG_OWN_CONTENT_ONLY
VIRTUAL_DISPLAY_FLAG_AUTO_MIRROR = 16
Allows content to be mirrored on private displays when no content is being shown. This flag is mutually exclusive with VIRTUAL_DISPLAY_FLAG_OWN_CONTENT_ONLY. If both flags are specified then the own-content only behavior will be applied. see: https://developer.android.com/reference/android/hardware/display/DisplayManager#VIRTUAL_DISPLAY_FLAG_AUTO_MIRROR)
message
emulator_controller.proto:1088Used as request type in: EmulatorController.setDisplayConfigurations
Used as response type in: EmulatorController.getDisplayConfigurations, EmulatorController.setDisplayConfigurations
repeated displays = 1
message
emulator_controller.proto:925Used in:
string key = 1
string value = 2
message
emulator_controller.proto:930Used in:
repeated entry = 1
message
emulator_controller.proto:792The aspect ratio (width/height) will be different from the one where the device is unfolded.
Used in:
uint32 width = 1
uint32 height = 2
uint32 xOffset = 3
It is possible for the screen to be folded in different ways depending on which surface is shown to the user. So xOffset and yOffset indicate the top left corner of the folded screen within the original unfolded screen.
uint32 yOffset = 4
message
emulator_controller.proto:702Used as request type in: EmulatorController.setGps
Used as response type in: EmulatorController.getGps
bool passiveUpdate = 1
Setting this to false will disable auto updating from the LocationUI, otherwise the location UI will override the location at a frequency of 1hz. - This is unused if the emulator is launched with -no-window, or when he location ui is disabled. - This will BREAK the location ui experience if it is set to false. For example routing will no longer function.
double latitude = 2
The latitude, in degrees.
double longitude = 3
The longitude, in degrees.
double speed = 4
The speed if it is available, in meters/second over ground
double bearing = 5
gets the horizontal direction of travel of this device, and is not related to the device orientation. It is guaranteed to be in the range [0.0, 360.0] if the device has a bearing. 0=North, 90=East, 180=South, etc..
double altitude = 6
The altitude if available, in meters above the WGS 84 reference ellipsoid.
int32 satellites = 7
The number of satellites used to derive the fix
message
emulator_controller.proto:854Used as response type in: EmulatorController.getScreenshot, EmulatorController.streamScreenshot
optional format = 1
uint32 width = 2
width is contained in format.
uint32 height = 3
height is contained in format.
bytes image = 4
The organization of the pixels in the image buffer is from left to right and bottom up. This will be empty if an alternative image transport is requested in the image format. In that case the side channel should be used to obtain the image data.
uint32 seq = 5
[Output Only] Monotonically increasing sequence number in a stream of screenshots. The first screenshot will have a sequence of 0. A single screenshot will always have a sequence number of 0. The sequence is not necessarily contiguous, and can be used to detect how many frames were dropped. An example sequence could be: [0, 3, 5, 7, 9, 11].
uint64 timestampUs = 6
[Output Only] Unix timestamp in microseconds when the emulator estimates the frame was generated. The timestamp is before the actual frame is copied and transformed. This can be used to calculate variance between frame production time, and frame depiction time.
message
emulator_controller.proto:803Used as request type in: EmulatorController.getScreenshot, EmulatorController.streamScreenshot
Used as field type in:
ImageFormat.ImgFormat format = 1
The (desired) format of the resulting bytes.
optional rotation = 2
[Output Only] The rotation of the image. The image will be rotated based upon the coarse grained orientation of the device.
uint32 width = 3
The (desired) width of the image. When passed as input the image will be scaled to match the given width, while maintaining the aspect ratio of the device. The returned image will never exceed the given width, but can be less. Omitting this value (or passing in 0) will result in no scaling, and the width of the actual device will be used.
uint32 height = 4
The (desired) height of the image. When passed as input the image will be scaled to match the given height, while maintaining the aspect ratio of the device. The returned image will never exceed the given height, but can be less. Omitting this value (or passing in 0) will result in no scaling, and the height of the actual device will be used.
uint32 display = 5
The (desired) display id of the device. Setting this to 0 (or omitting) indicates the main display.
optional transport = 6
Set this if you wish to use a different transport channel to deliver image frames.
optional foldedDisplay = 7
[Output Only] Display configuration when screen is folded. The value is the original configuration before scaling.
Used in:
PNG = 0
Portable Network Graphics format (https://en.wikipedia.org/wiki/Portable_Network_Graphics)
RGBA8888 = 1
Three-channel RGB color model supplemented with a fourth alpha channel. https://en.wikipedia.org/wiki/RGBA_color_model Each pixel consists of 4 bytes.
RGB888 = 2
Three-channel RGB color model, each pixel consists of 3 bytes
message
emulator_controller.proto:770An ImageTransport allows for specifying a side channel for delivering image frames versus using the standard bytes array that is returned with the gRPC request.
Used in:
ImageTransport.TransportChannel channel = 1
The desired transport channel used for delivering image frames. Only relevant when streaming screenshots.
string handle = 2
Handle used for writing image frames if transport is mmap. The client sets and owns this handle. It can be either a shm region, or a mmap. A mmap should be a url that starts with `file:///` Note: the mmap can result in tearing.
Used in:
TRANSPORT_CHANNEL_UNSPECIFIED = 0
Return full frames over the gRPC transport
MMAP = 1
Write images to the a file/shared memory handle.
Code types that the emulator can receive. Note that the emulator will do its best to translate the code to an evdev value that will be send to the emulator. This translation is based on the chromium translation tables. See (this)[https://android.googlesource.com/platform/external/qemu/+/refs/heads/emu-master-dev/android/android-grpc/android/emulation/control/keyboard/keycode_converter_data.inc] for details on the translation.
Used in:
Usb = 0
Evdev = 1
XKB = 2
Win = 3
Mac = 4
Used in:
keydown = 0
Indicates that this keyevent should be send to the emulator as a key down event. Meaning that the key event will be translated to an EvDev event type and bit 11 (0x400) will be set before it is sent to the emulator.
keyup = 1
Indicates that the keyevent should be send to the emulator as a key up event. Meaning that the key event will be translated to an EvDev event type and sent to the emulator.
keypress = 2
Indicates that the keyevent will be send to the emulator as e key down event and immediately followed by a keyup event.
message
emulator_controller.proto:397Used as request type in: EmulatorController.getLogcat, EmulatorController.streamLogcat
Used as response type in: EmulatorController.getLogcat, EmulatorController.streamLogcat
string contents = 1
[Output Only] The contents of the log output.
int64 start = 2
The starting byte position of the output that was returned. This should match the start parameter sent with the request. If the serial console output exceeds the size of the buffer, older output will be overwritten by newer content and the start values will be mismatched.
int64 next = 3
[Output Only] The position of the next byte of content from the serial console output. Use this value in the next request as the start parameter.
LogMessage.LogType sort = 4
Set the sort of response you are interested it in. It the type is "Parsed" the entries field will contain the parsed results. otherwise the contents field will be set.
repeated entries = 5
[Output Only] The parsed logcat entries so far. Only set if sort is set to Parsed
Used in:
Text = 0
Parsed = 1
message
emulator_controller.proto:426A parsed logcat entry.
Used in:
uint64 timestamp = 1
A Unix timestamps in milliseconds (The number of milliseconds that have elapsed since January 1, 1970 (midnight UTC/GMT), not counting leap seconds)
uint32 pid = 2
Process id.
uint32 tid = 3
Thread id.
LogcatEntry.LogLevel level = 4
string tag = 5
string msg = 6
The possible log levels.
Used in:
UNKNOWN = 0
DEFAULT = 1
VERBOSE = 2
DEBUG = 3
INFO = 4
WARN = 5
ERR = 6
FATAL = 7
SILENT = 8
Used in:
VIRTUAL_SCENE_CAMERA_INACTIVE = 0
VIRTUAL_SCENE_CAMERA_ACTIVE = 1
DISPLAY_CONFIGURATIONS_CHANGED_UI = 2
Fired when an update to a display event has been fired through the extended ui. This does not fire events when the display is changed through the console or gRPC endpoint.
Keep adding more for other event types
message
emulator_controller.proto:284Used in: ,
repeated float data = 1
Used in:
InitCall = 0
AcceptCall = 1
RejectCallExplicit = 2
RejectCallBusy = 3
DisconnectCall = 4
PlaceCallOnHold = 5
TakeCallOffHold = 6
message
emulator_controller.proto:913Used as response type in: EmulatorController.sendPhone, EmulatorController.sendSms
PhoneResponse.Response response = 1
Used in:
OK = 0
BadOperation = 1
Enum out of range
BadNumber = 2
Mal-formed telephone number
InvalidAction = 3
E.g., disconnect when no call is in progress
ActionFailed = 4
Internal error
RadioOff = 5
Radio power off
message
emulator_controller.proto:288Used as request type in: EmulatorController.getPhysicalModel, EmulatorController.setPhysicalModel, EmulatorController.streamPhysicalModel
Used as response type in: EmulatorController.getPhysicalModel, EmulatorController.streamPhysicalModel
PhysicalModelValue.PhysicalType target = 1
PhysicalModelValue.State status = 2
[Output Only]
optional value = 3
Value interpretation depends on sensor, will contain at most 3 values.
Details on the sensors documentation can be found here: https://developer.android.com/reference/android/hardware/Sensor.html#TYPE_ The types must follow the order defined in "external/qemu/android/hw-sensors.h"
Used in:
POSITION = 0
ROTATION = 1
All values are angles in degrees. values = [x,y,z]
MAGNETIC_FIELD = 2
TEMPERATURE = 3
Temperature in °C
PROXIMITY = 4
Proximity sensor distance measured in centimeters
LIGHT = 5
Ambient light level in SI lux units
PRESSURE = 6
Atmospheric pressure in hPa (millibar)
HUMIDITY = 7
Relative ambient air humidity in percent
VELOCITY = 8
AMBIENT_MOTION = 9
HINGE_ANGLE0 = 10
Describing a hinge angle sensor in degrees.
HINGE_ANGLE1 = 11
HINGE_ANGLE2 = 12
ROLLABLE0 = 13
ROLLABLE1 = 14
ROLLABLE2 = 15
Used in:
OK = 0
NO_SERVICE = -3
qemud service is not available/initiated.
DISABLED = -2
Sensor is disabled.
UNKNOWN = -1
Unknown sensor (should not happen)
Used in:
POSTURE_UNKNOWN = 0
POSTURE_CLOSED = 1
POSTURE_HALF_OPENED = 2
POSTURE_OPENED = 3
POSTURE_FLIPPED = 4
POSTURE_TENT = 5
POSTURE_MAX = 6
message
emulator_controller.proto:880Used in:
Rotation.SkinRotation rotation = 1
The rotation of the device, derived from the sensor state of the emulator. The derivation reflects how android observes the rotation state.
double xAxis = 2
Specifies the angle of rotation, in degrees [-180, 180]
double yAxis = 3
double zAxis = 4
Used in:
PORTRAIT = 0
0 degrees
LANDSCAPE = 1
90 degrees
REVERSE_PORTRAIT = 2
-180 degrees
REVERSE_LANDSCAPE = 3
-90 degrees
message
emulator_controller.proto:346A single sensor value.
Used as request type in: EmulatorController.getSensor, EmulatorController.setSensor, EmulatorController.streamSensor
Used as response type in: EmulatorController.getSensor, EmulatorController.streamSensor
SensorValue.SensorType target = 1
Type of sensor
SensorValue.State status = 2
[Output Only]
optional value = 3
Value interpretation depends on sensor enum, will contain at most 3 values.
These are the various sensors that can be available in an emulated devices.
Used in:
ACCELERATION = 0
Measures the acceleration force in m/s2 that is applied to a device on all three physical axes (x, y, and z), including the force of gravity.
GYROSCOPE = 1
Measures a device's rate of rotation in rad/s around each of the three physical axes (x, y, and z).
MAGNETIC_FIELD = 2
Measures the ambient geomagnetic field for all three physical axes (x, y, z) in μT.
ORIENTATION = 3
Measures degrees of rotation that a device makes around all three physical axes (x, y, z)
TEMPERATURE = 4
Measures the temperature of the device in degrees Celsius (°C).
PROXIMITY = 5
Measures the proximity of an object in cm relative to the view screen of a device. This sensor is typically used to determine whether a handset is being held up to a person's ear.
LIGHT = 6
Measures the ambient light level (illumination) in lx.
PRESSURE = 7
Measures the ambient air pressure in hPa or mbar.
HUMIDITY = 8
Measures the relative ambient humidity in percent (%).
MAGNETIC_FIELD_UNCALIBRATED = 9
GYROSCOPE_UNCALIBRATED = 10
Used in:
OK = 0
NO_SERVICE = -3
qemud service is not available/initiated.
DISABLED = -2
Sensor is disabled.
UNKNOWN = -1
Unknown sensor (should not happen)
message
snapshot_service.proto:206Provides detailed information regarding the snapshot.
Used in:
string snapshot_id = 1
The id of this snapshot. Use this id to load/delete/pull the snapshot.
optional details = 2
Detailed information about this snapshot. This contains a detailed hardware description of the snapshot. These details are the same as the "snapshot.pb" file found in an exported snapshot. Look at the import file for a detailed description of the available fields.
SnapshotDetails.LoadStatus status = 3
Provides information about the ability to restore this snapshot.
uint64 size = 4
The size of the folder that stores required information to load a snapshot.
Used in:
Compatible = 0
The emulator believes that the snapshot is compatible with the emulator that provided this information. The emulator will attempt to load this snapshot when requested. A snapshot is usually compatible when the following statements are true: - The snapshot was taken by the current emulator version. i.e. emulator_build_id in the details field matches the build_id of the emulator that provided this information. - The snapshot was taken on the current running machine, and no hardware changes have taken place between taking and loading the snapshot. - The avd configuration has not changed between when this snapshot was taken and when the snapshot was loaded. - The system images on which the avd is based have not changed.
Incompatible = 1
The emulator will not allow loading of the snapshot, as it deems the snapshot to be incompatible. Loading of snapshots can be forced by launching the emulator with the feature "AllowSnapshotMigration" enabled.
Loaded = 2
This snapshot was successfully loaded in the emulator, and was used at the starting point of the current running emulator. The following holds: A loaded snapshot is a compatible snapshot There is at most one snapshot_id that is in the "Loaded" state
Used in:
CompatibleOnly = 0
Only return compatible snapshots
All = 1
Return all snapshots.
message
snapshot_service.proto:156Sets options for SnapshotService. Used for both request and response messages.
Used as request type in: SnapshotService.DeleteSnapshot, SnapshotService.LoadSnapshot, SnapshotService.PullSnapshot, SnapshotService.PushSnapshot, SnapshotService.SaveSnapshot
Used as response type in: SnapshotService.DeleteSnapshot, SnapshotService.LoadSnapshot, SnapshotService.PullSnapshot, SnapshotService.PushSnapshot, SnapshotService.SaveSnapshot
string snapshot_id = 1
The identifier to the snapshot, only required for request messages. For streaming service, only used in the first stream message of a gRPC call (would be ignored in consequent stream messages of the same call).
bytes payload = 2
A stream of bytes. Encoded as a tar (possibly gzipped) file pendinf on the value of format.
bool success = 3
[response only] status fields, usually indicates end of transmission.
bytes err = 4
SnapshotPackage.Format format = 5
[request only] Format of the payload. Only used in request messages. For streaming service, only used in the first stream message of a gRPC call (would be ignored in consequent stream messages of the same call).
string path = 6
[request only] Path to the snapshot package file. Only used in request messages. When set in a request, the PullSnapshot/PushSnapshot operation will directly write/read the exported snapshot in path without streaming, which is usually significantly faster. It would require emulator to have direct access to path, which usually means it can only be used with a local emulator.
Used in:
TARGZ = 0
TAR = 1
DIRECTORY = 2
message
emulator_controller.proto:499The Touch interface represents a single contact point on a touch-sensitive device. The contact point is commonly a finger or stylus and the device may be a touchscreen or trackpad.
Used in:
int32 x = 1
The horizontal coordinate. This is the physical location on the screen For example 0 indicates the leftmost coordinate.
int32 y = 2
The vertical coordinate. This is the physical location on the screen For example 0 indicates the top left coordinate.
int32 identifier = 3
The identifier is an arbitrary non-negative integer that is used to identify and track each tool independently when multiple tools are active. For example, when multiple fingers are touching the device, each finger should be assigned a distinct tracking id that is used as long as the finger remains in contact. Tracking ids may be reused when their associated tools move out of range. The emulator currently supports up to 10 concurrent touch events. The identifier can be any uninque value and will be mapped to the next available internal identifier.
int32 pressure = 4
Reports the physical pressure applied to the tip of the tool or the signal strength of the touch contact. The values reported must be non-zero when the tool is touching the device and zero otherwise to indicate that the touch event is completed. Make sure to deliver a pressure of 0 for the given identifier when the touch event is completed, otherwise the touch identifier will not be unregistered!
int32 touch_major = 5
Optionally reports the cross-sectional area of the touch contact, or the length of the longer dimension of the touch contact.
int32 touch_minor = 6
Optionally reports the length of the shorter dimension of the touch contact. This axis will be ignored if touch_major is reporting an area measurement greater than 0.
Touch.EventExpiration expiration = 7
Used in:
EVENT_EXPIRATION_UNSPECIFIED = 0
The system will use the default time of 120s to track the touch event with the given identifier. If no update happens within this timeframe the identifier is considered expired and can be made available for re-use. This means that a touch event with pressure 0 for this identifier will be send to the emulator.
NEVER_EXPIRE = 1
Never expire the given slot. You must *ALWAYS* close the identifier by sending a touch event with 0 pressure.
message
emulator_controller.proto:456Information about the hypervisor that is currently in use.
Used in:
VmConfiguration.VmHypervisorType hypervisorType = 1
int32 numberOfCpuCores = 2
int64 ramSizeBytes = 3
Used in:
UNKNOWN = 0
An unknown hypervisor
NONE = 1
No hypervisor is in use. This usually means that the guest is running on a different CPU than the host, or you are using a platform where no hypervisor is available.
KVM = 2
The Kernel based Virtual Machine (https://www.linux-kvm.org/page/Main_Page)
HAXM = 3
Intel® Hardware Accelerated Execution Manager (Intel® HAXM) https://github.com/intel/haxm
HVF = 4
Hypervisor Framework. https://developer.apple.com/documentation/hypervisor
WHPX = 5
Window Hypervisor Platform https://docs.microsoft.com/en-us/virtualization/api/
GVM = 6
message
emulator_controller.proto:251A Run State that describes the state of the Virtual Machine.
Used as request type in: EmulatorController.setVmState
Used as response type in: EmulatorController.getVmState
VmRunState.RunState state = 1
Used in:
UNKNOWN = 0
The emulator is in an unknown state. You cannot transition to this state.
RUNNING = 1
Guest is actively running. You can transition to this state from the paused state.
RESTORE_VM = 2
Guest is paused to load a snapshot. You cannot transition to this state.
PAUSED = 3
Guest has been paused. Transitioning to this state will pause the emulator the guest will not be consuming any cpu cycles.
SAVE_VM = 4
Guest is paused to take or export a snapshot. You cannot transition to this state.
SHUTDOWN = 5
System shutdown, note that it is similar to power off. It tries to set the system status and notify guest. The system is likely going to disappear soon and do proper cleanup of resources, possibly taking a snapshot. This is the same behavior as closing the emulator by clicking the X (close) in the user interface.
TERMINATE = 7
Immediately terminate the emulator. No resource cleanup will take place. There is a good change to corrupt the system.
RESET = 9
Will cause the emulator to reset. This is not a state you can observe.
INTERNAL_ERROR = 10
Guest experienced some error state, you cannot transition to this state.