الوصف
يمكنك استخدام واجهة برمجة التطبيقات chrome.bluetoothSocket
لإرسال البيانات وتلقّيها إلى الأجهزة التي تتضمّن بلوتوث باستخدام اتصالات RFCOMM وL2CAP.
البيان
يجب الإعلان عن المفاتيح التالية في ملف البيان كي تتمكّن من استخدام واجهة برمجة التطبيقات هذه.
"bluetooth"
الأنواع
AcceptError
التعداد
"system_error"
حدث خطأ في النظام وقد يكون الاتصال غير قابل للاسترداد.
"not_listening"
المقبس لا يستجيب.
AcceptErrorInfo
أماكن إقامة
-
خطأ
رمز خطأ يشير إلى الخطأ الذي حدث.
-
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
أماكن إقامة
-
خطأ
رمز خطأ يشير إلى الخطأ الذي حدث.
-
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
نتيجة إنشاء المقبس
-
المرتجعات
-
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
عنصر يحتوي على معلومات المقبس
-
المرتجعات
-
Promise<SocketInfo>
Chrome 91 والإصدارات الأحدثلا تتوفّر الوعود إلا في الإصدار 3 من Manifest V3 والإصدارات الأحدث، وتحتاج الأنظمة الأساسية الأخرى إلى استخدام عمليات معاودة الاتصال.
getSockets()
chrome.bluetoothSocket.getSockets(
callback?: function,
)
يسترد قائمة المقابس المفتوحة حاليًا التي يملكها التطبيق.
المَعلمات
-
معاودة الاتصال
الدالة اختيارية
تبدو معلَمة
callback
على النحو التالي:(sockets: SocketInfo[]) => void
-
مآخذ
-
المرتجعات
-
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
الرقم
معرّف المقبس
-
المواقع
السمات المطلوب تعديلها
-
معاودة الاتصال
الدالة اختيارية
تبدو معلَمة
callback
على النحو التالي:() => void
المرتجعات
-
Promise<void>
Chrome 91 والإصدارات الأحدثلا تتوفّر الوعود إلا في الإصدار 3 من 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
-
معلومات
-