ONLINE HELP
 WINDEVWEBDEV AND WINDEV MOBILE

This content has been translated automatically.  Click here  to view the French version.
Help / WLanguage / WLanguage functions / Communication / Beacon functions
  • Properties specific to beaconDetectionInfo variables
  • Reinitialization
  • Functions that use beaconDetectionInfo variables
WINDEV
WindowsLinuxJavaReports and QueriesUser code (UMC)
WEBDEV
WindowsLinuxPHPWEBDEV - Browser code
WINDEV Mobile
AndroidAndroid Widget iPhone/iPadIOS WidgetApple WatchMac Catalyst
Others
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.
Note: For more details on the declaration of this type of variable and the use of WLanguage properties, see Declaring a variable.
Example
// Lancement de la détection des balises
BeaconDetectPrecise(groupe, ProcDétection)
INTERNAL PROCEDURE ProcDétection(tabInfo is array of beaconDetectionInfo)
	nDistanceMin is int 
	BaliseLaPlusProche is beaconDetectionInfo
	FOR EACH MonInfo OF tabInfo
		IF nDistanceMin = 0 _OR_ MonInfo.Distance < nDistanceMin
			BaliseLaPlusProche = Info
		END
	END
END
Properties

Properties specific to beaconDetectionInfo variables

The following properties can be used to manipulate 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:
  • biEremote tag beyond 3 meters.
  • biProche tag between 0.5 and 3 metres.
  • biTrèsProche tag less than 0.5 meters away.
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 a valid identifier: f4231ab6-5ef2-6c99-4229-af6c72e0446e
This property is read-only.
Remarks

Reinitialization

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

Functions that use beaconDetectionInfo variables

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
Comments
Click [Add] to post a comment

Last update: 03/27/2025

Send a report | Local help