ربط أجهزة تتضمّن بلوتوث

لإنشاء اتصال بين جهازين، يجب تنفيذ آليات من جهة الخادم ومن جهة العميل لأنّ أحد الجهازين يجب أن يفتح مقبس خادم، والآخر يجب أن يبدأ الاتصال باستخدام عنوان MAC الخاص بجهاز الخادم. يحصل كل من جهاز الخادم وجهاز العميل على BluetoothSocket المطلوب بطرق مختلفة. يتلقّى الخادم معلومات المقبس عند قبول اتصال وارد. يوفّر العميل معلومات المقبس عند فتح قناة RFCOMM للخادم.

يُعتبر الخادم والعميل متصلَين ببعضهما عندما يكون لكل منهما BluetoothSocket متصل على قناة RFCOMM نفسها. في هذه المرحلة، يمكن لكل جهاز الحصول على تدفقات الإدخال والإخراج، ويمكن أن تبدأ عملية نقل البيانات، وهو ما تتم مناقشته في القسم الخاص بنقل بيانات البلوتوث. يوضّح هذا القسم كيفية بدء الاتصال بين جهازين.

تأكَّد من حصولك على أذونات البلوتوث المناسبة وإعداد تطبيقك لاستخدام البلوتوث قبل محاولة العثور على الأجهزة التي تتضمّن بلوتوث.

أساليب الربط

تتمثل إحدى تقنيات التنفيذ في إعداد كل جهاز تلقائيًا كخادم بحيث يكون لكل جهاز مقبس خادم مفتوح ويستمع إلى الاتصالات. في هذه الحالة، يمكن لأي من الجهازين بدء اتصال مع الآخر ويصبح العميل. يمكن بدلاً من ذلك أن يستضيف أحد الجهازين الاتصال بشكل صريح ويفتح مقبس خادم عند الطلب، ويبدأ الجهاز الآخر الاتصال.

مربّع حوار إقران البلوتوث الذي يطلب من المستخدم إقران جهازه بجهاز آخر
الشكل 1. مربّع حوار إقران البلوتوث

الاتصال كخادم

عندما تريد توصيل جهازين، يجب أن يعمل أحدهما كخادم من خلال الاحتفاظ بـ BluetoothServerSocket مفتوح. الغرض من مقبس الخادم هو الاستماع إلى طلبات الاتصال الواردة وتوفير BluetoothSocket متصل بعد قبول الطلب. عند الحصول على BluetoothSocket من BluetoothServerSocket، يمكن التخلّص من BluetoothServerSocket، بل يجب ذلك، ما لم تكن تريد أن يقبل الجهاز المزيد من الاتصالات.

