chrome.audio

refresh date: 2026-09-25 robots: noindex

ब्यौरा

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

अनुमतियां

audio

उपलब्धता

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

टाइप

AudioDeviceInfo

प्रॉपर्टी

  • deviceName

    स्ट्रिंग

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

  • deviceType

    DeviceType

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

  • displayName

    स्ट्रिंग

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

  • id

    स्ट्रिंग

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

  • isActive

    बूलियन

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

  • लेवल

    संख्या

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

  • stableDeviceId

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

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

  • streamType

    StreamType

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

DeviceFilter

प्रॉपर्टी

  • isActive

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

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

  • streamTypes

    StreamType[] optional

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

DeviceIdLists

प्रॉपर्टी

  • इनपुट

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

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

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

  • आउटपुट

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

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

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

DeviceProperties

प्रॉपर्टी

  • लेवल

    number optional

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

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

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

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

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

StreamType

ऑडियो डिवाइस किस तरह की स्ट्रीम उपलब्ध कराता है.

Enum

"INPUT"

"OUTPUT"

तरीके

getDevices()

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

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

पैरामीटर

  • फ़िल्टर

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

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

  • कॉलबैक

    फ़ंक्शन ज़रूरी नहीं है

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

    (devices: AudioDeviceInfo[]) => void

रिटर्न

  • Promise<AudioDeviceInfo[]>

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

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

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

getMute()

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

इससे स्ट्रीम के तय किए गए टाइप के लिए, सिस्टम-वाइड म्यूट स्टेट मिलती है.

पैरामीटर

  • streamType

    StreamType

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

  • कॉलबैक

    फ़ंक्शन ज़रूरी नहीं है

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

    (value: boolean) => void

    • मान

      बूलियन

रिटर्न

  • Promise<boolean>

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

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

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

setActiveDevices()

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

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

पैरामीटर

  • आईडी

    DeviceIdLists

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

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

  • कॉलबैक

    फ़ंक्शन ज़रूरी नहीं है

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

    () => void

रिटर्न

  • Promise<void>

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

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

setMute()

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

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

पैरामीटर

  • streamType

    StreamType

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

  • isMuted

    बूलियन

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

  • कॉलबैक

    फ़ंक्शन ज़रूरी नहीं है

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

    () => void

रिटर्न

  • Promise<void>

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

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

setProperties()

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

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

पैरामीटर

  • id

    स्ट्रिंग

  • प्रॉपर्टी

    DeviceProperties

  • कॉलबैक

    फ़ंक्शन ज़रूरी नहीं है

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

    () => void

रिटर्न

  • Promise<void>

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

    प्रॉमिस सिर्फ़ Manifest 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