chrome.bluetooth

ब्यौरा

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

मेनिफ़ेस्ट

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

"bluetooth"

टाइप

AdapterState

प्रॉपर्टी

  • पता

    स्ट्रिंग

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

  • उपलब्ध

    बूलियन

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

  • खोज रहे हैं

    बूलियन

    यह बताता है कि अडैप्टर अभी खोज कर रहा है या नहीं.

  • नाम

    स्ट्रिंग

    अडैप्टर का वह नाम जिसे कोई भी व्यक्ति आसानी से पढ़ सकता है.

  • चालू

    बूलियन

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

BluetoothFilter

Chrome 67 और उसके बाद के वर्शन

प्रॉपर्टी

  • filterType

    FilterType ज़रूरी नहीं

    डिवाइस सूची पर लागू करने के लिए फ़िल्टर का प्रकार. सभी डिफ़ॉल्ट पर सेट है.

  • सीमा

    नंबर वैकल्पिक

    दिए जाने वाले ब्लूटूथ डिवाइस की ज़्यादा से ज़्यादा संख्या. अगर जानकारी नहीं है, तो डिफ़ॉल्ट 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/baseB के ज़रिए तय किया गया बिट-फ़ील्ड है.

  • deviceId

    नंबर वैकल्पिक

  • inquiryRssi

    नंबर वैकल्पिक

    Chrome 44 और उसके बाद वाले वर्शन के लिए

    सिग्नल की क्षमता, dBm में. यह फ़ील्ड सिर्फ़ खोज के दौरान ही उपलब्ध और मान्य होता है. खोज के बाहर इसका मान नहीं बताया गया है.

  • inquiryTxPower

    नंबर वैकल्पिक

    Chrome 44 और उसके बाद वाले वर्शन के लिए

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

  • नाम

    स्ट्रिंग ज़रूरी नहीं

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

  • जोड़ा गया

    बूलियन ज़रूरी नहीं

    यह बताता है कि डिवाइस को सिस्टम से जोड़ा गया है या नहीं.

  • productId

    नंबर वैकल्पिक

  • परिवहन

    परिवहन ज़रूरी नहीं

    Chrome 76 और उसके बाद के वर्शन

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

  • टाइप

    DeviceType ज़रूरी नहीं

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

  • uuids

    स्ट्रिंग[] ज़रूरी नहीं

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

  • vendorId

    नंबर वैकल्पिक

  • vendorIdSource

    VendorIdSource ज़रूरी नहीं

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

DeviceType

Chrome से पहचाने जाने वाले सामान्य डिवाइस टाइप.

Enum

"कंप्यूटर"

"फ़ोन"

"मॉडेम"

"ऑडियो"

"carAudio"

"वीडियो"

"पेरिफ़रल"

"जॉयस्टिक"

"गेमपैड"

"कीबोर्ड"

"माउस"

"टैबलेट"

"कीबोर्ड MouseCombo"

FilterType

Chrome 67 और उसके बाद के वर्शन

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

Enum

"सभी"

"known"

Transport

Chrome 76 और उसके बाद के वर्शन

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

Enum

"अमान्य"

"क्लासिक"

"le"

"ड्यूअल"

VendorIdSource

वेंडर आईडी के लिए, ऐलोकेशन अथॉरिटी.

Enum

"ब्लूटूथ"

"usb"

तरीके

getAdapterState()

प्रॉमिस 
chrome.bluetooth.getAdapterState(
  callback?: function,
)

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

पैरामीटर

  • कॉलबैक

    फ़ंक्शन वैकल्पिक

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

    (adapterInfo: AdapterState) => void

    • adapterInfo

      AdapterState

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

रिटर्न

  • Promise<AdapterState>

    Chrome 91 और उसके बाद वाले वर्शन के लिए

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

getDevice()

प्रॉमिस 
chrome.bluetooth.getDevice(
  deviceAddress: string,
  callback?: function,
)

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

पैरामीटर

  • deviceAddress

    स्ट्रिंग

    पाने वाले डिवाइस का पता.

  • कॉलबैक

    फ़ंक्शन वैकल्पिक

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

    (deviceInfo: Device) => void

    • deviceInfo

      डिवाइस

      ऑब्जेक्ट में डिवाइस की जानकारी है.

रिटर्न

  • Promise<Device>

    Chrome 91 और उसके बाद वाले वर्शन के लिए

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

getDevices()

प्रॉमिस 
chrome.bluetooth.getDevices(
  filter?: BluetoothFilter,
  callback?: function,
)

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

पैरामीटर

  • फ़िल्टर करें

    BluetoothFilter ज़रूरी नहीं

    Chrome 67 और उसके बाद के वर्शन

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

  • कॉलबैक

    फ़ंक्शन वैकल्पिक

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

    (deviceInfos: Device[]) => void

    • deviceInfos

      डिवाइस[]

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

रिटर्न

  • प्रॉमिस<डिवाइस[]>

    Chrome 91 और उसके बाद वाले वर्शन के लिए

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

startDiscovery()

प्रॉमिस 
chrome.bluetooth.startDiscovery(
  callback?: function,
)

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

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

पैरामीटर

  • कॉलबैक

    फ़ंक्शन वैकल्पिक

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

    () => void

रिटर्न

  • प्रॉमिस<void>

    Chrome 91 और उसके बाद वाले वर्शन के लिए

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

stopDiscovery()

प्रॉमिस 
chrome.bluetooth.stopDiscovery(
  callback?: function,
)

खोजना बंद करें.

पैरामीटर

  • कॉलबैक

    फ़ंक्शन वैकल्पिक

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

    () => void

रिटर्न

  • प्रॉमिस<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