chrome.bluetooth

תיאור

צריך להשתמש ב-API chrome.bluetooth כדי להתחבר למכשיר Bluetooth. כל הפונקציות מדווחות על כשלים באמצעות chrome.runtime.lastError.

מניפסט

כדי להשתמש ב-API הזה, צריך להצהיר על המפתחות הבאים במניפסט.

"bluetooth"

סוגים

AdapterState

מאפיינים

• כתובת

  מחרוזת

  כתובת המתאם, בפורמט 'XX:XX:XX:XX:XX:XX'.

• זמין

  בוליאני

  מציין אם המתאם זמין (כלומר מופעל).

• לגלות

  בוליאני

  מציין אם המתאם נמצא עכשיו או לא.

• שם

  מחרוזת

  שם המתאם, קריא לאנשים.

• מופעל

  בוליאני

  מציין אם למתאם יש מתח או לא.

BluetoothFilter

Chrome 67 ואילך

מאפיינים

• filterType

  FilterType אופציונלי

  סוג המסנן שצריך להחיל על רשימת המכשירים. ברירת המחדל היא הכול.

• הגבלה

  מספר אופציונלי

  המספר המקסימלי של מכשירי Bluetooth שצריך להחזיר. אם לא צויין ערך, ברירת המחדל היא 0 (ללא הגבלה).

Device

מאפיינים

• כתובת

  מחרוזת

  כתובת המכשיר, בפורמט 'XX:XX:XX:XX:XX:XX'.

• batteryPercentage

  מספר אופציונלי

  Chrome 77 ואילך

  רמת הטעינה שנותרה בסוללה של המכשיר.

• ניתן לחיבור

  ערך בוליאני אופציונלי

  Chrome 48 ואילך

  מציינת אם המכשיר ניתן לחיבור.

• מחובר

  ערך בוליאני אופציונלי

  מציין אם המכשיר מחובר כרגע למערכת.

• עם עצירות ביניים

  ערך בוליאני אופציונלי

  Chrome 48 ואילך

  מציין אם המכשיר מתחבר עכשיו למערכת.

• deviceClass

  מספר אופציונלי

  המחלקה של המכשיר, שדה ביט המוגדר על ידי http://www.bluetooth.org/en-us/specification/assigned-numbers/baseband.

• deviceId

  מספר אופציונלי

• inquiryRssi

  מספר אופציונלי

  Chrome 44 ואילך

  עוצמת האות שנקלטת בדציבלים (dBm). השדה הזה זמין ותקף רק בזמן הגילוי. ערך זה לא צוין מחוץ לגילוי.

• inquiryTxPower

  מספר אופציונלי

  Chrome 44 ואילך

  רמת העוצמה המשודרת. השדה הזה זמין רק למכשירי LE שכוללים את השדה הזה ב-AD. היא זמינה ותקינה רק במהלך הגילוי.

• שם

  מחרוזת אופציונלי

  שם המכשיר שקריא לאנשים.

• התאמה

  ערך בוליאני אופציונלי

  מציין אם המכשיר הותאם למערכת או לא.

• productId

  מספר אופציונלי

• תחבורה

  תחבורה אופציונלי

  Chrome 76 ואילך

  סוג ההעברה של מכשיר ה-Bluetooth.

• סוג

  DeviceType אופציונלי

  סוג המכשיר, אם הוא מזוהה על ידי Chrome. הנתון הזה מופיע מהשדה deviceClass ומייצג רק חלק קטן מסוגי המכשירים האפשריים. אם יש לכם ספק, עדיף להשתמש בשדה deviceClass באופן ישיר.

• uuids

  string[] אופציונלי

  מזהי UUID של פרוטוקולים, פרופילים ושירותים שפורסמו על ידי המכשיר. למכשירי Bluetooth קלאסיים, הרשימה הזו מתקבלת מנתוני EIR ומטבלאות ה-SDP. למכשירים עם צריכת אנרגיה נמוכה, הרשימה הזו מופיעה מהשירותים הראשיים של AD ו-GATT. במכשירים עם שני מצבים ניתן לעשות זאת משניהם.

• vendorId

  מספר אופציונלי

• vendorIdSource

  VendorIdSource אופציונלי

  רשומת מזהה המכשיר של המכשיר, אם היא זמינה.

DeviceType

סוגי מכשירים נפוצים שמזוהים על ידי Chrome.

Enum

"מחשב"

"טלפון"

"modem"

"audio"

"carAudio"

"וידאו"

"ציוד היקפי"

"ג'ויסטיק"

"gamepad"

"מקלדת"

"עכבר"

"טאבלט"

"מקלדתMouseCombo"

FilterType

Chrome 67 ואילך

סוגי סינון מכשירי Bluetooth.

Enum

"הכול"

"ידוע"

Transport

Chrome 76 ואילך

סוג ההעברה של מכשיר ה-Bluetooth.

Enum

"לא חוקי"

"קלאסי"

"le"

"dual"

VendorIdSource

רשויות הקצאה למזהי ספקים.

Enum

"Bluetooth"

"usb"

שיטות

getAdapterState()

הבטחה

chrome.bluetooth.getAdapterState(
  callback?: function,
)

קבלת מידע על מתאם Bluetooth.

פרמטרים

• קריאה חוזרת (callback)

  פונקציה אופציונלית

  הפרמטר callback נראה כך:

  (adapterInfo: AdapterState) => void

  • adapterInfo

    AdapterState

    אובייקט שמכיל את פרטי המתאם.

החזרות

