ब्यौरा
कनेक्ट किए गए यूएसबी डिवाइसों से इंटरैक्ट करने के लिए, chrome.usb
एपीआई का इस्तेमाल करें. यह एपीआई, किसी ऐप्लिकेशन में यूएसबी से जुड़ी कार्रवाइयों का ऐक्सेस देता है. इस एपीआई का इस्तेमाल करके, ऐप्लिकेशन हार्डवेयर डिवाइसों के ड्राइवर के तौर पर काम कर सकते हैं. इस एपीआई से जनरेट हुई गड़बड़ियों को runtime.lastError
को सेट करके और फ़ंक्शन के सामान्य कॉलबैक को एक्ज़ीक्यूट करके रिपोर्ट किया जाता है. इस मामले में, कॉलबैक के रेगुलर पैरामीटर तय नहीं किए जाएंगे.
अनुमतियां
usb
टाइप
ConfigDescriptor
प्रॉपर्टी
-
सक्रिय
बूलियन
Chrome 47+क्या यह कॉन्फ़िगरेशन चालू है?
-
configurationValue
संख्या
कॉन्फ़िगरेशन नंबर.
-
ब्यौरा
स्ट्रिंग ज़रूरी नहीं
कॉन्फ़िगरेशन का ब्यौरा.
-
extra_data
अरेबफ़र
इस कॉन्फ़िगरेशन से जुड़ा अतिरिक्त डिस्क्रिप्टर डेटा.
-
इंटरफ़ेस
उपलब्ध इंटरफ़ेस.
-
maxPower
संख्या
इस डिवाइस के लिए ज़रूरी पावर की ज़्यादा से ज़्यादा संख्या, मिलीयैंप्स (mA) में होनी चाहिए.
-
remoteWakeup
बूलियन
डिवाइस रिमोट वेकअप की सुविधा देता है.
-
selfPowered
बूलियन
यह डिवाइस अपने-आप काम करता है.
ConnectionHandle
प्रॉपर्टी
-
हैंडल
संख्या
यूएसबी डिवाइस और उससे जुड़े सभी ऐसे इंटरफ़ेस जिन पर दावा किया गया है और ट्रांसफ़र की मंज़ूरी बाकी है, इस कनेक्शन को दिखाने वाला ओपेक हैंडल. डिवाइस को खोलने पर, हर बार एक नया हैंडल बन जाता है. कनेक्शन हैंडल,
Device.device
से अलग है. -
productId
संख्या
प्रॉडक्ट आईडी.
-
vendorId
संख्या
डिवाइस का वेंडर आईडी.
ControlTransferInfo
प्रॉपर्टी
-
डेटा
ArrayBuffer ज़रूरी नहीं है
ट्रांसमिट किया जाने वाला डेटा (सिर्फ़ आउटपुट ट्रांसफ़र के लिए ज़रूरी है).
-
दिशा
ट्रांसफ़र करने का निर्देश (
"in"
या"out"
). -
इंडेक्स
संख्या
wIndex
फ़ील्ड, Ibid देखें. -
लंबाई
नंबर वैकल्पिक
मिलने वाली ज़्यादा से ज़्यादा बाइट की संख्या (सिर्फ़ इनपुट ट्रांसफ़र के लिए ज़रूरी है).
-
उपहार पाने वाला
ट्रांसफ़र टारगेट. अगर
"interface"
या"endpoint"
है, तोindex
के ज़रिए दिए गए टारगेट पर दावा किया जाना चाहिए. -
CANNOT TRANSLATE
संख्या
bRequest
फ़ील्ड में, यूनिवर्सल सीरियल बस स्पेसिफ़िकेशन रिविज़न 1.1 § 9.3 देखें. -
requestType
अनुरोध किस तरह का है.
-
टाइम आउट
नंबर वैकल्पिक
Chrome 43+अनुरोध का टाइम आउट (मिलीसेकंड में). डिफ़ॉल्ट वैल्यू
0
बताती है कि कोई टाइम आउट नहीं है. -
value
संख्या
wValue
फ़ील्ड, Ibid देखें.
Device
प्रॉपर्टी
-
डिवाइस
संख्या
यूएसबी डिवाइस का ओपेक आईडी. डिवाइस के अनप्लग होने तक, इस सेटिंग में कोई बदलाव नहीं होता.
-
manufacturerName
स्ट्रिंग
Chrome 46 और उसके बाद के वर्शनअगर उपलब्ध हो, तो डिवाइस से ली गई iManufacturer स्ट्रिंग को.
-
productId
संख्या
प्रॉडक्ट आईडी.
-
productName
स्ट्रिंग
Chrome 46 और उसके बाद के वर्शनउपलब्ध होने पर, डिवाइस से पढ़ी जाने वाली iProduct स्ट्रिंग.
-
serialNumber
स्ट्रिंग
Chrome 46 और उसके बाद के वर्शनउपलब्ध होने पर, डिवाइस से पढ़ी गई iSerialNumber स्ट्रिंग.
-
vendorId
संख्या
डिवाइस का वेंडर आईडी.
-
वर्शन
संख्या
Chrome 51 और उसके बाद वाले वर्शन के लिएडिवाइस का वर्शन (bcdडिवाइस फ़ील्ड).
DeviceFilter
प्रॉपर्टी
-
interfaceClass
नंबर वैकल्पिक
यूएसबी इंटरफ़ेस की क्लास, डिवाइस के किसी भी इंटरफ़ेस से मेल खाती है.
-
interfaceProtocol
नंबर वैकल्पिक
यूएसबी इंटरफ़ेस प्रोटोकॉल, सिर्फ़ इंटरफ़ेस की सब-क्लास के मेल खाने पर चुना गया.
-
interfaceSubclass
नंबर वैकल्पिक
यूएसबी इंटरफ़ेस की सब-क्लास. इसे सिर्फ़ इंटरफ़ेस क्लास के मेल खाने पर ही चुना गया है.
-
productId
नंबर वैकल्पिक
डिवाइस प्रॉडक्ट आईडी, सिर्फ़ वेंडर आईडी के मेल खाने पर ही जांचा गया.
-
vendorId
नंबर वैकल्पिक
डिवाइस वेंडर आईडी.
DevicePromptOptions
प्रॉपर्टी
-
फ़िल्टर
DeviceFilter[] ज़रूरी नहीं
उपयोगकर्ता को दिखाए गए डिवाइसों की सूची को फ़िल्टर करें. अगर किसी फ़िल्टर से मिलते-जुलते कई डिवाइस दिए गए हैं, तो वे डिवाइस दिखाए जाएंगे.
-
एक से ज़्यादा
बूलियन ज़रूरी नहीं
उपयोगकर्ता को एक से ज़्यादा डिवाइस चुनने की अनुमति दें.
Direction
निर्देश, पाने वाले व्यक्ति, रिक्वेस्ट टाइप, और ट्रांसफ़र टाइप सभी मैप को उनके नाम के साथ यूएसबी की खास जानकारी में शामिल करते हैं.
Enum
"इन"
"आउट"
EndpointDescriptor
प्रॉपर्टी
-
पता
संख्या
एंडपॉइंट पता.
-
दिशा
ट्रांसफ़र की दिशा.
-
extra_data
अरेबफ़र
इस एंडपॉइंट से जुड़ा अतिरिक्त डिस्क्रिप्टर डेटा.
-
maximumPacketSize
संख्या
पैकेट का ज़्यादा से ज़्यादा साइज़.
-
pollingInterval
नंबर वैकल्पिक
पोलिंग इंटरवल (सिर्फ़ बीच में रुकावट और आइसोक्रोनस).
-
सिंक करना
SynchronizationType ज़रूरी नहीं
सिंक करने का मोड ट्रांसफ़र करें (सिर्फ़ सिंक्रोनस).
-
टाइप
ट्रांसफ़र किस तरह का है.
-
इस्तेमाल
UsageType ज़रूरी नहीं
एंडपॉइंट के इस्तेमाल से जुड़ा संकेत.
EnumerateDevicesAndRequestAccessOptions
प्रॉपर्टी
-
interfaceId
नंबर वैकल्पिक
वह इंटरफ़ेस आईडी जिसके ऐक्सेस का अनुरोध करना है. यह सुविधा सिर्फ़ Chrome OS पर उपलब्ध है. दूसरे प्लैटफ़ॉर्म पर इसका कोई असर नहीं पड़ता.
-
productId
संख्या
प्रॉडक्ट आईडी.
-
vendorId
संख्या
डिवाइस का वेंडर आईडी.
EnumerateDevicesOptions
प्रॉपर्टी
-
फ़िल्टर
DeviceFilter[] ज़रूरी नहीं
किसी भी फ़िल्टर से मेल खाने वाला डिवाइस लौटाया जाएगा. खाली फ़िल्टर सूची में, वे सभी डिवाइस दिखेंगे जिनका इस्तेमाल करने के लिए, ऐप्लिकेशन को अनुमति है.
-
productId
नंबर वैकल्पिक
अब काम नहीं करताDeviceFilter.productId
सेटिंग के बराबर. -
vendorId
नंबर वैकल्पिक
अब काम नहीं करताDeviceFilter.vendorId
सेटिंग के बराबर.
GenericTransferInfo
प्रॉपर्टी
-
डेटा
ArrayBuffer ज़रूरी नहीं है
ट्रांसमिट किया जाने वाला डेटा (सिर्फ़ आउटपुट ट्रांसफ़र के लिए ज़रूरी है).
-
दिशा
ट्रांसफ़र करने का निर्देश (
"in"
या"out"
). -
एंडपॉइंट
संख्या
टारगेट एंडपॉइंट पता. इस एंडपॉइंट वाले इंटरफ़ेस पर दावा किया जाना चाहिए.
-
लंबाई
नंबर वैकल्पिक
मिलने वाली ज़्यादा से ज़्यादा बाइट की संख्या (सिर्फ़ इनपुट ट्रांसफ़र के लिए ज़रूरी है).
-
टाइम आउट
नंबर वैकल्पिक
Chrome 43+अनुरोध का टाइम आउट (मिलीसेकंड में). डिफ़ॉल्ट वैल्यू
0
बताती है कि कोई टाइम आउट नहीं है.
InterfaceDescriptor
प्रॉपर्टी
-
alternateSetting
संख्या
इंटरफ़ेस की वैकल्पिक सेटिंग संख्या (डिफ़ॉल्ट रूप से यह
0
पर सेट होती है) -
ब्यौरा
स्ट्रिंग ज़रूरी नहीं
इंटरफ़ेस का ब्यौरा.
-
एंडपॉइंट
उपलब्ध एंडपॉइंट.
-
extra_data
अरेबफ़र
इस इंटरफ़ेस से जुड़ा अतिरिक्त डिस्क्रिप्टर डेटा.
-
interfaceClass
संख्या
यूएसबी इंटरफ़ेस की क्लास.
-
interfaceNumber
संख्या
इंटरफ़ेस नंबर.
-
interfaceProtocol
संख्या
यूएसबी इंटरफ़ेस प्रोटोकॉल.
-
interfaceSubclass
संख्या
यूएसबी इंटरफ़ेस की सब-क्लास.
IsochronousTransferInfo
प्रॉपर्टी
-
packetLength
संख्या
इस ट्रांसफ़र में, हर पैकेट की लंबाई.
-
पैकेट
संख्या
इस ट्रांसफ़र में पैकेट की कुल संख्या.
-
transferInfo
पैरामीटर ट्रांसफ़र करना. इस पैरामीटर ब्लॉक में तय की गई ट्रांसफ़र की लंबाई या डेटा बफ़र को
packetLength
सीमाओं में बांटा जाता है, ताकि ट्रांसफ़र के अलग-अलग पैकेट बनाए जा सकें.
Recipient
Enum
"डिवाइस"
"इंटरफ़ेस"
"एंडपॉइंट"
"अन्य"
RequestType
Enum
"स्टैंडर्ड"
"क्लास"
"वेंडर"
"रिज़र्व्ड"
SynchronizationType
इंटरप्ट और आइसोक्रोनस मोड के लिए, SynchronizationType और UsageType यूएसबी की खासियतों के मुताबिक अपने नाम से मैप होते हैं.
Enum
"एसिंक्रोनस"
"अडैप्टिव"
"सिंक्रोनस"
TransferResultInfo
प्रॉपर्टी
-
डेटा
ArrayBuffer ज़रूरी नहीं है
इनपुट ट्रांसफ़र से मिला डेटा. आउटपुट ट्रांसफ़र के लिए
undefined
. -
resultCode
नंबर वैकल्पिक
0
वैल्यू बताती है कि ट्रांसफ़र पूरा हुआ. अन्य वैल्यू से पता चलता है कि गड़बड़ी ठीक नहीं हुई है.
TransferType
Enum
"control"
"बात करें"
"अलग-अलग तरह का"
"बल्क"
UsageType
Enum
"डेटा"
"सुझाव"
"अश्लील सुझाव"
"समय-समय पर"
"सूचना"
तरीके
bulkTransfer()
chrome.usb.bulkTransfer(
handle: ConnectionHandle,
transferInfo: GenericTransferInfo,
callback?: function,
)
बताए गए डिवाइस पर बल्क ट्रांसफ़र करता है.
पैरामीटर
-
हैंडल
डिवाइस से खुला कनेक्शन.
-
transferInfo
ट्रांसफ़र के पैरामीटर.
-
कॉलबैक
फ़ंक्शन वैकल्पिक
callback
पैरामीटर ऐसा दिखता है:(info: TransferResultInfo) => void
-
जानकारी
-
रिटर्न
-
Promise<TransferResultInfo>
Chrome 116 और उसके बाद वाले वर्शनप्रॉमिस सिर्फ़ मेनिफ़ेस्ट V3 और उसके बाद के वर्शन पर काम करता है. दूसरे प्लैटफ़ॉर्म को कॉलबैक इस्तेमाल करने होते हैं.
claimInterface()
chrome.usb.claimInterface(
handle: ConnectionHandle,
interfaceNumber: number,
callback?: function,
)
यूएसबी डिवाइस के इंटरफ़ेस का दावा करता है. डेटा को किसी इंटरफ़ेस या उससे जुड़े एंडपॉइंट पर ट्रांसफ़र करने से पहले, इंटरफ़ेस पर दावा करना ज़रूरी है. एक समय पर, सिर्फ़ एक कनेक्शन हैंडल ही किसी इंटरफ़ेस पर दावा कर सकता है. अगर इंटरफ़ेस पर पहले से ही दावा किया जा चुका है, तो इस कॉल की प्रक्रिया पूरी नहीं हो पाएगी.
जब इंटरफ़ेस की ज़रूरत न हो, तब releaseInterface
को कॉल किया जाना चाहिए.
पैरामीटर
-
हैंडल
डिवाइस से खुला कनेक्शन.
-
interfaceNumber
संख्या
दावा किया जाने वाला इंटरफ़ेस.
-
कॉलबैक
फ़ंक्शन वैकल्पिक
callback
पैरामीटर ऐसा दिखता है:() => void
रिटर्न
-
प्रॉमिस<void>
Chrome 116 और उसके बाद वाले वर्शनप्रॉमिस सिर्फ़ मेनिफ़ेस्ट V3 और उसके बाद के वर्शन पर काम करता है. दूसरे प्लैटफ़ॉर्म को कॉलबैक इस्तेमाल करने होते हैं.
closeDevice()
chrome.usb.closeDevice(
handle: ConnectionHandle,
callback?: function,
)
कनेक्शन हैंडल को बंद करता है. हैंडल बंद होने के बाद, उस पर ऑपरेशन शुरू करना एक सुरक्षित तरीका है. हालांकि, उस पर कोई कार्रवाई नहीं की जाती.
पैरामीटर
-
हैंडल
बंद करने के लिए
ConnectionHandle
. -
कॉलबैक
फ़ंक्शन वैकल्पिक
callback
पैरामीटर ऐसा दिखता है:() => void
रिटर्न
-
प्रॉमिस<void>
Chrome 116 और उसके बाद वाले वर्शनप्रॉमिस सिर्फ़ मेनिफ़ेस्ट V3 और उसके बाद के वर्शन पर काम करता है. दूसरे प्लैटफ़ॉर्म को कॉलबैक इस्तेमाल करने होते हैं.
controlTransfer()
chrome.usb.controlTransfer(
handle: ConnectionHandle,
transferInfo: ControlTransferInfo,
callback?: function,
)
बताए गए डिवाइस पर कंट्रोल ट्रांसफ़र करता है.
कंट्रोल ट्रांसफ़र का मतलब डिवाइस, इंटरफ़ेस या एंडपॉइंट से है. किसी इंटरफ़ेस या एंडपॉइंट पर ट्रांसफ़र करने के लिए, इंटरफ़ेस पर दावा करना ज़रूरी है.
पैरामीटर
-
हैंडल
डिवाइस से खुला कनेक्शन.
-
transferInfo
-
कॉलबैक
फ़ंक्शन वैकल्पिक
callback
पैरामीटर ऐसा दिखता है:(info: TransferResultInfo) => void
-
जानकारी
-
रिटर्न
-
Promise<TransferResultInfo>
Chrome 116 और उसके बाद वाले वर्शनप्रॉमिस सिर्फ़ मेनिफ़ेस्ट V3 और उसके बाद के वर्शन पर काम करता है. दूसरे प्लैटफ़ॉर्म को कॉलबैक इस्तेमाल करने होते हैं.
findDevices()
chrome.usb.findDevices(
options: EnumerateDevicesAndRequestAccessOptions,
callback?: function,
)
यह नीति, वेंडर, प्रॉडक्ट, और (वैकल्पिक तौर पर) इंटरफ़ेस आईडी से तय किए गए यूएसबी डिवाइसों को ढूंढती है. साथ ही, अगर अनुमतियां दी गई हों, तो उन्हें इस्तेमाल करने के लिए खोला जा सकता है.
अगर ऐक्सेस का अनुरोध अस्वीकार कर दिया जाता है या डिवाइस को नहीं खोला जाता है, तो कनेक्शन हैंडल बनाया या लौटाया नहीं जाएगा.
इस तरीके से कॉल करना, getDevices
को कॉल करने के बाद हर डिवाइस के लिए openDevice
को कॉल करने के बराबर है.
पैरामीटर
-
टारगेट किए गए डिवाइसों पर खोजी जाने वाली प्रॉपर्टी.
-
कॉलबैक
फ़ंक्शन वैकल्पिक
callback
पैरामीटर ऐसा दिखता है:(handles: ConnectionHandle[]) => void
-
हैंडल
-
रिटर्न
-
Promise<ConnectionHandle[]>
Chrome 116 और उसके बाद वाले वर्शनप्रॉमिस सिर्फ़ मेनिफ़ेस्ट V3 और उसके बाद के वर्शन पर काम करता है. दूसरे प्लैटफ़ॉर्म को कॉलबैक इस्तेमाल करने होते हैं.
getConfiguration()
chrome.usb.getConfiguration(
handle: ConnectionHandle,
callback?: function,
)
हाल ही में चुने गए कॉन्फ़िगरेशन के लिए, कॉन्फ़िगरेशन डिस्क्रिप्टर की सुविधा मिलती है.
पैरामीटर
-
हैंडल
डिवाइस से खुला कनेक्शन.
-
कॉलबैक
फ़ंक्शन वैकल्पिक
callback
पैरामीटर ऐसा दिखता है:(config: ConfigDescriptor) => void
-
कॉन्फ़िगरेशन
-
रिटर्न
-
Promise<ConfigDescriptor>
Chrome 116 और उसके बाद वाले वर्शनप्रॉमिस सिर्फ़ मेनिफ़ेस्ट V3 और उसके बाद के वर्शन पर काम करता है. दूसरे प्लैटफ़ॉर्म को कॉलबैक इस्तेमाल करने होते हैं.
getConfigurations()
chrome.usb.getConfigurations(
device: Device,
callback?: function,
)
डिवाइस कॉन्फ़िगरेशन डिस्क्रिप्टर का पूरा सेट दिखाता है.
पैरामीटर
-
डिवाइस
वह
Device
जिससे डिस्क्रिप्टर फ़ेच किए जाते हैं. -
कॉलबैक
फ़ंक्शन वैकल्पिक
callback
पैरामीटर ऐसा दिखता है:(configs: ConfigDescriptor[]) => void
-
कॉन्फ़िगरेशन
-
रिटर्न
-
Promise<ConfigDescriptor[]>
Chrome 116 और उसके बाद वाले वर्शनप्रॉमिस सिर्फ़ मेनिफ़ेस्ट V3 और उसके बाद के वर्शन पर काम करता है. दूसरे प्लैटफ़ॉर्म को कॉलबैक इस्तेमाल करने होते हैं.
getDevices()
chrome.usb.getDevices(
options: EnumerateDevicesOptions,
callback?: function,
)
कनेक्ट किए गए यूएसबी डिवाइसों की गिनती करता है.
पैरामीटर
रिटर्न
-
प्रॉमिस<डिवाइस[]>
Chrome 116 और उसके बाद वाले वर्शनप्रॉमिस सिर्फ़ मेनिफ़ेस्ट V3 और उसके बाद के वर्शन पर काम करता है. दूसरे प्लैटफ़ॉर्म को कॉलबैक इस्तेमाल करने होते हैं.
getUserSelectedDevices()
chrome.usb.getUserSelectedDevices(
options: DevicePromptOptions,
callback?: function,
)
यह उपयोगकर्ता को डिवाइस पिकर दिखाता है. साथ ही, चुने गए Device
नतीजे दिखाता है. अगर उपयोगकर्ता पिकर को रद्द करता है, तो डिवाइस खाली रहेगा. डायलॉग दिखाने के लिए, उपयोगकर्ता का जेस्चर ज़रूरी है. उपयोगकर्ता के जेस्चर के बिना, कॉलबैक ऐसे चलेगा जैसे कि उपयोगकर्ता ने रद्द किया हो.
पैरामीटर
रिटर्न
-
प्रॉमिस<डिवाइस[]>
Chrome 116 और उसके बाद वाले वर्शनप्रॉमिस सिर्फ़ मेनिफ़ेस्ट V3 और उसके बाद के वर्शन पर काम करता है. दूसरे प्लैटफ़ॉर्म को कॉलबैक इस्तेमाल करने होते हैं.
interruptTransfer()
chrome.usb.interruptTransfer(
handle: ConnectionHandle,
transferInfo: GenericTransferInfo,
callback?: function,
)
बताए गए डिवाइस पर रुकावट ट्रांसफ़र करता है.
पैरामीटर
-
हैंडल
डिवाइस से खुला कनेक्शन.
-
transferInfo
ट्रांसफ़र के पैरामीटर.
-
कॉलबैक
फ़ंक्शन वैकल्पिक
callback
पैरामीटर ऐसा दिखता है:(info: TransferResultInfo) => void
-
जानकारी
-
रिटर्न
-
Promise<TransferResultInfo>
Chrome 116 और उसके बाद वाले वर्शनप्रॉमिस सिर्फ़ मेनिफ़ेस्ट V3 और उसके बाद के वर्शन पर काम करता है. दूसरे प्लैटफ़ॉर्म को कॉलबैक इस्तेमाल करने होते हैं.
isochronousTransfer()
chrome.usb.isochronousTransfer(
handle: ConnectionHandle,
transferInfo: IsochronousTransferInfo,
callback?: function,
)
किसी खास डिवाइस पर एक सिंक्रोनस ट्रांसफ़र करता है.
पैरामीटर
-
हैंडल
डिवाइस से खुला कनेक्शन.
-
transferInfo
-
कॉलबैक
फ़ंक्शन वैकल्पिक
callback
पैरामीटर ऐसा दिखता है:(info: TransferResultInfo) => void
-
जानकारी
-
रिटर्न
-
Promise<TransferResultInfo>
Chrome 116 और उसके बाद वाले वर्शनप्रॉमिस सिर्फ़ मेनिफ़ेस्ट V3 और उसके बाद के वर्शन पर काम करता है. दूसरे प्लैटफ़ॉर्म को कॉलबैक इस्तेमाल करने होते हैं.
listInterfaces()
chrome.usb.listInterfaces(
handle: ConnectionHandle,
callback?: function,
)
किसी USB डिवाइस पर सभी इंटरफ़ेस की सूची बनाता है.
पैरामीटर
-
हैंडल
डिवाइस से खुला कनेक्शन.
-
कॉलबैक
फ़ंक्शन वैकल्पिक
callback
पैरामीटर ऐसा दिखता है:(descriptors: InterfaceDescriptor[]) => void
-
डिस्क्रिप्टर
-
रिटर्न
-
Promise<InterfaceDescriptor[]>
Chrome 116 और उसके बाद वाले वर्शनप्रॉमिस सिर्फ़ मेनिफ़ेस्ट V3 और उसके बाद के वर्शन पर काम करता है. दूसरे प्लैटफ़ॉर्म को कॉलबैक इस्तेमाल करने होते हैं.
openDevice()
chrome.usb.openDevice(
device: Device,
callback?: function,
)
getDevices
से लौटाए गए यूएसबी डिवाइस को खोलता है.
पैरामीटर
-
डिवाइस
खोलने के लिए
Device
. -
कॉलबैक
फ़ंक्शन वैकल्पिक
callback
पैरामीटर ऐसा दिखता है:(handle: ConnectionHandle) => void
-
हैंडल
-
रिटर्न
-
Promise<ConnectionHandle>
Chrome 116 और उसके बाद वाले वर्शनप्रॉमिस सिर्फ़ मेनिफ़ेस्ट V3 और उसके बाद के वर्शन पर काम करता है. दूसरे प्लैटफ़ॉर्म को कॉलबैक इस्तेमाल करने होते हैं.
releaseInterface()
chrome.usb.releaseInterface(
handle: ConnectionHandle,
interfaceNumber: number,
callback?: function,
)
दावा किया गया इंटरफ़ेस रिलीज़ करता है.
पैरामीटर
-
हैंडल
डिवाइस से खुला कनेक्शन.
-
interfaceNumber
संख्या
रिलीज़ किया जाने वाला इंटरफ़ेस.
-
कॉलबैक
फ़ंक्शन वैकल्पिक
callback
पैरामीटर ऐसा दिखता है:() => void
रिटर्न
-
प्रॉमिस<void>
Chrome 116 और उसके बाद वाले वर्शनप्रॉमिस सिर्फ़ मेनिफ़ेस्ट V3 और उसके बाद के वर्शन पर काम करता है. दूसरे प्लैटफ़ॉर्म को कॉलबैक इस्तेमाल करने होते हैं.
requestAccess()
chrome.usb.requestAccess(
device: Device,
interfaceId: number,
callback?: function,
)
यह फ़ंक्शन खास तौर पर Chrome OS के लिए था. इसलिए, इसे अन्य प्लैटफ़ॉर्म पर कॉल नहीं किया जा सकेगा. यह कार्रवाई अब साफ़ तौर पर openDevice
के हिस्से के तौर पर की जाती है और यह फ़ंक्शन सभी प्लैटफ़ॉर्म पर true
दिखाएगा.
अगर डिवाइस के दिए गए इंटरफ़ेस पर दावा नहीं किया गया है, तो Chrome OS के ज़रिए दावा किए गए डिवाइस को अनुमति ब्रोकर से ऐक्सेस करने का अनुरोध किया जाता है.
पैरामीटर
-
डिवाइस
ऐक्सेस का अनुरोध करने के लिए,
Device
. -
interfaceId
संख्या
वह खास इंटरफ़ेस जिसके लिए अनुरोध किया गया था.
-
कॉलबैक
फ़ंक्शन वैकल्पिक
callback
पैरामीटर ऐसा दिखता है:(success: boolean) => void
-
सफलता
बूलियन
-
रिटर्न
-
Promise<boolean>
Chrome 116 और उसके बाद वाले वर्शनप्रॉमिस सिर्फ़ मेनिफ़ेस्ट V3 और उसके बाद के वर्शन पर काम करता है. दूसरे प्लैटफ़ॉर्म को कॉलबैक इस्तेमाल करने होते हैं.
resetDevice()
chrome.usb.resetDevice(
handle: ConnectionHandle,
callback?: function,
)
यूएसबी डिवाइस को रीसेट करने की कोशिश करता है. अगर रीसेट नहीं हो पाता है, तो दिया गया कनेक्शन हैंडल बंद हो जाएगा. साथ ही, यूएसबी डिवाइस, डिसकनेक्ट होने के बाद फिर से कनेक्ट दिखेगा. ऐसे में, डिवाइस का ऐक्सेस पाने के लिए getDevices
या findDevices
को फिर से कॉल करना होगा.
पैरामीटर
-
हैंडल
रीसेट करने के लिए कनेक्शन हैंडल.
-
कॉलबैक
फ़ंक्शन वैकल्पिक
callback
पैरामीटर ऐसा दिखता है:(success: boolean) => void
-
सफलता
बूलियन
-
रिटर्न
-
Promise<boolean>
Chrome 116 और उसके बाद वाले वर्शनप्रॉमिस सिर्फ़ मेनिफ़ेस्ट V3 और उसके बाद के वर्शन पर काम करता है. दूसरे प्लैटफ़ॉर्म को कॉलबैक इस्तेमाल करने होते हैं.
setConfiguration()
chrome.usb.setConfiguration(
handle: ConnectionHandle,
configurationValue: number,
callback?: function,
)
कोई डिवाइस कॉन्फ़िगरेशन चुनें.
यह फ़ंक्शन, डिवाइस के उपलब्ध कॉन्फ़िगरेशन में से किसी एक को चुनकर, डिवाइस को असरदार तरीके से रीसेट करता है. सिर्फ़ 0
से बड़ी कॉन्फ़िगरेशन वैल्यू मान्य होती हैं. हालांकि, कुछ गड़बड़ी वाले डिवाइसों का कॉन्फ़िगरेशन 0
काम कर रहा है, इसलिए इस वैल्यू की अनुमति है.
पैरामीटर
-
हैंडल
डिवाइस से खुला कनेक्शन.
-
configurationValue
संख्या
-
कॉलबैक
फ़ंक्शन वैकल्पिक
callback
पैरामीटर ऐसा दिखता है:() => void
रिटर्न
-
प्रॉमिस<void>
Chrome 116 और उसके बाद वाले वर्शनप्रॉमिस सिर्फ़ मेनिफ़ेस्ट V3 और उसके बाद के वर्शन पर काम करता है. दूसरे प्लैटफ़ॉर्म को कॉलबैक इस्तेमाल करने होते हैं.
setInterfaceAlternateSetting()
chrome.usb.setInterfaceAlternateSetting(
handle: ConnectionHandle,
interfaceNumber: number,
alternateSetting: number,
callback?: function,
)
पहले दावा किए गए इंटरफ़ेस पर कोई दूसरी सेटिंग चुनता है.
पैरामीटर
-
हैंडल
उस डिवाइस से एक ओपन कनेक्शन, जिस पर इस इंटरफ़ेस पर दावा किया गया है.
-
interfaceNumber
संख्या
कॉन्फ़िगर करने के लिए इंटरफ़ेस.
-
alternateSetting
संख्या
कॉन्फ़िगर करने के लिए दूसरी सेटिंग.
-
कॉलबैक
फ़ंक्शन वैकल्पिक
callback
पैरामीटर ऐसा दिखता है:() => void
रिटर्न
-
प्रॉमिस<void>
Chrome 116 और उसके बाद वाले वर्शनप्रॉमिस सिर्फ़ मेनिफ़ेस्ट V3 और उसके बाद के वर्शन पर काम करता है. दूसरे प्लैटफ़ॉर्म को कॉलबैक इस्तेमाल करने होते हैं.
इवेंट
onDeviceAdded
chrome.usb.onDeviceAdded.addListener(
callback: function,
)
इवेंट तब जनरेट होता है, जब किसी डिवाइस को सिस्टम में जोड़ा जाता है. इवेंट सिर्फ़ उन ऐप्लिकेशन और एक्सटेंशन पर ब्रॉडकास्ट किए जाते हैं जिनके पास डिवाइस को ऐक्सेस करने की अनुमति है. ऐसा हो सकता है कि इंस्टॉल करते समय, जब उपयोगकर्ता ने वैकल्पिक अनुमति (permissions.request
देखें) या getUserSelectedDevices
को स्वीकार किया हो.
onDeviceRemoved
chrome.usb.onDeviceRemoved.addListener(
callback: function,
)
सिस्टम से डिवाइस हटाए जाने पर इवेंट जनरेट होता है. onDeviceAdded
देखें कि कौनसे इवेंट डिलीवर किए गए हैं.