chrome.bluetooth

ब्यौरा

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

मेनिफ़ेस्ट

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

"bluetooth"

टाइप

AdapterState

प्रॉपर्टी

  • पता

    स्ट्रिंग

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

  • उपलब्ध

    बूलियन

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

  • discovering

    बूलियन

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

  • नाम

    स्ट्रिंग

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

  • की ओर से

    बूलियन

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

BluetoothFilter

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

प्रॉपर्टी

  • filterType

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

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

  • सीमा

    number ज़रूरी नहीं

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

Device

प्रॉपर्टी

  • पता

    स्ट्रिंग

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

  • batteryPercentage

    number ज़रूरी नहीं

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

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

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

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

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

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

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

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

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

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

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

    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 में यह फ़ील्ड शामिल है. यह सिर्फ़ डिस्कवरी के दौरान उपलब्ध और मान्य है.

  • नाम

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

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

  • जोड़ा गया

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

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

  • productId

    number ज़रूरी नहीं

  • transport

    बस, मेट्रो वगैरह ज़रूरी नहीं है

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

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

  • टाइप

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

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

  • uuids

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

    डिवाइस के विज्ञापन में दिखाए गए प्रोटोकॉल, प्रोफ़ाइलों, और सेवाओं के यूनीक आइडेंटिफ़ायर (यूआईडी). क्लासिक ब्लूटूथ डिवाइसों के लिए, यह सूची EIR डेटा और एसडीपी टेबल से मिलती है. कम ऊर्जा वाले डिवाइसों के लिए, यह सूची 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()

वादा करना 
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

      Device[]

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

रिटर्न

  • Promise<Device[]>

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

    प्रॉमिस सिर्फ़ मेनिफ़ेस्ट V3 और उसके बाद के वर्शन के साथ काम करते हैं. अन्य प्लैटफ़ॉर्म के लिए, कॉलबैक का इस्तेमाल करना ज़रूरी है.

startDiscovery()

वादा करना 
chrome.bluetooth.startDiscovery(
  callback?: function,
)

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

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

पैरामीटर

  • कॉलबैक

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

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

    () => void

रिटर्न

  • Promise<void>

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

    प्रॉमिस सिर्फ़ मेनिफ़ेस्ट V3 और उसके बाद के वर्शन के साथ काम करते हैं. अन्य प्लैटफ़ॉर्म के लिए, कॉलबैक का इस्तेमाल करना ज़रूरी है.

stopDiscovery()

वादा करना 
chrome.bluetooth.stopDiscovery(
  callback?: function,
)

डिस्कवरी बंद करना.

पैरामीटर

  • कॉलबैक

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

    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