wavsurfer.js method(메서드)

wavsurfer 인스턴스 생성 후 다음 메서드를 사용 가능

 

1. 메서드 목록

cancelAjax() - 오디오 파일로드 포르세스 취소

destroy() - 이벤트, 요소를 제거하고 웹 오디오 노드 연결 끊음

empty() - 길이가 0인 오디오가 로드된 것처럼 파형을 지움

getActivePlugins() - 현재 초기화된 플러그인 이름의 맵 반환

getBackgroundColor() - 파형 컨테이너의 배경색을 반환

getCurrentTime() - 현재 진행 상황을 초 단위로 반환

getCursorColor() - 재생 헤드 위치를 나타내는 커서의 채우기 색상 반환

getDuration() - 오디오 클립 길이 초 단위 반환

getPlaybackRate() - 오디오 클립 재생속도 반환

getProgressColor() - 커서 이전의 파형 채우기 색상 반환

getVolume() - 오디오 클립 음량 반환

getMute() - 현재 음소거 상태 반환

getFilters() - 현재 설정된 필터의 배열 반환

getWaveColor() - 커서 이후의 파형 채우기 색상을 반환

exportPCM(length, accuracy, noWindow, start) - PCM 데이터를 JSON 배열로 반환

  1) 선택적 매개 변수 : length [number] - default: 1024,

                              accuracy [number] - default: 10000,

                              noWindow [true|false] - default: false,

                              start [number] - default: 0

exportImage(format, quality, type) - 파형 이미지를 데이터 URI 또는 Blob으로 반환

isPlaying() - 재생 여부 반환 (재생시 true, 재생중이지 않을 경우 false)

load(url, peaks, preload) - url : xhr을 통해 오디오 로드

                                  peaks : peaks의 옵션 배열,

                                  preload : 선택적 매개 변수, [none|metadata|auto], Audio element 가 backend 를 사용하고 있을 경우 사용 

loadBlob(url) - Blob 또는 File 개체에서 오디오 로드

on(eventName, callback) - 이벤트 구독

un(eventName, callback) - 이벤트 구독 취소

unAll() - 모든 이벤트 구독 취소

pause() - 재생 일시중지

play([start[, end]]) - 현재 위치에서 재생 시작. 선택적 매개변수로 start가 있으며 end 까지 초 단위로 재생할 오디오 범위를 지정 가능

playPause() - 일시 정지면 재생, 재생이면 일시정지

seekAndCenter(progress) - seeks의 위치 조정 (0 = 시작, 1 = 끝)

seekTo(progress) - seeks의 위치 조정 (0 = 시작, 1 = 끝)

setBackgroundColor(color) - 파형 컨테이너의 배경색 설정

setCursorColor(color) - 재생 헤드 위치를 나타내는 커서의 채우기 색상을 설정

setHeight(height) - 파형의 높이 설정

setFilter(filters) - WebAudio 노드를 그래프에 삽입

setPlaybackRate(rate) - 재생 속도 설정 

setPlayEnd(position) - 재생이 멈출 지점을 초 단위로 설정

setVolume(newVolume) - 재생 볼륨을 새 값으로 설정 (0 = 무음, 1 = 최대)

setMute(mute) - 현재 재생되는 사운드를 음소거. (true = 음소거, false = 음소거 해제)

setProgressColor(color) - 재생 커서 이전의 파형 채우기 색상 지정

setWaveColor(color) - 재생 커서 이후의 파형 채우기 색상 지정

skip(offset) - 현재 위치에서 설정 초만큼 건너뜀 (뒤로 이동할 경우 음수값 사용)

skipBackward() - skipLength 초 만큼 되감기 

skipForward() - skipLength 초 만큼 건너뛰기

setSinkId(deviceId) - 오디오 출력 장치를 변경

stop() - 중지 후 처음으로 재생 커서를 이동

toggleMute() - 음소거 토글

toggleInteraction() - 마우스 상호작용 전환

toggleScroll() - scrollParent 의 스크롤값 토글

zoom(pxPerSec) - 파형을 수평으로 확대 및 축소. 매개 변수는 오디오의 초당 수평 픽셀 수.

 

2. 필터 연결

var lowpass = wavesurfer.backend.ac.createBiquadFilter();
wavesurfer.backend.setFilter(lowpass);

 

# 참고자료

wavesurfer-js.org/docs/methods.html