System.Beacon.Components.TCustomBeacon.OnParseManufacturerData
Delphi
property OnParseManufacturerData: TParseManufacturerDataEvent read FOnParseManufacturerData write FOnParseManufacturerData;
C++
__property System::Beacon::TParseManufacturerDataEvent OnParseManufacturerData = {read=FOnParseManufacturerData, write=FOnParseManufacturerData};
Properties
| Type | Visibility | Source | Unit | Parent |
|---|---|---|---|---|
| event | public | System.Beacon.Components.pas System.Beacon.Components.hpp |
System.Beacon.Components | TCustomBeacon |
Description
Occurs when the Bluetooth Low Energy manager discovers a device, and lets you parse the manufacturer-specific data in the advertising data of the discovered device.
Bluetooth Low Energy devices can advertise themselves so that other Bluetooth Low Energy devices, such as yours, can discover them. Beacons are Bluetooth Low Energy devices that include manufacturer-specific data in their advertising data that allows you to determine the distance between the beacon and your Bluetooth Low Energy device.
The format of that manufacturer-specific data usually follows one of two widely-used standards, either iBeacon or AltBeacon. The beacon component supports those standards, and it can successfully parse any manufacturer-specific data that follows either one of them, as long as you previously configure the right standard to use.
However, there may be beacons that do not follow any of those standards, and provide their data in a format of their own. If that is the case of your beacons, you can implement an event handler for OnParseManufacturerData that parses the incoming manufacturer-specific data and fills a beacon information record.
The event handler of OnParseManufacturerData receives the following parameters:
Senderis your beacon component.ADatais the manufacturer-specific data from the advertising data of a discovered Bluetooth Low Energy device.AData_Highis the number of bytes inAData.BeaconInfois an instance of TBeaconInfo that you must fill from the data inAData.Handleddetermines whether your event handler successfully parsed the input data and filledBeaconInfowith the required information (True) or your event handler expects the default parser of the beacon component to parse the input data instead (False).HandledisFalseby default, make sure that you change its value toTrueafter you successfully parse the input data.
As a starting point for your event handler, check the implementation of the existing parser functions for the supported standards. See TStandardBeaconParser.Parse and TAlternativeBeaconParser.Parse on the platform-specific System.Beacon.Common.pas unit that implements the beacon API for platforms other than iOS. You can find this unit on the C:\Program Files (x86)\Embarcadero\Studio\22.0\source\rtl\net folder.