إعداد البلوتوث

قبل أن يتمكّن تطبيقك من الاتصال عبر البلوتوث أو البلوتوث منخفض الطاقة، عليك التأكّد من أنّ البلوتوث متاح على الجهاز، وإذا كان متاحًا، عليك التأكّد من تفعيله. يُرجى العِلم أنّ هذا التحقّق ضروري فقط إذا تم ضبط السمة android:required في إدخال ملف البيان <uses-feature.../> على false.

إذا لم يكن البلوتوث متاحًا، عليك إيقاف أي ميزات تتطلّب البلوتوث. إذا كان البلوتوث متاحًا ولكن تم إيقافه، يمكنك أن تطلب من المستخدم تفعيله بدون مغادرة تطبيقك.

الخطوة الأولى هي إضافة أذونات البلوتوث إلى ملف البيان من أجل استخدام واجهات برمجة التطبيقات التالية.

بعد منح الأذونات، يتم إعداد البلوتوث في خطوتَين باستخدام 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() للتحقّق مما إذا كان البلوتوث مفعَّلاً حاليًا. إذا عرضت هذه الطريقة القيمة "خطأ"، يعني ذلك أنّ البلوتوث غير مفعّل. لطلب تفعيل البلوتوث، يمكنك استدعاء startActivityForResult()، مع تمرير إجراء نية 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 في دالة الاستدعاء onActivityResult(). إذا لم يتم تفعيل البلوتوث بسبب خطأ (أو إذا اختار المستخدم "رفض")، يكون رمز النتيجة RESULT_CANCELED.

يمكن لتطبيقك أيضًا الاستماع إلى نية البث ACTION_STATE_CHANGED، والتي يبثها النظام كلما تغيرت حالة البلوتوث. يحتوي هذا البث على الحقلين الإضافيين EXTRA_STATE وEXTRA_PREVIOUS_STATE، اللذين يتضمّنان حالتي البلوتوث الجديدة والقديمة على التوالي. القيم المحتملة لهذه الحقول الإضافية هي STATE_TURNING_ON وSTATE_ON وSTATE_TURNING_OFF وSTATE_OFF. يمكن أن يكون الاستماع إلى هذا البث مفيدًا إذا كان تطبيقك بحاجة إلى رصد التغييرات التي تم إجراؤها على حالة البلوتوث أثناء التشغيل.

بعد تفعيل البلوتوث على الجهاز، يمكنك استخدام كل من تقنية Bluetooth Classic وتقنية البلوتوث منخفض الطاقة.

بالنسبة إلى تقنية Bluetooth Classic، يمكنك البحث عن الأجهزة التي تتضمّن بلوتوث والربط بها.

بالنسبة إلى تقنية "بلوتوث منخفض الطاقة"، يمكنك العثور على أجهزة BLE والاتصال بخادم GATT ونقل بيانات BLE.