• Promise<AdapterState>

  Chrome מגרסה 91 ואילך

  הבטחות נתמכות רק במניפסט מגרסה V3 ואילך, בפלטפורמות אחרות צריך להשתמש בקריאות חוזרות (callback).

getDevice()

הבטחה

chrome.bluetooth.getDevice(
  deviceAddress: string,
  callback?: function,
)

קבלת מידע על מכשיר Bluetooth שמוכר למערכת.

פרמטרים

• deviceAddress

  מחרוזת

  כתובת המכשיר להורדה.

• קריאה חוזרת (callback)

  פונקציה אופציונלית

  הפרמטר callback נראה כך:

  (deviceInfo: Device) => void

  • deviceInfo

    מכשיר

    אובייקט שמכיל את פרטי המכשיר.

החזרות

• Promise<Device>

  Chrome מגרסה 91 ואילך

  הבטחות נתמכות רק במניפסט מגרסה V3 ואילך, בפלטפורמות אחרות צריך להשתמש בקריאות חוזרות (callback).

getDevices()

הבטחה

chrome.bluetooth.getDevices(
  filter?: BluetoothFilter,
  callback?: function,
)

קבלת רשימה של מכשירי Bluetooth שמוכרים למערכת, כולל מכשירים מותאמים ומכשירים שהתגלו לאחרונה.

פרמטרים

• סינון

  BluetoothFilter אופציונלי

  Chrome 67 ואילך

  כמה קריטריונים לסינון הרשימה של מכשירי Bluetooth שהוחזרו. אם המסנן לא מוגדר או מוגדר לערך {}, רשימת המכשירים שיוחזרו תכיל את כל מכשירי Bluetooth. בשלב הזה האפשרות הזו נתמכת רק ב-ChromeOS. בפלטפורמות אחרות מוצגת רשימה מלאה.

• קריאה חוזרת (callback)

  פונקציה אופציונלית

  הפרמטר callback נראה כך:

  (deviceInfos: Device[]) => void

  • deviceInfos

    מכשיר[]

    מערך של אובייקטים שמכילים מידע מהמכשיר.

החזרות

• התחייבות<מכשיר[]>

  Chrome מגרסה 91 ואילך

  הבטחות נתמכות רק במניפסט מגרסה V3 ואילך, בפלטפורמות אחרות צריך להשתמש בקריאות חוזרות (callback).

startDiscovery()

הבטחה

chrome.bluetooth.startDiscovery(
  callback?: function,
)

מתחילים לגלות. מכשירים חדשים שיתגלו יוחזרו דרך האירוע onDeviceAdded. יש להשיג באמצעות getdevices שכבר נמצאו מוכרים למתאם, והם יעודכנו באמצעות האירוע onDeviceChanged רק אם המידע לגביהם ישתנה.

תהליך הגילוי לא יעבוד אם האפליקציה הזו כבר נקראה startDiscovery. תהליך הגילוי יכול להצריך משאבים רבים: יש להפעיל את stopDiscovery בהקדם האפשרי.

פרמטרים

• קריאה חוזרת (callback)

  פונקציה אופציונלית

  הפרמטר callback נראה כך:

  () => void

החזרות

• הבטחה<Empty>

  Chrome מגרסה 91 ואילך

  הבטחות נתמכות רק במניפסט מגרסה V3 ואילך, בפלטפורמות אחרות צריך להשתמש בקריאות חוזרות (callback).

stopDiscovery()

הבטחה

chrome.bluetooth.stopDiscovery(
  callback?: function,
)

הפסקת הגילוי.

פרמטרים

• קריאה חוזרת (callback)

  פונקציה אופציונלית

  הפרמטר callback נראה כך:

  () => void

החזרות

• הבטחה<Empty>

  Chrome מגרסה 91 ואילך

  הבטחות נתמכות רק במניפסט מגרסה V3 ואילך, בפלטפורמות אחרות צריך להשתמש בקריאות חוזרות (callback).

אירועים

onAdapterStateChanged

chrome.bluetooth.onAdapterStateChanged.addListener(
  callback: function,
)

מופעל כשהמצב של מתאם ה-Bluetooth משתנה.

פרמטרים

• קריאה חוזרת (callback)

  פונקציה

  הפרמטר callback נראה כך:

  (state: AdapterState) => void

  • הסמוי הסופי

    AdapterState

onDeviceAdded

chrome.bluetooth.onDeviceAdded.addListener(
  callback: function,
)

מופעל כשיש מידע על מכשיר Bluetooth חדש.

פרמטרים

• קריאה חוזרת (callback)

  פונקציה

  הפרמטר callback נראה כך:

  (device: Device) => void

  • מכשיר

    מכשיר

onDeviceChanged

chrome.bluetooth.onDeviceChanged.addListener(
  callback: function,
)

מופעל כשמידע על מכשיר Bluetooth מוכר השתנה.

פרמטרים

• קריאה חוזרת (callback)

  פונקציה

  הפרמטר callback נראה כך:

  (device: Device) => void

  • מכשיר

    מכשיר

onDeviceRemoved

chrome.bluetooth.onDeviceRemoved.addListener(
  callback: function,
)

מופעל כשמכשיר Bluetooth שהתגלה בעבר היה מחוץ לטווח למשך זמן ארוך מספיק כדי להיחשב כלא זמין שוב, וכשמסירים מכשיר מותאם.

פרמטרים

• קריאה חוזרת (callback)

  פונקציה

  הפרמטר callback נראה כך:

  (device: Device) => void

  • מכשיר

    מכשיר