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ımak için sağlanır. Bu API şu anda yalnızca ChromeOS'te 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

    Bu, etkin olan mevcut cihazsa doğru değerini döndürür.

  • seviye

    sayı

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

  • stableDeviceId

    dize isteğe bağlı

    Kullanılabildiğinde kararlı/kalıcı cihaz kimliği dizesi.

  • streamType

    StreamType

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

DeviceFilter

Özellikler

  • isActive

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

    Ayarlandığında, 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 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 düzeyi. Varsayılan olarak cihazın mevcut ses düzeyine ayarlanır.

    Ses girişi cihazıyla kullanıldığında ses cihazı kazancını gösterir.

    Ses çıkış cihazıyla kullanıldığında ses cihazının ses düzeyini 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"

"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 şu anda sessize alınıp alınmadığı.

  • streamType

    StreamType

    Sessize alma değerinin değiştiği akışın türü. Güncellenen sessize alma 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ü.

Enum

"INPUT"

"OUTPUT"

Yöntemler

getDevices()

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

filter'ya göre filtrelenmiş 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 {} olarak ayarlanırsa döndürülen cihaz listesi, kullanılabilir tüm ses cihazlarını içerir.

  • callback

    işlev isteğe bağlı

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

    (devices: AudioDeviceInfo[]) => void

İadeler

  • Promise<AudioDeviceInfo[]>

    Chrome 116 veya daha yeni bir sürüm

    Promises yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformlarda geri çağırmalar kullanılmalıdır.

getMute()

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

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

Parametreler

  • streamType

    StreamType

    Sessiz durumunun getirileceği yayın türü.

  • callback

    işlev isteğe bağlı

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

    (value: boolean) => void

    • value

      boolean

İadeler

  • Promise<boolean>

    Chrome 116 veya daha yeni bir sürüm

    Promises yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformlarda geri çağırmalar kullanılmalıdır.

setActiveDevices()

Promise 
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 ayarlanmamışsa bu kategorideki cihazlar etkilenmez.

    Mevcut olmayan bir cihaz kimliği iletmek hatadır.

  • callback

    işlev isteğe bağlı

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

    () => void

İadeler

  • Promise<void>

    Chrome 116 veya daha yeni bir sürüm

    Promises yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformlarda geri çağırmalar kullanılmalıdır.

setMute()

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

Bir akış 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

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

  • isMuted

    boolean

    Yeni sessize alma değeri.

  • callback

    işlev isteğe bağlı

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

    () => void

İadeler

  • Promise<void>

    Chrome 116 veya daha yeni bir sürüm

    Promises yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformlarda geri çağırmalar kullanılmalıdır.

setProperties()

Promise 
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

    işlev isteğe bağlı

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

    () => void

İadeler

  • Promise<void>

    Chrome 116 veya daha yeni bir sürüm

    Promises yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformlarda geri çağırmalar kullanılmalıdı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 düzeyi değiştiğinde tetiklenir.

Parametreler

onMuteChanged

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

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

Parametreler