NearbyDevice-v1

A Barion wikiből
  • Tervezet
  • Üzlet
  • Informatika
  • Pénzügy
  • Jog
  • 99%
  • Online elfogadó
  • Mobil elfogadó
  • Pénztárgép
  • Feltöltés
  • Piactér
  • Nonprofit
  • Parkolas

Értesítés közelben levő eszközökről

SIGNALR NearbyDevice

Erre a SignalR metódusra feliratkozva tudunk értesítést kapni a Barion rendszerétől arról, ha valaki a közelünkben érzékelte a sugárzott Bluetooth azonosítónkat. Ez különösen akkor hasznos, ha olyan eszközökről kapunk így értesítést, amelyek nem képesek Bluetooth sugárzásra. Ezek az eszközök viszont érzékelik a mi sugárzás képes készülékünk azonosítóit és azokat a szerverre felküldve közvetetten értesíteni tudnak minket is jelenlétükről.

A Barion mobilalkalmazás ezt az értesítést használja, hogy megjelenítse a közelben lévő Barion felhasználókat.

Beérkező adatok

A beérkező adat a minket érzékelő készülék publikus adatait leíró objektum.

Mező Típus Leírás Formátum / Példa
Beacon BluetoothSignal A készülék iBeacon azonosítói.
{
     MajorId: 1,
     MinorId: 77849
}
EmailAddress string A felhasználó e-mail címe. balaton@example.com
ShopName string Amennyiben a készülék bolthoz tartozik, akkor a bolt neve. "Balaton Étterem Kft."
ShopId GUID Amennyiben a készülék bolthoz tartozik, a bolt azonosítója. "ff837a04-6fed-477b-b4f1-57e61c768a5b"
IsPerson bool Személyhez tartozik-e az eszköz. false
UserName string Felhasználónév. Jelen pillanatban megegyezik az email címmel. balaton@example.com
FullName string A készülék teljes neve. Ha a készülék bolthoz tartozik, akkor a bolt neve, ha személyhez, akkor az illető teljes neve. A megjelenítéshez használható. "Balaton Étterem Kft."

A beérkezett készülék információt érdemes csak egy időre megtartanunk. A Barion nem küld arról értesítést, ha egy adott készülék már nem érzékel minket. Itt magunknak kell arról gondoskodni, hogy ha egy ideje már nem kaptunk indformációt egy készülékről, akkor azt vegyük ki a nyilvántartásunkból, mert valószínűleg már nem érzékel minket.

Példák

Az alábbi példában javascriptből kapcsolódunk a Barion HUB-hoz és feliratkozik a NewTransaction metódusra.

var barionSignalR = 'https://api.barion.com/barionsignal';
var barionHubName = 'barionHub';
 
// A kapcsolat definiálása
var myConnection = $.hubConnection(barionSignalR);
 
// A proxy létrehozása
var barionHubProxy = myConnection.createHubProxy(barionHubName);
 
// Feliratkozás
barionHubProxy.on('nearbyDevice', function (deviceInformation) {
      console.log(deviceInformation);
});
 
// Kapcsolat felépítése
myConnection.start().done(function () {
 
   // The connection is established here...
 
});

A fenti példában a deviceInformation objektumban a következő érték van:

{
    Beacon: {
          MajorId: 1,
         MinorId: 233
    },
    EmailAddress: "szabo@example.com",
    FullName: "Szabó Klára"
    ShopName: null,
    ShopId: 0,
    IsPerson: true,
    UserName: "szabo@example.com",
 
}