Skip to content

Beacon events

This content is not available in your language yet.

BeaconParser แปลง BeaconFrame เป็น BeaconHit เมื่อพบรูปแบบที่รองรับ ส่วน BeaconRegionMonitor รวมการพบ beacon ต่อเนื่องเป็น enter, dwell (ถ้ากำหนด) และ exit event ให้แอป

นักพัฒนาที่ต่อ BeaconScanner adapter ของแอปเข้ากับ BeaconRegionMonitor

  1. ส่ง frame จาก scanner ให้ BeaconParser.parse(frame) เมธอดคืน BeaconHit เมื่ออ่านรูปแบบที่รองรับ หรือคืน null เมื่อไม่รู้จัก
  2. ส่ง scanner ให้ BeaconRegionMonitor และฟัง monitor.events ก่อนเรียก start()
  3. ตรวจ event.type ซึ่งเป็น RegionEventType.enter, RegionEventType.dwell หรือ RegionEventType.exit แล้วอ่าน event.beacon เพื่อใช้ uuid, major, minor, rssi และ hwid ที่อาจมี
  4. กำหนด dwellAfter เมื่อต้องการ event dwell; ถ้าไม่ส่งค่านี้จะไม่มี dwell event โดย monitor ตั้งเวลา dwell หนึ่งครั้งต่อการเข้าพื้นที่แต่ละครั้ง
  5. ถ้าไม่มี frame ใหม่ก่อน exitAfter หมดเวลา monitor จะยกเลิก timer ของ dwell และส่ง exit; stop() และ dispose() ยกเลิก timer ที่ค้างโดยไม่ส่ง exit
  6. เรียก stop() เมื่อต้องการหยุดชั่วคราว หรือ dispose() เมื่อเลิกใช้ monitor
  • parser รองรับ iBeacon ที่ใช้ Apple manufacturer ID 0x004C และ prefix 02 15 รวมถึง LINE service UUID FE6F
  • LINE parser ปัจจุบันอ่าน payload bytes 1-5 เป็น HWID อักขระฐานสิบหกตัวพิมพ์เล็ก 10 ตัว และไม่ได้ตรวจ frame type ก่อนอ่าน
  • monitor เริ่ม enter หลังพบ beacon เดิม 2 ครั้งตามค่าเริ่มต้น และส่ง exit เมื่อไม่มี frame เดิมเข้ามา 10 วินาทีตามค่าเริ่มต้น ทุก frame ที่ตรงกันจะเริ่มนับเวลาการออกใหม่ แต่ไม่เริ่มนับ dwell ใหม่
  • dwellAfter เริ่มนับเมื่อเกิด enter และส่ง event ได้ครั้งเดียวต่อ visit; ถ้า timer exitAfter หมดก่อน dwell จะถูกยกเลิก
  • BeaconEventSink เป็น interface ปลายทางที่แอปต้อง implement เอง ส่วน RetryingBeaconEventUploader เรียก sink สูงสุด 3 ครั้งตามค่าเริ่มต้น โดยหน่วง 250 ms แล้ว 500 ms; หากล้มเหลวครบจะส่ง error ครั้งสุดท้ายกลับ
  • uploader ไม่ได้ส่ง network request เอง; แอปเป็นผู้กำหนด transport, consent และการจัดการข้อมูล
  • ค่าตัวอย่างใน RecordedBeaconFrames เป็น test vectors ไม่ใช่การบันทึกจากอุปกรณ์จริง

เริ่มต้นใช้งาน LBMA Mobile SDK · ความเป็นส่วนตัวและความยินยอม