chrome.bluetooth

ब्यौरा

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

मेनिफ़ेस्ट

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

"bluetooth"

टाइप

AdapterState

प्रॉपर्टी

  • पता

    स्ट्रिंग

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

  • उपलब्ध

    boolean

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

  • खोज रहे हैं

    boolean

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

  • नाम

    स्ट्रिंग

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

  • पावर

    boolean

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

BluetoothFilter

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

प्रॉपर्टी

  • filterType

    FilterType ज़रूरी नहीं

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

  • सीमा

    नंबर ज़रूरी नहीं

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

Device

प्रॉपर्टी

  • पता

    स्ट्रिंग

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

  • batteryPercentage

    नंबर ज़रूरी नहीं

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

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

  • कनेक्ट किया जा सकने वाला डिवाइस

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

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

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

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

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

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

  • कनेक्‍टिंग

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

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

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

  • deviceClass

    नंबर ज़रूरी नहीं

    डिवाइस की क्लास, http://www.ब्लूटूथ.org/en-us/specification/assigned-numbers/baseबैंड से तय किया गया बिट-फ़ील्ड.

  • deviceId

    नंबर ज़रूरी नहीं

  • inquiryRssi

    नंबर ज़रूरी नहीं

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

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

  • inquiryTxPower

    नंबर ज़रूरी नहीं

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

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

  • नाम

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

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

  • जोड़ा गया

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

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

  • productId

    नंबर ज़रूरी नहीं

  • परिवहन

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

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

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

  • टाइप

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

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

  • यूयूआईडी

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

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

  • vendorId

    नंबर ज़रूरी नहीं

  • vendorIdSource

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

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

DeviceType

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

Enum

"modem"

"carAudio"

FilterType

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

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

Enum

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

      डिवाइस

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

रिटर्न

  • वादा<डिवाइस>

    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 इवेंट का इस्तेमाल करके, सिर्फ़ तब अपडेट किया जाएगा, जब उनकी जानकारी में बदलाव होगा.

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

पैरामीटर

  • कॉलबैक

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

    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