audio/controller-v2
2
1
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

新增音量保护

Browse Source
This commit is contained in:
eafonyang
2026-09-22 11:55:39 +08:00
parent 053c0e3cd8
commit b555372cc8
11 changed files with 251 additions and 12 deletions
Download Patch File Download Diff File Expand all files Collapse all files
client/public/changelog.md
+6
View File
@@ -2,6 +2,12 @@
> This document records feature updates and bug fixes for the Luxsin X9 controller. Entries are listed in reverse chronological order — the newest release appears first.
## v2026.09.22
### New Features
- Added a dedicated "Headphone settings" section on the Audio page, grouping headphone gain and automatic headphone impedance detection.
- Added maximum headphone volume and headphone startup volume settings. These two settings are shown only on firmware version 2.0.11.0 (build 2011) or later.
## v2026.09.01
### Bug Fixes
client/src/config/firmwareFeatures.ts
+6
View File
@@ -13,6 +13,8 @@ export const FIRMWARE_FEATURE_MIN_VERSION = {
hearingCompensation: 2007,
/** PEQ preset rename (peqRename) and reorder (peqSoft) in manage dialog. */
peqPresetRenameAndSort: 2008,
/** Audio 页面耳机最大音量和耳机启动音量设置。 */
hpVolumeSettings: 2011,
} as const;
export type FirmwareFeatureKey = keyof typeof FIRMWARE_FEATURE_MIN_VERSION;
@@ -32,3 +34,7 @@ export function getBootSoundMaxIndex(firmwareVersion: number): number {
export function supportsPeqPresetRenameAndSort(firmwareVersion: number): boolean {
return isFirmwareFeatureAvailable("peqPresetRenameAndSort", firmwareVersion);
}
export function supportsHpVolumeSettings(firmwareVersion: number): boolean {
return isFirmwareFeatureAvailable("hpVolumeSettings", firmwareVersion);
}
client/src/lib/luxsinApi.ts
+6
View File
@@ -95,6 +95,10 @@ export interface DeviceState {
dacGain: number;
dacArc: number;
dacImpedance: number;
/** 耳机最大音量：0 = 0dB，1 = -5dB … 10 = -50dB；旧固件可能不返回。 */
hpMaxVolume?: number;
/** 耳机启动音量：0 = 默认，1 = -20dB … 7 = -50dB；旧固件可能不返回。 */
hpStartupVolume?: number;
dacVolumeDirect: number;
analogGain: number;
effect_enable: number;
@@ -590,6 +594,8 @@ export const MOCK_DEVICE_STATE: DeviceState = {
dacGain: 0,
dacArc: 0,
dacImpedance: 0,
hpMaxVolume: 0,
hpStartupVolume: 0,
dacVolumeDirect: 0,
analogGain: 0,
effect_enable: 0,
client/src/locales/data-de.json
+30
View File
@@ -389,6 +389,7 @@
"dac": {
"sectionBalanceSensitivity": "Balance & Empfindlichkeit",
"sectionOutput": "Ausgangsmerkmale",
"sectionHpSettings": "Kopfhörer-Einstellungen",
"sectionIisSettings": "IIS-Einstellungen",
"sectionSystemInterface": "System & Schnittstelle",
"balance": "Links-Rechts-Balance",
@@ -435,6 +436,35 @@
]
},
"volumeStep": "Lautstärkestufe",
"hpMaxVolume": {
"label": "Max. Kopfhörerlautstärke",
"options": [
{ "index": 0, "label": "0dB" },
{ "index": 1, "label": "-5dB" },
{ "index": 2, "label": "-10dB" },
{ "index": 3, "label": "-15dB" },
{ "index": 4, "label": "-20dB" },
{ "index": 5, "label": "-25dB" },
{ "index": 6, "label": "-30dB" },
{ "index": 7, "label": "-35dB" },
{ "index": 8, "label": "-40dB" },
{ "index": 9, "label": "-45dB" },
{ "index": 10, "label": "-50dB" }
]
},
"hpStartupVolume": {
"label": "Kopfhörer-Startlautstärke",
"options": [
{ "index": 0, "label": "Standard" },
{ "index": 1, "label": "-20dB" },
{ "index": 2, "label": "-25dB" },
{ "index": 3, "label": "-30dB" },
{ "index": 4, "label": "-35dB" },
{ "index": 5, "label": "-40dB" },
{ "index": 6, "label": "-45dB" },
{ "index": 7, "label": "-50dB" }
]
},
"bootVolume": {
"label": "Startlautstärke",
"options": [
client/src/locales/data-en.json
+30
View File
@@ -389,6 +389,7 @@
"dac": {
"sectionBalanceSensitivity": "Balance & sensitivity",
"sectionOutput": "Output characteristics",
"sectionHpSettings": "Headphone settings",
"sectionIisSettings": "IIS settings",
"sectionSystemInterface": "System & interface",
"balance": "Left-right balance",
@@ -435,6 +436,35 @@
]
},
"volumeStep": "Volume step",
"hpMaxVolume": {
"label": "Max headphone volume",
"options": [
{ "index": 0, "label": "0dB" },
{ "index": 1, "label": "-5dB" },
{ "index": 2, "label": "-10dB" },
{ "index": 3, "label": "-15dB" },
{ "index": 4, "label": "-20dB" },
{ "index": 5, "label": "-25dB" },
{ "index": 6, "label": "-30dB" },
{ "index": 7, "label": "-35dB" },
{ "index": 8, "label": "-40dB" },
{ "index": 9, "label": "-45dB" },
{ "index": 10, "label": "-50dB" }
]
},
"hpStartupVolume": {
"label": "Headphone startup volume",
"options": [
{ "index": 0, "label": "Default" },
{ "index": 1, "label": "-20dB" },
{ "index": 2, "label": "-25dB" },
{ "index": 3, "label": "-30dB" },
{ "index": 4, "label": "-35dB" },
{ "index": 5, "label": "-40dB" },
{ "index": 6, "label": "-45dB" },
{ "index": 7, "label": "-50dB" }
]
},
"bootVolume": {
"label": "Boot volume",
"options": [
client/src/locales/data-es.json
+30
View File
@@ -389,6 +389,7 @@
"dac": {
"sectionBalanceSensitivity": "Balance y sensibilidad",
"sectionOutput": "Características de salida",
"sectionHpSettings": "Ajustes de auriculares",
"sectionIisSettings": "Configuración IIS",
"sectionSystemInterface": "Sistema e interfaz",
"balance": "Balance izquierda-derecha",
@@ -435,6 +436,35 @@
]
},
"volumeStep": "Paso de volumen",
"hpMaxVolume": {
"label": "Volumen máx. de auriculares",
"options": [
{ "index": 0, "label": "0dB" },
{ "index": 1, "label": "-5dB" },
{ "index": 2, "label": "-10dB" },
{ "index": 3, "label": "-15dB" },
{ "index": 4, "label": "-20dB" },
{ "index": 5, "label": "-25dB" },
{ "index": 6, "label": "-30dB" },
{ "index": 7, "label": "-35dB" },
{ "index": 8, "label": "-40dB" },
{ "index": 9, "label": "-45dB" },
{ "index": 10, "label": "-50dB" }
]
},
"hpStartupVolume": {
"label": "Volumen de inicio de auriculares",
"options": [
{ "index": 0, "label": "Predeterminado" },
{ "index": 1, "label": "-20dB" },
{ "index": 2, "label": "-25dB" },
{ "index": 3, "label": "-30dB" },
{ "index": 4, "label": "-35dB" },
{ "index": 5, "label": "-40dB" },
{ "index": 6, "label": "-45dB" },
{ "index": 7, "label": "-50dB" }
]
},
"bootVolume": {
"label": "Volumen de inicio",
"options": [
client/src/locales/data-fr.json
+30
View File
@@ -389,6 +389,7 @@
"dac": {
"sectionBalanceSensitivity": "Balance et sensibilité",
"sectionOutput": "Caractéristiques de sortie",
"sectionHpSettings": "Réglages du casque",
"sectionIisSettings": "Paramètres IIS",
"sectionSystemInterface": "Système et interface",
"balance": "Balance gauche-droite",
@@ -435,6 +436,35 @@
]
},
"volumeStep": "Pas de volume",
"hpMaxVolume": {
"label": "Volume max. du casque",
"options": [
{ "index": 0, "label": "0dB" },
{ "index": 1, "label": "-5dB" },
{ "index": 2, "label": "-10dB" },
{ "index": 3, "label": "-15dB" },
{ "index": 4, "label": "-20dB" },
{ "index": 5, "label": "-25dB" },
{ "index": 6, "label": "-30dB" },
{ "index": 7, "label": "-35dB" },
{ "index": 8, "label": "-40dB" },
{ "index": 9, "label": "-45dB" },
{ "index": 10, "label": "-50dB" }
]
},
"hpStartupVolume": {
"label": "Volume de démarrage du casque",
"options": [
{ "index": 0, "label": "Par défaut" },
{ "index": 1, "label": "-20dB" },
{ "index": 2, "label": "-25dB" },
{ "index": 3, "label": "-30dB" },
{ "index": 4, "label": "-35dB" },
{ "index": 5, "label": "-40dB" },
{ "index": 6, "label": "-45dB" },
{ "index": 7, "label": "-50dB" }
]
},
"bootVolume": {
"label": "Volume de démarrage",
"options": [
client/src/locales/data-zh-HK.json
+30
View File
@@ -383,6 +383,7 @@
"dac": {
"sectionBalanceSensitivity": "平衡與靈敏度",
"sectionOutput": "輸出特性",
"sectionHpSettings": "耳機設定",
"sectionIisSettings": "IIS設定",
"sectionSystemInterface": "系統與介面",
"balance": "左右平衡",
@@ -429,6 +430,35 @@
]
},
"volumeStep": "音量級距",
"hpMaxVolume": {
"label": "耳機最大音量",
"options": [
{ "index": 0, "label": "0dB" },
{ "index": 1, "label": "-5dB" },
{ "index": 2, "label": "-10dB" },
{ "index": 3, "label": "-15dB" },
{ "index": 4, "label": "-20dB" },
{ "index": 5, "label": "-25dB" },
{ "index": 6, "label": "-30dB" },
{ "index": 7, "label": "-35dB" },
{ "index": 8, "label": "-40dB" },
{ "index": 9, "label": "-45dB" },
{ "index": 10, "label": "-50dB" }
]
},
"hpStartupVolume": {
"label": "耳機啟動音量",
"options": [
{ "index": 0, "label": "預設" },
{ "index": 1, "label": "-20dB" },
{ "index": 2, "label": "-25dB" },
{ "index": 3, "label": "-30dB" },
{ "index": 4, "label": "-35dB" },
{ "index": 5, "label": "-40dB" },
{ "index": 6, "label": "-45dB" },
{ "index": 7, "label": "-50dB" }
]
},
"bootVolume": {
"label": "開機音量",
"options": [
client/src/locales/data-zh.json
+30
View File
@@ -383,6 +383,7 @@
"dac": {
"sectionBalanceSensitivity": "平衡与灵敏度",
"sectionOutput": "输出特性",
"sectionHpSettings": "耳机设定",
"sectionIisSettings": "IIS设置",
"sectionSystemInterface": "系统与接口",
"balance": "左右平衡",
@@ -429,6 +430,35 @@
]
},
"volumeStep": "音量幅度",
"hpMaxVolume": {
"label": "耳机最大音量",
"options": [
{ "index": 0, "label": "0dB" },
{ "index": 1, "label": "-5dB" },
{ "index": 2, "label": "-10dB" },
{ "index": 3, "label": "-15dB" },
{ "index": 4, "label": "-20dB" },
{ "index": 5, "label": "-25dB" },
{ "index": 6, "label": "-30dB" },
{ "index": 7, "label": "-35dB" },
{ "index": 8, "label": "-40dB" },
{ "index": 9, "label": "-45dB" },
{ "index": 10, "label": "-50dB" }
]
},
"hpStartupVolume": {
"label": "耳机启动音量",
"options": [
{ "index": 0, "label": "默认" },
{ "index": 1, "label": "-20dB" },
{ "index": 2, "label": "-25dB" },
{ "index": 3, "label": "-30dB" },
{ "index": 4, "label": "-35dB" },
{ "index": 5, "label": "-40dB" },
{ "index": 6, "label": "-45dB" },
{ "index": 7, "label": "-50dB" }
]
},
"bootVolume": {
"label": "开机音量",
"options": [
client/src/pages/AudioPage.tsx
+49 -12
View File
@@ -3,7 +3,8 @@
Design: Reference luxsin_x8_音频设置.png
Sections:
- 平衡与灵敏度: 左右平衡, VU灵敏度, 模拟输入增益 sliders
- 输出特性: 滤波特性, 耳机增益, 音量幅度
- 输出特性: 滤波特性, 前级输出音量直通模式, ARC模式, 音量幅度
- 耳机设定: 耳机增益, 自动检测耳机阻抗, 耳机最大音量, 耳机启动音量(后两项 version >= 2011 才显示)
- 系统与接口: 开机音量, XLR极性
All list rows → navigate to /select page
============================================================ */
@@ -13,6 +14,7 @@ import { useLocation } from "wouter";
import { useState, useEffect, useRef } from "react";
import BottomNav from "@/components/BottomNav";
import { navigateToSelect } from "./SelectPage";
import { supportsHpVolumeSettings } from "@/config/firmwareFeatures";
import {
getBootSoundMaxIndex,
normalizeBootSound,
@@ -107,6 +109,7 @@ type LocaleDac = {
dac?: {
sectionBalanceSensitivity?: string;
sectionOutput?: string;
sectionHpSettings?: string;
sectionSystemInterface?: string;
balance?: string;
sensitivity?: string;
@@ -114,6 +117,8 @@ type LocaleDac = {
autoImpedanceDetection?: string;
filters?: { label?: string; options?: Array<{ index: number; label: string }> };
dacGain?: { label?: string; options?: Array<{ index: number; label: string }> };
hpMaxVolume?: { label?: string; options?: Array<{ index: number; label: string }> };
hpStartupVolume?: { label?: string; options?: Array<{ index: number; label: string }> };
dacVolumeDirect?: { label?: string; options?: Array<{ index: number; label: string }> };
dacArc?: { label?: string; options?: Array<{ index: number; label: string }> };
volumeStep?: string;
@@ -217,6 +222,8 @@ export default function AudioPage() {
const gainIdx = ds?.dacGain ?? 0;
const autoImpedanceOn = (ds?.dacImpedance ?? 0) === 1;
const hpMaxVolumeIdx = Math.min(Math.max(ds?.hpMaxVolume ?? 0, 0), 10);
const hpStartupVolumeIdx = Math.min(Math.max(ds?.hpStartupVolume ?? 0, 0), 7);
const dacVolumeDirectIdx = ds?.dacVolumeDirect ?? 0;
const dacArcIdx = ds?.dacArc ?? 0;
const stepIdx = ds?.soundStep ?? 1;
@@ -224,6 +231,7 @@ export default function AudioPage() {
const xlrIdx = ds?.xlr ?? 0;
const bootSoundVal = normalizeBootSound(localBootSound);
const firmwareVersion = parseFirmwareVersion(ds?.version);
const showHpVolumeSettings = supportsHpVolumeSettings(firmwareVersion);
const bootSoundMaxIdx = getBootSoundMaxIndex(firmwareVersion);
const bootSoundSelectIdx = Math.min(bootSoundVal, bootSoundMaxIdx);
const BOOT_VOLUME_OPTIONS = bootVolumeOptions(dacText, bootSoundMaxIdx);
@@ -233,6 +241,12 @@ export default function AudioPage() {
const DAC_VOLUME_DIRECT_OPTIONS = optionLabels(dacText.dacVolumeDirect?.options, ["关闭", "0dB", "-12dB"]);
const DAC_ARC_OPTIONS = optionLabels(dacText.dacArc?.options, ["ARC", "EARC"]);
const XLR_OPTIONS = optionLabels(dacText.xlr?.options, ["正常", "反转"]);
const HP_MAX_VOLUME_OPTIONS = optionLabels(dacText.hpMaxVolume?.options, [
"0dB", "-5dB", "-10dB", "-15dB", "-20dB", "-25dB", "-30dB", "-35dB", "-40dB", "-45dB", "-50dB",
]);
const HP_STARTUP_VOLUME_OPTIONS = optionLabels(dacText.hpStartupVolume?.options, [
"默认", "-20dB", "-25dB", "-30dB", "-35dB", "-40dB", "-45dB", "-50dB",
]);
const pageTitle = usePageTitleWithConnection(localeData.home?.audioSet ?? "Audio");
@@ -338,17 +352,6 @@ export default function AudioPage() {
value={FILTER_OPTIONS[filterIdx] ?? FILTER_OPTIONS[0] ?? "—"}
onClick={() => goSelect(dacText.filters?.label ?? "选择滤波特性", FILTER_OPTIONS, filterIdx, "filterCharacteristic")}
/>
<ListRow
label={dacText.dacGain?.label ?? "耳机增益"}
value={GAIN_OPTIONS[gainIdx] ?? GAIN_OPTIONS[0] ?? "—"}
onClick={() => goSelect(dacText.dacGain?.label ?? "选择耳机增益", GAIN_OPTIONS, gainIdx, "dacGain")}
/>
<ListRow
label={dacText.autoImpedanceDetection ?? "自动检测耳机阻抗"}
toggle
checked={autoImpedanceOn}
onToggle={(v) => updateSetting({ dacImpedance: v ? 1 : 0 })}
/>
<ListRow
label={dacText.dacVolumeDirect?.label ?? "前级输出音量直通模式"}
value={DAC_VOLUME_DIRECT_OPTIONS[dacVolumeDirectIdx] ?? DAC_VOLUME_DIRECT_OPTIONS[0] ?? "—"}
@@ -380,6 +383,40 @@ export default function AudioPage() {
/>
</div>
{/* ── 耳机设定 ── */}
<SectionHeader title={dacText.sectionHpSettings ?? "耳机设定"} />
<div className="ios-list-group">
<ListRow
label={dacText.dacGain?.label ?? "耳机增益"}
value={GAIN_OPTIONS[gainIdx] ?? GAIN_OPTIONS[0] ?? "—"}
onClick={() => goSelect(dacText.dacGain?.label ?? "选择耳机增益", GAIN_OPTIONS, gainIdx, "dacGain")}
/>
<ListRow
label={dacText.autoImpedanceDetection ?? "自动检测耳机阻抗"}
toggle
checked={autoImpedanceOn}
onToggle={(v) => updateSetting({ dacImpedance: v ? 1 : 0 })}
/>
{showHpVolumeSettings && (
<>
<ListRow
label={dacText.hpMaxVolume?.label ?? "耳机最大音量"}
value={HP_MAX_VOLUME_OPTIONS[hpMaxVolumeIdx] ?? HP_MAX_VOLUME_OPTIONS[0] ?? "—"}
onClick={() =>
goSelect(dacText.hpMaxVolume?.label ?? "耳机最大音量", HP_MAX_VOLUME_OPTIONS, hpMaxVolumeIdx, "hpMaxVolume")
}
/>
<ListRow
label={dacText.hpStartupVolume?.label ?? "耳机启动音量"}
value={HP_STARTUP_VOLUME_OPTIONS[hpStartupVolumeIdx] ?? HP_STARTUP_VOLUME_OPTIONS[0] ?? "—"}
onClick={() =>
goSelect(dacText.hpStartupVolume?.label ?? "耳机启动音量", HP_STARTUP_VOLUME_OPTIONS, hpStartupVolumeIdx, "hpStartupVolume")
}
/>
</>
)}
</div>
{/* ── 系统与接口 ── */}
<SectionHeader title={dacText.sectionSystemInterface ?? "系统与接口"} />
<div className="ios-list-group">
client/src/pages/SelectPage.tsx
+4
View File
@@ -123,6 +123,10 @@ const KEY_TO_SETTING: Record<string, string> = {
dacImpedance: "dacImpedance",
hpMaxVolume: "hpMaxVolume",
hpStartupVolume: "hpStartupVolume",
dacVolumeDirect: "dacVolumeDirect",
dacArc: "dacArc",