chrome.audio

refresh date: 2026-09-25 robots: noindex

Opis

Interfejs API chrome.audio umożliwia użytkownikom uzyskiwanie informacji o urządzeniach audio podłączonych do systemu i sterowanie nimi. Ten interfejs API jest obecnie dostępny tylko w trybie kiosku w ChromeOS.

Uprawnienia

audio

Dostępność

Chrome 59 lub nowsza wersja Tylko ChromeOS

Typy

AudioDeviceInfo

Właściwości

  • deviceName

    tekst

    Nazwa urządzenia.

  • deviceType

    DeviceType

    Typ urządzenia.

  • wyświetlanaNazwa

    tekst

    przyjazna dla użytkownika nazwa (np. „Mikrofon USB”).

  • id

    tekst

    Unikalny identyfikator urządzenia audio.

  • isActive

    wartość logiczna

    Prawda, jeśli jest to obecnie aktywne urządzenie.

  • poziom

    liczba

    Poziom dźwięku urządzenia, głośność wyjściowa, wzmocnienie wejściowe.

  • stableDeviceId

    ciąg znaków opcjonalny

    Ciąg znaków identyfikatora urządzenia (jeśli jest dostępny).

  • streamType

    StreamType

    Typ strumienia powiązany z tym urządzeniem.

DeviceFilter

Właściwości

  • isActive

    boolean opcjonalne

    Jeśli jest ustawiony, filtr będzie spełniony tylko przez urządzenia audio, których stan aktywności odpowiada tej wartości.

  • streamTypes

    StreamType[] opcjonalny

    Jeśli ta zasada jest skonfigurowana, filtr będzie uwzględniać tylko urządzenia audio, których typ strumienia znajduje się na tej liście.

DeviceIdLists

Właściwości

  • wprowadzanie danych

    string[] opcjonalne

    Lista urządzeń wejściowych określonych przez ich identyfikatory.

    Aby wskazać, że urządzenia wejściowe nie powinny być objęte działaniem, pozostaw tę właściwość nieustawioną.

  • output

    string[] opcjonalne

    Lista urządzeń wyjściowych określonych przez ich identyfikatory.

    Aby wskazać, że urządzenia wyjściowe nie powinny być objęte działaniem, pozostaw tę właściwość nieustawioną.

DeviceProperties

Właściwości

  • poziom

    number optional

    Żądany poziom głośności urządzenia audio. Domyślnie jest to bieżący poziom głośności urządzenia.

    Jeśli jest używany z urządzeniem wejściowym audio, reprezentuje wzmocnienie urządzenia audio.

    Jeśli jest używany z urządzeniem wyjściowym audio, reprezentuje głośność urządzenia audio.

DeviceType

Dostępne typy urządzeń audio.

Typ wyliczeniowy

"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

Właściwości

  • deviceId

    tekst

    Identyfikator urządzenia, którego poziom dźwięku się zmienił.

  • poziom

    liczba

    Nowy poziom głośności urządzenia.

MuteChangedEvent

Właściwości

  • isMuted

    wartość logiczna

    Określa, czy strumień jest teraz wyciszony.

  • streamType

    StreamType

    Typ strumienia, dla którego zmieniła się wartość wyciszenia. Zaktualizowana wartość wyciszenia zostanie zastosowana do wszystkich urządzeń z tym typem strumienia.

StreamType

Typ strumienia dostarczanego przez urządzenie audio.

Typ wyliczeniowy

"INPUT"

"OUTPUT"

Metody

getDevices()

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

Pobiera listę urządzeń audio przefiltrowaną na podstawie filter.

Parametry

  • filtr

    DeviceFilter opcjonalny

    Właściwości urządzenia, według których można filtrować listę zwróconych urządzeń audio. Jeśli filtr jest nieskonfigurowany lub ma wartość {}, zwrócona lista urządzeń będzie zawierać wszystkie dostępne urządzenia audio.

  • callback

    function opcjonalne

    Parametr callback wygląda tak:

    (devices: AudioDeviceInfo[]) => void

Zwroty

  • Promise<AudioDeviceInfo[]>

    Chrome 116 lub nowsza wersja

    Zwraca żądaną listę urządzeń audio.

    Obiekty Promise są obsługiwane tylko w przypadku platformy Manifest V3 i nowszych. Na innych platformach należy używać wywołań zwrotnych.

getMute()

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

Pobiera stan wyciszenia w całym systemie dla określonego typu strumienia.

Parametry

  • streamType

    StreamType

    Typ strumienia, dla którego ma zostać pobrany stan wyciszenia.

  • callback

    function opcjonalne

    Parametr callback wygląda tak:

    (value: boolean) => void

    • wartość

      wartość logiczna

Zwroty

  • Promise<boolean>

    Chrome 116 lub nowsza wersja

    Obiekt Promise, który zwraca wartość logiczną wskazującą, czy wyciszenie jest ustawione dla określonego typu strumienia.

    Obiekty Promise są obsługiwane tylko w przypadku platformy Manifest V3 i nowszych. Na innych platformach należy używać wywołań zwrotnych.

setActiveDevices()

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

Ustawia listy aktywnych urządzeń wejściowych lub wyjściowych.

Parametry

  • identyfikatory

    DeviceIdLists

    Określa identyfikatory urządzeń, które powinny być aktywne. Jeśli lista wejściowa lub wyjściowa nie jest skonfigurowana, nie ma to wpływu na urządzenia z tej kategorii.

    Przekazanie nieistniejącego identyfikatora urządzenia jest błędem.

  • callback

    function opcjonalne

    Parametr callback wygląda tak:

    () => void

Zwroty

  • thought Promise<void>

    Chrome 116 lub nowsza wersja

    Obiekty Promise są obsługiwane tylko w przypadku platformy Manifest V3 i nowszych. Na innych platformach należy używać wywołań zwrotnych.

setMute()

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

Ustawia stan wyciszenia dla typu strumienia. Stan wyciszenia zostanie zastosowany do wszystkich urządzeń audio z określonym typem strumienia audio.

Parametry

  • streamType

    StreamType

    Typ strumienia, dla którego ma zostać ustawiony stan wyciszenia.

  • isMuted

    wartość logiczna

    Nowa wartość wyciszenia.

  • callback

    function opcjonalne

    Parametr callback wygląda tak:

    () => void

Zwroty

  • thought Promise<void>

    Chrome 116 lub nowsza wersja

    Obiekty Promise są obsługiwane tylko w przypadku platformy Manifest V3 i nowszych. Na innych platformach należy używać wywołań zwrotnych.

setProperties()

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

Ustawia właściwości urządzenia wejściowego lub wyjściowego.

Parametry

  • id

    tekst

  • właściwości

    DeviceProperties

  • callback

    function opcjonalne

    Parametr callback wygląda tak:

    () => void

Zwroty

  • thought Promise<void>

    Chrome 116 lub nowsza wersja

    Obiekty Promise są obsługiwane tylko w przypadku platformy Manifest V3 i nowszych. Na innych platformach należy używać wywołań zwrotnych.

Wydarzenia

onDeviceListChanged

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

Uruchamiane, gdy zmieniają się urządzenia audio, czyli dodawane są nowe urządzenia lub usuwane są istniejące.

Parametry

onLevelChanged

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

Uruchamiane, gdy zmienia się poziom dźwięku aktywnego urządzenia audio.

Parametry

onMuteChanged

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

Uruchamiane, gdy zmienia się stan wyciszenia wejścia lub wyjścia audio. Pamiętaj, że stan wyciszenia jest ustawieniem systemowym, a nowa wartość dotyczy każdego urządzenia audio z określonym typem strumienia.

Parametry