لإعداد مقبس خادم وقبول اتصال، أكمِل التسلسل التالي من الخطوات:

  1. يمكنك الحصول على BluetoothServerSocket من خلال الاتصال بالرقم listenUsingRfcommWithServiceRecord(String, UUID).

    السلسلة هي اسم يمكن التعرّف عليه لخدمتك، ويكتبه النظام تلقائيًا في إدخال جديد في قاعدة بيانات بروتوكول اكتشاف الخدمة (SDP) على الجهاز. الاسم عشوائي ويمكن أن يكون ببساطة اسم تطبيقك. يتم أيضًا تضمين المعرّف الفريد العالمي (UUID) في إدخال SDP ويشكّل أساس اتفاقية الاتصال مع جهاز العميل. أي عندما يحاول العميل الاتصال بهذا الجهاز، فإنه يحمل UUID الذي يحدد بشكل فريد الخدمة التي يريد الاتصال بها. يجب أن تتطابق معرّفات UUID هذه ليتم قبول الاتصال.

    ‫UUID هو تنسيق موحّد من 128 بت لمعرّف سلسلة يُستخدم لتحديد المعلومات بشكل فريد. يُستخدم المعرّف الفريد العالمي لتحديد المعلومات التي يجب أن تكون فريدة داخل نظام أو شبكة لأنّ احتمال تكرار المعرّف الفريد العالمي هو صفر فعليًا. ويتم إنشاؤها بشكل مستقل، بدون استخدام سلطة مركزية. في هذه الحالة، يتم استخدامه لتحديد خدمة البلوتوث في تطبيقك بشكل فريد. للحصول على معرّف UUID لاستخدامه مع تطبيقك، يمكنك استخدام أحد UUID منشئي المحتوى العشوائيين العديدين على الويب، ثم تهيئة معرّف UUID باستخدام fromString(String).

  2. ابدأ الاستماع إلى طلبات الاتصال من خلال استدعاء accept().

    هذه مكالمة حظر. ويتم عرضها عند قبول اتصال أو حدوث استثناء. لا يتم قبول الاتصال إلا عندما يرسل جهاز بعيد طلب اتصال يحتوي على معرّف فريد عالمي (UUID) يتطابق مع المعرّف المسجَّل في مقبس الخادم هذا الذي ينتظر استقبال البيانات. عند نجاح العملية، تعرض دالة accept() قيمة BluetoothSocket متصلة.

  3. إذا أردت قبول اتصالات إضافية، يمكنك استدعاء close().

    يؤدي طلب الإجراء هذا إلى تحرير مقبس الخادم وجميع موارده، ولكنّه لا يغلق BluetoothSocket المتصل الذي تم عرضه من خلال accept(). على عكس بروتوكول TCP/IP، يسمح بروتوكول RFCOMM باتصال عميل واحد فقط لكل قناة في المرة الواحدة، لذا في معظم الحالات، من المنطقي استدعاء close() على BluetoothServerSocket مباشرةً بعد قبول مقبس متصل.

بما أنّ طلب accept() هو طلب حظر، لا تنفِّذه في سلسلة واجهة المستخدم للنشاط الرئيسي. ويضمن تنفيذها في سلسلة محادثات أخرى أن يظل بإمكان تطبيقك الاستجابة لتفاعلات المستخدمين الأخرى. من المنطقي عادةً تنفيذ جميع الأعمال التي تتضمّن BluetoothServerSocket أو BluetoothSocket في سلسلة محادثات جديدة يديرها تطبيقك. لإلغاء مكالمة محظورة مثل accept()، يمكنك الاتصال بـ close() على BluetoothServerSocket أو BluetoothSocket من سلسلة محادثات أخرى. يُرجى العِلم أنّ جميع الطرق في BluetoothServerSocket أو BluetoothSocket آمنة من حيث سلاسل المحادثات.

مثال

في ما يلي سلسلة محادثات مبسطة لمكوّن الخادم الذي يقبل الاتصالات الواردة:

Kotlin

private inner class AcceptThread : Thread() {

   private val mmServerSocket: BluetoothServerSocket? by lazy(LazyThreadSafetyMode.NONE) {
       bluetoothAdapter?.listenUsingInsecureRfcommWithServiceRecord(NAME, MY_UUID)
   }

   override fun run() {
       // Keep listening until exception occurs or a socket is returned.
       var shouldLoop = true
       while (shouldLoop) {
           val socket: BluetoothSocket? = try {
               mmServerSocket?.accept()
           } catch (e: IOException) {
               Log.e(TAG, "Socket's accept() method failed", e)
               shouldLoop = false
               null
           }
           socket?.also {
               manageMyConnectedSocket(it)
               mmServerSocket?.close()
               shouldLoop = false
           }
       }
   }

   // Closes the connect socket and causes the thread to finish.
   fun cancel() {
       try {
           mmServerSocket?.close()
       } catch (e: IOException) {
           Log.e(TAG, "Could not close the connect socket", e)
       }
   }
}

Java

private class AcceptThread extends Thread {
   private final BluetoothServerSocket mmServerSocket;

   public AcceptThread() {
       // Use a temporary object that is later assigned to mmServerSocket
       // because mmServerSocket is final.
       BluetoothServerSocket tmp = null;
       try {
           // MY_UUID is the app's UUID string, also used by the client code.
           tmp = bluetoothAdapter.listenUsingRfcommWithServiceRecord(NAME, MY_UUID);
       } catch (IOException e) {
           Log.e(TAG, "Socket's listen() method failed", e);
       }
       mmServerSocket = tmp;
   }

