chrome.audio

refresh date: 2026-09-25 robots: noindex

Descripción

La API de chrome.audio se proporciona para permitir que los usuarios obtengan información sobre los dispositivos de audio conectados al sistema y los controlen. Actualmente, esta API solo está disponible en el modo kiosco para ChromeOS.

Permisos

audio

Disponibilidad

Chrome 59 y versiones posteriores Solo en ChromeOS

Tipos

AudioDeviceInfo

Propiedades

  • deviceName

    string

    Nombre del dispositivo.

  • deviceType

    DeviceType

    Tipo del dispositivo.

  • displayName

    string

    Es el nombre fácil de usar (p.ej., "Micrófono USB").

  • id

    string

    Es el identificador único del dispositivo de audio.

  • Está activo

    booleano

    Es verdadero si este es el dispositivo activo actual.

  • level

    número

    Es el nivel de sonido del dispositivo, el volumen de salida y la ganancia de entrada.

  • stableDeviceId

    string opcional

    Es la cadena de ID de dispositivo estable o persistente cuando está disponible.

  • streamType

    StreamType

    Es el tipo de transmisión asociado con este dispositivo.

DeviceFilter

Propiedades

  • Está activo

    booleano opcional

    Si se establece, solo los dispositivos de audio cuyo estado activo coincida con este valor cumplirán con el filtro.

  • streamTypes

    StreamType[] opcional

    Si se establece, solo los dispositivos de audio cuyo tipo de transmisión se incluya en esta lista cumplirán con el filtro.

DeviceIdLists

Propiedades

  • entrada

    string[] opcional

    Es la lista de dispositivos de entrada especificados por su ID.

    Para indicar que los dispositivos de entrada no deben verse afectados, deja esta propiedad sin configurar.

  • output

    string[] opcional

    Es la lista de dispositivos de salida especificados por su ID.

    Para indicar que los dispositivos de salida no deben verse afectados, deja esta propiedad sin configurar.

DeviceProperties

Propiedades

  • level

    number opcional

    Es el nivel de sonido deseado del dispositivo de audio. Se establece de forma predeterminada en el nivel de sonido actual del dispositivo.

    Si se usa con un dispositivo de entrada de audio, representa la ganancia del dispositivo de audio.

    Si se usa con un dispositivo de salida de audio, representa el volumen del dispositivo de audio.

DeviceType

Tipos de dispositivos de audio disponibles.

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

Propiedades

  • deviceId

    string

    Es el ID del dispositivo cuyo nivel de sonido cambió.

  • level

    número

    El nuevo nivel de sonido del dispositivo.

MuteChangedEvent

Propiedades

  • isMuted

    booleano

    Indica si la transmisión está silenciada o no.

  • streamType

    StreamType

    Es el tipo de transmisión para la que cambió el valor de silencio. El valor de silencio actualizado se aplica a todos los dispositivos con este tipo de transmisión.

StreamType

Es el tipo de transmisión que proporciona un dispositivo de audio.

Enum

"INPUT"

"OUTPUT"

Métodos

getDevices()

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

Obtiene una lista de dispositivos de audio filtrados según filter.

Parámetros

  • filter

    DeviceFilter opcional

    Son las propiedades del dispositivo por las que se filtra la lista de dispositivos de audio que se muestran. Si no se establece el filtro o se establece en {}, la lista de dispositivos devuelta contendrá todos los dispositivos de audio disponibles.

  • callback

    función opcional

    El parámetro callback se ve de la siguiente manera: 

    (devices: AudioDeviceInfo[]) => void

Muestra

  • Promise<AudioDeviceInfo[]>

    Chrome 116 y versiones posteriores

    Informa la lista solicitada de dispositivos de audio.

    Las promesas solo se admiten en Manifest V3 y versiones posteriores. Otras plataformas deben usar devoluciones de llamada.

getMute()

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

Obtiene el estado de silencio de todo el sistema para el tipo de transmisión especificado.

Parámetros

  • streamType

    StreamType

    Es el tipo de transmisión para el que se debe recuperar el estado de silencio.

  • callback

    función opcional

    El parámetro callback se ve de la siguiente manera: 

    (value: boolean) => void

    • valor

      booleano

Muestra

  • Promise<boolean>

    Chrome 116 y versiones posteriores

    Es una promesa que se resuelve con un valor booleano que indica si se estableció el silencio o no para el tipo de transmisión especificado.

    Las promesas solo se admiten en Manifest V3 y versiones posteriores. Otras plataformas deben usar devoluciones de llamada.

setActiveDevices()

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

Establece listas de dispositivos de entrada o salida activos.

Parámetros

  • Especifica los IDs de los dispositivos que deben estar activos. Si no se establece la lista de entrada o salida, los dispositivos de esa categoría no se verán afectados.

    Se produce un error si se pasa un ID de dispositivo inexistente.

  • callback

    función opcional

    El parámetro callback se ve de la siguiente manera: 

    () => void

Muestra

  • Promise<void>

    Chrome 116 y versiones posteriores

    Las promesas solo se admiten en Manifest V3 y versiones posteriores. Otras plataformas deben usar devoluciones de llamada.

setMute()

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

Establece el estado de silencio para un tipo de transmisión. El estado de silencio se aplicará a todos los dispositivos de audio con el tipo de transmisión de audio especificado.

Parámetros

  • streamType

    StreamType

    Es el tipo de transmisión para el que se debe establecer el estado de silencio.

  • isMuted

    booleano

    Es el nuevo valor de silencio.

  • callback

    función opcional

    El parámetro callback se ve de la siguiente manera: 

    () => void

Muestra

  • Promise<void>

    Chrome 116 y versiones posteriores

    Las promesas solo se admiten en Manifest V3 y versiones posteriores. Otras plataformas deben usar devoluciones de llamada.

setProperties()

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

Establece las propiedades del dispositivo de entrada o salida.

Parámetros

  • id

    string

  • propiedades

    DeviceProperties

  • callback

    función opcional

    El parámetro callback se ve de la siguiente manera: 

    () => void

Muestra

  • Promise<void>

    Chrome 116 y versiones posteriores

    Las promesas solo se admiten en Manifest V3 y versiones posteriores. Otras plataformas deben usar devoluciones de llamada.

Eventos

onDeviceListChanged

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

Se activa cuando cambian los dispositivos de audio, ya sea que se agreguen dispositivos nuevos o se quiten los existentes.

Parámetros

onLevelChanged

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

Se activa cuando cambia el nivel de sonido de un dispositivo de audio activo.

Parámetros

onMuteChanged

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

Se activa cuando cambia el estado de silencio de la entrada o salida de audio. Ten en cuenta que el estado de silencio se aplica a todo el sistema y que el valor nuevo se aplica a todos los dispositivos de audio con el tipo de transmisión especificado.

Parámetros