เริ่มต้นใช้งาน LBMA Mobile SDK
ใช้ทำอะไร
หัวข้อที่มีชื่อว่า “ใช้ทำอะไร”lbma_sdk เป็นแพ็กเกจ Flutter สำหรับอ่านและจัดกลุ่มข้อมูล beacon ที่แอปส่งให้ แพ็กเกจมีสัญญา BeaconScanner, ตัวอ่าน BeaconParser และ BeaconRegionMonitor แต่ไม่มีตัวสแกน Bluetooth สำหรับอุปกรณ์จริงให้โดยตรง
ผู้ที่ใช้ได้
หัวข้อที่มีชื่อว่า “ผู้ที่ใช้ได้”นักพัฒนาแอป Flutter ที่ใช้ workspace ของ AIYA และมี platform adapter ซึ่งทำตาม BeaconScanner
ทำยังไง
หัวข้อที่มีชื่อว่า “ทำยังไง”-
ในแอปที่อยู่ใต้
apps/<ชื่อแอป>เพิ่ม dependency แบบ local workspace:dependencies:lbma_sdk:path: ../../packages/lbma_sdkจาก root ของ workspace ให้รัน
flutter pub getเพื่อ resolve dependency -
import entrypoint ของแพ็กเกจ:
import 'package:lbma_sdk/lbma_sdk.dart'; -
สร้าง platform adapter ของแอปที่ implement
BeaconScannerแล้วส่งให้ monitor ฟัง event ก่อนเริ่มสแกน:final BeaconScanner scanner = appBeaconScanner;final monitor = BeaconRegionMonitor(scanner: scanner);final events = monitor.events.listen((event) {final beacon = event.beacon;// จัดการ event ในแอปของคุณ});final started = await monitor.start();if (!started) {// แสดงสถานะที่เหมาะสมเมื่อ adapter เริ่มสแกนไม่ได้} -
เมื่อเลิกใช้ ให้ยกเลิก subscription และปิด monitor:
await events.cancel();await monitor.dispose(); -
ใน unit test หรือการทดลองที่ไม่ใช้วิทยุ ใช้
FakeBeaconScannerกับRecordedBeaconFramesแทน adapter จริง
ข้อควรรู้
หัวข้อที่มีชื่อว่า “ข้อควรรู้”lbma_sdkเป็นแพ็กเกจใน monorepo และตั้งpublish_to: none; ตัวอย่าง path dependency นี้ใช้กับแอปใน workspace ตามโครงสร้างข้างต้นBeaconScannerเป็น interface เท่านั้น แอปต้องจัดการ Bluetooth, lifecycle และสิทธิ์ของระบบปฏิบัติการเองFakeBeaconScannerใช้ทดสอบข้อมูลตัวอย่าง ไม่ได้สแกน beacon จริง- หากแอปเลือกส่ง event ออกไป ให้ใช้
BeaconEventSinkที่แอปเป็นผู้กำหนด;RetryingBeaconEventUploaderช่วยลองส่งซ้ำ แต่ไม่ได้เชื่อมเครือข่ายให้เอง - API และรายละเอียด event อยู่ในหน้า Beacon events ส่วนสิทธิ์ระบบอยู่ในหน้า Android และ iOS