chrome.audio

.

Descripción

Se proporciona la API de chrome.audio 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 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

    boolean

    Es verdadero si este es el dispositivo activo en este momento.

  • level

    número

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

  • stableDeviceId

    string opcional

    La cadena de ID del dispositivo estable o persistente cuando está disponible.

  • streamType

    StreamType

    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

    Lista de dispositivos de entrada especificados por su ID.

    Para indicar que los dispositivos de entrada no deben verse afectados, no configures esta propiedad.

  • output

    string[] opcional

    Lista de dispositivos de salida especificados por su ID.

    Para indicar que los dispositivos de salida no deben verse afectados, no configures esta propiedad.

DeviceProperties

Propiedades

  • level

    número opcional

    El nivel de sonido deseado para el dispositivo de audio. El valor predeterminado es 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

    ID del dispositivo cuyo nivel de sonido cambió.

  • level

    número

    Nuevo nivel de sonido del dispositivo.

MuteChangedEvent

Propiedades

  • isMuted

    boolean

    Si se silenció o no la transmisión.

  • streamType

    StreamType

    Tipo de transmisión para la que se 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

"ENTRADA"

"SALIDA"

Métodos

getDevices()

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

Obtiene una lista de dispositivos de audio filtrados en función de filter.

Parámetros

  • filter

    DeviceFilter opcional

    Propiedades del dispositivo por las que se filtra la lista de dispositivos de audio que se muestran. Si el filtro no se establece o se establece en {}, la lista de dispositivos mostrados 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

    Las promesas son compatibles con Manifest V3 y versiones posteriores, pero se proporcionan devoluciones de llamada para retrocompatibilidad. No puedes usar ambos en la misma llamada a función. El se resuelve con el mismo tipo que se pasa a la devolución de llamada.

getMute()

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

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

Parámetros

  • streamType

    StreamType

    Tipo de transmisión para la 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

      boolean

Muestra

  • Promise<boolean>

    Chrome 116 y versiones posteriores

    Las promesas son compatibles con Manifest V3 y versiones posteriores, pero se proporcionan devoluciones de llamada para retrocompatibilidad. No puedes usar ambos en la misma llamada a función. El se resuelve con el mismo tipo que se pasa a la devolución de llamada.

setActiveDevices()

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

Establece listas de dispositivos de entrada o salida activos.

Parámetros

  • Especifica los ID 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.

    Es un error pasar un ID de dispositivo que no existe.

  • callback

    función opcional

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

    () => void

Muestra

  • Promesa<void>

    Chrome 116 y versiones posteriores

    Las promesas son compatibles con Manifest V3 y versiones posteriores, pero se proporcionan devoluciones de llamada para retrocompatibilidad. No puedes usar ambos en la misma llamada a función. El se resuelve con el mismo tipo que se pasa a la devolución de llamada.

setMute()

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

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

    El tipo de transmisión para el que se debe configurar el estado de silencio.

  • isMuted

    boolean

    Nuevo valor de silenciamiento.

  • callback

    función opcional

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

    () => void

Muestra

  • Promesa<void>

    Chrome 116 y versiones posteriores

    Las promesas son compatibles con Manifest V3 y versiones posteriores, pero se proporcionan devoluciones de llamada para retrocompatibilidad. No puedes usar ambos en la misma llamada a función. El se resuelve con el mismo tipo que se pasa a la devolución de llamada.

setProperties()

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

Establece las propiedades del dispositivo de entrada o salida.

Parámetros

  • id

    string

  • properties

    DeviceProperties

  • callback

    función opcional

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

    () => void

Muestra

  • Promesa<void>

    Chrome 116 y versiones posteriores

    Las promesas son compatibles con Manifest V3 y versiones posteriores, pero se proporcionan devoluciones de llamada para retrocompatibilidad. No puedes usar ambos en la misma llamada a función. El se resuelve con el mismo tipo que se pasa a la devolución de llamada.

Eventos

onDeviceListChanged

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

Se activa cuando cambian los dispositivos de audio, ya sea que se agregan dispositivos nuevos o se quitan dispositivos 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 el valor nuevo se aplica a todos los dispositivos de audio con el tipo de transmisión especificado.

Parámetros