ब्यौरा
chrome.audio एपीआई इसलिए उपलब्ध कराया गया है, ताकि उपयोगकर्ता सिस्टम से जुड़े ऑडियो डिवाइसों के बारे में जानकारी पा सकें और उन्हें कंट्रोल कर सकें. फ़िलहाल, यह एपीआई सिर्फ़ ChromeOS के कीऑस्क मोड में उपलब्ध है.
अनुमतियां
audioउपलब्धता
टाइप
AudioDeviceInfo
प्रॉपर्टी
-
deviceName
स्ट्रिंग
डिवाइस का नाम.
-
deviceType
डिवाइस का टाइप.
-
displayName
स्ट्रिंग
उपयोगकर्ता के लिए आसान नाम (जैसे, "यूएसबी माइक्रोफ़ोन").
-
आईडी
स्ट्रिंग
ऑडियो डिवाइस का यूनीक आइडेंटिफ़ायर.
-
isActive
बूलियन
अगर यह मौजूदा चालू डिवाइस है, तो वैल्यू 'सही है' पर सेट होती है.
-
लेवल
संख्या
डिवाइस का साउंड लेवल, आउटपुट के लिए वॉल्यूम, इनपुट के लिए गेन.
-
stableDeviceId
string ज़रूरी नहीं है
अगर डिवाइस आईडी उपलब्ध है, तो यह डिवाइस आईडी की स्टेबल/परसिस्टेड स्ट्रिंग होती है.
-
streamType
इस डिवाइस से जुड़ा स्ट्रीम टाइप.
DeviceFilter
प्रॉपर्टी
-
isActive
बूलियन ज़रूरी नहीं है
अगर यह वैल्यू सेट की जाती है, तो सिर्फ़ उन ऑडियो डिवाइसों को फ़िल्टर किया जाएगा जिनकी चालू स्थिति इस वैल्यू से मेल खाती है.
-
streamTypes
StreamType[] optional
अगर यह फ़िल्टर सेट किया जाता है, तो सिर्फ़ उन ऑडियो डिवाइसों को फ़िल्टर किया जाएगा जिनके स्ट्रीम टाइप इस सूची में शामिल हैं.
DeviceIdLists
प्रॉपर्टी
-
इनपुट
string[] ज़रूरी नहीं है
इनपुट डिवाइसों की सूची, उनकी आईडी के हिसाब से दी गई है.
अगर आपको यह बताना है कि इनपुट डिवाइसों पर कोई असर नहीं पड़ना चाहिए, तो इस प्रॉपर्टी को सेट न करें.
-
आउटपुट
string[] ज़रूरी नहीं है
आउटपुट डिवाइसों की सूची, उनके आईडी के हिसाब से दी गई है.
अगर आपको यह बताना है कि आउटपुट डिवाइसों पर कोई असर नहीं पड़ना चाहिए, तो इस प्रॉपर्टी को सेट न करें.
DeviceProperties
प्रॉपर्टी
-
लेवल
number ज़रूरी नहीं
ऑडियो डिवाइस की आवाज़ का पसंदीदा लेवल. यह डिवाइस के मौजूदा साउंड लेवल पर सेट होता है.
अगर इसका इस्तेमाल ऑडियो इनपुट डिवाइस के साथ किया जाता है, तो यह ऑडियो डिवाइस के गेन को दिखाता है.
अगर इसका इस्तेमाल ऑडियो आउटपुट डिवाइस के साथ किया जाता है, तो यह ऑडियो डिवाइस की आवाज़ को दिखाता है.
DeviceType
ऑडियो डिवाइस के उपलब्ध टाइप.
Enum
"HEADPHONE"
"MIC"
"USB"
"BLUETOOTH"
"HDMI"
"INTERNAL_SPEAKER"
"INTERNAL_MIC"
"FRONT_MIC"
"REAR_MIC"
"KEYBOARD_MIC"
"HOTWORD"
"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,
): Promise<AudioDeviceInfo[]>
यह filter के आधार पर फ़िल्टर किए गए ऑडियो डिवाइसों की सूची दिखाता है.
पैरामीटर
-
फ़िल्टर करें
DeviceFilter optional
डिवाइस की वे प्रॉपर्टी जिनके हिसाब से, ऑडियो डिवाइसों की सूची को फ़िल्टर करना है. अगर फ़िल्टर सेट नहीं किया गया है या इसे
{}पर सेट किया गया है, तो डिवाइसों की दिखाई गई सूची में सभी उपलब्ध ऑडियो डिवाइस शामिल होंगे.
रिटर्न
-
Promise<AudioDeviceInfo[]>
Chrome 116 या इसके बाद का वर्शनयह अनुरोध की गई ऑडियो डिवाइसों की सूची दिखाता है.
getMute()
chrome.audio.getMute(
streamType: StreamType,
): Promise<boolean>
इससे, तय की गई स्ट्रीम के टाइप के लिए, सिस्टम-वाइड म्यूट की स्थिति मिलती है.
पैरामीटर
-
streamType
स्ट्रीम का वह टाइप जिसके लिए म्यूट करने की स्थिति का डेटा पाना है.
रिटर्न
-
Promise<boolean>
Chrome 116 या इसके बाद का वर्शनयह प्रॉमिस, बूलियन वैल्यू के साथ रिज़ॉल्व होता है. इससे पता चलता है कि स्ट्रीम के चुने गए टाइप के लिए, म्यूट करने की सुविधा चालू है या नहीं.
setActiveDevices()
chrome.audio.setActiveDevices(
ids: DeviceIdLists,
): Promise<void>
चालू इनपुट और/या आउटपुट डिवाइसों की सूचियां सेट करता है.
पैरामीटर
-
ids
इस नीति से, उन डिवाइसों के आईडी तय किए जाते हैं जिन्हें चालू किया जाना चाहिए. अगर इनपुट या आउटपुट डिवाइसों की सूची सेट नहीं की जाती है, तो उस कैटगरी के डिवाइसों पर इसका कोई असर नहीं पड़ता.
ऐसे डिवाइस का आईडी पास करना एक गड़बड़ी है जो मौजूद नहीं है.
रिटर्न
-
Promise<void>
Chrome 116 या इसके बाद का वर्शन
setMute()
chrome.audio.setMute(
streamType: StreamType,
isMuted: boolean,
): Promise<void>
इससे किसी स्ट्रीम टाइप के लिए म्यूट करने की स्थिति सेट की जाती है. म्यूट करने की स्थिति, ऑडियो स्ट्रीम के तय किए गए टाइप वाले सभी ऑडियो डिवाइसों पर लागू होगी.
पैरामीटर
-
streamType
स्ट्रीम का वह टाइप जिसके लिए म्यूट करने की स्थिति सेट करनी है.
-
isMuted
बूलियन
म्यूट करने की नई वैल्यू.
रिटर्न
-
Promise<void>
Chrome 116 या इसके बाद का वर्शन
setProperties()
chrome.audio.setProperties(
id: string,
properties: DeviceProperties,
): Promise<void>
इनपुट या आउटपुट डिवाइस के लिए प्रॉपर्टी सेट करता है.
पैरामीटर
-
आईडी
स्ट्रिंग
-
प्रॉपर्टी
रिटर्न
-
Promise<void>
Chrome 116 या इसके बाद का वर्शन
इवेंट
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
-
इवेंट
-