chrome.bluetoothSocket

الوصف

يمكنك استخدام واجهة برمجة التطبيقات chrome.bluetoothSocket لإرسال البيانات وتلقّيها إلى الأجهزة التي تتضمّن بلوتوث باستخدام اتصالات RFCOMM وL2CAP.

البيان

يجب الإعلان عن المفاتيح التالية في ملف البيان كي تتمكّن من استخدام واجهة برمجة التطبيقات هذه.

"bluetooth"

الأنواع

AcceptError

التعداد

"system_error"
حدث خطأ في النظام وقد يكون الاتصال غير قابل للاسترداد.

"not_listening"
المقبس لا يستجيب.

AcceptErrorInfo

أماكن إقامة

• خطأ

  AcceptError

  رمز خطأ يشير إلى الخطأ الذي حدث.

• errorMessage

  سلسلة

  رسالة الخطأ

• socketId

  الرقم

  معرّف مقبس الخادم

AcceptInfo

أماكن إقامة

• clientSocketId

  الرقم

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

• socketId

  الرقم

  معرّف مقبس الخادم

CreateInfo

أماكن إقامة

• socketId

  الرقم

  معرّف المقبس الذي تم إنشاؤه حديثًا. تجدر الإشارة إلى أنّ معرّفات المقابس التي تم إنشاؤها من واجهة برمجة التطبيقات هذه غير متوافقة مع معرّفات المقابس التي تم إنشاؤها من واجهات برمجة تطبيقات أخرى، مثل واجهة برمجة التطبيقات [sockets.tcp](../sockets_tcp/).

ListenOptions

أماكن إقامة

• قائمة المهام

  الرقم اختياري

  طول قائمة انتظار الاستماع في المقبس تعتمد القيمة التلقائية على النظام الفرعي لمضيف نظام التشغيل.

• العضويات

  الرقم اختياري

  قناة بروتوكول RFCOMM المستخدمة من قِبل listenUsingRfcomm. وفي حال تحديد ذلك، يجب ألا تكون هذه القناة قيد الاستخدام في السابق، وإلا سيتعذّر إتمام استدعاء الطريقة. وفي حال عدم تحديد قيمة، سيتم تلقائيًا تخصيص قناة غير مستخدَمة.

• مدير النشاط التجاري على الإنترنت

  الرقم اختياري

  مخطط L2CAP PSM المُستخدَم من قِبل "listenUsingL2cap" في حال تحديد ذلك، يجب ألا يكون PSM هذا مُستخدَمًا في السابق أو عند تعذُّر استدعاء الطريقة. في حال عدم تحديد ذلك، سيتم تلقائيًا تخصيص PSM غير مستخدَم.

ReceiveError

التعداد

"تم قطع الاتصال"
تم قطع الاتصال.

"system_error"
حدث خطأ في النظام وقد يكون الاتصال غير قابل للاسترداد.

"not_ linked"
لم يتم توصيل المقبس.

ReceiveErrorInfo

أماكن إقامة

• خطأ

  ReceiveError

  رمز خطأ يشير إلى الخطأ الذي حدث.

• errorMessage

  سلسلة

  رسالة الخطأ

• socketId

  الرقم

  معرّف المقبس

ReceiveInfo

أماكن إقامة

• البيانات

  ArrayBuffer

  تم استلام البيانات، ويبلغ الحد الأقصى للحجم bufferSize.

• socketId

  الرقم

  معرّف المقبس

SocketInfo

أماكن إقامة

• معالجة

  سلسلة اختيارية

  في حال توصيل المقبس الأساسي، يحتوي على عنوان البلوتوث للجهاز المتصل به.

• bufferSize

  الرقم اختياري

  حجم المخزن المؤقت المستخدم لاستقبال البيانات. إذا لم يتم تحديد حجم للمخزن المؤقت بشكل صريح، لن يتم تقديم القيمة.

• تم الربط

  boolean

  علامة تشير إلى ما إذا كان المقبس متصلاً بنظير بعيد

• اسم

  سلسلة اختيارية

  سلسلة يحددها التطبيق مرتبطة بالمقبس.

• متوقف مؤقتًا

  boolean

  علامة تشير إلى ما إذا كان المقبس المتصل يمنع نظيره من إرسال المزيد من البيانات، أو ما إذا كان يتم إرسال طلبات الاتصال على مقبس الاستماع من خلال الحدث onAccept أو وضعها في قائمة مهام قائمة انتظار الاستماع يمكنك الاطّلاع على setPaused. القيمة التلقائية هي "false".

