chrome.bluetooth

ब्यौरा

किसी ब्लूटूथ डिवाइस से कनेक्ट करने के लिए, chrome.bluetooth API का इस्तेमाल करें. सभी फ़ंक्शन, chrome.runtime.lastError के ज़रिए गड़बड़ियों की जानकारी देते हैं.

उपलब्धता

सिर्फ़ ChromeOS के लिए

मेनिफ़ेस्ट

इस एपीआई का इस्तेमाल करने के लिए, इन कुंजियों को मेनिफ़ेस्ट फ़ाइल में शामिल करना ज़रूरी है.

"bluetooth"

टाइप

AdapterState

प्रॉपर्टी

  • पता

    स्ट्रिंग

    अडैप्टर का पता, 'XX:XX:XX:XX:XX:XX' फ़ॉर्मैट में.

  • उपलब्ध

    बूलियन

    इससे पता चलता है कि अडैप्टर उपलब्ध है या नहीं. इसका मतलब है कि अडैप्टर चालू है या नहीं.

  • डिस्कवर करना

    बूलियन

    यह कुकी बताती है कि अडैप्टर फ़िलहाल डिस्कवर कर रहा है या नहीं.

  • नाम

    स्ट्रिंग

    अडैप्टर का ऐसा नाम जिसे आसानी से पढ़ा जा सकता है.

  • की ओर से

    बूलियन

    इससे पता चलता है कि अडैप्टर में पावर है या नहीं.

BluetoothFilter

Chrome 67 या इसके बाद के वर्शन

प्रॉपर्टी

  • filterType

    FilterType ज़रूरी नहीं है

    डिवाइस की सूची पर लागू किए जाने वाले फ़िल्टर का टाइप. डिफ़ॉल्ट रूप से, सभी को अनुमति दी जाती है.

  • सीमा

    number ज़रूरी नहीं

    ब्लूटूथ डिवाइसों की ज़्यादा से ज़्यादा संख्या. अगर कोई वैल्यू नहीं दी जाती है, तो डिफ़ॉल्ट वैल्यू 0 होती है. इसका मतलब है कि कोई सीमा नहीं है.

Device

प्रॉपर्टी

  • पता

    स्ट्रिंग

    डिवाइस का पता, 'XX:XX:XX:XX:XX:XX' फ़ॉर्मैट में.

  • batteryPercentage

    number ज़रूरी नहीं

    Chrome 77 या इसके बाद का वर्शन

    डिवाइस में बची हुई बैटरी.

  • कनेक्ट किया जा सकता है

    boolean optional

    Chrome 48 या इसके बाद का वर्शन

    इससे पता चलता है कि डिवाइस कनेक्ट किया जा सकता है या नहीं.

  • कनेक्ट किया गया

    boolean optional

    इससे पता चलता है कि डिवाइस फ़िलहाल सिस्टम से कनेक्ट है या नहीं.

  • कनेक्ट हो रहा है

    boolean optional

    Chrome 48 या इसके बाद का वर्शन

    इससे पता चलता है कि डिवाइस, फ़िलहाल सिस्टम से कनेक्ट हो रहा है या नहीं.

  • deviceClass

    number ज़रूरी नहीं

    डिवाइस की क्लास. यह एक बिट-फ़ील्ड है, जिसे http://www.bluetooth.org/en-us/specification/assigned-numbers/baseband ने तय किया है.

  • deviceId

    number ज़रूरी नहीं

  • inquiryRssi

    number ज़रूरी नहीं

    Chrome 44 या इसके बाद का वर्शन

    dBm में सिग्नल की क्वालिटी. यह फ़ील्ड सिर्फ़ डिस्कवरी के दौरान उपलब्ध होता है और मान्य होता है. डिस्कवरी के बाहर इसकी वैल्यू तय नहीं की गई है.

  • inquiryTxPower

    number ज़रूरी नहीं

    Chrome 44 या इसके बाद का वर्शन

    ट्रांसमिट किया गया पावर लेवल. यह फ़ील्ड सिर्फ़ उन LE डिवाइसों के लिए उपलब्ध है जो इस फ़ील्ड को AD में शामिल करते हैं. यह सुविधा सिर्फ़ डिस्कवरी के दौरान उपलब्ध होती है और मान्य होती है.

  • नाम

    string ज़रूरी नहीं है

    डिवाइस का ऐसा नाम जिसे आसानी से पढ़ा जा सकता है.

  • जोड़ा गया

    boolean optional

    इससे पता चलता है कि डिवाइस, सिस्टम के साथ पेयर किया गया है या नहीं.

  • productId

    number ज़रूरी नहीं

  • परिवहन

    ट्रांसपोर्ट ज़रूरी नहीं है

    Chrome 76 या इसके बाद के वर्शन

    ब्लूटूथ डिवाइस के ट्रांसपोर्ट का टाइप.

  • टाइप

    DeviceType ज़रूरी नहीं है

    डिवाइस का टाइप. यह जानकारी तब दिखती है, जब Chrome को डिवाइस की पहचान हो जाती है. यह deviceClass फ़ील्ड से मिलता है और यह डिवाइस टाइप के कुछ ही विकल्पों को दिखाता है. अगर आपको किसी बात पर संदेह है, तो सीधे deviceClass फ़ील्ड का इस्तेमाल करें.

  • uuids

    string[] ज़रूरी नहीं है

    डिवाइस के ज़रिए विज्ञापित किए गए प्रोटोकॉल, प्रोफ़ाइलों, और सेवाओं के यूयूआईडी. क्लासिक ब्लूटूथ डिवाइसों के लिए, यह सूची ईआईआर डेटा और एसडीपी टेबल से मिलती है. कम ऊर्जा वाले डिवाइसों के लिए, यह सूची AD और GATT की मुख्य सेवाओं से मिलती है. डुअल मोड वाले डिवाइसों के लिए, यह जानकारी दोनों से मिल सकती है.

  • vendorId

    number ज़रूरी नहीं

  • vendorIdSource

    VendorIdSource ज़रूरी नहीं है

    डिवाइस का डिवाइस आईडी रिकॉर्ड, जहां उपलब्ध हो.

