chrome.bluetooth

ब्यौरा

किसी ब्लूटूथ डिवाइस से कनेक्ट करने के लिए, chrome.bluetooth एपीआई का इस्तेमाल करें. सभी फ़ंक्शन, 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+

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

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

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

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

  • नाम

    string ज़रूरी नहीं

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

  • जोड़ा गया

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

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

  • productId

    number ज़रूरी नहीं

  • ट्रांसपोर्ट

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

    Chrome 76+

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

  • टाइप

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

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

  • uuids

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

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

  • 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>

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

पैरामीटर

  • कॉलबैक

    function ज़रूरी नहीं

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

    (adapterInfo: AdapterState) => void

    • adapterInfo

      AdapterState

      अडैप्टर की जानकारी वाला ऑब्जेक्ट.

रिटर्न

  • Promise<AdapterState>

    Chrome 91+

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

getDevice()

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

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

पैरामीटर

  • deviceAddress

    स्ट्रिंग

    उस डिवाइस का पता जिसकी जानकारी चाहिए.

  • कॉलबैक

    function ज़रूरी नहीं

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

    (deviceInfo: Device) => void

    • deviceInfo

      डिवाइस

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

रिटर्न

  • Promise<Device>

    Chrome 91+

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

getDevices()

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

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

पैरामीटर

  • फ़िल्टर

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

    Chrome 67+

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

  • कॉलबैक

    function ज़रूरी नहीं

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

    (deviceInfos: Device[]) => void

    • deviceInfos

      डिवाइस[]

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

रिटर्न

  • Promise<Device[]>

    Chrome 91+

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

startDiscovery()

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

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

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

पैरामीटर

  • कॉलबैक

    function ज़रूरी नहीं

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

    () => void

रिटर्न

  • वादा<शून्य>

    Chrome 91+

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

stopDiscovery()

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

खोज बंद करें.

पैरामीटर

  • कॉलबैक

    function ज़रूरी नहीं

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

    () => void

रिटर्न

  • वादा<शून्य>

    Chrome 91+

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