chrome.audio

설명

chrome.audio API는 사용자가 시스템에 연결된 오디오 기기에 관한 정보를 얻고 이를 제어할 수 있도록 제공됩니다. 이 API는 현재 ChromeOS용 키오스크 모드에서만 사용할 수 있습니다.

권한

audio

가용성

Chrome 59 이상 에서 확인하세요. ChromeOS만 해당

유형

AudioDeviceInfo

속성

  • deviceName

    문자열

    기기 이름.

  • deviceType

    DeviceType

    기기 유형입니다.

  • displayName

    문자열

    사용자 친화적인 이름 (예: 'USB 마이크')입니다.

  • id

    문자열

    오디오 기기의 고유 식별자입니다.

  • isActive

    부울

    현재 활성 기기인 경우 true입니다.

  • 레벨

    숫자

    기기의 사운드 레벨, 출력용 볼륨, 입력 게인입니다.

  • stableDeviceId

    문자열(선택사항)

    안정적인/지속된 기기 ID 문자열입니다(해당하는 경우).

  • streamType

    StreamType

    이 기기와 연결된 스트림 유형입니다.

DeviceFilter

속성

  • isActive

    불리언 선택사항

    설정하면 활성 상태가 이 값과 일치하는 오디오 기기만 필터를 충족합니다.

  • streamTypes

    StreamType[] 선택사항

    설정된 경우 스트림 유형이 이 목록에 포함된 오디오 기기만 필터를 충족합니다.

DeviceIdLists

속성

  • 입력

    string[] 선택사항

    ID로 지정된 입력 기기 목록입니다.

    입력 기기가 영향을 받지 않아야 함을 나타내려면 이 속성을 설정하지 않은 상태로 두세요.

  • output

    string[] 선택사항

    ID로 지정된 출력 장치의 목록입니다.

    출력 장치가 영향을 받지 않아야 함을 나타내려면 이 속성을 설정하지 않은 상태로 두세요.

DeviceProperties

속성

  • 레벨

    숫자 선택사항

    오디오 기기의 원하는 사운드 수준입니다. 기본값은 기기의 현재 사운드 수준입니다.

    오디오 입력 기기와 함께 사용하는 경우 오디오 기기 게인을 나타냅니다.

    오디오 출력 장치와 함께 사용되는 경우 오디오 기기 볼륨을 나타냅니다.

DeviceType

사용 가능한 오디오 기기 유형입니다.

열거형

'헤드폰'

'MIC'

'USB'

'BLUETOOTH'

'HDMI'

'INTERNAL_SPEAKER'

'INTERNAL_MIC'

'FRONT_MIC'

'REAR_MIC'

'KEYBOARD_MIC'

"HOTWORD"

'라인아웃'

'POST_MIX_LOOPBACK'

'POST_DSP_LOOPBACK'

'ALSA_LOOPBACK'

'OTHER'

LevelChangedEvent

속성

  • deviceId

    문자열

    사운드 수준이 변경된 기기의 ID입니다.

  • 레벨

    숫자

    기기의 새로운 음량입니다.

MuteChangedEvent

속성

  • isMuted

    부울

    현재 스트림이 음소거되었는지 여부입니다.

  • streamType

    StreamType

    음소거 값이 변경된 스트림의 유형입니다. 업데이트된 음소거 값은 이 스트림 유형의 모든 기기에 적용됩니다.

StreamType

오디오 기기에서 제공하는 스트림 유형입니다.

열거형

'입력'

'출력'

메서드

getDevices()

<ph type="x-smartling-placeholder"></ph> 프로미스 를 통해 개인정보처리방침을 정의할 수 있습니다.
chrome.audio.getDevices(
  filter?: DeviceFilter,
  callback?: function,
)

filter에 기반하여 필터링된 오디오 기기 목록을 가져옵니다.

매개변수

  • filter

    DeviceFilter 선택사항

    반환된 오디오 기기 목록을 필터링할 기기 속성입니다. 필터를 설정하지 않거나 {}로 설정하면 반환된 기기 목록에 사용 가능한 모든 오디오 기기가 포함됩니다.

  • 콜백

    함수 선택사항

    callback 매개변수는 다음과 같습니다. 

    (devices: AudioDeviceInfo[]) => void

