FLOORP-3D-AUDIO 제작자: haruu
本スクリプトは、Web Audio APIを使用してWebページ上のメディア音声に3D空間定位(HRTF)やイコライザー、コンプレッサー処理を施すバックグラウンド処理コードです。ポップアップ画面やストレージの設定変更と連動し、ノーマル、ASMR、シアター、ピンポイントといったモードに応じた音響バランスを自動調整。DOMの変化を監視して新規に読み込まれた動画や音声にも自動でエフェクトを適用し、臨場感あふれるサウンド体験を提供します。注意スペックが低いPCで裏で再生すると音がかくつく可能性があります
사용자 2명사용자 2명
확장 메타 데이터
스크린샷
정보
이 스크립트는 확장 프로그램의 '콘텐츠 스크립트(content script)'로 작동하며, 주로 다음과 같은 메커니즘과 기능으로 구성되어 있습니다.
1. 다중 실행 방지 및 초기화
다중 실행 방지(Guard):
스토리지 연동: 확장 프로그램의 스토리지(
AudioContext 및 오디오 이펙트 체인
Web Audio API를 활용하여 오디오 데이터에 대해 다음과 같은 필터와 이펙트를 순차적으로 연결(라우팅)합니다.
BiquadFilter(이퀄라이저):
저음(Bass): lowshelf 필터로 저음역대(140Hz 이하)를 조절합니다.
중음(Mid): peaking 필터(2200Hz)로 보컬의 명료도를 높입니다(부스트).
고음(Treble): highshelf 필터(6000Hz)로 시원하고 선명한 고음역대를 조절합니다.
DynamicsCompressor(컴프레서): 음이 깨지거나 갑작스럽게 커지는 것을 방지하고, 전체 음량을 균일하게 조정합니다.
Panner(3D 공간 음향): HRTF(머리 전달 함수) 모델을 사용하여, 화면상 동영상/오디오 요소의 위치나 사용자가 지정한 좌표(VR 공간 내)에 맞춰 소리가 입체적으로 들리도록 좌표를 실시간으로 계산 및 변경합니다.
GainNode(음량 조절): 모드별 음량 밸런스나 리버브(잔향) 느낌을 조절합니다.
모드별 음향 프리셋
Normal: 표준적인 입체 음향과 균형 잡힌 이퀄라이징을 제공합니다.
Pin: Pin 기능을 통해 애드온이 정상적으로 작동하는지 테스트할 수 있습니다. ASMR: 음질 깨짐(클리핑)을 방지하면서 미세한 소리가 돋보이도록 컴프레서와 필터를 최적화했습니다.
Theater: 영화관과 같은 깊이감과 공간감이 느껴지는 서라운드 효과를 구현합니다.
실시간 모니터링 및 동기화
DOM 모니터링: MutationObserver와 주기적인 타이머(setInterval)를 병용하여, 동적으로 추가된 동영상이나 오디오 요소(YouTube 및 각종 스트리밍 사이트의 플레이어 등)를 빠짐없이 감지하고 효과를 자동으로 적용합니다.
프레임 단위 좌표 업데이트: requestAnimationFrame을 활용하여, 페이지 내 요소의 위치 변화나 고정(pinning) 좌표에 맞춰 3D 음향의 리스너 및 소스 위치를 부드럽게 추적합니다.
설정 및 메시지 모니터링: 팝업 등에서 발생하는 스토리지 변경(storage.onChanged)이나 런타임 메시지(runtime.onMessage)를 실시간으로 수신하여, 페이지를 새로 고침하지 않고도 즉시 음질이나 모드 설정을 반영합니다.
4개 언어를 지원합니다: 일본어, 영어, 중국어, 한국어.
1. 다중 실행 방지 및 초기화
다중 실행 방지(Guard):
window.hasAudioEnhancerRunning 플래그를 사용하여 동일한 탭 내에서 스크립트가 중복 실행되는 것을 방지합니다.스토리지 연동: 확장 프로그램의 스토리지(
storage.local)에서 사용자 설정값(모드, 음의 깊이, 저음/고음 강도, VR 위치 등)을 비동기 방식으로 불러와 초기값을 설정합니다. AudioContext 및 오디오 이펙트 체인
Web Audio API를 활용하여 오디오 데이터에 대해 다음과 같은 필터와 이펙트를 순차적으로 연결(라우팅)합니다.
BiquadFilter(이퀄라이저):
저음(Bass): lowshelf 필터로 저음역대(140Hz 이하)를 조절합니다.
중음(Mid): peaking 필터(2200Hz)로 보컬의 명료도를 높입니다(부스트).
고음(Treble): highshelf 필터(6000Hz)로 시원하고 선명한 고음역대를 조절합니다.
DynamicsCompressor(컴프레서): 음이 깨지거나 갑작스럽게 커지는 것을 방지하고, 전체 음량을 균일하게 조정합니다.
Panner(3D 공간 음향): HRTF(머리 전달 함수) 모델을 사용하여, 화면상 동영상/오디오 요소의 위치나 사용자가 지정한 좌표(VR 공간 내)에 맞춰 소리가 입체적으로 들리도록 좌표를 실시간으로 계산 및 변경합니다.
GainNode(음량 조절): 모드별 음량 밸런스나 리버브(잔향) 느낌을 조절합니다.
모드별 음향 프리셋
applyModeSettingsToElement 함수를 통해 선택된 모드에 따라 각 매개변수가 동적으로 변경됩니다.Normal: 표준적인 입체 음향과 균형 잡힌 이퀄라이징을 제공합니다.
Pin: Pin 기능을 통해 애드온이 정상적으로 작동하는지 테스트할 수 있습니다. ASMR: 음질 깨짐(클리핑)을 방지하면서 미세한 소리가 돋보이도록 컴프레서와 필터를 최적화했습니다.
Theater: 영화관과 같은 깊이감과 공간감이 느껴지는 서라운드 효과를 구현합니다.
실시간 모니터링 및 동기화
DOM 모니터링: MutationObserver와 주기적인 타이머(setInterval)를 병용하여, 동적으로 추가된 동영상이나 오디오 요소(YouTube 및 각종 스트리밍 사이트의 플레이어 등)를 빠짐없이 감지하고 효과를 자동으로 적용합니다.
프레임 단위 좌표 업데이트: requestAnimationFrame을 활용하여, 페이지 내 요소의 위치 변화나 고정(pinning) 좌표에 맞춰 3D 음향의 리스너 및 소스 위치를 부드럽게 추적합니다.
설정 및 메시지 모니터링: 팝업 등에서 발생하는 스토리지 변경(storage.onChanged)이나 런타임 메시지(runtime.onMessage)를 실시간으로 수신하여, 페이지를 새로 고침하지 않고도 즉시 음질이나 모드 설정을 반영합니다.
4개 언어를 지원합니다: 일본어, 영어, 중국어, 한국어.
리뷰어 0명이 0점으로 평가함
권한 및 데이터
필수 권한:
- 브라우저 탭에 접근
- 모든 웹사이트에서 사용자의 데이터에 접근
선택적 권한:
- 모든 웹사이트에서 사용자의 데이터에 접근
데이터 수집:
- 개발자는 이 확장 기능이 데이터 수집을 요구하지 않는다고 밝히고 있습니다.
추가 정보
- 부가 기능 링크
- 버전
- 3.0.1
- 크기
- 437.15 KB
- 최근 업데이트
- 10일 전 (2026년 11월 9일)
- 관련 카테고리
- 라이선스
- All Rights Reserved
- 버전 목록
- 모음집에 추가
ABEMA
ほかにも対応していない可能性があります。
具体的に動画の読み込みができなくなる遅くなるなどがあります