chrome.audio

ब्यौरा

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

अनुमतियां

audio

उपलब्धता

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

टाइप

AudioDeviceInfo

प्रॉपर्टी

  • deviceName

    स्ट्रिंग

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

  • deviceType

    DeviceType

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

  • displayName

    स्ट्रिंग

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

  • आईडी

    स्ट्रिंग

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

  • isActive

    बूलियन

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

  • लेवल

    संख्या

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

  • stableDeviceId

    स्ट्रिंग ज़रूरी नहीं

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

  • streamType

    StreamType

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

DeviceFilter

प्रॉपर्टी

  • isActive

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

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

  • streamTypes

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

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

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"

"अन्य"

LevelChangedEvent

प्रॉपर्टी

  • deviceId

    स्ट्रिंग

    उस डिवाइस का आईडी जिसका साउंड लेवल बदला गया है.

  • लेवल

    संख्या

    डिवाइस की आवाज़ का नया लेवल.

MuteChangedEvent

प्रॉपर्टी

  • isMuted

    बूलियन

    स्ट्रीम को म्यूट किया गया है या नहीं.

  • streamType

    StreamType

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

StreamType

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

Enum

"INPUT"

"OUTPUT"

तरीके

getDevices()

वादा करना 
chrome.audio.getDevices(
  filter?: DeviceFilter,
  callback?: function,
)

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

पैरामीटर

  • फ़िल्टर करें

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

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

  • कॉलबैक

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

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

    (devices: AudioDeviceInfo[]) => void

रिटर्न

  • Promise<AudioDeviceInfo[]>

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

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

getMute()

वादा करना 
chrome.audio.getMute(
  streamType: StreamType,
  callback?: function,
)

यह किसी खास स्ट्रीम टाइप के लिए, पूरे सिस्टम में म्यूट की स्थिति दिखाता है.

पैरामीटर

  • streamType

    StreamType

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

  • कॉलबैक

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

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

    (value: boolean) => void

    • value

      बूलियन

रिटर्न

  • Promise<boolean>

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

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

setActiveDevices()

वादा करना 
chrome.audio.setActiveDevices(
  ids: DeviceIdLists,
  callback?: function,
)

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

पैरामीटर

  • आईडी

    DeviceIdLists

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

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

  • कॉलबैक

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

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

    () => void

रिटर्न

  • Promise<void>

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

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

setMute()

वादा करना 
chrome.audio.setMute(
  streamType: StreamType,
  isMuted: boolean,
  callback?: function,
)

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

पैरामीटर

  • streamType

    StreamType

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

  • isMuted

    बूलियन

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

  • कॉलबैक

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

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

    () => void

रिटर्न

  • Promise<void>

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

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

setProperties()

वादा करना 
chrome.audio.setProperties(
  id: string,
  properties: DeviceProperties,
  callback?: function,
)

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

पैरामीटर

  • आईडी

    स्ट्रिंग

  • प्रॉपर्टी

    DeviceProperties

  • कॉलबैक

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

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

    () => 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