반환 값

  • Promise&lt;AudioDeviceInfo[]&gt;

    Chrome 116 이상 를 통해 개인정보처리방침을 정의할 수 있습니다.

    프로미스는 Manifest V3 이상에서만 지원되며 다른 플랫폼에서는 콜백을 사용해야 합니다.

getMute()

<ph type="x-smartling-placeholder"></ph> 프로미스 를 통해 개인정보처리방침을 정의할 수 있습니다.
chrome.audio.getMute(
  streamType: StreamType,
  callback?: function,
)

지정된 스트림 유형의 시스템 전체 음소거 상태를 가져옵니다.

매개변수

  • streamType

    StreamType

    음소거 상태를 가져와야 하는 스트림 유형입니다.

  • 콜백

    함수 선택사항

    callback 매개변수는 다음과 같습니다. 

    (value: boolean) => void

    • 값

      부울

반환 값

  • Promise&lt;boolean&gt;

    Chrome 116 이상 를 통해 개인정보처리방침을 정의할 수 있습니다.

    프로미스는 Manifest V3 이상에서만 지원되며 다른 플랫폼에서는 콜백을 사용해야 합니다.

setActiveDevices()

<ph type="x-smartling-placeholder"></ph> 프로미스 를 통해 개인정보처리방침을 정의할 수 있습니다.
chrome.audio.setActiveDevices(
  ids: DeviceIdLists,
  callback?: function,
)

활성 입력 및/또는 출력 장치의 목록을 설정합니다.

매개변수

  • 활성화되어야 하는 기기의 ID를 지정합니다. 입력 또는 출력 목록이 설정되지 않은 경우 해당 카테고리에 있는 기기는 영향을 받지 않습니다.

    존재하지 않는 기기 ID를 전달하면 오류가 발생합니다.

  • 콜백

    함수 선택사항

    callback 매개변수는 다음과 같습니다. 

    () => void

반환 값

  • 프로미스<void>

    Chrome 116 이상 를 통해 개인정보처리방침을 정의할 수 있습니다.

    프로미스는 Manifest V3 이상에서만 지원되며 다른 플랫폼에서는 콜백을 사용해야 합니다.

setMute()

<ph type="x-smartling-placeholder"></ph> 프로미스 를 통해 개인정보처리방침을 정의할 수 있습니다.
chrome.audio.setMute(
  streamType: StreamType,
  isMuted: boolean,
  callback?: function,
)

스트림 유형의 음소거 상태를 설정합니다. 음소거 상태는 지정된 오디오 스트림 유형의 모든 오디오 기기에 적용됩니다.

매개변수

  • streamType

    StreamType

    음소거 상태를 설정해야 하는 스트림 유형입니다.

  • isMuted

    부울

    새 숨기기 값입니다.

  • 콜백

    함수 선택사항

    callback 매개변수는 다음과 같습니다. 

    () => void

반환 값

  • 프로미스<void>

    Chrome 116 이상 를 통해 개인정보처리방침을 정의할 수 있습니다.

    프로미스는 Manifest V3 이상에서만 지원되며 다른 플랫폼에서는 콜백을 사용해야 합니다.

setProperties()

<ph type="x-smartling-placeholder"></ph> 프로미스 를 통해 개인정보처리방침을 정의할 수 있습니다.
chrome.audio.setProperties(
  id: string,
  properties: DeviceProperties,
  callback?: function,
)

입력 또는 출력 장치의 속성을 설정합니다.

매개변수

  • id

    문자열

  • 콜백

    함수 선택사항

    callback 매개변수는 다음과 같습니다. 

    () => void

반환 값

  • 프로미스<void>

    Chrome 116 이상 를 통해 개인정보처리방침을 정의할 수 있습니다.

    프로미스는 Manifest V3 이상에서만 지원되며 다른 플랫폼에서는 콜백을 사용해야 합니다.

이벤트

onDeviceListChanged

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

오디오 기기가 변경되거나 새 기기가 추가되거나 기존 기기가 삭제될 때 실행됩니다.

매개변수

onLevelChanged

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

활성 오디오 기기의 사운드 수준이 변경되면 실행됩니다.

매개변수

onMuteChanged

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

오디오 입력 또는 출력의 음소거 상태가 변경되면 실행됩니다. 음소거 상태는 시스템 전체에 적용되며 새 값은 지정된 스트림 유형의 모든 오디오 기기에 적용됩니다.

매개변수