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

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