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ımak için sağlanmaktadı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

    boolean

    Geçerli olarak etkin cihaz buysa doğru değerini döndürür.

  • seviye

    sayı

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

  • stableDeviceId

    dize isteğe bağlı

    Kullanılabilir olduğunda sabit/kalıcı cihaz kimliği dizesi.

  • streamType

    StreamType

    Bu cihazla ilişkilendirilmiş akış 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 akış 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 ayarlamadan bırakın.

  • çıkış

    string[] isteğe bağlı

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

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

DeviceProperties

Özellikler

  • seviye

    sayı isteğe bağlı

    Ses sisteminin istenen ses düzeyi. Varsayılan olarak cihazın mevcut ses seviyesine ayarlanır.

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

    Ses çıkış cihazıyla kullanılırsa ses cihazındaki ses düzeyini gösterir.

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

  • seviye

    sayı

    Cihazın yeni ses seviyesi.

MuteChangedEvent

Özellikler

  • isMuted

    boolean

    Akışın şu anda sesinin kapatılıp kapatılmadığı.

  • streamType

    StreamType

    Yoksayma değerinin değiştiği akışın türü. Güncellenen yoksayma değeri, bu akış türüne sahip tüm cihazlar için geçerlidir.

StreamType

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

Enum

"INPUT"

"ÇIKIŞ"

Yöntemler

getDevices()

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

filter temel alınarak filtrelenen ses cihazlarının listesini alır.

Parametreler

  • filtrele

    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

    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 'nı inceleyin.

    Vaatler yalnızca Manifest V3 ve sonraki sürümler için desteklenir. Diğer platformların geri çağırma yapması gerekir.

getMute()

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

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

Parametreler

  • streamType

    StreamType

    Yoksayma durumunun getirilmesi gereken akış 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 'nı inceleyin.

    Vaatler yalnızca Manifest V3 ve sonraki sürümler için desteklenir. Diğer platformların geri çağırma yapması gerekir.

setActiveDevices()

Söz 'nı inceleyin.
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 ayarlanmazsa söz konusu kategorideki cihazlar etkilenmez.

    Var olmayan bir cihaz kimliğinin aktarılması hatadır.

  • geri çağırma

    işlev isteğe bağlı

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

    () => void

İadeler

  • Taahhüt<void>

    Chrome 116 ve sonraki sürümler 'nı inceleyin.

    Vaatler yalnızca Manifest V3 ve sonraki sürümler için desteklenir. Diğer platformların geri çağırma yapması gerekir.

setMute()

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

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

Parametreler

  • streamType

    StreamType

    Yoksayma durumunun ayarlanması gereken yayın türü.

  • isMuted

    boolean

    Yeni yoksayma değeri.

  • geri çağırma

    işlev isteğe bağlı

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

    () => void

İadeler

  • Taahhüt<void>

    Chrome 116 ve sonraki sürümler 'nı inceleyin.

    Vaatler yalnızca Manifest V3 ve sonraki sürümler için desteklenir. Diğer platformların geri çağırma yapması gerekir.

setProperties()

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

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

Parametreler

  • id

    dize

  • geri çağırma

    işlev isteğe bağlı

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

    () => void

İadeler

  • Taahhüt<void>

    Chrome 116 ve sonraki sürümler 'nı inceleyin.

    Vaatler yalnızca Manifest V3 ve sonraki sürümler için desteklenir. Diğer platformların geri çağırma yapması gerekir.

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