CompanionDeviceManager.StartObservingDevicePresence(String) Method
Definition
Important
Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.
Register to receive callbacks whenever the associated device comes in and out of range.
[Android.Runtime.Register("startObservingDevicePresence", "(Ljava/lang/String;)V", "", ApiSince=31)]
[Android.Runtime.RequiresPermission("android.permission.REQUEST_OBSERVE_COMPANION_DEVICE_PRESENCE")]
public void StartObservingDevicePresence (string deviceAddress);
[<Android.Runtime.Register("startObservingDevicePresence", "(Ljava/lang/String;)V", "", ApiSince=31)>]
[<Android.Runtime.RequiresPermission("android.permission.REQUEST_OBSERVE_COMPANION_DEVICE_PRESENCE")>]
member this.StartObservingDevicePresence : string -> unit
Parameters
- deviceAddress
- String
a previously-associated companion device's address
- Attributes
Remarks
Register to receive callbacks whenever the associated device comes in and out of range.
The provided device must be #associate associated
with the calling app before calling this method.
Caller must implement a single CompanionDeviceService
which will be bound to and receive callbacks to CompanionDeviceService#onDeviceAppeared
and CompanionDeviceService#onDeviceDisappeared
. The app doesn't need to remain running in order to receive its callbacks.
Calling app must declare uses-permission android.Manifest.permission#REQUEST_OBSERVE_COMPANION_DEVICE_PRESENCE
.
Calling app must check for feature presence of PackageManager#FEATURE_COMPANION_DEVICE_SETUP
before calling this API.
For Bluetooth LE devices, this is based on scanning for device with the given address. The system will scan for the device when Bluetooth is ON or Bluetooth scanning is ON.
For Bluetooth classic devices this is triggered when the device connects/disconnects. WiFi devices are not supported.
If a Bluetooth LE device wants to use a rotating mac address, it is recommended to use Resolvable Private Address, and ensure the device is bonded to the phone so that android OS is able to resolve the address.
Portions of this page are modifications based on work created and shared by the Android Open Source Project and used according to terms described in the Creative Commons 2.5 Attribution License.