   public void run() {
       BluetoothSocket socket = null;
       // Keep listening until exception occurs or a socket is returned.
       while (true) {
           try {
               socket = mmServerSocket.accept();
           } catch (IOException e) {
               Log.e(TAG, "Socket's accept() method failed", e);
               break;
           }

           if (socket != null) {
               // A connection was accepted. Perform work associated with
               // the connection in a separate thread.
               manageMyConnectedSocket(socket);
               mmServerSocket.close();
               break;
           }
       }
   }

   // Closes the connect socket and causes the thread to finish.
   public void cancel() {
       try {
           mmServerSocket.close();
       } catch (IOException e) {
           Log.e(TAG, "Could not close the connect socket", e);
       }
   }
}

في هذا المثال، نريد اتصالاً واردًا واحدًا فقط، لذا بمجرد قبول الاتصال والحصول على BluetoothSocket، يمرر التطبيق BluetoothSocket الذي تم الحصول عليه إلى سلسلة محادثات منفصلة، ويغلق BluetoothServerSocket، ويخرج من الحلقة.

يُرجى العِلم أنّه عندما تعرض دالة accept() القيمة BluetoothSocket، يكون المقبس متصلاً. لذلك، يجب عدم استدعاء connect()، كما تفعل من جهة العميل.

تم تصميم طريقة manageMyConnectedSocket() الخاصة بالتطبيق لبدء سلسلة المحادثات لنقل البيانات، والتي تتم مناقشتها في موضوع نقل بيانات البلوتوث.

عادةً، يجب إغلاق BluetoothServerSocket بمجرد الانتهاء من الاستماع إلى الاتصالات الواردة. في هذا المثال، يتم استدعاء close() فور الحصول على BluetoothSocket. قد تحتاج أيضًا إلى توفير طريقة عامة في سلسلة التعليمات الخاصة بك يمكنها إغلاق BluetoothSocket الخاص في حالة احتياجك إلى التوقف عن الاستماع على مقبس الخادم هذا.

الاتصال كعميل

لبدء اتصال بجهاز بعيد يقبل الاتصالات على مقبس خادم مفتوح، يجب أولاً الحصول على كائن BluetoothDevice يمثّل الجهاز البعيد. لمعرفة كيفية إنشاء BluetoothDevice، يُرجى الاطّلاع على العثور على الأجهزة التي تتضمّن بلوتوث. يجب بعد ذلك استخدام BluetoothDevice للحصول على BluetoothSocket وبدء الاتصال.

في ما يلي الإجراء الأساسي:

  1. باستخدام BluetoothDevice، يمكنك الحصول على BluetoothSocket من خلال الاتصال بالرقم createRfcommSocketToServiceRecord(UUID).

    تُنشئ هذه الطريقة عنصر BluetoothSocket يسمح للعميل بالاتصال بـ BluetoothDevice. يجب أن يتطابق المعرّف الفريد العالمي (UUID) الذي تم تمريره هنا مع المعرّف الفريد العالمي (UUID) الذي استخدمه جهاز الخادم عند استدعاء listenUsingRfcommWithServiceRecord(String, UUID) لفتح BluetoothServerSocket. لاستخدام معرّف UUID مطابق، عليك تضمين سلسلة UUID في تطبيقك، ثم الإشارة إليها من كل من رمز الخادم والعميل.

  2. ابدأ عملية الربط من خلال طلب connect(). يُرجى العِلم أنّ هذه الطريقة هي استدعاء حظر.

    بعد أن يستدعي العميل هذه الطريقة، ينفّذ النظام عملية بحث في بروتوكول SDP للعثور على الجهاز البعيد الذي يتطابق مع معرّف UUID. إذا نجحت عملية البحث وقبل الجهاز البعيد الاتصال، تتم مشاركة قناة RFCOMM لاستخدامها أثناء الاتصال، وتظهر طريقة connect(). إذا تعذّر الاتصال أو انتهت مهلة طريقة connect() (بعد حوالي 12 ثانية)، ستعرض الطريقة IOException.