DeviceType

Chrome पर इस्तेमाल किए जाने वाले डिवाइसों के टाइप.

Enum

"computer"

"phone"

"modem"

"audio"

"carAudio"

"video"

"peripheral"

"joystick"

"gamepad"

"keyboard"

"mouse"

"tablet"

"keyboardMouseCombo"

FilterType

Chrome 67 या इसके बाद के वर्शन

ब्लूटूथ डिवाइसों को फ़िल्टर करने के टाइप.

Enum

"all"

"known"

Transport

Chrome 76 या इसके बाद के वर्शन

ब्लूटूथ डिवाइस के ट्रांसपोर्ट का टाइप.

Enum

"invalid"

"classic"

"le"

"dual"

VendorIdSource

वेंडर आईडी असाइन करने वाली संस्थाएं.

Enum

"bluetooth"

"usb"

तरीके

getAdapterState()

Promise 
chrome.bluetooth.getAdapterState(
  callback?: function,
): Promise<AdapterState>

ब्लूटूथ अडैप्टर के बारे में जानकारी पाएं.

पैरामीटर

  • कॉलबैक

    फ़ंक्शन ज़रूरी नहीं

    callback पैरामीटर ऐसा दिखता है: 

    (adapterInfo: AdapterState) => void

    • adapterInfo

      AdapterState

      इस ऑब्जेक्ट में अडैप्टर की जानकारी होती है.

रिटर्न

  • Promise<AdapterState>

    Chrome 91 या इसके बाद का वर्शन

    प्रॉमिस सिर्फ़ मेनिफ़ेस्ट V3 और इसके बाद के वर्शन के लिए काम करते हैं. अन्य प्लैटफ़ॉर्म को कॉलबैक का इस्तेमाल करना होगा.

getDevice()

Promise 
chrome.bluetooth.getDevice(
  deviceAddress: string,
  callback?: function,
): Promise<Device>

सिस्टम से कनेक्ट किए गए ब्लूटूथ डिवाइस के बारे में जानकारी पाएं.

पैरामीटर

  • deviceAddress

    स्ट्रिंग

    डिवाइस का वह पता जिसे पाना है.

  • कॉलबैक

    फ़ंक्शन ज़रूरी नहीं

    callback पैरामीटर ऐसा दिखता है: 

    (deviceInfo: Device) => void

    • deviceInfo

      डिवाइस

      डिवाइस की जानकारी देने वाला ऑब्जेक्ट.

रिटर्न

  • Promise<Device>

    Chrome 91 या इसके बाद का वर्शन

    प्रॉमिस सिर्फ़ मेनिफ़ेस्ट V3 और इसके बाद के वर्शन के लिए काम करते हैं. अन्य प्लैटफ़ॉर्म को कॉलबैक का इस्तेमाल करना होगा.

getDevices()

Promise 
chrome.bluetooth.getDevices(
  filter?: BluetoothFilter,
  callback?: function,
): Promise<Device[]>

सिस्टम को पता है कि कौनसे ब्लूटूथ डिवाइस उपलब्ध हैं. इनमें वे डिवाइस भी शामिल हैं जिन्हें हाल ही में खोजा गया है और वे डिवाइस भी शामिल हैं जिन्हें सिस्टम से जोड़ा गया है.

