ข้ามไปยังเนื้อหา

สิทธิ์ Bluetooth และตำแหน่งบน Android และ iOS

หน้านี้แยก interface ของ lbma_sdk ออกจากสิทธิ์ระบบที่แอปต้องจัดการก่อนใช้ Bluetooth Low Energy

นักพัฒนาแอป Flutter ที่กำลังเขียนหรือเลือก platform scanner adapter

  1. ให้ adapter ของแอปตรวจแพลตฟอร์มและขอสิทธิ์ขณะใช้งานตามการสแกนที่แอปต้องทำ ก่อนคืนผลจาก BeaconScanner.start()
  2. Android 12 ขึ้นไป: ตรวจ declaration และ runtime flow ของ BLUETOOTH_SCAN กับ BLUETOOTH_CONNECT ในแอปโฮสต์ให้ตรงกับรูปแบบการสแกนและ Android SDK ที่ใช้
  3. iOS: เพิ่มข้อความอธิบายการใช้ Bluetooth ใน NSBluetoothAlwaysUsageDescription แล้วทดสอบ prompt จากการเริ่มสแกนบนอุปกรณ์จริง
  4. ขอสิทธิ์ตำแหน่งเบื้องหลังหรือการแจ้งเตือนเฉพาะเมื่อฟีเจอร์ของแอปต้องใช้ และจัดทำ flow ขอสิทธิ์เพิ่มเติมแยกจากการสแกน foreground
  5. หาก adapter เริ่มไม่ได้ ให้แอปจัดการผล false จาก start() และอธิบายวิธีเปิดสิทธิ์ใน Settings ตามแพลตฟอร์ม
  • lbma_sdk เองไม่มี plugin ขอสิทธิ์ ไม่มีหน้าขอสิทธิ์ และไม่เริ่มสแกนวิทยุ; BeaconScanner ระบุให้ platform adapter รับผิดชอบ permission และ lifecycle
  • ตัวอย่าง Fardago ใน source ปัจจุบันประกาศ BLUETOOTH_SCAN และ BLUETOOTH_CONNECT; โค้ด Android ยังขอ locationWhenInUse ร่วมด้วย จึงไม่ควรนำลำดับหรือเงื่อนไขนี้ไปใช้เป็น flow มาตรฐานของแอปอื่นโดยไม่ตรวจสอบกับผู้ดูแล SDK
  • Info.plist ของ Fardago มีคำอธิบาย Bluetooth และตำแหน่ง พร้อม background modes bluetooth-central และ location; foreground ใช้ system prompt ของ CoreBluetooth ส่วน background service ยังไม่มีหน้าขอ Always permission แบบเป็นขั้น และยังไม่มีหลักฐานทดสอบบนอุปกรณ์จริง
  • โน้ต iOS ของแพ็กเกจเป็น implementation notes ไม่ใช่ adapter ที่ส่งมาพร้อม lbma_sdk หรือหลักฐานว่า permission flow ผ่านการยอมรับบนอุปกรณ์
  • ความต้องการจริงขึ้นกับแพลตฟอร์ม, เวอร์ชันระบบ, foreground/background behavior และ adapter ที่เลือก ตรวจเอกสาร platform ล่าสุดก่อนปล่อยแอป

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