chrome.audio

Açıklama

chrome.audio API, kullanıcıların sisteme bağlı ses cihazları hakkında bilgi edinmelerine ve bu cihazları kontrol etmelerine olanak tanır. Bu API şu anda yalnızca ChromeOS için kiosk modunda kullanılabilir.

İzinler

audio

Kullanılabilirlik

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

Türler

AudioDeviceInfo

Özellikler

  • deviceName

    dize

    Cihaz adı.

  • deviceType

    DeviceType

    Cihazın türü.

  • displayName

    dize

    Kullanımı kolay ad (ör. "USB Mikrofon").

  • id

    dize

    Ses cihazının benzersiz tanımlayıcısı.

  • isActive

    boolean

    Geçerli etkin cihaz buysa doğru değerini alır.

  • seviye

    sayı

    Cihazın ses düzeyi, çıkış sesi, giriş kazancı.

  • stableDeviceId

    string isteğe bağlı

    Mevcut olduğunda kararlı/kalıcı cihaz kimliği dizesi.

  • streamType

    StreamType

    Bu cihazla ilişkilendirilmiş yayın türü.

DeviceFilter

Özellikler

  • isActive

    boole isteğe bağlı

    Ayarlanırsa yalnızca etkin durumu bu değerle eşleşen ses cihazları filtreye uyar.

  • streamTypes

    StreamType[] isteğe bağlı

    Ayarlanırsa yalnızca yayın türü bu listede yer alan ses cihazları filtreye uygun olur.

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

    numara isteğe bağlı

    Ses cihazının istenen ses düzeyi. Varsayılan olarak cihazın geçerli ses düzeyi ayarlanır.

    Ses giriş cihazıyla kullanılırsa ses cihazı kazancını temsil eder.

    Ses çıkış cihazıyla birlikte kullanılıyorsa ses cihazının ses düzeyini gösterir.

DeviceType

Kullanılabilir ses sistemi türleri.

Enum

"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 düzeyi değişen cihazın kimliği.

  • seviye

    sayı

    Cihazın yeni ses düzeyi.

MuteChangedEvent

Özellikler

  • isMuted

    boolean

    Akışın sesinin kapatılıp kapatılmayacağını belirler.

  • streamType

    StreamType

    Sesi kapatma değerinin değiştirildiği akışın türü. Güncellenen sesi kapatma değeri, bu yayın türündeki tüm cihazlar için geçerli olur.

StreamType

Ses cihazının sağladığı yayın türü.

Enum

"INPUT"

Yöntemler

getDevices()

Söz 
chrome.audio.getDevices(
  filter?: DeviceFilter,
  callback?: function,
)

filter kriterine göre filtrelenmiş ses cihazlarının listesini alır.

Parametreler

  • filter

    DeviceFilter isteğe bağlı

    Döndürülen ses cihazları listesinin filtreleneceği cihaz özellikleri. Filtre ayarlanmaz veya {} olarak ayarlanırsa döndürülen cihaz listesi, kullanılabilir tüm ses cihazlarını içerir.

  • geri çağırma

    Functions (isteğe bağlı)

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

    (devices: AudioDeviceInfo[])=>void

İlerlemeler

  • Promise<AudioDeviceInfo[]>

    Chrome 116 ve sonraki sürümler

    Vaatler, Manifest V3 ve sonraki sürümlerde desteklenir ancak geriye dönük uyumluluk için geri çağırmalar sağlanır. Aynı işlev çağrısında ikisini birden kullanamazsınız. Vaat, geri çağırmaya iletilen aynı türle çözümlenir.

getMute()

Söz 
chrome.audio.getMute(
  streamType: StreamType,
  callback?: function,
)

Belirtilen akış türü için sistem genelinde sessize alma durumunu alır.

Parametreler

  • streamType

    StreamType

    Sesi kapatma durumunun getirilmesi gereken akış türü.

  • geri çağırma

    Functions (isteğe bağlı)

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

    (value: boolean)=>void

    • value

      boolean

İlerlemeler

  • Promise<boolean>

    Chrome 116 ve sonraki sürümler

    Vaatler, Manifest V3 ve sonraki sürümlerde desteklenir ancak geriye dönük uyumluluk için geri çağırmalar sağlanır. Aynı işlev çağrısında ikisini birden kullanamazsınız. Vaat, geri çağırmaya iletilen aynı türle çözümlenir.

setActiveDevices()

Söz 
chrome.audio.setActiveDevices(
  ids: DeviceIdLists,
  callback?: function,
)

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

Parametreler

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

    Mevcut olmayan bir cihaz kimliğinin iletilmesi bir hatadır.

  • geri çağırma

    Functions (isteğe bağlı)

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

    ()=>void

İlerlemeler

  • Promise<void>

    Chrome 116 ve sonraki sürümler

    Vaatler, Manifest V3 ve sonraki sürümlerde desteklenir ancak geriye dönük uyumluluk için geri çağırmalar sağlanır. Aynı işlev çağrısında ikisini birden kullanamazsınız. Vaat, geri çağırmaya iletilen aynı türle çözümlenir.

setMute()

Söz 
chrome.audio.setMute(
  streamType: StreamType,
  isMuted: boolean,
  callback?: function,
)

Akış türünün sesini kapatma durumunu ayarlar. Sesi kapatma durumu, belirtilen ses yayını türüne sahip tüm ses cihazları için geçerli olur.

Parametreler

  • streamType

    StreamType

    Sesi kapatma durumunun ayarlanması gereken yayın türü.

  • isMuted

    boolean

    Yeni yoksayma değeri.

  • geri çağırma

    Functions (isteğe bağlı)

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

    ()=>void

İlerlemeler

  • Promise<void>

    Chrome 116 ve sonraki sürümler

    Vaatler, Manifest V3 ve sonraki sürümlerde desteklenir ancak geriye dönük uyumluluk için geri çağırmalar sağlanır. Aynı işlev çağrısında ikisini birden kullanamazsınız. Vaat, geri çağırmaya iletilen aynı türle çözümlenir.

setProperties()

Söz 
chrome.audio.setProperties(
  id: string,
  properties: DeviceProperties,
  callback?: function,
)

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

Parametreler

  • id

    dize

  • mülkler

    DeviceProperties

  • geri çağırma

    Functions (isteğe bağlı)

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

    ()=>void

İlerlemeler

  • Promise<void>

    Chrome 116 ve sonraki sürümler

    Vaatler, Manifest V3 ve sonraki sürümlerde desteklenir ancak geriye dönük uyumluluk için geri çağırmalar sağlanır. Aynı işlev çağrısında ikisini birden kullanamazsınız. Vaat, geri çağırmaya iletilen aynı türle çözümlenir.

Etkinlikler

onDeviceListChanged

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

Ses cihazları değiştiğinde (yeni cihaz 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 düzeyi 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. Sesi kapatma durumunun sistem genelinde geçerli olduğunu ve yeni değerin, belirtilen yayın türüne sahip her ses cihazı için geçerli olduğunu unutmayın.

Parametreler