Added in API level 34

Summary: Nested Classes | Methods | Inherited Methods

VirtualDeviceManager

---

Kotlin |Java

public final class VirtualDeviceManager
extends Object

java.lang.Object
↳	android.companion.virtual.VirtualDeviceManager

---

System level service for creation and management of virtual devices.

VirtualDeviceManager enables interactive sharing of capabilities between the host Android device and a remote device.

Not to be confused with the Android Studio's Virtual Device Manager, which allows for device emulation.

Summary

Nested classes
interface	VirtualDeviceManager.VirtualDeviceListener Listener for changes in the available virtual devices.

Public methods
VirtualDevice	getVirtualDevice(int deviceId) Returns the details of the virtual device with the given ID, if any.
List<VirtualDevice>	getVirtualDevices() Returns the details of all available virtual devices.
void	registerVirtualDeviceListener(Executor executor, VirtualDeviceManager.VirtualDeviceListener listener) Registers a virtual device listener to receive notifications when virtual devices are created or closed.
void	unregisterVirtualDeviceListener(VirtualDeviceManager.VirtualDeviceListener listener) Unregisters a virtual device listener previously registered with registerVirtualDeviceListener(Executor, VirtualDeviceListener).

Inherited methods

From class java.lang.Object Object clone() Creates and returns a copy of this object. boolean equals(Object obj) Indicates whether some other object is "equal to" this one. void finalize() Called by the garbage collector on an object when garbage collection determines that there are no more references to the object. final Class<?> getClass() Returns the runtime class of this Object. int hashCode() Returns a hash code value for the object. final void notify() Wakes up a single thread that is waiting on this object's monitor. final void notifyAll() Wakes up all threads that are waiting on this object's monitor. String toString() Returns a string representation of the object. final void wait(long timeoutMillis, int nanos) Causes the current thread to wait until it is awakened, typically by being notified or interrupted, or until a certain amount of real time has elapsed. final void wait(long timeoutMillis) Causes the current thread to wait until it is awakened, typically by being notified or interrupted, or until a certain amount of real time has elapsed. final void wait() Causes the current thread to wait until it is awakened, typically by being notified or interrupted.

Public methods

getVirtualDevice

Added in API level 35

public VirtualDevice getVirtualDevice (int deviceId)

Returns the details of the virtual device with the given ID, if any.

The returned object is a read-only representation of the virtual device that expose its properties.

Note that if the virtual device is closed and becomes invalid, the returned object will not be updated and may contain stale values. Use a VirtualDeviceListener for real time updates of the availability of virtual devices.

Parameters
deviceId	int

Returns
VirtualDevice	the virtual device with the requested ID, or null if no such device exists or it has already been closed.

getVirtualDevices

Added in API level 34

public List<VirtualDevice> getVirtualDevices ()

Returns the details of all available virtual devices.

The returned objects are read-only representations that expose the properties of all existing virtual devices.

Note that if a virtual device is closed and becomes invalid, the returned objects will not be updated and may contain stale values.

Returns
List<VirtualDevice>	This value cannot be null.

registerVirtualDeviceListener

Added in API level 35

public void registerVirtualDeviceListener (Executor executor, 
                VirtualDeviceManager.VirtualDeviceListener listener)

Registers a virtual device listener to receive notifications when virtual devices are created or closed.

Parameters
executor	Executor: The executor where the listener is executed on. This value cannot be null. Callback and listener events are dispatched through this Executor, providing an easy way to control which thread is used. To dispatch events through the main thread of your application, you can use Context.getMainExecutor(). Otherwise, provide an Executor that dispatches to an appropriate thread.
listener	VirtualDeviceManager.VirtualDeviceListener: The listener to add. This value cannot be null.

See also:

• unregisterVirtualDeviceListener(VirtualDeviceListener)

unregisterVirtualDeviceListener

Added in API level 35

public void unregisterVirtualDeviceListener (VirtualDeviceManager.VirtualDeviceListener listener)

Unregisters a virtual device listener previously registered with registerVirtualDeviceListener(Executor, VirtualDeviceListener).

Parameters
listener	VirtualDeviceManager.VirtualDeviceListener: The listener to unregister. This value cannot be null.

See also:

• registerVirtualDeviceListener(Executor, VirtualDeviceListener)