Deskripsi
chrome.audio
API disediakan untuk memungkinkan pengguna mendapatkan informasi dan mengontrol perangkat audio yang terpasang ke sistem. API ini saat ini hanya tersedia dalam mode kios untuk ChromeOS.
Izin
audio
Ketersediaan
Jenis
AudioDeviceInfo
Properti
-
deviceName
string
Nama perangkat.
-
deviceType
Jenis perangkat.
-
displayName
string
Nama yang mudah digunakan (mis. "Mikrofon USB").
-
id
string
ID unik perangkat audio.
-
isActive
boolean
True jika perangkat ini aktif saat ini.
-
yaitu tingkat klik
angka
Level suara perangkat, volume untuk output, penguatan untuk input.
-
stableDeviceId
string opsional
String ID perangkat stabil/tetap jika tersedia.
-
streamType
Jenis streaming yang dikaitkan dengan perangkat ini.
DeviceFilter
Properti
-
isActive
boolean opsional
Jika disetel, hanya perangkat audio yang status aktifnya cocok dengan nilai ini yang akan memenuhi filter.
-
streamTypes
StreamType[] opsional
Jika disetel, hanya perangkat audio yang jenis streaming-nya disertakan dalam daftar ini yang akan memenuhi filter.
DeviceIdLists
Properti
-
input
string[] opsional
Daftar perangkat input yang ditentukan berdasarkan ID-nya.
Untuk menunjukkan bahwa perangkat input tidak akan terpengaruh, jangan tetapkan properti ini.
-
hasil
string[] opsional
Daftar perangkat output yang ditentukan berdasarkan ID-nya.
Untuk menunjukkan perangkat output tidak akan terpengaruh, jangan tetapkan properti ini.
DeviceProperties
Properti
-
yaitu tingkat klik
nomor opsional
Tingkat suara yang diinginkan perangkat audio. Setelan default-nya adalah level suara perangkat saat ini.
Jika digunakan dengan perangkat input audio, mewakili penguatan perangkat audio.
Jika digunakan dengan perangkat output audio, mewakili volume perangkat audio.
DeviceType
Jenis perangkat audio yang tersedia.
Enum
"HEADPHONE"
"MIC"
"USB"
"BLUETOOTH"
"HDMI"
"INTERNAL_SPEAKER"
"INTERNAL_MIC"
"FRONT_MIC"
"REAR_MIC"
"HOTWORD"
"LINEOUT"
"POST_MIX_LOOPBACK"
"POST_DSP_LOOPBACK"
"ALSA_LOOPBACK"
"OTHER"
LevelChangedEvent
Properti
-
deviceId
string
ID perangkat yang tingkat suaranya telah berubah.
-
yaitu tingkat klik
angka
Level suara baru perangkat.
MuteChangedEvent
Properti
-
isMuted
boolean
Apakah streaming sekarang dibisukan atau tidak.
-
streamType
Jenis streaming yang nilai bisukan audionya telah diubah. Nilai bisu yang diperbarui berlaku untuk semua perangkat dengan jenis streaming ini.
StreamType
Jenis streaming yang disediakan perangkat audio.
Enum
"INPUT"
"OUTPUT"
Metode
getDevices()
chrome.audio.getDevices(
filter?: DeviceFilter,
callback?: function,
)
Mendapatkan daftar perangkat audio yang difilter berdasarkan filter
.
Parameter
-
filter
DeviceFilter opsional
Properti perangkat yang digunakan untuk memfilter daftar perangkat audio yang ditampilkan. Jika filter tidak disetel atau disetel ke
{}
, daftar perangkat yang ditampilkan akan berisi semua perangkat audio yang tersedia. -
callback
fungsi opsional
Parameter
callback
terlihat seperti:(devices: AudioDeviceInfo[]) => void
-
perangkat
-
Hasil
-
Promise<AudioDeviceInfo[]>
Chrome 116 dan yang lebih baruPromise didukung di Manifes V3 dan yang lebih baru, tetapi callback disediakan untuk kompatibilitas mundur. Anda tidak dapat menggunakan keduanya pada panggilan fungsi yang sama. Promise di-resolve dengan jenis yang sama yang diteruskan ke callback.
getMute()
chrome.audio.getMute(
streamType: StreamType,
callback?: function,
)
Mendapatkan status bisukan di seluruh sistem untuk jenis streaming yang ditentukan.
Parameter
-
streamType
Jenis streaming yang status penonaktifannya harus diambil.
-
callback
fungsi opsional
Parameter
callback
terlihat seperti:(value: boolean) => void
-
value
boolean
-
Hasil
-
Promise<boolean>
Chrome 116 dan yang lebih baruPromise didukung di Manifes V3 dan yang lebih baru, tetapi callback disediakan untuk kompatibilitas mundur. Anda tidak dapat menggunakan keduanya pada panggilan fungsi yang sama. Promise di-resolve dengan jenis yang sama yang diteruskan ke callback.
setActiveDevices()
chrome.audio.setActiveDevices(
ids: DeviceIdLists,
callback?: function,
)
Menetapkan daftar perangkat input dan/atau output aktif.
Parameter
-
ids
Menentukan ID perangkat yang akan aktif. Jika daftar input atau output tidak disetel, perangkat dalam kategori tersebut tidak akan terpengaruh.
Ini merupakan error untuk meneruskan ID perangkat yang tidak ada.
-
callback
fungsi opsional
Parameter
callback
terlihat seperti:() => void
Hasil
-
Promise<void>
Chrome 116 dan yang lebih baruPromise didukung di Manifes V3 dan yang lebih baru, tetapi callback disediakan untuk kompatibilitas mundur. Anda tidak dapat menggunakan keduanya pada panggilan fungsi yang sama. Promise di-resolve dengan jenis yang sama yang diteruskan ke callback.
setMute()
chrome.audio.setMute(
streamType: StreamType,
isMuted: boolean,
callback?: function,
)
Menyetel status penonaktifan untuk jenis streaming. Status bisukan akan diterapkan ke semua perangkat audio dengan jenis streaming audio yang ditentukan.
Parameter
-
streamType
Jenis streaming yang status penonaktifannya harus ditetapkan.
-
isMuted
boolean
Nilai penonaktifan baru.
-
callback
fungsi opsional
Parameter
callback
terlihat seperti:() => void
Hasil
-
Promise<void>
Chrome 116 dan yang lebih baruPromise didukung di Manifes V3 dan yang lebih baru, tetapi callback disediakan untuk kompatibilitas mundur. Anda tidak dapat menggunakan keduanya pada panggilan fungsi yang sama. Promise di-resolve dengan jenis yang sama yang diteruskan ke callback.
setProperties()
chrome.audio.setProperties(
id: string,
properties: DeviceProperties,
callback?: function,
)
Menetapkan properti untuk perangkat input atau output.
Parameter
-
id
string
-
properti
-
callback
fungsi opsional
Parameter
callback
terlihat seperti:() => void
Hasil
-
Promise<void>
Chrome 116 dan yang lebih baruPromise didukung di Manifes V3 dan yang lebih baru, tetapi callback disediakan untuk kompatibilitas mundur. Anda tidak dapat menggunakan keduanya pada panggilan fungsi yang sama. Promise di-resolve dengan jenis yang sama yang diteruskan ke callback.
Peristiwa
onDeviceListChanged
chrome.audio.onDeviceListChanged.addListener(
callback: function,
)
Diaktifkan saat perangkat audio berubah, entah itu perangkat baru yang ditambahkan, atau perangkat yang sudah ada dihapus.
Parameter
-
callback
fungsi
Parameter
callback
terlihat seperti:(devices: AudioDeviceInfo[]) => void
-
perangkat
-
onLevelChanged
chrome.audio.onLevelChanged.addListener(
callback: function,
)
Diaktifkan saat level suara berubah untuk perangkat audio aktif.
Parameter
-
callback
fungsi
Parameter
callback
terlihat seperti:(event: LevelChangedEvent) => void
-
event
-
onMuteChanged
chrome.audio.onMuteChanged.addListener(
callback: function,
)
Diaktifkan saat status bisukan input atau output audio berubah. Perlu diketahui bahwa status bisukan berlaku di seluruh sistem dan nilai baru berlaku untuk setiap perangkat audio dengan jenis streaming yang ditentukan.
Parameter
-
callback
fungsi
Parameter
callback
terlihat seperti:(event: MuteChangedEvent) => void
-
event
-