Help / WLanguage / WLanguage functions / Communication / Beacon functions
  • Properties specific to beaconDetectionInfo variables
  • Reinitialization
  • Functions that use variables of type beaconDetectionInfo
WindowsLinuxUniversal Windows 10 AppJavaReports and QueriesUser code (UMC)
WindowsLinuxPHPWEBDEV - Browser code
AndroidAndroid Widget iPhone/iPadIOS WidgetApple WatchMac CatalystUniversal Windows 10 App
Stored procedures
The beaconDetectionInfo type is used to describe the information relative to a Beacon detected with BeaconDetectPrecise. The characteristics of this Beacon can be read using different WLanguage properties.
Remark: For more details on the declaration of this type of variable and the use of WLanguage properties, see Declaring a variable.
// Start detecting tags
BeaconDetectPrecise(group, ProcDetection)
INTERNAL PROCÉDURE ProcDetection(arrInfo is array of beaconDetectionInfo)
nMinDistance is int
NearestBeacon is beaconDetectionInfo
FOR EACH MyInfo OF arrInfo
IF nMinDistance = 0 _OR_ MyInfo..Distance < nMinDistance
NearestBeacon = Info

Properties specific to beaconDetectionInfo variables

The following properties can be used to handle a variable of type beaconDetectionInfo:
Property nameType usedEffect
DistanceRealDistance (in meters) between the device and the Beacon. The accuracy of the measurement can vary from one device to another but also if the Beacon is in a closed space (e.g., a bag).
This property is read-only.
iPhone/iPadIOS WidgetMac Catalyst Information not available. Therefore, the call to ..Distance will always return -1 (invalid value).
MajorIntegerMajor number of the Beacon (integer between 0 and 65535).
This property is read-only.
MinorIntegerMinor number of the Beacon (integer between 0 and 65535).
This property is read-only.
ProximityInteger constantProximity of the Beacon to the device:
  • biDistant: tag beyond 3 meters.
  • biNear: Beacon between 0.5 m (1.6 ft) and 3 meters (9.8 ft).
  • biVeryClose: Beacon within 0.5 m (1.6 ft).
This property is read-only.
UUIDCharacter stringIdentifier (or Proximity UUID) associated with the Beacon. In most cases, this identifier corresponds to the organization or to the person to which the Beacon belongs.
This identifier includes 32 hexadecimal digits separated into 5 groups. Each group must contain the following number of digits:
  • 1st group: 8 digits.
  • 2nd group: 4 digits.
  • 3rd group: 4 digits.
  • 4th group: 4 digits.
  • 5th group: 12 digits.
The different groups are separated by a dash.
Example of valid identifier: f4231ab6-5ef2-6c99-4229-af6c72e0446e
This property is read-only.


You can use VariableReset to reset the contents of a variable of type beaconDetectionInfo.

Functions that use variables of type beaconDetectionInfo

BeaconDetectBackgroundNotifies the application when the device enters or leaves the transmission range of a set of Beacons.
BeaconDetectPreciseUsed to find the Beacons near the device.
BeaconStopBackgroundDetectionStops one or more Beacon detections in the background.
Minimum version required
  • Version 23
Click [Add] to post a comment

Last update: 06/28/2023

Send a report | Local help