بما أنّ connect() هو طلب حظر، عليك دائمًا تنفيذ إجراء الاتصال هذا في سلسلة تعليمات منفصلة عن سلسلة تعليمات النشاط الرئيسي (واجهة المستخدم).

مثال

في ما يلي مثال أساسي على سلسلة محادثات عميل تبدأ اتصالاً عبر البلوتوث:

Kotlin

private inner class ConnectThread(device: BluetoothDevice) : Thread() {

   private val mmSocket: BluetoothSocket? by lazy(LazyThreadSafetyMode.NONE) {
       device.createRfcommSocketToServiceRecord(MY_UUID)
   }

   public override fun run() {
       // Cancel discovery because it otherwise slows down the connection.
       bluetoothAdapter?.cancelDiscovery()

       mmSocket?.let { socket ->
           // Connect to the remote device through the socket. This call blocks
           // until it succeeds or throws an exception.
           socket.connect()

           // The connection attempt succeeded. Perform work associated with
           // the connection in a separate thread.
           manageMyConnectedSocket(socket)
       }
   }

   // Closes the client socket and causes the thread to finish.
   fun cancel() {
       try {
           mmSocket?.close()
       } catch (e: IOException) {
           Log.e(TAG, "Could not close the client socket", e)
       }
   }
}

Java

private class ConnectThread extends Thread {
   private final BluetoothSocket mmSocket;
   private final BluetoothDevice mmDevice;

   public ConnectThread(BluetoothDevice device) {
       // Use a temporary object that is later assigned to mmSocket
       // because mmSocket is final.
       BluetoothSocket tmp = null;
       mmDevice = device;

       try {
           // Get a BluetoothSocket to connect with the given BluetoothDevice.
           // MY_UUID is the app's UUID string, also used in the server code.
           tmp = device.createRfcommSocketToServiceRecord(MY_UUID);
       } catch (IOException e) {
           Log.e(TAG, "Socket's create() method failed", e);
       }
       mmSocket = tmp;
   }

   public void run() {
       // Cancel discovery because it otherwise slows down the connection.
       bluetoothAdapter.cancelDiscovery();

       try {
           // Connect to the remote device through the socket. This call blocks
           // until it succeeds or throws an exception.
           mmSocket.connect();
       } catch (IOException connectException) {
           // Unable to connect; close the socket and return.
           try {
               mmSocket.close();
           } catch (IOException closeException) {
               Log.e(TAG, "Could not close the client socket", closeException);
           }
           return;
       }

       // The connection attempt succeeded. Perform work associated with
       // the connection in a separate thread.
       manageMyConnectedSocket(mmSocket);
   }

   // Closes the client socket and causes the thread to finish.
   public void cancel() {
       try {
           mmSocket.close();
       } catch (IOException e) {
           Log.e(TAG, "Could not close the client socket", e);
       }
   }
}

لاحظ أنه في هذا المقتطف، يتم استدعاء cancelDiscovery() قبل حدوث محاولة الاتصال. يجب دائمًا استدعاء cancelDiscovery() قبل connect()، خاصةً لأنّ cancelDiscovery() تنجح بغض النظر عمّا إذا كان اكتشاف الجهاز قيد التقدم حاليًا. إذا كان تطبيقك بحاجة إلى تحديد ما إذا كانت عملية اكتشاف الأجهزة جارية، يمكنك التحقّق من ذلك باستخدام isDiscovering().

تم تصميم طريقة manageMyConnectedSocket() الخاصة بالتطبيق لبدء سلسلة المحادثات لنقل البيانات، والتي تتم مناقشتها في القسم الخاص بنقل بيانات البلوتوث.

عند الانتهاء من استخدام BluetoothSocket، يجب دائمًا استدعاء close(). يؤدي ذلك إلى إغلاق المقبس المتصل على الفور وتحرير جميع الموارد الداخلية ذات الصلة.