chrome.audio

Descrizione

Viene fornita l'API chrome.audio 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 semplice 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 dell'audio del dispositivo, il volume per l'uscita e il guadagno per l'ingresso.

  • stableDeviceId

    stringa facoltativo

    La stringa ID dispositivo stabile/persistente, se disponibile.

  • streamType

    StreamType

    Tipo di stream associato a questo dispositivo.

DeviceFilter

Proprietà

  • isActive

    booleano 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 di dispositivi di input specificati in base al relativo ID.

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

  • output

    string[] facoltativo

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

    numero facoltativo

    Il livello audio desiderato del dispositivo audio. Per impostazione predefinita è l'attuale livello sonoro del dispositivo.

    Se utilizzato con un dispositivo di input 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

"CUFFETTO"

"MIC"

"USB"

"BLUETOOTH"

"HDMI"

"INTERNAL_SPEAKER"

"INTERNAL_MIC"

"FRONT_MIC"

"REAR_MIC"

"KEYBOARD_MIC"

"HOTWORD"

"LINEOUT"

"POST_MIX_LOOPBACK"

"POST_DSP_LOOPBACK"

"ALSA_LOOPBACK"

"ALTRO"

LevelChangedEvent

Proprietà

  • deviceId

    stringa

    ID del dispositivo il cui livello audio è cambiato.

  • livello

    numero

    Il nuovo livello sonoro del dispositivo.

MuteChangedEvent

Proprietà

  • isMuted

    booleano

    Indica se lo stream è ora disattivato o meno.

  • streamType

    StreamType

    Il tipo di stream per cui è stato modificato il valore di disattivazione dell'audio. Il valore di disattivazione 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()

Promesso .
chrome.audio.getDevices(
  filter?: DeviceFilter,
  callback?: function,
)

Consente di acquisire un elenco di dispositivi audio filtrati in base a filter.

Parametri

  • filtro

    DeviceFilter facoltativo

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

  • callback

    funzione facoltativa

    Il parametro callback ha il seguente aspetto: 

    (devices: AudioDeviceInfo[]) => void

Resi

  • Promise<AudioDeviceInfo[]>

    Chrome 116 e versioni successive .

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

getMute()

Promesso .
chrome.audio.getMute(
  streamType: StreamType,
  callback?: function,
)

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

Parametri

  • streamType

    StreamType

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

  • callback

    funzione facoltativa

    Il parametro callback ha il seguente aspetto: 

    (value: boolean) => void

    • valore

      booleano

Resi

  • Promise<boolean>

    Chrome 116 e versioni successive .

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

setActiveDevices()

Promesso .
chrome.audio.setActiveDevices(
  ids: DeviceIdLists,
  callback?: function,
)

Consente di impostare elenchi di dispositivi di input e/o output attivi.

Parametri

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

    È un errore passare in un ID dispositivo inesistente.

  • callback

    funzione facoltativa

    Il parametro callback ha il seguente aspetto: 

    () => void

Resi

  • Promesso<void>

    Chrome 116 e versioni successive .

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

setMute()

Promesso .
chrome.audio.setMute(
  streamType: StreamType,
  isMuted: boolean,
  callback?: function,
)

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

Parametri

  • streamType

    StreamType

    Tipo di stream per cui impostare lo stato di disattivazione audio.

  • isMuted

    booleano

    Nuovo valore di disattivazione audio.

  • callback

    funzione facoltativa

    Il parametro callback ha il seguente aspetto: 

    () => void

Resi

  • Promesso<void>

    Chrome 116 e versioni successive .

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

setProperties()

Promesso .
chrome.audio.setProperties(
  id: string,
  properties: DeviceProperties,
  callback?: function,
)

Consente di impostare le proprietà del dispositivo di input o output.

Parametri

  • id

    stringa

  • callback

    funzione facoltativa

    Il parametro callback ha il seguente aspetto: 

    () => void

Resi

  • Promesso<void>

    Chrome 116 e versioni successive .

    Le promesse 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 cambiano dispositivi audio, quando vengono aggiunti nuovi dispositivi o vengono rimossi quelli esistenti.

Parametri

onLevelChanged

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

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

Parametri

onMuteChanged

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

Attivato quando cambia lo stato di disattivazione dell'audio dell'ingresso o dell'uscita audio. Tieni presente che lo stato di disattivazione audio è a livello di sistema e il nuovo valore viene applicato a tutti i dispositivi audio con il tipo di stream specificato.

Parametri