chrome.audio

refresh date: 2026-09-25 robots: noindex

Açıklama

chrome.audio API'si, kullanıcıların sisteme bağlı ses sistemleri hakkında bilgi edinmesine ve bu cihazları kontrol etmesine olanak tanımak için sağlanır. Bu API şu anda yalnızca ChromeOS için kiosk modunda kullanılabilir.

İzinler

audio

Kullanılabilirlik

Chrome 59 ve sonraki sürümler Yalnızca ChromeOS

Türler

AudioDeviceInfo

Özellikler

  • deviceName

    dize

    Cihaz adı.

  • deviceType

    DeviceType

    Cihazın türü.

  • görünen ad

    dize

    Kullanıcı dostu ad (ör. "USB Mikrofon").

  • id

    dize

    Ses sisteminin benzersiz tanımlayıcısı.

  • isActive

    boole

    Bu cihaz şu anda etkinse doğru değerini döndürür.

  • seviye

    sayı

    Cihazın ses seviyesi, çıkış için ses düzeyi, giriş için kazanç.

  • stableDeviceId

    string isteğe bağlı

    Mümkün olduğunda kararlı/kalıcı cihaz kimliği dizesi.

  • streamType

    StreamType

    Bu cihazla ilişkili akış türü.

DeviceFilter

Özellikler

  • isActive

    boole isteğe bağlı

    Bu değer ayarlanırsa yalnızca etkin durumu bu değerle eşleşen ses sistemleri filtreyi karşılar.

  • streamTypes

    StreamType[] isteğe bağlı

    Bu politika ayarlanırsa yalnızca akış türü bu listede yer alan ses sistemleri filtreyi karşılar.

DeviceIdLists

Özellikler

  • giriş

    string[] isteğe bağlı

    Kimlikleriyle belirtilen giriş cihazlarının listesi.

    Giriş cihazlarının etkilenmemesi gerektiğini belirtmek için bu özelliği ayarlanmamış olarak bırakın.

  • çıkış

    string[] isteğe bağlı

    Kimlikleriyle belirtilen çıkış cihazlarının listesi.

    Çıkış cihazlarının etkilenmemesi gerektiğini belirtmek için bu özelliği ayarlanmamış olarak bırakın.

DeviceProperties

Özellikler

  • seviye

    number isteğe bağlı

    Ses cihazının istenen ses seviyesi. Varsayılan olarak cihazın mevcut ses düzeyine ayarlanır.

    Ses giriş cihazıyla kullanıldığında ses sistemi kazancını temsil eder.

    Ses çıkış cihazıyla kullanıldığında ses cihazının ses seviyesini temsil eder.

DeviceType

Kullanılabilir ses sistemi türleri.

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

Özellikler

  • deviceId

    dize

    Ses seviyesi değişen cihazın kimliği.

  • seviye

    sayı

    Cihazın yeni ses seviyesi.

MuteChangedEvent

Özellikler

  • isMuted

    boole

    Yayın sesinin kapatılıp kapatılmadığı.

  • streamType

    StreamType

    Sessize alma değerinin değiştiği akışın türü. Güncellenen ses kapatma değeri, bu akış türüne sahip tüm cihazlar için geçerli olur.

StreamType

Ses sisteminin sağladığı akış türü.

Enum

"INPUT"

"OUTPUT"

Yöntemler

getDevices()

Taahhüt 
chrome.audio.getDevices(
  filter?: DeviceFilter,
  callback?: function,
): Promise<AudioDeviceInfo[]>

filter ölçütüne göre filtrelenmiş ses sistemlerinin listesini alır.

Parametreler

  • filtre

    DeviceFilter isteğe bağlı

    Döndürülen ses sistemleri listesinin filtreleneceği cihaz özellikleri. Filtre ayarlanmazsa veya {} değerine ayarlanırsa döndürülen cihaz listesinde mevcut tüm ses sistemleri yer alır.

  • callback

    function isteğe bağlı

    callback parametresi şu şekilde görünür: 

    (devices: AudioDeviceInfo[]) => void

İadeler

  • Promise<AudioDeviceInfo[]>

    Chrome 116+

    İstenen ses sistemleri listesini bildirir.

    Promise'ler yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformların geri çağırma işlevlerini kullanması gerekir.

getMute()

Taahhüt 
chrome.audio.getMute(
  streamType: StreamType,
  callback?: function,
): Promise<boolean>

Belirtilen akış türü için sistem genelindeki ses kapatma durumunu alır.

Parametreler

  • streamType

    StreamType

    Sessize alma durumunun alınması gereken akış türü.

  • callback

    function isteğe bağlı

    callback parametresi şu şekilde görünür: 

    (value: boolean) => void

    • value

      boole

İadeler

  • Promise<boolean>

    Chrome 116+

    Belirtilen akış türü için sesin kapatılıp kapatılmadığını belirten bir boole değeriyle çözümlenen Promise.

    Promise'ler yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformların geri çağırma işlevlerini kullanması gerekir.

setActiveDevices()

Taahhüt 
chrome.audio.setActiveDevices(
  ids: DeviceIdLists,
  callback?: function,
): Promise<void>

Etkin giriş ve/veya çıkış cihazlarının listelerini ayarlar.

Parametreler

  • Etkin olması gereken cihazların kimliklerini belirtir. Giriş veya çıkış listesi ayarlanmazsa ilgili kategorideki cihazlar etkilenmez.

    Mevcut olmayan bir cihaz kimliği iletmek hataya neden olur.

  • callback

    function isteğe bağlı

    callback parametresi şu şekilde görünür: 

    () => void

İadeler

  • Promise<void>

    Chrome 116+

    Promise'ler yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformların geri çağırma işlevlerini kullanması gerekir.

setMute()

Taahhüt 
chrome.audio.setMute(
  streamType: StreamType,
  isMuted: boolean,
  callback?: function,
): Promise<void>

Bir akış türü için ses kapatma durumunu ayarlar. Sessize alma durumu, belirtilen ses akışı türüne sahip tüm ses sistemleri için geçerli olur.

Parametreler

  • streamType

    StreamType

    Sessize alma durumunun ayarlanması gereken akış türü.

  • isMuted

    boole

    Yeni ses kapatma değeri.

  • callback

    function isteğe bağlı

    callback parametresi şu şekilde görünür: 

    () => void

İadeler

  • Promise<void>

    Chrome 116+

    Promise'ler yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformların geri çağırma işlevlerini kullanması gerekir.

setProperties()

Taahhüt 
chrome.audio.setProperties(
  id: string,
  properties: DeviceProperties,
  callback?: function,
): Promise<void>

Giriş veya çıkış cihazının özelliklerini ayarlar.

Parametreler

  • id

    dize

  • mülkler

    DeviceProperties

  • callback

    function isteğe bağlı

    callback parametresi şu şekilde görünür: 

    () => void

İadeler

  • Promise<void>

    Chrome 116+

    Promise'ler yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformların geri çağırma işlevlerini kullanması gerekir.

Etkinlikler

onDeviceListChanged

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

Ses sistemleri değiştiğinde (yeni cihazlar eklendiğinde veya mevcut cihazlar kaldırıldığında) tetiklenir.

Parametreler

onLevelChanged

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

Etkin bir ses cihazının ses seviyesi değiştiğinde tetiklenir.

Parametreler

onMuteChanged

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

Ses girişinin veya çıkışının ses kapatma durumu değiştiğinde tetiklenir. Sessize alma durumunun sistem genelinde geçerli olduğunu ve yeni değerin, belirtilen akış türüne sahip her ses sistemine uygulandığını unutmayın.

Parametreler