beaconGroup (Type of variable)

WINDEV, WEBDEV AND WINDEV MOBILE
ONLINE HELP

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 Beacon tags. The characteristics of this set of Beacon tags can be defined and modified by several WLanguage properties.

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

Reminder: The Beacon tags are using the Bluetooth Low Energy technology to emit a triplet of values:

UUID (Universally Unique Identifier, also known as Proximity UUID): unique identifier representing the organization or the person to which the tag belongs.
Major: number used to identify a group of tags within the same organization (same UUID)
Minor: number used to identify a specific tag within the same group (same UUID and same Major number).

This triplet is used to identify the Beacon tag in a unique way.

by using the first value or the first two values of triplet, you have the ability to define whether a Beacon tag belongs to an organization and/or to a sub-group of this organization.

Example

// Group of all Beacon tags belonging to 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 tag
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 Beacon tags:

Property name	Type used	Effect

Description	Character string	Description of group of Beacon tags.
Major	Integer	Integer included between -1 and 65535 describing the Major number for the group of tags. The default property value is set to -1. This value means that the Major number will be ignored to define whether a tag belongs to the group. If the property value was specified (other than -1), ..UUID must also be specified.
Minor	Integer	Integer included between -1 and 65535 describing the Minor number for the group of tags. The default property value is set to -1. This value means that the Minor number will be ignored to define whether a tag belongs to the group. If the property value was specified (other than -1), ..UUID and ..Major must also be specified.
UUID	Character string	Identifier (GUID) common to the group tags. 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.

Note: These properties can be handled by using one of the following syntaxes:

<Variable name>..<Property name>
<Variable name>.<Property name>

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	Allows the application to be notified when the device enters into or exits from an area corresponding to the emission radius of a set of Beacon tags.
Versions 23 and later BeaconDetectPrecise New in version 23 BeaconDetectPrecise BeaconDetectPrecise	Used to find the Beacon tags nearby the device.
Versions 23 and later BeaconStopBackgroundDetection New in version 23 BeaconStopBackgroundDetection BeaconStopBackgroundDetection	Stops one or more detections of Beacon tags in background.