• ثابت

  boolean

  علامة تشير إلى ما إذا كان المقبس لا يزال مفتوحًا عند إلغاء تحميل صفحة الحدث للتطبيق (راجِع SocketProperties.persistent). القيمة التلقائية هي "false".

• socketId

  الرقم

  معرّف المقبس

• uuid

  سلسلة اختيارية

  إذا كان المقبس الأساسي متصلاً، سيحتوي المقبس الأساسي على معلومات حول الخدمة الفريدة العالمية (UUID) التي يتصل بها. وإذا كان المقبس الأساسي متصلاً به، سيحتوي المقبس على معلومات حول الخدمة الفريدة العالمية (UUID) التي يتصل بها.

SocketProperties

أماكن إقامة

• bufferSize

  الرقم اختياري

  حجم المخزن المؤقت المستخدم لاستقبال البيانات. القيمة التلقائية هي 4096.

• اسم

  سلسلة اختيارية

  يشير ذلك المصطلح إلى سلسلة يحدِّدها التطبيق مرتبطة بالمقبس.

• ثابت

  منطقية اختيارية

  علامة تشير إلى ترك المقبس مفتوحًا عند إلغاء تحميل صفحة الحدث للتطبيق (راجِع إدارة مراحل نشاط التطبيق) القيمة التلقائية هي false. عند تحميل التطبيق، يمكن استرجاع أي مقابس تم فتحها سابقًا باستخدام firebase=true باستخدام getSockets.

الطُرق

close()

وعد

chrome.bluetoothSocket.close(
  socketId: number,
  callback?: function,
)

يتم فصل المقبس وإتلافه. يجب إغلاق كل مقبس تم إنشاؤه بعد الاستخدام. لم يعد معرف المقبس صالحًا عند استدعاء الدالة. ومع ذلك، لا يمكن ضمان إغلاق المقبس إلا عند استدعاء معاودة الاتصال.

المَعلمات

• socketId

  الرقم

  معرّف المقبس

• معاودة الاتصال

  الدالة اختيارية

  تبدو معلَمة callback على النحو التالي:

  ()=>void

المرتجعات

• Promise<void>

  Chrome 91 والإصدارات الأحدث

  لا تتوفّر الوعود إلا في الإصدار 3 من Manifest V3 والإصدارات الأحدث، وتحتاج الأنظمة الأساسية الأخرى إلى استخدام عمليات معاودة الاتصال.

connect()

وعد

chrome.bluetoothSocket.connect(
  socketId: number,
  address: string,
  uuid: string,
  callback?: function,
)

توصيل المقبس بجهاز بلوتوث بعيد. عند اكتمال عملية "connect" بنجاح، يتم جمع أحداث "onReceive" عند تلقّي البيانات من التطبيق المشابه. إذا حدث خطأ في الشبكة أثناء استلام وقت التشغيل للحِزم، يُرجَّح حدث onReceiveError، وعندها لن يتم رفع حدث onReceive لهذا المقبس حتى يتم استدعاء طريقة setPaused(false).

المَعلمات

• socketId

  الرقم

  معرّف المقبس

• معالجة

  سلسلة

  عنوان الجهاز الذي يتضمّن بلوتوث

• uuid

  سلسلة

  المعرِّف الفريد العالمي للخدمة المطلوب الاتصال بها.

• معاودة الاتصال

  الدالة اختيارية

  تبدو معلَمة callback على النحو التالي:

  ()=>void

المرتجعات

• Promise<void>

  Chrome 91 والإصدارات الأحدث

  لا تتوفّر الوعود إلا في الإصدار 3 من Manifest V3 والإصدارات الأحدث، وتحتاج الأنظمة الأساسية الأخرى إلى استخدام عمليات معاودة الاتصال.

create()

وعد

chrome.bluetoothSocket.create(
  properties?: SocketProperties,
  callback?: function,
)

تنشئ مقبس بلوتوث.

المَعلمات

• المواقع

  SocketProperties اختيارية

  خصائص المقبس (اختيارية)

• معاودة الاتصال

  الدالة اختيارية

  تبدو معلَمة callback على النحو التالي:

  (createInfo: CreateInfo)=>void

  • createInfo

    CreateInfo

    نتيجة إنشاء المقبس

المرتجعات

• Promise<CreateInfo>

  Chrome 91 والإصدارات الأحدث

  لا تتوفّر الوعود إلا في الإصدار 3 من Manifest V3 والإصدارات الأحدث، وتحتاج الأنظمة الأساسية الأخرى إلى استخدام عمليات معاودة الاتصال.

disconnect()

وعد

chrome.bluetoothSocket.disconnect(
  socketId: number,
  callback?: function,
)

يتم فصل المقبس يظل معرف المقبس صالحًا.

المَعلمات

