chrome.audio

ब्यौरा

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

अनुमतियां

audio

उपलब्धता

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

टाइप

AudioDeviceInfo

प्रॉपर्टी

  • deviceName

    स्ट्रिंग

    डिवाइस का नाम

  • deviceType

    DeviceType

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

  • displayName

    स्ट्रिंग

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

  • id

    स्ट्रिंग

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

  • isActive

    boolean

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

  • लेवल

    नंबर

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

  • stableDeviceId

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

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

  • streamType

    StreamType

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

DeviceFilter

प्रॉपर्टी

  • isActive

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

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

  • streamTypes

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

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

DeviceIdLists

प्रॉपर्टी

  • इनपुट

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

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

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

  • आउटपुट

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

    उन आउटपुट डिवाइसों की सूची जिनके आईडी के हिसाब से डिवाइस का इस्तेमाल किया जाता है.

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

DeviceProperties

प्रॉपर्टी

  • लेवल

    नंबर ज़रूरी नहीं

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

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

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

DeviceType

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

Enum

"BLUETOOTH"

"INTERNAL_SPEAKER"

"INTERNAL_MIC"

"FRONT_MIC"

"REAR_MIC"

"LINEOUT"

"POST_MIX_LOOPBACK"

"POST_DSP_LOOPBACK"

"ALSA_LOOPBACK"

"OTHER"

LevelChangedEvent

प्रॉपर्टी

  • deviceId

    स्ट्रिंग

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

  • लेवल

    नंबर

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

MuteChangedEvent

प्रॉपर्टी

  • isMuted

    boolean

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

  • streamType

    StreamType

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

StreamType

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

Enum

"INPUT"

तरीके

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

    StreamType

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

  • कॉलबैक

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

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

    (value: boolean)=>void

    • value

      boolean

रिटर्न

  • Promise<boolean>

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

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

setActiveDevices()

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

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

पैरामीटर

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

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

  • कॉलबैक

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

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

    ()=>void

रिटर्न

  • Promise<void>

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

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

setMute()

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

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

पैरामीटर

  • streamType

    StreamType

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

  • isMuted

    boolean

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

  • कॉलबैक

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

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

    ()=>void

रिटर्न

  • Promise<void>

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

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

setProperties()

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

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

पैरामीटर

  • id

    स्ट्रिंग

  • प्रॉपर्टी

    DeviceProperties

  • कॉलबैक

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

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

    ()=>void

रिटर्न

  • Promise<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