chrome.bluetoothSocket

الوصف

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

البيان

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

"bluetooth"

الأنواع

AcceptError

Enum

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

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

AcceptErrorInfo

أماكن إقامة

  • خطأ

    AcceptError

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

  • errorMessage

    سلسلة

    رسالة الخطأ.

  • socketId

    الرقم

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

AcceptInfo

أماكن إقامة

  • clientSocketId

    الرقم

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

  • socketId

    الرقم

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

CreateInfo

أماكن إقامة

  • socketId

    الرقم

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

ListenOptions

أماكن إقامة

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

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

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

  • قناة

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

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

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

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

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

ReceiveError

Enum

"غير متّصل"
انقطاع الاتصال.

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

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

ReceiveErrorInfo

أماكن إقامة

  • خطأ

    ReceiveError

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

  • errorMessage

    سلسلة

    رسالة الخطأ.

  • socketId

    الرقم

    معرِّف المقبس

ReceiveInfo

أماكن إقامة

  • البيانات

    مخزن المصفوفات

    البيانات التي تم استلامها، بحد أقصى bufferSize

  • socketId

    الرقم

    معرِّف المقبس

SocketInfo

أماكن إقامة

  • معالجة

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

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

  • bufferSize

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

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

  • تم الربط

    منطقي

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

  • الاسم

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

    سلسلة معرّف التطبيق المرتبطة بالمقبس

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

    منطقي

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

  • مستمر

    منطقي

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

  • socketId

    الرقم

    معرِّف المقبس

  • رقم uuid

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

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

SocketProperties

أماكن إقامة

  • bufferSize

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

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

  • الاسم

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

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

  • مستمر

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

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

الطُرق

close()

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

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

المعلمات

  • socketId

    الرقم

    معرِّف المقبس

  • رد الاتصال

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

    تظهر المَعلمة callback على النحو التالي: 

    () => void

المرتجعات

  • وعود <باطلة>

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

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

connect()

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

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

المعلمات

  • socketId

    الرقم

    معرِّف المقبس

  • معالجة

    سلسلة

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

  • رقم uuid

    سلسلة

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

  • رد الاتصال

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

    تظهر المَعلمة callback على النحو التالي: 

    () => void

المرتجعات

  • وعود <باطلة>

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

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

create()

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

لإنشاء مقبس بلوتوث.

المعلمات

  • المواقع

    SocketProperties اختيارية

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

  • رد الاتصال

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

    تظهر المَعلمة callback على النحو التالي: 

    (createInfo: CreateInfo) => void

    • createInfo

      CreateInfo

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

المرتجعات

  • Promise&lt;CreateInfo&gt;

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

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

disconnect()

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

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

المعلمات

  • socketId

    الرقم

    معرِّف المقبس

  • رد الاتصال

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

    تظهر المَعلمة callback على النحو التالي: 

    () => void

المرتجعات

  • وعود <باطلة>

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

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

getInfo()

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

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

المعلمات

  • socketId

    الرقم

    معرِّف المقبس

  • رد الاتصال

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

    تظهر المَعلمة callback على النحو التالي: 

    (socketInfo: SocketInfo) => void

    • socketInfo

      SocketInfo

      كائن يحتوي على معلومات المقبس

المرتجعات

  • Promise&lt;SocketInfo&gt;

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

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

getSockets()

وعود 
chrome.bluetoothSocket.getSockets(
  callback?: function,
)

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

المعلمات

  • رد الاتصال

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

    تظهر المَعلمة callback على النحو التالي: 

    (sockets: SocketInfo[]) => void

المرتجعات

  • Promise&lt;SocketInfo[]&gt;

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

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

listenUsingL2cap()

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

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

المعلمات

  • socketId

    الرقم

    معرِّف المقبس

  • رقم uuid

    سلسلة

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

  • الخيارات

    ListenOptions اختيارية

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

  • رد الاتصال

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

    تظهر المَعلمة callback على النحو التالي: 

    () => void

المرتجعات

  • وعود <باطلة>

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

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

listenUsingRfcomm()

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

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

المعلمات

  • socketId

    الرقم

    معرِّف المقبس

  • رقم uuid

    سلسلة

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

  • الخيارات

    ListenOptions اختيارية

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

  • رد الاتصال

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

    تظهر المَعلمة callback على النحو التالي: 

    () => void

المرتجعات

  • وعود <باطلة>

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

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

send()

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

يرسل البيانات على مقبس البلوتوث المحدد.

المعلمات

  • socketId

    الرقم

    معرِّف المقبس

  • البيانات

    مخزن المصفوفات

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

  • رد الاتصال

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

    تظهر المَعلمة callback على النحو التالي: 

    (bytesSent: number) => void

    • bytesSent

      الرقم

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

المرتجعات

  • Promise&lt;number&gt;

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

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

setPaused()

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

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

المعلمات

  • socketId

    الرقم

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

    منطقي

  • رد الاتصال

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

    تظهر المَعلمة callback على النحو التالي: 

    () => void

المرتجعات

  • وعود <باطلة>

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

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

update()

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

لتعديل خصائص المقبس

المعلمات

  • socketId

    الرقم

    معرِّف المقبس

  • المواقع

    SocketProperties

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

  • رد الاتصال

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

    تظهر المَعلمة callback على النحو التالي: 

    () => void

المرتجعات

  • وعود <باطلة>

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

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

فعاليات

onAccept

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

الحدث الذي يُنشأ عند إنشاء اتصال بمقبس معيّن.

المعلمات

  • رد الاتصال

    دالة

    تظهر المَعلمة callback على النحو التالي: 

    (info: AcceptInfo) => void

onAcceptError

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

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

المعلمات

  • رد الاتصال

    دالة

    تظهر المَعلمة callback على النحو التالي: 

    (info: AcceptErrorInfo) => void

onReceive

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

يشير ذلك المصطلح إلى الحدث الذي يتم رفعه عند استلام بيانات في مقبس معيّن.

المعلمات

  • رد الاتصال

    دالة

    تظهر المَعلمة callback على النحو التالي: 

    (info: ReceiveInfo) => void

onReceiveError

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

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

المعلمات

  • رد الاتصال

    دالة

    تظهر المَعلمة callback على النحو التالي: 

    (info: ReceiveErrorInfo) => void