如何在Cocoa Swift中为playerCharacter类添加WASD移动功能

要实现俯视视角的WASD移动，核心要解决NSView接收键盘事件和位置更新后重绘两个问题，以下是修改后的完整代码及关键说明：

import Cocoa

public class PlayerCharacter: NSView {
    var x: Int
    var y: Int
    let color: NSColor
    // 移动步长，可根据需求调整
    private let moveStep: Int = 10

    init(x: Int, y: Int) {
        self.x = x
        self.y = y
        self.color = NSColor.darkGray

        let frame = NSRect(x: x, y: y, width: 50, height: 50)
        super.init(frame: frame)
        // 初始化时请求成为第一响应者
        self.becomeFirstResponder()
    }

    required init?(coder aDecoder: NSCoder) {
        fatalError("init(coder:) has not been implemented")
    }

    // 允许视图成为第一响应者，才能接收键盘事件
    public override var acceptsFirstResponder: Bool {
        return true
    }

    public override func keyDown(with event: NSEvent) {
        super.keyDown(with: event)
        guard let keyChar = event.charactersIgnoringModifiers?.lowercased().first else { return }

        switch keyChar {
        case "w":
            y += moveStep
        case "s":
            y -= moveStep
        case "a":
            x -= moveStep
        case "d":
            x += moveStep
        default:
            break
        }

        // 更新视图的frame位置
        self.frame = NSRect(x: x, y: y, width: self.frame.width, height: self.frame.height)
        // 标记视图需要重绘
        self.setNeedsDisplay()
    }

    public override func draw(_ dirtyRect: NSRect) {
        super.draw(dirtyRect)
        color.setFill()
        dirtyRect.fill()
    }
}

关键要点说明 #

• 第一响应者设置：重写acceptsFirstResponder返回true，并在初始化时调用becomeFirstResponder()，确保视图能捕获键盘事件。如果视图是窗口的子视图，需保证窗口没有其他抢占焦点的控件，确保事件能传递到该视图。
• 键盘事件处理：在keyDown(with:)中通过event.charactersIgnoringModifiers获取按键字符，统一转小写后匹配WASD，计算新坐标后更新视图的frame。
• 重绘触发：修改位置后必须调用setNeedsDisplay()，让系统触发draw(_:)方法刷新视图显示。
• 坐标系注意：Cocoa的坐标系原点在左下角，所以W键对应y轴增加（向上移动），S键对应y轴减少（向下移动），符合俯视视角的操作直觉。

如果是在非Xcode环境（比如命令行工具+AppKit）运行，需确保窗口已正确初始化，且PlayerCharacter实例已添加到窗口内容视图中，同时窗口处于激活状态才能接收键盘事件。

内容的提问来源于stack exchange，提问作者Salty4141