chrome.audio

refresh date: 2026-09-25 robots: noindex

अहम जानकारी: यह एपीआई सिर्फ़ ChromeOS पर काम करता है.

ब्यौरा

chrome.audio एपीआई की मदद से, उपयोगकर्ता सिस्टम से जुड़े ऑडियो डिवाइसों के बारे में जानकारी पा सकते हैं और उन्हें कंट्रोल कर सकते हैं. फ़िलहाल, यह एपीआई सिर्फ़ ChromeOS के कीऑस्क मोड में उपलब्ध है.

अनुमतियां

audio

उपलब्धता

Chrome 59 और इसके बाद के वर्शन सिर्फ़ ChromeOS के लिए

टाइप

AudioDeviceInfo

प्रॉपर्टी

• deviceName

  स्ट्रिंग

  डिवाइस का नाम.

• deviceType

  DeviceType

  डिवाइस का टाइप.

• displayName

  स्ट्रिंग

  उपयोगकर्ता के लिए आसान नाम (जैसे, "यूएसबी माइक्रोफ़ोन").

• आईडी

  स्ट्रिंग

  ऑडियो डिवाइस का यूनीक आइडेंटिफ़ायर.

• isActive

  बूलियन

  अगर यह मौजूदा चालू डिवाइस है, तो वैल्यू true होगी.

• लेवल

  संख्या

  डिवाइस का साउंड लेवल, आउटपुट के लिए वॉल्यूम, और इनपुट के लिए गेन.

• stableDeviceId

  string ज़रूरी नहीं

  डिवाइस आईडी की स्ट्रिंग, जो उपलब्ध होने पर स्टेबल/पर्सिस्टेंट होती है.

• streamType

  StreamType

  इस डिवाइस से जुड़ी स्ट्रीम का टाइप.

DeviceFilter

प्रॉपर्टी

• isActive

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

  अगर इसे सेट किया जाता है, तो सिर्फ़ वे ऑडियो डिवाइस फ़िल्टर की शर्तों को पूरा करेंगे जिनकी चालू स्थिति इस वैल्यू से मैच करती है.

• streamTypes

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

  अगर यह नीति सेट है, तो सिर्फ़ वे ऑडियो डिवाइस फ़िल्टर के मुताबिक होंगे जिनकी स्ट्रीम का टाइप इस सूची में शामिल है.

DeviceIdLists

प्रॉपर्टी

• इनपुट

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

  आईडी के हिसाब से तय किए गए इनपुट डिवाइसों की सूची.

  अगर आपको इनपुट डिवाइसों पर कोई असर नहीं डालना है, तो इस प्रॉपर्टी को सेट न करें.

• आउटपुट

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

  आईडी के हिसाब से आउटपुट डिवाइसों की सूची.

  अगर आपको आउटपुट डिवाइसों पर कोई असर नहीं डालना है, तो इस प्रॉपर्टी को सेट न करें.

DeviceProperties

प्रॉपर्टी

• लेवल

  number ज़रूरी नहीं

  ऑडियो डिवाइस की आवाज़ का लेवल. यह डिफ़ॉल्ट रूप से, डिवाइस के मौजूदा साउंड लेवल पर सेट होता है.

  अगर इसका इस्तेमाल ऑडियो इनपुट डिवाइस के साथ किया जाता है, तो यह ऑडियो डिवाइस के गेन को दिखाता है.

  ऑडियो आउटपुट डिवाइस के साथ इस्तेमाल किए जाने पर, यह ऑडियो डिवाइस की आवाज़ को दिखाता है.

DeviceType

ऑडियो डिवाइस के उपलब्ध टाइप.

Enum

"HEADPHONE"

"MIC"

"यूएसबी"

"BLUETOOTH"

"एचडीएमआई"

"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

  उस स्ट्रीम का टाइप जिसकी म्यूट वैल्यू बदली गई है. म्यूट करने की अपडेट की गई वैल्यू, इस स्ट्रीम टाइप वाले सभी डिवाइसों पर लागू होती है.

StreamType

ऑडियो डिवाइस से मिलने वाली स्ट्रीम का टाइप.

Enum

"INPUT"

"OUTPUT"

तरीके

getDevices()

वादा

chrome.audio.getDevices(
  filter?: DeviceFilter,
  callback?: function,
): Promise<AudioDeviceInfo[]>

filter के आधार पर फ़िल्टर किए गए ऑडियो डिवाइसों की सूची मिलती है.

पैरामीटर

• फ़िल्टर

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

  डिवाइस की प्रॉपर्टी, जिनके हिसाब से ऑडियो डिवाइसों की सूची को फ़िल्टर किया जाता है. अगर फ़िल्टर सेट नहीं है या {} पर सेट है, तो डिवाइस की सूची में सभी उपलब्ध ऑडियो डिवाइस शामिल होंगे.

• कॉलबैक

  function ज़रूरी नहीं

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

  (devices: AudioDeviceInfo[]) => void

  • डिवाइस

    AudioDeviceInfo[]

