chrome.audio

Açıklama

chrome.audio API, kullanıcıların sisteme bağlı ses cihazları hakkında bilgi edinmesine ve bu cihazları kontrol etmesine olanak tanı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 cihazının benzersiz tanımlayıcısı.

  • isActive

    boolean

    Mevcut etkin cihaz bu ise doğru değerini döndürür.

  • seviye

    sayı

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

  • stableDeviceId

    dize isteğe bağlı

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

  • streamType

    StreamType

    Bu cihazla ilişkili 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ı filtreyi karşılar.

  • streamTypes

    StreamType[] isteğe bağlı

    Bu ayar etkinleştirilirse yalnızca akış türü bu listede yer alan ses cihazları filtreyi karşılar.

DeviceIdLists

Özellikler

  • giriş

    string[] isteğe bağlı

    Kimliklerine göre belirtilen giriş cihazlarının listesi.

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

  • çıkış

    string[] isteğe bağlı

    Kimliklerine göre belirtilen çıkış cihazlarının listesi.

    Çıkış cihazlarının etkilenmeyeceğ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üzeyidir.

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

    Ses çıkış cihazıyla birlikte kullanılırsa ses cihazının ses seviyesini gösterir.

DeviceType

Kullanılabilir ses cihazı 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"

"DİĞER"

LevelChangedEvent

Özellikler

  • deviceId

    dize

    Ses düzeyi değişen cihazın kimliği.

  • seviye

    sayı

    Cihazın yeni ses seviyesi.

MuteChangedEvent

Özellikler

  • isMuted

    boolean

    Akış şu anda sessiz olup olmadığı.

  • streamType

    StreamType

    Sessize alma değerinin değiştiği yayının türü. Güncellenen sessize alma değeri, bu yayın türüne sahip tüm cihazlar için geçerlidir.

StreamType

Ses cihazının sağladığı akış türü.

Enum

"INPUT"

"OUTPUT"

Yöntemler

getDevices()

Promise 
chrome.audio.getDevices(
  filter?: DeviceFilter,
  callback?: function,
)

filter değerine göre filtrelenen ses cihazlarının listesini alır.

Parametreler

  • filtrele

    DeviceFilter isteğe bağlı

    Döndürülen ses cihazları listesini filtrelemek için kullanılacak cihaz özellikleri. Filtre ayarlanmazsa veya {} değerine ayarlanırsa döndürülen cihaz listesi mevcut tüm ses cihazlarını içerir.

  • geri çağırma

    işlev isteğe bağlı

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

    (devices: AudioDeviceInfo[]) => void

İadeler

  • Promise<AudioDeviceInfo[]>

    Chrome 116 ve sonraki sürümler

    Sözler Manifest V3 ve sonraki sürümlerde desteklenir ancak geriye dönük uyumluluk için geri çağırma işlevleri sağlanır. Aynı işlev çağrısında ikisini birden kullanamazsınız. Sözleşme, geri çağırma işlevine iletilen türle çözülür.

getMute()

Promise 
chrome.audio.getMute(
  streamType: StreamType,
  callback?: function,
)

Belirtilen yayın türü için sistem genelindeki sessize alma durumunu alır.

Parametreler

  • streamType

    StreamType

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

  • geri çağırma

    işlev isteğe bağlı

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

    (value: boolean) => void

    • value

      boolean

İadeler

  • Promise<boolean>

    Chrome 116 ve sonraki sürümler

    Sözler Manifest V3 ve sonraki sürümlerde desteklenir ancak geriye dönük uyumluluk için geri çağırma işlevleri sağlanır. Aynı işlev çağrısında ikisini birden kullanamazsınız. Sözleşme, geri çağırma işlevine iletilen türle çözülür.

setActiveDevices()

Promise 
chrome.audio.setActiveDevices(
  ids: DeviceIdLists,
  callback?: function,
)

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

Parametreler

  • kimlikler

    DeviceIdLists

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

    Var olmayan bir cihaz kimliği göndermek hatalıdır.

  • geri çağırma

    işlev isteğe bağlı

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

    () => void

İadeler

  • Promise<void>

    Chrome 116 ve sonraki sürümler

    Sözler Manifest V3 ve sonraki sürümlerde desteklenir ancak geriye dönük uyumluluk için geri çağırma işlevleri sağlanır. Aynı işlev çağrısında ikisini birden kullanamazsınız. Sözleşme, geri çağırma işlevine iletilen türle çözülür.

setMute()

Promise 
chrome.audio.setMute(
  streamType: StreamType,
  isMuted: boolean,
  callback?: function,
)

Bir yayın türü için sessize alma durumunu ayarlar. Sessize alma durumu, belirtilen ses akışı 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 sessize alma değeri.

  • geri çağırma

    işlev isteğe bağlı

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

    () => void

İadeler

  • Promise<void>

    Chrome 116 ve sonraki sürümler

    Sözler Manifest V3 ve sonraki sürümlerde desteklenir ancak geriye dönük uyumluluk için geri çağırma işlevleri sağlanır. Aynı işlev çağrısında ikisini birden kullanamazsınız. Sözleşme, geri çağırma işlevine iletilen türle çözülür.

setProperties()

Promise 
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

    işlev isteğe bağlı

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

    () => void

İadeler

  • Promise<void>

    Chrome 116 ve sonraki sürümler

    Sözler Manifest V3 ve sonraki sürümlerde desteklenir ancak geriye dönük uyumluluk için geri çağırma işlevleri sağlanır. Aynı işlev çağrısında ikisini birden kullanamazsınız. Sözleşme, geri çağırma işlevine iletilen türle çözülür.

Etkinlikler

onDeviceListChanged

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

Ses cihazları 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 sessiz durumu değiştiğinde tetiklenir. Sessize alma durumunun sistem genelinde 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