chrome.audio

ब्यौरा

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

अनुमतियां

audio

उपलब्धता

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

टाइप

AudioDeviceInfo

प्रॉपर्टी

  • deviceName

    स्ट्रिंग

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

  • deviceType

    DeviceType

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

  • displayName

    स्ट्रिंग

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

  • आईडी

    स्ट्रिंग

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

  • isActive

    बूलियन

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

  • लेवल

    संख्या

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

  • stableDeviceId

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

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

  • streamType

    StreamType

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

DeviceFilter

प्रॉपर्टी

  • isActive

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

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

  • streamTypes

    StreamType[] optional

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

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"

"OTHER"

LevelChangedEvent

प्रॉपर्टी

  • deviceId

    स्ट्रिंग

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

  • लेवल

    संख्या

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

MuteChangedEvent

प्रॉपर्टी

  • isMuted

    बूलियन

    इससे पता चलता है कि स्ट्रीम को म्यूट किया गया है या नहीं.

  • streamType

    StreamType

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

StreamType

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

Enum

"INPUT"

"OUTPUT"

तरीके

getDevices()

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

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

पैरामीटर

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

    DeviceFilter optional

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

रिटर्न

  • Promise<AudioDeviceInfo[]>

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

getMute()

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

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

पैरामीटर

  • streamType

    StreamType

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

रिटर्न

  • Promise<boolean>

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

setActiveDevices()

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

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

पैरामीटर

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

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

रिटर्न

  • Promise<void>

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

setMute()

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

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

पैरामीटर

  • streamType

    StreamType

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

  • isMuted

    बूलियन

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

रिटर्न

  • Promise<void>

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

setProperties()

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

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

पैरामीटर

  • आईडी

    स्ट्रिंग

  • प्रॉपर्टी

    DeviceProperties

रिटर्न

  • 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