रिटर्न

• Promise<AudioDeviceInfo[]>

  Chrome 116 या इसके बाद का वर्शन

  अनुरोध किए गए ऑडियो डिवाइसों की सूची दिखाता है.

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

getMute()

वादा

chrome.audio.getMute(
  streamType: StreamType,
  callback?: function,
): Promise<boolean>

इससे, चुनी गई स्ट्रीम के लिए पूरे सिस्टम में म्यूट की स्थिति का पता चलता है.

पैरामीटर

• streamType

  StreamType

  वह स्ट्रीम टाइप जिसके लिए म्यूट की स्थिति फ़ेच करनी है.

• कॉलबैक

  function ज़रूरी नहीं

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

  (value: boolean) => void

  • मान

    बूलियन

रिटर्न

• Promise<boolean>

  Chrome 116 या इसके बाद का वर्शन

  प्रॉमिस, जो बूलियन के साथ रिज़ॉल्व होता है. इससे पता चलता है कि तय की गई स्ट्रीम टाइप के लिए, म्यूट सेट है या नहीं.

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

setActiveDevices()

वादा

chrome.audio.setActiveDevices(
  ids: DeviceIdLists,
  callback?: function,
): Promise<void>

यह चालू इनपुट और/या आउटपुट डिवाइसों की सूचियां सेट करता है.

पैरामीटर

• आईडी

  DeviceIdLists

  इससे उन डिवाइसों के आईडी तय किए जाते हैं जो चालू होने चाहिए. अगर इनपुट या आउटपुट की सूची सेट नहीं है, तो उस कैटगरी के डिवाइसों पर कोई असर नहीं पड़ता.

  अगर ऐसा डिवाइस आईडी पास किया जाता है जो मौजूद नहीं है, तो गड़बड़ी होती है.

• कॉलबैक

  function ज़रूरी नहीं

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

  () => void

रिटर्न

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

  Chrome 116 या इसके बाद का वर्शन

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

setMute()

वादा

chrome.audio.setMute(
  streamType: StreamType,
  isMuted: boolean,
  callback?: function,
): Promise<void>

इससे किसी स्ट्रीम टाइप के लिए, म्यूट की स्थिति सेट की जाती है. म्यूट करने की स्थिति, तय किए गए ऑडियो स्ट्रीम टाइप वाले सभी ऑडियो डिवाइसों पर लागू होगी.

पैरामीटर

• streamType

  StreamType

  स्ट्रीम का वह टाइप जिसके लिए म्यूट की स्थिति सेट की जानी चाहिए.

• isMuted

  बूलियन

  म्यूट करने की नई वैल्यू.

• कॉलबैक

  function ज़रूरी नहीं

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

  () => void

रिटर्न

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

  Chrome 116 या इसके बाद का वर्शन

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

setProperties()

वादा

chrome.audio.setProperties(
  id: string,
  properties: DeviceProperties,
  callback?: function,
): Promise<void>

इनपुट या आउटपुट डिवाइस के लिए प्रॉपर्टी सेट करता है.

पैरामीटर

• आईडी

  स्ट्रिंग

• प्रॉपर्टी

  DeviceProperties

• कॉलबैक

  function ज़रूरी नहीं

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

  () => void

रिटर्न

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

  Chrome 116 या इसके बाद का वर्शन

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

इवेंट

onDeviceListChanged

chrome.audio.onDeviceListChanged.addListener(
  callback: function,
)

यह इवेंट तब ट्रिगर होता है, जब ऑडियो डिवाइसों में बदलाव होता है. जैसे, नए डिवाइस जोड़े जाते हैं या मौजूदा डिवाइस हटाए जाते हैं.

पैरामीटर

• कॉलबैक

  फ़ंक्शन

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

  (devices: AudioDeviceInfo[]) => void

  • डिवाइस

    AudioDeviceInfo[]

onLevelChanged

chrome.audio.onLevelChanged.addListener(
  callback: function,
)

यह इवेंट तब ट्रिगर होता है, जब किसी चालू ऑडियो डिवाइस के लिए आवाज़ का लेवल बदलता है.

पैरामीटर

• कॉलबैक

  फ़ंक्शन

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

  (event: LevelChangedEvent) => void

  • इवेंट

    LevelChangedEvent

onMuteChanged

chrome.audio.onMuteChanged.addListener(
  callback: function,
)

ऑडियो इनपुट या आउटपुट के म्यूट होने की स्थिति बदलने पर ट्रिगर होता है. ध्यान दें कि म्यूट की स्थिति पूरे सिस्टम पर लागू होती है. साथ ही, नई वैल्यू, तय किए गए स्ट्रीम टाइप वाले हर ऑडियो डिवाइस पर लागू होती है.

पैरामीटर

• कॉलबैक

  फ़ंक्शन

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

  (event: MuteChangedEvent) => void

  • इवेंट

    MuteChangedEvent