• socketId

  الرقم

  معرّف المقبس

• معاودة الاتصال

  الدالة اختيارية

  تبدو معلَمة callback على النحو التالي:

  ()=>void

المرتجعات

• Promise<void>

  Chrome 91 والإصدارات الأحدث

  لا تتوفّر الوعود إلا في الإصدار 3 من Manifest V3 والإصدارات الأحدث، وتحتاج الأنظمة الأساسية الأخرى إلى استخدام عمليات معاودة الاتصال.

getInfo()

وعد

chrome.bluetoothSocket.getInfo(
  socketId: number,
  callback?: function,
)

لاسترداد حالة المقبس المحدد.

المَعلمات

• socketId

  الرقم

  معرّف المقبس

• معاودة الاتصال

  الدالة اختيارية

  تبدو معلَمة callback على النحو التالي:

  (socketInfo: SocketInfo)=>void

  • socketInfo

    SocketInfo

    عنصر يحتوي على معلومات المقبس

المرتجعات

• Promise<SocketInfo>

  Chrome 91 والإصدارات الأحدث

  لا تتوفّر الوعود إلا في الإصدار 3 من Manifest V3 والإصدارات الأحدث، وتحتاج الأنظمة الأساسية الأخرى إلى استخدام عمليات معاودة الاتصال.

getSockets()

وعد

chrome.bluetoothSocket.getSockets(
  callback?: function,
)

يسترد قائمة المقابس المفتوحة حاليًا التي يملكها التطبيق.

المَعلمات

• معاودة الاتصال

  الدالة اختيارية

  تبدو معلَمة callback على النحو التالي:

  (sockets: SocketInfo[])=>void

  • مآخذ

    SocketInfo[]

المرتجعات

• Promise<SocketInfo[]>

  Chrome 91 والإصدارات الأحدث

  لا تتوفّر الوعود إلا في الإصدار 3 من Manifest V3 والإصدارات الأحدث، وتحتاج الأنظمة الأساسية الأخرى إلى استخدام عمليات معاودة الاتصال.

listenUsingL2cap()

وعد

chrome.bluetoothSocket.listenUsingL2cap(
  socketId: number,
  uuid: string,
  options?: ListenOptions,
  callback?: function,
)

الاستماع إلى الاتصالات باستخدام بروتوكول L2CAP.

المَعلمات

• socketId

  الرقم

  معرّف المقبس

• uuid

  سلسلة

  المعرّف الفريد العالمي للخدمة الذي يمكن الاستماع إليه

• الخيارات

  ListenOptions اختيارية

  خيارات إضافية اختيارية للخدمة.

• معاودة الاتصال

  الدالة اختيارية

  تبدو معلَمة callback على النحو التالي:

  ()=>void

المرتجعات

• Promise<void>

  Chrome 91 والإصدارات الأحدث

  لا تتوفّر الوعود إلا في الإصدار 3 من Manifest V3 والإصدارات الأحدث، وتحتاج الأنظمة الأساسية الأخرى إلى استخدام عمليات معاودة الاتصال.

listenUsingRfcomm()

وعد

chrome.bluetoothSocket.listenUsingRfcomm(
  socketId: number,
  uuid: string,
  options?: ListenOptions,
  callback?: function,
)

يرصد الاتصالات باستخدام بروتوكول RFCOMM.

المَعلمات

• socketId

  الرقم

  معرّف المقبس

• uuid

  سلسلة

  المعرّف الفريد العالمي للخدمة الذي يمكن الاستماع إليه

• الخيارات

  ListenOptions اختيارية

  خيارات إضافية اختيارية للخدمة.

• معاودة الاتصال

  الدالة اختيارية

  تبدو معلَمة callback على النحو التالي:

  ()=>void

المرتجعات

• Promise<void>

  Chrome 91 والإصدارات الأحدث

  لا تتوفّر الوعود إلا في الإصدار 3 من Manifest V3 والإصدارات الأحدث، وتحتاج الأنظمة الأساسية الأخرى إلى استخدام عمليات معاودة الاتصال.

send()

وعد

chrome.bluetoothSocket.send(
  socketId: number,
  data: ArrayBuffer,
  callback?: function,
)

لإرسال البيانات عبر مقبس البلوتوث المحدّد

المَعلمات

• socketId

  الرقم

  معرّف المقبس

• البيانات

  ArrayBuffer

  البيانات المطلوب إرسالها.

• معاودة الاتصال

  الدالة اختيارية

  تبدو معلَمة callback على النحو التالي:

  (bytesSent: number)=>void

  • bytesSent

    الرقم

    عدد وحدات بايت التي تم إرسالها.

المرتجعات

