From b0d64ae7ae3c0d3edb38a1ed7d1e9da5102e6e89 Mon Sep 17 00:00:00 2001 From: logic-finder Date: Sun, 2 Jan 2022 20:48:09 +0900 Subject: translate the below document. AudioNode.disconnect() --- files/ko/web/api/audionode/disconnect/index.md | 80 ++++++++++++++++++++++++++ 1 file changed, 80 insertions(+) create mode 100644 files/ko/web/api/audionode/disconnect/index.md (limited to 'files/ko/web/api') diff --git a/files/ko/web/api/audionode/disconnect/index.md b/files/ko/web/api/audionode/disconnect/index.md new file mode 100644 index 0000000000..7b75c1d565 --- /dev/null +++ b/files/ko/web/api/audionode/disconnect/index.md @@ -0,0 +1,80 @@ +--- +title: AudioNode.disconnect() +slug: Web/API/AudioNode/disconnect +tags: + - API + - Audio + - AudioNode + - Disconnect + - Method + - Reference + - Web Audio API +browser-compat: api.AudioNode.disconnect +--- +{{ APIRef("Web Audio API") }} + +{{ domxref("AudioNode") }} 인터페이스의 **`disconnect()`** 메서드는 하나 이상의 노드를 메서드가 호출된 노드로부터 연결 해제할 수 있게 합니다. + +## 구문 + +```js +AudioNode.disconnect(); + +AudioNode.disconnect(output); + +AudioNode.disconnect(destination); + +AudioNode.disconnect(destination, output); + +AudioNode.disconnect(destination, output, input); +``` + +### 반환 값 + +{{jsxref("undefined")}} + +### 매개변수 + +`disconnect()` 메서드의 몇 가지 버전이 있는데, 각 버전은 매개변수의 다른 조합을 받아 어떤 노드를 어디에서 연결을 끊을지 제어합니다. 만약 매개변수가 제공되지 않았다면, 나가는 모든 연결들이 연결 해제됩니다. + +- `destination` {{optional_inline}} + - : 연결을 끊을 노드 혹은 노드들을 명시하는 {{domxref("AudioNode")}} 또는 {{domxref("AudioParam")}}. 만약 이 값이 `AudioNode` 라면, 하나의 노드가 연결 해제되고, 만약 선택적인 다른 매개변수가 있다면 (`output` 그리고/또는 `input`), 어떤 입력 그리고/또는 출력이 연결 해제되어야 하는지를 추가적으로 제한합니다. 만약 이 값이 `AudioParam` 이라면, 이 `AudioParam` 으로 향하는 연결이 제거되고, 이 계산된 파라미터로 가는 노드의 기여는 한 번 변화가 발생하고 나면 진전되며 0이 됩니다. +- `output` {{optional_inline}} + - : 현재 `AudioNode` 로부터 어떤 출력이 연결 해제될지를 기술하는 인덱스. 인덱스 숫자는 출력 채널의 수에 따라 정의됩니다 ([오디오 채널](/ko/docs/Web/API/Web_Audio_API/Basic_concepts_behind_Web_Audio_API#audio_channels)을 참고해 보세요). +- `input` {{optional_inline}} + - : 명시된 목적지 `AudioNode`로 가는 어떤 입력이 연결 해제될지를 기술하는 인덱스. 인덱스 숫자는 입력 채널의 수에 따라 정의됩니다 ([오디오 채널](/ko/docs/Web/API/Web_Audio_API/Basic_concepts_behind_Web_Audio_API#audio_channels)을 참고해 보세요). + +### 예외 + +- `IndexSizeError` {{domxref("DOMException")}} + - : 만약 `input` 혹은 `output` 으로 명시된 값이 유효하지 않다면 발생되며, 존재하지 않거나 허용되는 범위 밖에 있는 노드를 나타냅니다. +- `InvalidAccessError` {{domxref("DOMException")}} + - : `disconnect()` 가 호출된 노드가 명시된 `destination` 노드에 연결되어있지 않다면 발생됩니다. + +## 예제 + +```js +var AudioContext = window.AudioContext || window.webkitAudioContext; + +var audioCtx = new AudioContext(); + +var oscillator = audioCtx.createOscillator(); +var gainNode = audioCtx.createGain(); + +oscillator.connect(gainNode); +gainNode.connect(audioCtx.destination); + +gainNode.disconnect(); +``` + +## 명세서 + +{{Specifications}} + +## 브라우저 호환성 + +{{Compat}} + +## 같이 보기 + +- [Web Audio API 사용하기](/ko/docs/Web/API/Web_Audio_API/Using_Web_Audio_API) -- cgit v1.2.3-54-g00ecf