ตั้งค่าบลูทูธ

ก่อนที่แอปจะสื่อสารผ่านบลูทูธหรือบลูทูธพลังงานต่ำได้ คุณต้องยืนยันว่าอุปกรณ์รองรับบลูทูธ และหากรองรับ ให้ตรวจสอบว่าได้เปิดใช้บลูทูธแล้ว โปรดทราบว่าการตรวจสอบนี้จำเป็นเฉพาะในกรณีที่ตั้งค่าแอตทริบิวต์ android:required ในรายการไฟล์ Manifest <uses-feature.../> เป็น false

หากไม่รองรับบลูทูธ คุณควรปิดใช้ฟีเจอร์บลูทูธอย่างเหมาะสม หากอุปกรณ์รองรับบลูทูธแต่ปิดอยู่ คุณสามารถขอให้ผู้ใช้เปิดใช้บลูทูธโดยไม่ต้องออกจากแอป

ขั้นตอนแรกคือการเพิ่มสิทธิ์บลูทูธลงในไฟล์ Manifest เพื่อใช้ API ต่อไปนี้

เมื่อมีสิทธิ์แล้ว การตั้งค่าบลูทูธจะเสร็จสมบูรณ์ใน 2 ขั้นตอนโดยใช้ BluetoothAdapter ดังนี้

  1. ดาวน์โหลด BluetoothAdapter

    ต้องใช้ BluetoothAdapter สำหรับกิจกรรมบลูทูธทั้งหมด BluetoothAdapter แสดงถึงอะแดปเตอร์บลูทูธของอุปกรณ์เอง (วิทยุบลูทูธ) หากต้องการรับ BluetoothAdapter คุณต้องมี Context ก่อน ใช้บริบทนี้เพื่อรับอินสแตนซ์ของบริการระบบ BluetoothManager การเรียกใช้ BluetoothManager#getAdapter จะให้ผลลัพธ์เป็นออบเจ็กต์ BluetoothAdapter หาก getAdapter() แสดงค่า Null แสดงว่าอุปกรณ์ไม่รองรับบลูทูธ

    เช่น

    Kotlin

    val bluetoothManager: BluetoothManager = getSystemService(BluetoothManager::class.java)
    val bluetoothAdapter: BluetoothAdapter? = bluetoothManager.getAdapter()
    if (bluetoothAdapter == null) {
        // Device doesn't support Bluetooth
    }
    

    Java

    BluetoothManager bluetoothManager = getSystemService(BluetoothManager.class);
    BluetoothAdapter bluetoothAdapter = bluetoothManager.getAdapter();
    if (bluetoothAdapter == null) {
        // Device doesn't support Bluetooth
    }
    

  2. เปิดใช้บลูทูธ

    ถัดไป คุณต้องตรวจสอบว่าเปิดใช้บลูทูธแล้ว เรียกใช้ isEnabled() เพื่อตรวจสอบว่าบลูทูธเปิดใช้อยู่หรือไม่ หากเมธอดนี้แสดงผลเป็น false แสดงว่าบลูทูธปิดอยู่ หากต้องการขอให้เปิดใช้บลูทูธ ให้เรียกใช้ startActivityForResult() โดยส่งการดำเนินการ Intent ACTION_REQUEST_ENABLE การเรียกนี้จะส่งคำขอเพื่อเปิดใช้บลูทูธผ่านการตั้งค่าระบบ (โดยไม่หยุดแอป)

    เช่น

    Kotlin

    if (bluetoothAdapter?.isEnabled == false) {
        val enableBtIntent = Intent(BluetoothAdapter.ACTION_REQUEST_ENABLE)
        startActivityForResult(enableBtIntent, REQUEST_ENABLE_BT)
    }
    

    Java

    if (!bluetoothAdapter.isEnabled()) {
        Intent enableBtIntent = new Intent(BluetoothAdapter.ACTION_REQUEST_ENABLE);
        startActivityForResult(enableBtIntent, REQUEST_ENABLE_BT);
    }
    

กล่องโต้ตอบจะปรากฏขึ้นเพื่อขอสิทธิ์จากผู้ใช้ในการเปิดใช้บลูทูธ ดังที่แสดงในรูปที่ 1 หากผู้ใช้ให้สิทธิ์ ระบบจะเริ่มเปิดใช้บลูทูธ และโฟกัสจะกลับไปที่แอปของคุณเมื่อกระบวนการเสร็จสมบูรณ์ (หรือล้มเหลว)

กล่องโต้ตอบของระบบที่ขอสิทธิ์เปิดบลูทูธ
รูปที่ 1 กล่องโต้ตอบการเปิดใช้บลูทูธ

ค่าคงที่ REQUEST_ENABLE_BT ที่ส่งไปยัง startActivityForResult() เป็นจำนวนเต็มที่กำหนดไว้ในเครื่องซึ่งต้องมากกว่าหรือเท่ากับ 0 ระบบจะส่งค่าคงที่นี้กลับไปให้คุณในการติดตั้งใช้งาน onActivityResult() เป็นพารามิเตอร์ requestCode

หากเปิดใช้บลูทูธสำเร็จ กิจกรรมของคุณจะได้รับรหัสผลลัพธ์ RESULT_OK ใน Callback onActivityResult() หากไม่ได้เปิดใช้บลูทูธเนื่องจากข้อผิดพลาด (หรือผู้ใช้ตอบว่า "ปฏิเสธ") รหัสผลลัพธ์จะเป็น RESULT_CANCELED

นอกจากนี้ แอปของคุณยังฟัง Intent การออกอากาศ ACTION_STATE_CHANGED ได้ด้วย ซึ่งระบบจะออกอากาศเมื่อใดก็ตามที่สถานะบลูทูธมีการเปลี่ยนแปลง การออกอากาศนี้มีช่องเพิ่มเติม EXTRA_STATE และ EXTRA_PREVIOUS_STATE ซึ่งมีสถานะบลูทูธใหม่และเก่าตามลำดับ ค่าที่เป็นไปได้สำหรับช่องเพิ่มเติมเหล่านี้คือ STATE_TURNING_ON, STATE_ON, STATE_TURNING_OFF และ STATE_OFF การฟังการออกอากาศนี้จะมีประโยชน์หากแอปของคุณต้องการตรวจจับการเปลี่ยนแปลงรันไทม์ที่เกิดขึ้นกับสถานะบลูทูธ

เมื่อเปิดใช้บลูทูธในอุปกรณ์แล้ว คุณจะใช้ได้ทั้งบลูทูธคลาสสิกและบลูทูธพลังงานต่ำ

สำหรับบลูทูธคลาสสิก คุณสามารถค้นหาอุปกรณ์บลูทูธและเชื่อมต่อกับอุปกรณ์บลูทูธได้

สำหรับบลูทูธพลังงานต่ำ คุณสามารถค้นหาอุปกรณ์ BLE, เชื่อมต่อกับเซิร์ฟเวอร์ GATT และโอนข้อมูล BLE ได้