Skip to content

เริ่มต้นใช้งาน LBMA Mobile SDK

This content is not available in your language yet.

lbma_sdk เป็นแพ็กเกจ Flutter สำหรับอ่านและจัดกลุ่มข้อมูล beacon ที่แอปส่งให้ แพ็กเกจมีสัญญา BeaconScanner, ตัวอ่าน BeaconParser และ BeaconRegionMonitor แต่ไม่มีตัวสแกน Bluetooth สำหรับอุปกรณ์จริงให้โดยตรง

นักพัฒนาแอป Flutter ที่ใช้ workspace ของ AIYA และมี platform adapter ซึ่งทำตาม BeaconScanner

  1. ในแอปที่อยู่ใต้ apps/<ชื่อแอป> เพิ่ม dependency แบบ local workspace:

    dependencies:
    lbma_sdk:
    path: ../../packages/lbma_sdk

    จาก root ของ workspace ให้รัน flutter pub get เพื่อ resolve dependency

  2. import entrypoint ของแพ็กเกจ:

    import 'package:lbma_sdk/lbma_sdk.dart';
  3. สร้าง 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 เริ่มสแกนไม่ได้
    }
  4. เมื่อเลิกใช้ ให้ยกเลิก subscription และปิด monitor:

    await events.cancel();
    await monitor.dispose();
  5. ใน 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