chrome.audio

refresh date: 2026-09-25 robots: noindex

Descrizione

L'API chrome.audio viene fornita per consentire agli utenti di ottenere informazioni sui dispositivi audio collegati al sistema e di controllarli. Questa API è attualmente disponibile solo in modalità kiosk per ChromeOS.

Autorizzazioni

audio

Disponibilità

Chrome 59 e versioni successive Solo ChromeOS

Tipi

AudioDeviceInfo

Proprietà

  • deviceName

    stringa

    Nome del dispositivo.

  • deviceType

    DeviceType

    Tipo di dispositivo.

  • displayName

    stringa

    Il nome facile da usare (ad es. "Microfono USB").

  • id

    stringa

    L'identificatore univoco del dispositivo audio.

  • isActive

    booleano

    True se questo è il dispositivo attualmente attivo.

  • livello

    numero

    Il livello audio del dispositivo, il volume per l'output, il guadagno per l'input.

  • stableDeviceId

    stringa facoltativa

    La stringa dell'ID dispositivo stabile/persistente, se disponibile.

  • streamType

    StreamType

    Tipo di stream associato a questo dispositivo.

DeviceFilter

Proprietà

  • isActive

    boolean facoltativo

    Se impostato, solo i dispositivi audio il cui stato attivo corrisponde a questo valore soddisferanno il filtro.

  • streamTypes

    StreamType[] facoltativo

    Se impostato, solo i dispositivi audio il cui tipo di stream è incluso in questo elenco soddisferanno il filtro.

DeviceIdLists

Proprietà

  • input

    string[] facoltativo

    Elenco dei dispositivi di input specificati dal relativo ID.

    Per indicare che i dispositivi di input non devono essere interessati, lascia questa proprietà non impostata.

  • output

    string[] facoltativo

    Elenco dei dispositivi di output specificati in base al relativo ID.

    Per indicare che i dispositivi di output non devono essere interessati, lascia questa proprietà non impostata.

DeviceProperties

Proprietà

  • livello

    number optional

    Il livello audio desiderato del dispositivo audio. Per impostazione predefinita, viene utilizzato il livello audio corrente del dispositivo.

    Se utilizzato con un dispositivo di ingresso audio, rappresenta il guadagno del dispositivo audio.

    Se utilizzato con un dispositivo di output audio, rappresenta il volume del dispositivo audio.

DeviceType

Tipi di dispositivi audio disponibili.

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

Proprietà

  • deviceId

    stringa

    ID del dispositivo il cui livello audio è cambiato.

  • livello

    numero

    Il nuovo livello audio del dispositivo.

MuteChangedEvent

Proprietà

  • isMuted

    booleano

    Indica se lo stream è ora disattivato.

  • streamType

    StreamType

    Il tipo di stream per cui è stato modificato il valore di disattivazione dell'audio. Il valore di disattivazione dell'audio aggiornato si applica a tutti i dispositivi con questo tipo di stream.

StreamType

Tipo di stream fornito da un dispositivo audio.

Enum

"INPUT"

"OUTPUT"

Metodi

getDevices()

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

Recupera un elenco di dispositivi audio filtrati in base a filter.

Parametri

  • filtro

    DeviceFilter facoltativo

    Proprietà dei dispositivi in base alle quali filtrare l'elenco dei dispositivi audio restituiti. Se il filtro non viene impostato o se viene impostato su {}, l'elenco dei dispositivi restituito conterrà tutti i dispositivi audio disponibili.

  • callback

    funzione elemento facoltativo

    Il parametro callback ha il seguente aspetto: 

    (devices: AudioDeviceInfo[]) => void

Resi

  • Promise<AudioDeviceInfo[]>

    Chrome 116 e versioni successive

    Segnala l'elenco richiesto di dispositivi audio.

    Le promise sono supportate solo per Manifest V3 e versioni successive, mentre le altre piattaforme devono utilizzare i callback.

getMute()

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

Recupera lo stato di disattivazione dell'audio a livello di sistema per il tipo di stream specificato.

Parametri

  • streamType

    StreamType

    Tipo di stream per cui deve essere recuperato lo stato di disattivazione dell'audio.

  • callback

    funzione elemento facoltativo

    Il parametro callback ha il seguente aspetto: 

    (value: boolean) => void

    • valore

      booleano

Resi

  • Promise<boolean>

    Chrome 116 e versioni successive

    Promise che si risolve con un valore booleano che indica se l'audio è disattivato o meno per il tipo di stream specificato.

    Le promise sono supportate solo per Manifest V3 e versioni successive, mentre le altre piattaforme devono utilizzare i callback.

setActiveDevices()

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

Imposta gli elenchi dei dispositivi di input e/o output attivi.

Parametri

  • Specifica gli ID dei dispositivi che devono essere attivi. Se l'elenco di input o di output non è impostato, i dispositivi della categoria non sono interessati.

    Se viene trasmesso un ID dispositivo inesistente, si verifica un errore.

  • callback

    funzione elemento facoltativo

    Il parametro callback ha il seguente aspetto: 

    () => void

Resi

  • Promise<void>

    Chrome 116 e versioni successive

    Le promise sono supportate solo per Manifest V3 e versioni successive, mentre le altre piattaforme devono utilizzare i callback.

setMute()

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

Imposta lo stato di disattivazione dell'audio per un tipo di stream. Lo stato di disattivazione dell'audio verrà applicato a tutti i dispositivi audio con il tipo di stream audio specificato.

Parametri

  • streamType

    StreamType

    Tipo di stream per cui deve essere impostato lo stato di disattivazione dell'audio.

  • isMuted

    booleano

    Nuovo valore di disattivazione audio.

  • callback

    funzione elemento facoltativo

    Il parametro callback ha il seguente aspetto: 

    () => void

Resi

  • Promise<void>

    Chrome 116 e versioni successive

    Le promise sono supportate solo per Manifest V3 e versioni successive, mentre le altre piattaforme devono utilizzare i callback.

setProperties()

Promise 
chrome.audio.setProperties(
  id: string,
  properties: DeviceProperties,
  callback?: function,
): Promise<void>

Imposta le proprietà del dispositivo di input o output.

Parametri

  • id

    stringa

  • proprietà

    DeviceProperties

  • callback

    funzione elemento facoltativo

    Il parametro callback ha il seguente aspetto: 

    () => void

Resi

  • Promise<void>

    Chrome 116 e versioni successive

    Le promise sono supportate solo per Manifest V3 e versioni successive, mentre le altre piattaforme devono utilizzare i callback.

Eventi

onDeviceListChanged

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

Attivato quando i dispositivi audio cambiano, ovvero quando vengono aggiunti nuovi dispositivi o rimossi quelli esistenti.

Parametri

onLevelChanged

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

Attivato quando il livello audio cambia per un dispositivo audio attivo.

Parametri

onMuteChanged

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

Attivato quando lo stato di disattivazione dell'audio dell'ingresso o dell'uscita audio cambia. Tieni presente che lo stato di disattivazione dell'audio è a livello di sistema e il nuovo valore si applica a ogni dispositivo audio con il tipo di stream specificato.

Parametri