ProjectedDeviceController
@ExperimentalProjectedApi
public final class ProjectedDeviceController implements AutoCloseable
Controller for the Projected device.
Use create to create an instance of this class. Call close when finished with this instance to release resources.
Summary
Nested types |
|---|
public final class ProjectedDeviceController.CapabilityRepresents an intrinsic piece of functionality of a Projected device, i.e., what it is capable of. |
Public methods |
|
|---|---|
final void |
addBatteryStateChangedListener(Adds a listener for battery state changes. |
void |
close()Releases resources, unregistering any active listeners. |
static final @NonNull ProjectedDeviceController |
@RequiresApi(value = 34)Connects to the service providing features for Projected devices and returns the |
final @NonNull List<@NonNull AudioDeviceInfo> |
Returns the list of |
final @NonNull Set<@NonNull ProjectedDeviceController.Capability> |
The capabilities of the Projected device. |
final void |
removeBatteryStateChangedListener(Removes a previously added listener. |
Public methods
addBatteryStateChangedListener
public final void addBatteryStateChangedListener(
@NonNull CoroutineContext context,
@NonNull Function1<@NonNull BatteryState, Unit> listener
)
Adds a listener for battery state changes.
The listener lambda will be executed in a new coroutine launched within the provided context. The listener will be automatically unregistered when the context's Job is canceled.
close
public void close()
Releases resources, unregistering any active listeners. This instance should not be used after calling close.
create
@RequiresApi(value = 34)
public static final @NonNull ProjectedDeviceController create(@NonNull Context context)
Connects to the service providing features for Projected devices and returns the ProjectedDeviceController when the connection is established. The caller is responsible for calling close on the returned instance when it's no longer needed to release all internal resources.
| Throws | |
|---|---|
IllegalStateException |
if the projected service is not found or binding is not permitted |
getAudioDevices
public final @NonNull List<@NonNull AudioDeviceInfo> getAudioDevices()
Returns the list of AudioDeviceInfo objects associated with the projected device.
getCapabilities
public final @NonNull Set<@NonNull ProjectedDeviceController.Capability> getCapabilities()
The capabilities of the Projected device.
These capabilities represent intrinsic functionality of the device that will not change over the lifetime of the device, for example, whether the device is capable of showing a visual user interface at all, regardless of whether the screen is currently on or off.
removeBatteryStateChangedListener
public final void removeBatteryStateChangedListener(
@NonNull Function1<@NonNull BatteryState, Unit> listener
)
Removes a previously added listener. Note: Listeners are also automatically removed when their associated CoroutineScope is canceled.