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
Türler
AudioDeviceInfo
Özellikler
-
deviceName
dize
Cihaz adı.
-
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
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
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()
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
-
cihaz
-
İlerlemeler
-
Promise<AudioDeviceInfo[]>
Chrome 116 ve sonraki sürümlerVaatler yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformların geri çağırmaları kullanması gerekir.
getMute()
chrome.audio.getMute(
streamType: StreamType,
callback?: function,
)
Belirtilen akış türü için sistem genelinde sessize alma durumunu alır.
Parametreler
-
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ümlerVaatler yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformların geri çağırmaları kullanması gerekir.
setActiveDevices()
chrome.audio.setActiveDevices(
ids: DeviceIdLists,
callback?: function,
)
Etkin giriş ve/veya çıkış cihazlarının listesini ayarlar.
Parametreler
-
ids
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ümlerVaatler yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformların geri çağırmaları kullanması gerekir.
setMute()
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
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ümlerVaatler yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformların geri çağırmaları kullanması gerekir.
setProperties()
chrome.audio.setProperties(
id: string,
properties: DeviceProperties,
callback?: function,
)
Giriş veya çıkış cihazının özelliklerini ayarlar.
Parametreler
-
id
dize
-
mülkler
-
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ümlerVaatler yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformların geri çağırmaları kullanması gerekir.
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
-
geri çağırma
işlev
callback
parametresi şu şekilde görünür:(devices: AudioDeviceInfo[]) => void
-
cihaz
-
onLevelChanged
chrome.audio.onLevelChanged.addListener(
callback: function,
)
Etkin bir ses cihazının ses düzeyi değiştiğinde tetiklenir.
Parametreler
-
geri çağırma
işlev
callback
parametresi şu şekilde görünür:(event: LevelChangedEvent) => void
-
event
-
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
-
geri çağırma
işlev
callback
parametresi şu şekilde görünür:(event: MuteChangedEvent) => void
-
event
-