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