• وعد<الرقم>

  Chrome 91 والإصدارات الأحدث

  لا تتوفّر الوعود إلا في الإصدار 3 من Manifest V3 والإصدارات الأحدث، وتحتاج الأنظمة الأساسية الأخرى إلى استخدام عمليات معاودة الاتصال.

setPaused()

وعد

chrome.bluetoothSocket.setPaused(
  socketId: number,
  paused: boolean,
  callback?: function,
)

يفعّل المقبس المتصل أو يوقف إمكانية استلام الرسائل من نظيره أو في منع المقبس الكهربائي من قبول الاتصالات الجديدة. القيمة التلقائية هي "false". عادةً ما يتم استخدام الإيقاف المؤقت للمقبس المتصل بواسطة أحد التطبيقات لتقييد البيانات التي يرسلها نظيره. عند إيقاف المقبس المتصل مؤقتًا، لن يتم رفع onReceiveحدث. عند توصيل المقبس وإلغاء الإيقاف المؤقت، يتم رفع أحداث onReceive مرة أخرى عند استلام الرسائل. عند إيقاف مقبس الاستماع مؤقتًا، يتم قبول الاتصالات الجديدة حتى تمتلئ قائمة المهام ثم يتم رفض طلبات الاتصال الإضافية. لا يتم رفع أحداث onAccept إلا عند إلغاء إيقاف المقبس مؤقتًا.

المَعلمات

• socketId

  الرقم

• متوقف مؤقتًا

  boolean

• معاودة الاتصال

  الدالة اختيارية

  تبدو معلَمة callback على النحو التالي:

  ()=>void

المرتجعات

• Promise<void>

  Chrome 91 والإصدارات الأحدث

  لا تتوفّر الوعود إلا في الإصدار 3 من Manifest V3 والإصدارات الأحدث، وتحتاج الأنظمة الأساسية الأخرى إلى استخدام عمليات معاودة الاتصال.

update()

وعد

chrome.bluetoothSocket.update(
  socketId: number,
  properties: SocketProperties,
  callback?: function,
)

لتحديث خصائص المقبس.

المَعلمات

• socketId

  الرقم

  معرّف المقبس

• المواقع

  SocketProperties

  السمات المطلوب تعديلها

• معاودة الاتصال

  الدالة اختيارية

  تبدو معلَمة callback على النحو التالي:

  ()=>void

المرتجعات

• Promise<void>

  Chrome 91 والإصدارات الأحدث

  لا تتوفّر الوعود إلا في الإصدار 3 من Manifest V3 والإصدارات الأحدث، وتحتاج الأنظمة الأساسية الأخرى إلى استخدام عمليات معاودة الاتصال.

فعاليات

onAccept

chrome.bluetoothSocket.onAccept.addListener(
  callback: function,
)

يتم رفع الحدث عند إنشاء اتصال لمقبس معين.

المَعلمات

• معاودة الاتصال

  الوظيفة

  تبدو معلَمة callback على النحو التالي:

  (info: AcceptInfo)=>void

  • معلومات

    AcceptInfo

onAcceptError

chrome.bluetoothSocket.onAcceptError.addListener(
  callback: function,
)

تم رفع الحدث عندما حدث خطأ في الشبكة أثناء انتظار وقت التشغيل الاتصالات الجديدة على المقبس المعني. بعد رفع هذا الحدث، يتم ضبط المقبس على paused ولن يتم رفع أحداث onAccept أخرى لهذا المقبس.

المَعلمات

• معاودة الاتصال

  الوظيفة

  تبدو معلَمة callback على النحو التالي:

  (info: AcceptErrorInfo)=>void

  • معلومات

    AcceptErrorInfo

onReceive

chrome.bluetoothSocket.onReceive.addListener(
  callback: function,
)

تم رفع الحدث عند استلام بيانات لمقبس معيَّن.

المَعلمات

• معاودة الاتصال

  الوظيفة

  تبدو معلَمة callback على النحو التالي:

  (info: ReceiveInfo)=>void

  • معلومات

    ReceiveInfo

onReceiveError

chrome.bluetoothSocket.onReceiveError.addListener(
  callback: function,
)

تم رفع الحدث عند حدوث خطأ في الشبكة أثناء فترة التشغيل أثناء انتظار البيانات على المقبس. بعد رفع هذا الحدث، يتم ضبط المقبس على paused ولن يتم رفع أحداث onReceive أخرى لهذا المقبس.

المَعلمات

• معاودة الاتصال

  الوظيفة

  تبدو معلَمة callback على النحو التالي:

  (info: ReceiveErrorInfo)=>void

  • معلومات

    ReceiveErrorInfo