browser.audio

ब्यौरा

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

अनुमतियां

audio

उपलब्धता

Chrome 59 और इसके बाद के वर्शन Chrome 148 और इसके बाद के वर्शन में browser.* सिर्फ़ ChromeOS के लिए

टाइप

AudioDeviceInfo

प्रॉपर्टी

  • deviceName

    स्ट्रिंग

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

  • deviceType

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

  • displayName

    स्ट्रिंग

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

  • आईडी

    स्ट्रिंग

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

  • isActive

    बूलियन

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

  • लेवल

    संख्या

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

  • stableDeviceId

    string ज़रूरी नहीं

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

  • 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

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

Enum

"INPUT"

"OUTPUT"

तरीके

getDevices()

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

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

पैरामीटर

  • फ़िल्टर

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

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

रिटर्न

  • Promise<AudioDeviceInfo[]>

    Chrome 116+ browser.* Chrome 148 से

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

getMute()

browser.audio.getMute(
  streamType: StreamType,
)
: Promise<boolean>

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

पैरामीटर

  • streamType

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

रिटर्न

  • Promise<boolean>

    Chrome 116+ browser.* Chrome 148 से

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

setActiveDevices()

browser.audio.setActiveDevices(
  ids: DeviceIdLists,
)
: Promise<void>

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

पैरामीटर

  • आईडी

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

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

रिटर्न

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

    Chrome 116+ browser.* Chrome 148 से

setMute()

browser.audio.setMute(
  streamType: StreamType,
  isMuted: boolean,
)
: Promise<void>

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

पैरामीटर

  • streamType

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

  • isMuted

    बूलियन

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

रिटर्न

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

    Chrome 116+ browser.* Chrome 148 से

setProperties()

browser.audio.setProperties(
  id: string,
  properties: DeviceProperties,
)
: Promise<void>

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

पैरामीटर

  • आईडी

    स्ट्रिंग

  • प्रॉपर्टी

रिटर्न

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

    Chrome 116+ browser.* Chrome 148 से

इवेंट

onDeviceListChanged

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

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

पैरामीटर

  • कॉलबैक

    फ़ंक्शन

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

    (devices: AudioDeviceInfo[]) => void

onLevelChanged

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

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

पैरामीटर

  • कॉलबैक

    फ़ंक्शन

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

    (event: LevelChangedEvent) => void

onMuteChanged

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

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

पैरामीटर

  • कॉलबैक

    फ़ंक्शन

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

    (event: MuteChangedEvent) => void