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