chrome.audio

ब्यौरा

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

अनुमतियां

audio

उपलब्धता

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

टाइप

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