ONLINE HELP
 WINDEVWEBDEV AND WINDEV MOBILE

Help / WLanguage / WLanguage functions / Communication / Beacon functions
  • Properties specific to beaconGroup variables
  • Reinitialization
  • Functions that use beaconGroup variables
WINDEV
WindowsLinuxUniversal Windows 10 AppJavaReports and QueriesUser code (UMC)
WEBDEV
WindowsLinuxPHPWEBDEV - Browser code
WINDEV Mobile
AndroidAndroid Widget iPhone/iPadIOS WidgetApple WatchMac CatalystUniversal Windows 10 App
Others
Stored procedures
The beaconGroup type is used to define the advanced characteristics for a set of Beacons. The characteristics of this set of Beacons can be defined and changed via 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.
Reminder: Beacons use Bluetooth Low Energy technology to emit a triplet of values:
  • UUID (Universally Unique Identifier, also known as Proximity UUID): unique identifier that generally represents the organization or the person to which the Beacon belongs.
  • Major: number used to identify a group of Beacons within the same organization (same UUID)
  • Minor: number used to identify a specific Beacon within the same group (same UUID and same Major number).
This triplet is used to identify the Beacon in a unique way.
by using the first value or the first two values of the triplet, you can determine whether a Beacon belongs to an organization and/or to a sub-group of this organization.
Example
// Group of all Beacons from the same organization
group is beaconGroup
group.UUID = "f4231ab6-5ef2-6c99-4229-af6c72e0446e"
 
// Group of all Beacon tags belonging to the same organization with Major number 5
group is beaconGroup
group.UUID = "f4231ab6-5ef2-6c99-4229-af6c72e0446e"
group.Major = 5
 
// Unique Beacon
group is beaconGroup
group.UUID = "f4231ab6-5ef2-6c99-4229-af6c72e0446e"
group.Major = 5
group.Minor = 1
Remarks

Properties specific to beaconGroup variables

The following properties can be used to handle a group of Beacons:
Property nameType usedEffect
DescriptionCharacter stringDescription of the group of Beacons.
MajorIntegerInteger included between -1 and 65535 describing the Major number of the group of Beacons.
  • The default property value is set to -1. This value means that the Major number will be ignored to determine whether a Beacon belongs to the group.
  • If the value of this property has been specified (other than -1), the UUID property must also be specified.
MinorIntegerInteger included between -1 and 65535 describing the Minor number of the group of Beacons.
  • The default property value is set to -1. This value means that the Minor number will be ignored to determine whether a Beacon belongs to the group.
  • If the value of this property has been specified (other than -1), the UUID and Major properties must also be specified.
UUIDCharacter stringIdentifier (GUID) common to Beacons of the group. 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 identifier is mandatory in order for the group to be valid.

Reinitialization

You can use VariableReset to reset the content of a beaconGroup variable.

Functions that use beaconGroup 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: 06/28/2023

Send a report | Local help