You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
/// Returns information about Bluetooth devices using Apple Private APIs
479
+
///
480
+
/// Parameters:
481
+
/// * None
482
+
///
483
+
/// Returns:
484
+
/// * A table containing information about devices using private Apple APIs.
485
+
///
486
+
/// Notes:
487
+
/// * This function uses private Apple APIs - that means it can break without notice on any macOS version update. Please report breakage to us!
488
+
/// * This function will return information for all connected Bluetooth devices, but much of it will be meaningless for most devices
489
+
/// * The table contains the following keys:
490
+
/// * vendorID - Numerical identifier for the vendor of the device (Apple's ID is 76)
491
+
/// * productID - Numerical identifier for the device
492
+
/// * address - The bluetooth address of the device
493
+
/// * isApple - A string containing "YES" or "NO", depending on whether or not this is an Apple/Beats product, or a third party product
494
+
/// * name - A human readable string containing the name of the device
495
+
/// * batteryPercentSingle - For some devices this will contain the percentage of the battery (e.g. Beats headphones)
496
+
/// * batteryPercentCombined - We do not currently understand what this field represents, please report if you find a non-zero value here
497
+
/// * batteryPercentCase - Battery percentage of AirPods cases (note that this will often read 0 - the AirPod case sleeps aggressively)
498
+
/// * batteryPercentLeft - Battery percentage of the left AirPod if it is out of the case
499
+
/// * batteryPercentRight - Battery percentage of the right AirPod if it is out of the case
500
+
/// * buttonMode - We do not currently understand what this field represents, please report if you find a value other than 1
501
+
/// * micMode - For AirPods this corresponds to the microphone option in the device's Bluetooth options
502
+
/// * leftDoubleTap - For AirPods this corresponds to the left double tap action in the device's Bluetooth options
503
+
/// * rightDoubleTap - For AirPods this corresponds to the right double tap action in the device's Bluetooth options
504
+
/// * primaryBud - For AirPods this is either "left" or "right" depending on which bud is currently considered the primary device
505
+
/// * primaryInEar - For AirPods this is "YES" or "NO" depending on whether or not the primary bud is currently in an ear
506
+
/// * secondaryInEar - For AirPods this is "YES" or "NO" depending on whether or not the secondary bud is currently in an ear
507
+
/// * isInEarDetectionSupported - Whether or not this device can detect when it is currently in an ear
508
+
/// * isEnhancedDoubleTapSupported - Whether or not this device supports double tapping
509
+
/// * isANCSupported - We believe this likely indicates whether or not this device supports Active Noise Cancelling (e.g. Beats Solo)
510
+
/// * Please report any crashes from this function - it's likely that there are Bluetooth devices we haven't tested which may return weird data
511
+
/// * Many/Most/All non-Apple party products will likely return zeros for all of the battery related fields here, as will Apple HID devices. It seems that these private APIs mostly exist to support Apple/Beats headphones.
0 commit comments