पैरामीटर

  • फ़िल्टर

    BluetoothFilter ज़रूरी नहीं है

    Chrome 67 या इसके बाद के वर्शन

    ब्लूटूथ डिवाइसों की सूची को फ़िल्टर करने के लिए कुछ शर्तें. अगर फ़िल्टर सेट नहीं किया गया है या इसे {} पर सेट किया गया है, तो डिवाइसों की सूची में सभी ब्लूटूथ डिवाइस शामिल होंगे. फ़िलहाल, यह सुविधा सिर्फ़ ChromeOS पर काम करती है. अन्य प्लैटफ़ॉर्म के लिए, पूरी सूची दिखाई जाती है.

  • कॉलबैक

    फ़ंक्शन ज़रूरी नहीं

    callback पैरामीटर ऐसा दिखता है: 

    (deviceInfos: Device[]) => void

    • deviceInfos

      Device[]

      डिवाइस की जानकारी देने वाले ऑब्जेक्ट का कलेक्शन.

रिटर्न

  • Promise<Device[]>

    Chrome 91 या इसके बाद का वर्शन

    प्रॉमिस सिर्फ़ मेनिफ़ेस्ट V3 और इसके बाद के वर्शन के लिए काम करते हैं. अन्य प्लैटफ़ॉर्म को कॉलबैक का इस्तेमाल करना होगा.

startDiscovery()

Promise 
chrome.bluetooth.startDiscovery(
  callback?: function,
): Promise<void>

खोज शुरू करें. नए डिवाइसों की जानकारी, onDeviceAdded इवेंट के ज़रिए दी जाएगी. पहले से खोजे गए ऐसे डिवाइसों की जानकारी, अडैप्टर को पहले से पता होनी चाहिए. इसके लिए, getDevices का इस्तेमाल करना होगा. साथ ही, अगर इन डिवाइसों की जानकारी में बदलाव होता है, तो उन्हें सिर्फ़ onDeviceChanged इवेंट का इस्तेमाल करके अपडेट किया जाएगा.

अगर इस ऐप्लिकेशन ने पहले ही startDiscovery को कॉल किया है, तो डिस्कवरी शुरू नहीं होगी. डिस्कवरी में ज़्यादा संसाधनों का इस्तेमाल हो सकता है: stopDiscovery को जल्द से जल्द कॉल किया जाना चाहिए.

पैरामीटर

  • कॉलबैक

    फ़ंक्शन ज़रूरी नहीं

    callback पैरामीटर ऐसा दिखता है: 

    () => void

रिटर्न

  • Promise<void>

    Chrome 91 या इसके बाद का वर्शन

    प्रॉमिस सिर्फ़ मेनिफ़ेस्ट V3 और इसके बाद के वर्शन के लिए काम करते हैं. अन्य प्लैटफ़ॉर्म को कॉलबैक का इस्तेमाल करना होगा.

stopDiscovery()

Promise 
chrome.bluetooth.stopDiscovery(
  callback?: function,
): Promise<void>

खोजे जाने की सुविधा बंद करें.

पैरामीटर

  • कॉलबैक

    फ़ंक्शन ज़रूरी नहीं

    callback पैरामीटर ऐसा दिखता है: 

    () => void

रिटर्न

  • Promise<void>

    Chrome 91 या इसके बाद का वर्शन

    प्रॉमिस सिर्फ़ मेनिफ़ेस्ट V3 और इसके बाद के वर्शन के लिए काम करते हैं. अन्य प्लैटफ़ॉर्म को कॉलबैक का इस्तेमाल करना होगा.

इवेंट

onAdapterStateChanged

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

जब ब्लूटूथ अडैप्टर की स्थिति बदलती है, तब यह इवेंट ट्रिगर होता है.

पैरामीटर

  • कॉलबैक

    फ़ंक्शन

    callback पैरामीटर ऐसा दिखता है: 

    (state: AdapterState) => void

onDeviceAdded

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

यह इवेंट तब ट्रिगर होता है, जब किसी नए ब्लूटूथ डिवाइस के बारे में जानकारी उपलब्ध होती है.

पैरामीटर

  • कॉलबैक

    फ़ंक्शन

    callback पैरामीटर ऐसा दिखता है: 

    (device: Device) => void

onDeviceChanged

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

इस इवेंट को तब ट्रिगर किया जाता है, जब किसी जाने-पहचाने ब्लूटूथ डिवाइस की जानकारी में बदलाव होता है.

पैरामीटर

  • कॉलबैक

    फ़ंक्शन

    callback पैरामीटर ऐसा दिखता है: 

    (device: Device) => void

onDeviceRemoved

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

यह इवेंट तब ट्रिगर होता है, जब पहले खोजा गया कोई ब्लूटूथ डिवाइस, लंबे समय तक रेंज से बाहर रहता है. ऐसा तब होता है, जब उसे फिर से उपलब्ध नहीं माना जाता. साथ ही, यह इवेंट तब भी ट्रिगर होता है, जब कोई जुड़ा हुआ डिवाइस हटा दिया जाता है.

पैरामीटर

  • कॉलबैक

    फ़ंक्शन

    callback पैरामीटर ऐसा दिखता है: 

    (device: Device) => void