Files
web-Iot/src/components/devices/DPadControl.tsx

233 lines
7.4 KiB
TypeScript
Raw Normal View History

import React, { useCallback, useEffect, useRef, useState } from 'react';
import { useTranslation } from 'react-i18next';
import { ChevronUp, ChevronDown, ChevronLeft, ChevronRight, Circle } from 'lucide-react';
export interface GamepadState {
buttons: boolean[];
axes: number[];
connected: boolean;
ts?: number;
}
interface DPadControlProps {
onGamepadUpdate?: (state: GamepadState) => void;
onSpeedChange?: (speed: number) => void;
disabled?: boolean;
}
// 键盘按键映射
const KEY_MAP: Record<string, string> = {
ArrowUp: 'up',
ArrowDown: 'down',
ArrowLeft: 'left',
ArrowRight: 'right',
w: 'up',
s: 'down',
a: 'left',
d: 'right',
W: 'up',
S: 'down',
A: 'left',
D: 'right',
};
const DPadControl: React.FC<DPadControlProps> = ({ onGamepadUpdate, onSpeedChange, disabled = false }) => {
const { t } = useTranslation();
const [pressed, setPressed] = useState<Record<string, boolean>>({});
const [speed, setSpeed] = useState(0.5);
const pressTimer = useRef<number | null>(null);
// 用 ref 存储最新状态,避免 setInterval 闭包捕获旧值
const pressedRef = useRef<Record<string, boolean>>({});
const speedRef = useRef(0.5);
2026-10-15 15:11:24 +08:00
// 始终指向最新的 emit,保证「按住持续发送」不受旧闭包影响
const emitRef = useRef<((overrides?: Record<string, boolean>) => void) | null>(null);
// 记录当前按下的键盘按键,避免 keydown 重复触发
const activeKeysRef = useRef<Set<string>>(new Set());
2026-10-15 15:11:24 +08:00
// 用 ref 存储外部回调,避免 emit/startPress/endPress 因回调引用变化而重建,
// 进而触发 useEffect 清理把持续发送的定时器清掉
const onGamepadUpdateRef = useRef(onGamepadUpdate);
onGamepadUpdateRef.current = onGamepadUpdate;
const onSpeedChangeRef = useRef(onSpeedChange);
onSpeedChangeRef.current = onSpeedChange;
// 构建状态:只传输 xy 坐标(axes),buttons 全部为 false
const buildState = useCallback(
(overrides: Record<string, boolean> = {}): GamepadState => {
const btnMap = { ...pressedRef.current, ...overrides };
// 方向键映射到左摇杆 axes[0] X, axes[1] Y
let axisX = 0;
let axisY = 0;
const spd = speedRef.current;
2026-10-15 15:11:24 +08:00
// 向右为正、向左为负;向上为正、向下为负
if (btnMap.left) axisX -= spd;
if (btnMap.right) axisX += spd;
2026-10-15 15:11:24 +08:00
if (btnMap.up) axisY += spd;
if (btnMap.down) axisY -= spd;
return {
buttons: new Array(17).fill(false),
2026-10-15 15:11:24 +08:00
axes: [0, axisY, axisX, 0],
connected: true,
ts: Date.now(),
};
},
[],
);
const emit = useCallback(
(overrides?: Record<string, boolean>) => {
if (disabled) return;
const state = overrides ? buildState(overrides) : buildState();
2026-10-15 15:11:24 +08:00
onGamepadUpdateRef.current?.(state);
},
2026-10-15 15:11:24 +08:00
[buildState, disabled],
);
2026-10-15 15:11:24 +08:00
emitRef.current = emit;
const startPress = useCallback(
(key: string) => {
if (disabled) return;
pressedRef.current = { ...pressedRef.current, [key]: true };
setPressed(pressedRef.current);
emit({ [key]: true });
// 持续发送(模拟手柄按住)
if (pressTimer.current) window.clearInterval(pressTimer.current);
pressTimer.current = window.setInterval(() => {
2026-10-15 15:11:24 +08:00
emitRef.current?.();
}, 100);
},
[disabled, emit],
);
const endPress = useCallback(
(key: string) => {
if (disabled) return;
if (pressTimer.current) {
window.clearInterval(pressTimer.current);
pressTimer.current = null;
}
pressedRef.current = { ...pressedRef.current, [key]: false };
setPressed(pressedRef.current);
emit({ [key]: false });
},
[disabled, emit],
);
// 键盘控制:方向键 / WASD
useEffect(() => {
const handleKeyDown = (e: KeyboardEvent) => {
// 焦点在输入框时不触发
const target = e.target as HTMLElement;
if (target && (target.tagName === 'INPUT' || target.tagName === 'TEXTAREA' || target.isContentEditable)) {
return;
}
const key = KEY_MAP[e.key];
if (!key) return;
// 防止 keydown 持续触发(系统自动重复)
if (activeKeysRef.current.has(key)) return;
activeKeysRef.current.add(key);
e.preventDefault();
startPress(key);
};
const handleKeyUp = (e: KeyboardEvent) => {
const key = KEY_MAP[e.key];
if (!key) return;
activeKeysRef.current.delete(key);
e.preventDefault();
endPress(key);
};
// 窗口失焦时清空所有按键状态
const handleBlur = () => {
activeKeysRef.current.forEach((key) => endPress(key));
activeKeysRef.current.clear();
};
window.addEventListener('keydown', handleKeyDown);
window.addEventListener('keyup', handleKeyUp);
window.addEventListener('blur', handleBlur);
return () => {
window.removeEventListener('keydown', handleKeyDown);
window.removeEventListener('keyup', handleKeyUp);
window.removeEventListener('blur', handleBlur);
// 清理定时器
if (pressTimer.current) {
window.clearInterval(pressTimer.current);
pressTimer.current = null;
}
};
}, [startPress, endPress]);
const btnBase =
'flex items-center justify-center w-8 h-8 rounded-xl border transition-all duration-150 select-none active:scale-95';
const btnActive = 'border-cyan-400 bg-cyan-500/30 text-cyan-300 shadow-[0_0_16px_rgba(34,211,238,0.4)]';
const btnIdle = 'border-slate-600 bg-slate-800/60 text-slate-300 hover:border-cyan-500/60 hover:text-cyan-300';
const renderBtn = (key: string, icon: React.ReactNode, ariaLabel: string) => (
<button
aria-label={ariaLabel}
disabled={disabled}
className={`${btnBase} ${pressed[key] ? btnActive : btnIdle} ${disabled ? 'opacity-40 cursor-not-allowed' : 'cursor-pointer'}`}
onMouseDown={() => startPress(key)}
onMouseUp={() => endPress(key)}
onMouseLeave={() => pressed[key] && endPress(key)}
onTouchStart={(e) => { e.preventDefault(); startPress(key); }}
onTouchEnd={(e) => { e.preventDefault(); endPress(key); }}
>
{icon}
</button>
);
return (
<div className="flex flex-col items-center gap-1 w-full">
{/* 十字方向键 */}
<div className="grid grid-cols-3 grid-rows-3 gap-2.5">
<div />
{renderBtn('up', <ChevronUp className="w-6 h-6" />, t('devices.dpad.up'))}
<div />
{renderBtn('left', <ChevronLeft className="w-6 h-6" />, t('devices.dpad.left'))}
{renderBtn('center', <Circle className="w-5 h-5 fill-current" />, t('devices.dpad.center'))}
{renderBtn('right', <ChevronRight className="w-6 h-6" />, t('devices.dpad.right'))}
<div />
{renderBtn('down', <ChevronDown className="w-6 h-6" />, t('devices.dpad.down'))}
<div />
</div>
{/* 速度滑块 */}
<div className="w-full px-3">
<div className="flex items-center justify-between mb-2">
<span className="text-sm text-slate-400 font-medium">{t('devices.dpad.speed')}</span>
<span className="text-sm font-bold text-cyan-300">{Math.round(speed * 100)}%</span>
</div>
<input
type="range"
min={0}
max={1}
step={0.01}
value={speed}
onChange={(e) => {
const v = parseFloat(e.target.value);
setSpeed(v);
speedRef.current = v;
2026-10-15 15:11:24 +08:00
onSpeedChangeRef.current?.(v);
}}
className="w-full h-2.5 rounded-full appearance-none cursor-pointer bg-slate-700 accent-cyan-400"
style={{
background: `linear-gradient(to right, #22d3ee 0%, #22d3ee ${speed * 100}%, #334155 ${speed * 100}%, #334155 100%)`,
}}
/>
<div className="flex justify-between mt-1.5 text-[11px] text-slate-500">
<span>0%</span>
<span>50%</span>
<span>100%</span>
</div>
</div>
</div>
);
};
export default DPadControl;