chrome.bluetooth

ब्यौरा

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

मेनिफ़ेस्ट

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

"bluetooth"

टाइप

AdapterState

प्रॉपर्टी

  • पता

    स्ट्रिंग

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

  • उपलब्ध

    बूलियन

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

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

    बूलियन

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

  • नाम

    स्ट्रिंग

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

  • की ओर से

    बूलियन

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

BluetoothFilter

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

प्रॉपर्टी

  • filterType

    FilterType optional

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

  • सीमा

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

  • नाम

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

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

  • जोड़ा गया

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

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

  • productId

    number ज़रूरी नहीं

  • परिवहन

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

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

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

  • टाइप

    DeviceType optional

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

  • uuids

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

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

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

पैरामीटर

  • कॉलबैक

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

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

    (adapterInfo: AdapterState) => void

    • adapterInfo

      AdapterState

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

रिटर्न

  • Promise<AdapterState>

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

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

getDevice()

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

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

पैरामीटर

  • deviceAddress

    स्ट्रिंग

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

  • कॉलबैक

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

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

    (deviceInfo: Device) => void

    • deviceInfo

      डिवाइस

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

रिटर्न

  • Promise<Device>

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

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

getDevices()

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

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

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

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

पैरामीटर

  • कॉलबैक

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

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

    () => void

रिटर्न

  • Promise<void>

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

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

stopDiscovery()

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