chroom.audio

Beschrijving

De chrome.audio API is bedoeld om gebruikers informatie te geven over en controle te geven over de audioapparaten die op het systeem zijn aangesloten. Deze API is momenteel alleen beschikbaar in de kioskmodus voor ChromeOS.

Machtigingen

audio

Beschikbaarheid

Chrome 59+ Alleen ChromeOS

Typen

AudioDeviceInfo

Eigenschappen

  • apparaatnaam

    snaar

    Apparaatnaam.

  • apparaattype

    Apparaattype

    Type apparaat.

  • Getoond

    snaar

    De gebruiksvriendelijke naam (bijv. "USB-microfoon").

  • id

    snaar

    De unieke identificatie van het audioapparaat.

  • isActief

    Booleaanse

    Waar als dit het huidige actieve apparaat is.

  • niveau

    nummer

    Het geluidsniveau van het apparaat, volume voor uitvoer, versterking voor invoer.

  • stabieleDeviceId

    string optioneel

    De stabiele/permanente apparaat-ID-tekenreeks indien beschikbaar.

  • stroomType

    Stroomtype

    Streamtype dat aan dit apparaat is gekoppeld.

DeviceFilter

Eigenschappen

  • isActief

    boolean optioneel

    Als deze optie is ingesteld, komen alleen audioapparaten waarvan de actieve status overeenkomt met deze waarde in aanmerking voor het filter.

  • streamTypes

    StreamType [] optioneel

    Als deze optie is ingesteld, voldoen alleen audioapparaten waarvan het streamtype in deze lijst is opgenomen aan het filter.

DeviceIdLists

Eigenschappen

  • invoer

    string[] optioneel

    Lijst met invoerapparaten gespecificeerd op basis van hun ID.

    Om aan te geven dat invoerapparaten niet beïnvloed moeten worden, laat u deze eigenschap uitgeschakeld.

  • uitvoer

    string[] optioneel

    Lijst met uitvoerapparaten gespecificeerd op basis van hun ID.

    Om aan te geven dat uitvoerapparaten niet beïnvloed moeten worden, laat u deze eigenschap uitgeschakeld.

DeviceProperties

Eigenschappen

  • niveau

    nummer optioneel

    Het gewenste geluidsniveau van het audioapparaat. Standaard is dit het huidige geluidsniveau van het apparaat.

    Indien gebruikt met een audio-invoerapparaat, vertegenwoordigt dit de versterking van het audioapparaat.

    Geeft het volume van het audioapparaat weer als het wordt gebruikt met een audio-uitvoerapparaat.

DeviceType

Beschikbare audioapparaattypen.

Enum

"KOPTELEFOON"

"MIC"

"USB"

"BLUETOOTH"

"HDMI"

"INTERNE_SPREKER"

"INTERN_MICROFOON"

"FRONT_MICROFOON"

"ACHTERSTE_MICROFOON"

"TOETSENBORD_MICROFOON"

"HOETWOORD"

"LINE-OUT"

"POST_MIX_LOOPBACK"

"POST_DSP_LOOPBACK"

"ALSA_LOOPBACK"

"ANDER"

LevelChangedEvent

Eigenschappen

  • apparaat-ID

    snaar

    ID van het apparaat waarvan het geluidsniveau is gewijzigd.

  • niveau

    nummer

    Het nieuwe geluidsniveau van het apparaat.

MuteChangedEvent

Eigenschappen

  • is gedempt

    Booleaanse

    Of de stream nu gedempt is.

  • stroomType

    Stroomtype

    Het type stream waarvoor de dempingswaarde is gewijzigd. De bijgewerkte dempingswaarde is van toepassing op alle apparaten met dit streamtype.

StreamType

Het type stream dat een audioapparaat levert.

Enum

"INVOER"

"UITGANG"

Methoden

getDevices()

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

Geeft een lijst met audioapparaten weer, gefilterd op basis van filter .

Parameters

  • filter

    DeviceFilter optioneel

    Apparaateigenschappen waarmee de lijst met geretourneerde audioapparaten wordt gefilterd. Als het filter niet is ingesteld of is ingesteld op {} , bevat de geretourneerde apparatenlijst alle beschikbare audioapparaten.

Retourneren

getMute()

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

Haalt de systeembrede dempingsstatus op voor het opgegeven streamtype.

Parameters

  • stroomType

    Stroomtype

    Streamtype waarvoor de dempingsstatus moet worden opgehaald.

Retourneren

  • Belofte<boolean>

    Chroom 116+

setActiveDevices()

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

Stelt lijsten in met actieve invoer- en/of uitvoerapparaten.

Parameters

  • Geeft de ID's aan van apparaten die actief moeten zijn. Als de invoer- of uitvoerlijst niet is ingesteld, worden apparaten in die categorie niet beïnvloed.

    Het is fout om een niet-bestaande apparaat-ID door te geven.

Retourneren

  • Belofte<leegte>

    Chroom 116+

setMute()

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

Stelt de dempingsstatus in voor een streamtype. De dempingsstatus is van toepassing op alle audioapparaten met het opgegeven audiostreamtype.

Parameters

  • stroomType

    Stroomtype

    Streamtype waarvoor de dempingsstatus moet worden ingesteld.

  • is gedempt

    Booleaanse

    Nieuwe dempingswaarde.

Retourneren

  • Belofte<leegte>

    Chroom 116+

setProperties()

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

Hiermee stelt u de eigenschappen voor het invoer- of uitvoerapparaat in.

Parameters

Retourneren

  • Belofte<leegte>

    Chroom 116+

Evenementen

onDeviceListChanged

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

Wordt geactiveerd wanneer audioapparaten veranderen, hetzij doordat er nieuwe apparaten worden toegevoegd, hetzij doordat bestaande apparaten worden verwijderd.

Parameters

onLevelChanged

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

Wordt geactiveerd wanneer het geluidsniveau van een actief audioapparaat verandert.

Parameters

onMuteChanged

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

Wordt geactiveerd wanneer de dempstatus van de audio-invoer of -uitvoer verandert. Houd er rekening mee dat de dempstatus systeembreed is en dat de nieuwe waarde van toepassing is op elk audioapparaat met het opgegeven streamtype.

Parameters