ब्यौरा
chrome.audio
एपीआई इसलिए दिया जाता है, ताकि उपयोगकर्ताओं को सिस्टम से जुड़े ऑडियो डिवाइसों के बारे में जानकारी पाने और उन्हें कंट्रोल करने में मदद मिल सके. फ़िलहाल, यह एपीआई सिर्फ़ ChromeOS के लिए कीऑस्क मोड में उपलब्ध है.
अनुमतियां
audio
उपलब्धता
टाइप
AudioDeviceInfo
प्रॉपर्टी
-
deviceName
स्ट्रिंग
डिवाइस का नाम
-
deviceType
डिवाइस का टाइप.
-
displayName
स्ट्रिंग
उपयोगकर्ता को आसानी से समझ में आने वाला नाम, जैसे कि "यूएसबी माइक्रोफ़ोन".
-
id
स्ट्रिंग
ऑडियो डिवाइस का यूनीक आइडेंटिफ़ायर.
-
isActive
boolean
अगर यह मौजूदा डिवाइस है, तो 'सही है'.
-
लेवल
नंबर
डिवाइस की आवाज़ का स्तर, आउटपुट के लिए वॉल्यूम, इनपुट के लिए गेन.
-
stableDeviceId
स्ट्रिंग ज़रूरी नहीं
उपलब्ध होने पर, स्टेबल/परसिस्टेंट डिवाइस आईडी स्ट्रिंग.
-
streamType
इस डिवाइस से जुड़ी स्ट्रीम का टाइप.
DeviceFilter
प्रॉपर्टी
-
isActive
बूलियन ज़रूरी नहीं
अगर इस नीति को सेट किया जाता है, तो सिर्फ़ उन ऑडियो डिवाइसों को इसका इस्तेमाल किया जाएगा जिनकी चालू स्थिति इस वैल्यू से मेल खाती है.
-
streamTypes
StreamType[] ज़रूरी नहीं है
अगर इस नीति को सेट किया जाता है, तो सिर्फ़ उन ऑडियो डिवाइसों को फ़िल्टर किया जाएगा जिनकी स्ट्रीम का टाइप इस सूची में शामिल है.
DeviceIdLists
प्रॉपर्टी
-
इनपुट
स्ट्रिंग[] ज़रूरी नहीं है
इनपुट डिवाइसों की सूची, उनके आईडी के हिसाब से दी गई है.
यह बताने के लिए कि इनपुट डिवाइसों पर कोई असर नहीं पड़ेगा, इस प्रॉपर्टी को सेट न करें.
-
आउटपुट
स्ट्रिंग[] ज़रूरी नहीं है
उन आउटपुट डिवाइसों की सूची जिनके आईडी के हिसाब से डिवाइस का इस्तेमाल किया जाता है.
यह बताने के लिए कि आउटपुट डिवाइसों पर कोई असर न पड़े, इस प्रॉपर्टी को सेट न करें.
DeviceProperties
प्रॉपर्टी
-
लेवल
नंबर ज़रूरी नहीं
ऑडियो डिवाइस के मुताबिक आवाज़ का लेवल. डिफ़ॉल्ट रूप से, यह डिवाइस की आवाज़ के मौजूदा लेवल पर सेट होती है.
अगर ऑडियो इनपुट डिवाइस के साथ इस्तेमाल किया जाता है, तो इससे ऑडियो डिवाइस के मुनाफ़े का पता चलता है.
अगर इसका इस्तेमाल ऑडियो आउटपुट डिवाइस के साथ किया जाता है, तो इससे ऑडियो डिवाइस के वॉल्यूम का पता चलता है.
DeviceType
ऑडियो डिवाइस के उपलब्ध टाइप.
Enum
"BLUETOOTH"
"INTERNAL_SPEAKER"
"INTERNAL_MIC"
"FRONT_MIC"
"REAR_MIC"
"LINEOUT"
"POST_MIX_LOOPBACK"
"POST_DSP_LOOPBACK"
"ALSA_LOOPBACK"
"OTHER"
LevelChangedEvent
प्रॉपर्टी
-
deviceId
स्ट्रिंग
उस डिवाइस का आईडी जिसकी आवाज़ का लेवल बदल गया है.
-
लेवल
नंबर
डिवाइस का नया आवाज़ लेवल.
MuteChangedEvent
प्रॉपर्टी
-
isMuted
boolean
स्ट्रीम को अब म्यूट किया गया है या नहीं.
-
streamType
स्ट्रीम का वह टाइप जिसके लिए म्यूट वैल्यू बदली गई है. म्यूट करने के लिए अपडेट की गई वैल्यू, इस तरह की स्ट्रीम वाले सभी डिवाइसों पर लागू होती है.
StreamType
ऑडियो डिवाइस किस तरह की स्ट्रीम उपलब्ध कराता है.
Enum
"INPUT"
तरीके
getDevices()
chrome.audio.getDevices(
filter?: DeviceFilter,
callback?: function,
)
आपको filter
के हिसाब से फ़िल्टर किए गए ऑडियो डिवाइसों की सूची मिलेगी.
पैरामीटर
-
फ़िल्टर
DeviceFilter ज़रूरी नहीं है
डिवाइस की वे प्रॉपर्टी जिनके हिसाब से, लौटाए गए ऑडियो डिवाइसों की सूची को फ़िल्टर करना है. अगर फ़िल्टर सेट नहीं है या
{}
पर सेट किया गया है, तो लौटाए गए डिवाइस की सूची में सभी उपलब्ध ऑडियो डिवाइस शामिल होंगे. -
कॉलबैक
फ़ंक्शन ज़रूरी नहीं
callback
पैरामीटर ऐसा दिखता है:(devices: AudioDeviceInfo[]) => void
-
डिवाइस
-
रिटर्न
-
Promise<AudioDeviceInfo[]>
Chrome 116 और इसके बाद के वर्शनप्रॉमिस, मेनिफ़ेस्ट V3 और इसके बाद के वर्शन में काम करता है. हालांकि, पुराने सिस्टम के साथ काम करने के लिए कॉलबैक दिए जाते हैं. आप एक ही फ़ंक्शन कॉल पर दोनों का इस्तेमाल नहीं कर सकते. प्रॉमिस उसी टाइप के साथ रिज़ॉल्व हो जाती है जिसे कॉलबैक को पास किया जाता है.
getMute()
chrome.audio.getMute(
streamType: StreamType,
callback?: function,
)
इससे, किसी स्ट्रीम टाइप के लिए पूरे सिस्टम को म्यूट किया जा सकता है.
पैरामीटर
-
streamType
ऐसी स्ट्रीम टाइप जिसके लिए म्यूट की स्थिति फ़ेच की जानी चाहिए.
-
कॉलबैक
फ़ंक्शन ज़रूरी नहीं
callback
पैरामीटर ऐसा दिखता है:(value: boolean) => void
-
value
boolean
-
रिटर्न
-
Promise<boolean>
Chrome 116 और इसके बाद के वर्शनप्रॉमिस, मेनिफ़ेस्ट V3 और इसके बाद के वर्शन में काम करता है. हालांकि, पुराने सिस्टम के साथ काम करने के लिए कॉलबैक दिए जाते हैं. आप एक ही फ़ंक्शन कॉल पर दोनों का इस्तेमाल नहीं कर सकते. प्रॉमिस उसी टाइप के साथ रिज़ॉल्व हो जाती है जिसे कॉलबैक को पास किया जाता है.
setActiveDevices()
chrome.audio.setActiveDevices(
ids: DeviceIdLists,
callback?: function,
)
ऐक्टिव इनपुट और/या आउटपुट डिवाइसों की सूचियां सेट करता है.
पैरामीटर
-
ids
उन डिवाइसों के आईडी के बारे में बताता है जिन्हें चालू होना चाहिए. अगर इनपुट या आउटपुट सूची सेट नहीं की गई है, तो उस कैटगरी के डिवाइसों पर इसका कोई असर नहीं पड़ेगा.
किसी गैर-मौजूद डिवाइस आईडी को पास करने में गड़बड़ी हुई.
-
कॉलबैक
फ़ंक्शन ज़रूरी नहीं
callback
पैरामीटर ऐसा दिखता है:() => void
रिटर्न
-
Promise<void>
Chrome 116 और इसके बाद के वर्शनप्रॉमिस, मेनिफ़ेस्ट V3 और इसके बाद के वर्शन में काम करता है. हालांकि, पुराने सिस्टम के साथ काम करने के लिए कॉलबैक दिए जाते हैं. आप एक ही फ़ंक्शन कॉल पर दोनों का इस्तेमाल नहीं कर सकते. प्रॉमिस उसी टाइप के साथ रिज़ॉल्व हो जाती है जिसे कॉलबैक को पास किया जाता है.
setMute()
chrome.audio.setMute(
streamType: StreamType,
isMuted: boolean,
callback?: function,
)
यह सुविधा किसी स्ट्रीम टाइप के लिए म्यूट की स्थिति सेट करती है. म्यूट की स्थिति, उन सभी ऑडियो डिवाइसों पर लागू होगी जिनमें किसी खास तरह की ऑडियो स्ट्रीम चुनी गई है.
पैरामीटर
-
streamType
स्ट्रीम का वह टाइप जिसके लिए म्यूट की स्थिति सेट की जानी चाहिए.
-
isMuted
boolean
म्यूट करने के लिए नई वैल्यू.
-
कॉलबैक
फ़ंक्शन ज़रूरी नहीं
callback
पैरामीटर ऐसा दिखता है:() => void
रिटर्न
-
Promise<void>
Chrome 116 और इसके बाद के वर्शनप्रॉमिस, मेनिफ़ेस्ट V3 और इसके बाद के वर्शन में काम करता है. हालांकि, पुराने सिस्टम के साथ काम करने के लिए कॉलबैक दिए जाते हैं. आप एक ही फ़ंक्शन कॉल पर दोनों का इस्तेमाल नहीं कर सकते. प्रॉमिस उसी टाइप के साथ रिज़ॉल्व हो जाती है जिसे कॉलबैक को पास किया जाता है.
setProperties()
chrome.audio.setProperties(
id: string,
properties: DeviceProperties,
callback?: function,
)
इनपुट या आउटपुट डिवाइस के लिए प्रॉपर्टी सेट करता है.
पैरामीटर
-
id
स्ट्रिंग
-
प्रॉपर्टी
-
कॉलबैक
फ़ंक्शन ज़रूरी नहीं
callback
पैरामीटर ऐसा दिखता है:() => void
रिटर्न
-
Promise<void>
Chrome 116 और इसके बाद के वर्शनप्रॉमिस, मेनिफ़ेस्ट V3 और इसके बाद के वर्शन में काम करता है. हालांकि, पुराने सिस्टम के साथ काम करने के लिए कॉलबैक दिए जाते हैं. आप एक ही फ़ंक्शन कॉल पर दोनों का इस्तेमाल नहीं कर सकते. प्रॉमिस उसी टाइप के साथ रिज़ॉल्व हो जाती है जिसे कॉलबैक को पास किया जाता है.
इवेंट
onDeviceListChanged
chrome.audio.onDeviceListChanged.addListener(
callback: function,
)
ऑडियो डिवाइस बदलने, नए डिवाइस जोड़े जाने या मौजूदा डिवाइस को हटाने पर सक्रिय होता है.
पैरामीटर
-
कॉलबैक
फ़ंक्शन
callback
पैरामीटर ऐसा दिखता है:(devices: AudioDeviceInfo[]) => void
-
डिवाइस
-
onLevelChanged
chrome.audio.onLevelChanged.addListener(
callback: function,
)
यह तब ट्रिगर होता है, जब किसी चालू ऑडियो डिवाइस की आवाज़ का लेवल बदलता है.
पैरामीटर
-
कॉलबैक
फ़ंक्शन
callback
पैरामीटर ऐसा दिखता है:(event: LevelChangedEvent) => void
-
इवेंट
-
onMuteChanged
chrome.audio.onMuteChanged.addListener(
callback: function,
)
यह तब सक्रिय होता है, जब ऑडियो इनपुट या आउटपुट म्यूट की स्थिति बदल जाती है. ध्यान दें कि म्यूट की स्थिति सिस्टम में हर जगह लागू होती है. नई वैल्यू, स्ट्रीम टाइप वाले हर ऑडियो डिवाइस पर लागू होती है.
पैरामीटर
-
कॉलबैक
फ़ंक्शन
callback
पैरामीटर ऐसा दिखता है:(event: MuteChangedEvent) => void
-
इवेंट
-