beaconGroup (Type of variable)

ONLINE HELP
WINDEV, WEBDEV AND WINDEV MOBILE

Version:

Home | Sign in | English

Properties specific to the description of beaconGroup variables
Reinitialization
Functions that use the beaconGroup variables

WINDEV

WEBDEV

WINDEV Mobile

Others

See also

beaconGroup (Type of variable)

In french: beaconGroupe

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 modified via different WLanguage properties.

Remark: See Declaring a variable for more details on the declaration of this type of variable and the use of WLanguage properties.

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 the description of beaconGroup variables

The following properties can be used to handle a group of Beacons:

Property name	Type used	Effect

Description	Character string	Description of the group of Beacons.
Major	Integer	Integer 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.
Minor	Integer	Integer 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.
UUID	Character string	Identifier (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

To reinitialize the content of a beaconGroup variable, you have the ability to use VariableReset.

Functions that use the beaconGroup variables


Versions 23 and later BeaconDetectBackground New in version 23 BeaconDetectBackground BeaconDetectBackground	Notifies the application when the device enters or leaves the transmission range of a set of Beacons.
Versions 23 and later BeaconDetectPrecise New in version 23 BeaconDetectPrecise BeaconDetectPrecise	Used to find the Beacons near the device.
Versions 23 and later BeaconStopBackgroundDetection New in version 23 BeaconStopBackgroundDetection BeaconStopBackgroundDetection	Stops one or more Beacon detections in the background.