Skip to content

Run a virtual iPhone on an Apple Silicon Mac.

Swift
8.6 KB
Raw Blame
import AppKit
import Dynamic
import Foundation
import Virtualization
import VPhoneCoreKit

// MARK: - Key Helper

@MainActor
class VPhoneVirtualMachineKeySender {
    private let vm: VZVirtualMachine
    private let control: VPhoneGuestControl
    weak var window: NSWindow?

    /// First _VZKeyboard from the VM's internal keyboard array (used by typeString).
    private var firstKeyboard: AnyObject? {
        guard let arr = Dynamic(vm)._keyboards.asObject as? NSArray, arr.count > 0 else { return nil }
        return arr.object(at: 0) as AnyObject
    }

    init(vm: VPhoneVirtualMachine, control: VPhoneGuestControl) {
        self.vm = vm.virtualMachine
        self.control = control
    }

    // MARK: - Connection Guard

    private func requireConnection() -> Bool {
        if control.isConnected {
            return true
        }

        VPhoneAlert.present(
            title: "Guest Not Connected",
            message: "The guest agent is not connected. Wait for it to connect, then try again.",
            style: .warning,
        )
        return false
    }

    // MARK: - Hardware Keys (Consumer Page 0x0C)

    /// The TV's Back/Menu key through the same native keyboard as arrows and
    /// Return. This works without the guest daemon, including during setup.
    func sendTVBack() {
        guard let keyboard = firstKeyboard else { return }
        for type in [0, 1] {
            if let event = Dynamic._VZKeyEvent(type: type, keyCode: UInt16(0x35)).asAnyObject {
                Dynamic(keyboard).sendKeyEvents([event] as NSArray)
            }
        }
    }

    func sendHome() {
        guard requireConnection() else { return }
        control.sendHIDPress(page: 0x0C, usage: 0x40)
    }

    /// tvOS reads consumer Menu (0x0C/0x40) as the TV button and opens
    /// Control Center when it is held. A USB keyboard has no such key, so
    /// this goes through vphoned like Home.
    func sendTVControlCenter() {
        guard requireConnection() else { return }
        control.sendHIDDown(page: 0x0C, usage: 0x40)
        Task { [control] in
            try? await Task.sleep(for: .milliseconds(1200))
            control.sendHIDUp(page: 0x0C, usage: 0x40)
        }
    }

    /// An Apple Watch's side button is consumer Help (0x0C/0x95), the device
    /// tree's `/buttons` "help" beside the crown's "menu". Carousel reads it
    /// as the side button (Control Center, Wallet, SOS); consumer Power
    /// (0x30) only sleeps or wakes the display there.
    func sendWatchSideButton() {
        guard requireConnection() else { return }
        control.sendHIDPress(page: 0x0C, usage: 0x95)
    }

    func sendPower() {
        guard requireConnection() else { return }
        control.sendHIDPress(page: 0x0C, usage: 0x30)
    }

    func sendVolumeUp() {
        guard requireConnection() else { return }
        control.sendHIDPress(page: 0x0C, usage: 0xE9)
    }

    func sendVolumeDown() {
        guard requireConnection() else { return }
        control.sendHIDPress(page: 0x0C, usage: 0xEA)
    }

    // MARK: - Combos

    func sendSpotlight() {
        guard requireConnection() else { return }
        // Cmd+Space: messages are processed sequentially by vphoned
        control.sendHIDDown(page: 0x07, usage: 0xE3) // Cmd down
        control.sendHIDPress(page: 0x07, usage: 0x2C) // Space press
        control.sendHIDUp(page: 0x07, usage: 0xE3) // Cmd up
    }

    /// A 🌐 tap: the guest switches to its next input source. The Mac's fn key
    /// does the same while the VM window is key; see `VPhoneApplication`.
    func sendGlobe() {
        guard requireConnection() else { return }
        let globe = VPhoneGuestKeyMap.globe
        control.sendHIDPress(page: globe.page, usage: globe.usage)
    }

    // MARK: - Type ASCII from Clipboard

    func typeFromClipboard() {
        guard let string = NSPasteboard.general.string(forType: .string) else {
            print("[keys] Clipboard has no string")
            return
        }
        print("[keys] Typing \(string.count) characters from clipboard")
        typeString(string)
    }

    func typeString(_ string: String) {
        guard let keyboard = firstKeyboard else {
            print("[keys] No keyboard found")
            return
        }

        var delay: TimeInterval = 0
        let interval: TimeInterval = 0.02

        for char in string {
            guard let (keyCode, needsShift) = asciiToVK(char) else {
                print("[keys] Skipping unsupported char: '\(char)'")
                continue
            }

            DispatchQueue.main.asyncAfter(deadline: .now() + delay) {
                var events: [AnyObject] = []
                if needsShift {
                    if let obj = Dynamic._VZKeyEvent(type: 0, keyCode: UInt16(0x38)).asAnyObject {
                        events.append(obj)
                    }
                }
                if let obj = Dynamic._VZKeyEvent(type: 0, keyCode: keyCode).asAnyObject {
                    events.append(obj)
                }
                if let obj = Dynamic._VZKeyEvent(type: 1, keyCode: keyCode).asAnyObject {
                    events.append(obj)
                }
                if needsShift {
                    if let obj = Dynamic._VZKeyEvent(type: 1, keyCode: UInt16(0x38)).asAnyObject {
                        events.append(obj)
                    }
                }
                Dynamic(keyboard).sendKeyEvents(events as NSArray)
            }

            delay += interval
        }
    }

    // MARK: - ASCII -> Apple VK Code (US Layout)

    private func asciiToVK(_ char: Character) -> (UInt16, Bool)? {
        switch char {
        case "a": (0x00, false)
        case "b": (0x0B, false)
        case "c": (0x08, false)
        case "d": (0x02, false)
        case "e": (0x0E, false)
        case "f": (0x03, false)
        case "g": (0x05, false)
        case "h": (0x04, false)
        case "i": (0x22, false)
        case "j": (0x26, false)
        case "k": (0x28, false)
        case "l": (0x25, false)
        case "m": (0x2E, false)
        case "n": (0x2D, false)
        case "o": (0x1F, false)
        case "p": (0x23, false)
        case "q": (0x0C, false)
        case "r": (0x0F, false)
        case "s": (0x01, false)
        case "t": (0x11, false)
        case "u": (0x20, false)
        case "v": (0x09, false)
        case "w": (0x0D, false)
        case "x": (0x07, false)
        case "y": (0x10, false)
        case "z": (0x06, false)
        case "A": (0x00, true)
        case "B": (0x0B, true)
        case "C": (0x08, true)
        case "D": (0x02, true)
        case "E": (0x0E, true)
        case "F": (0x03, true)
        case "G": (0x05, true)
        case "H": (0x04, true)
        case "I": (0x22, true)
        case "J": (0x26, true)
        case "K": (0x28, true)
        case "L": (0x25, true)
        case "M": (0x2E, true)
        case "N": (0x2D, true)
        case "O": (0x1F, true)
        case "P": (0x23, true)
        case "Q": (0x0C, true)
        case "R": (0x0F, true)
        case "S": (0x01, true)
        case "T": (0x11, true)
        case "U": (0x20, true)
        case "V": (0x09, true)
        case "W": (0x0D, true)
        case "X": (0x07, true)
        case "Y": (0x10, true)
        case "Z": (0x06, true)
        case "0": (0x1D, false)
        case "1": (0x12, false)
        case "2": (0x13, false)
        case "3": (0x14, false)
        case "4": (0x15, false)
        case "5": (0x17, false)
        case "6": (0x16, false)
        case "7": (0x1A, false)
        case "8": (0x1C, false)
        case "9": (0x19, false)
        case "-": (0x1B, false)
        case "=": (0x18, false)
        case "[": (0x21, false)
        case "]": (0x1E, false)
        case "\\": (0x2A, false)
        case ";": (0x29, false)
        case "'": (0x27, false)
        case ",": (0x2B, false)
        case ".": (0x2F, false)
        case "/": (0x2C, false)
        case "`": (0x32, false)
        case "!": (0x12, true)
        case "@": (0x13, true)
        case "#": (0x14, true)
        case "$": (0x15, true)
        case "%": (0x17, true)
        case "^": (0x16, true)
        case "&": (0x1A, true)
        case "*": (0x1C, true)
        case "(": (0x19, true)
        case ")": (0x1D, true)
        case "_": (0x1B, true)
        case "+": (0x18, true)
        case "{": (0x21, true)
        case "}": (0x1E, true)
        case "|": (0x2A, true)
        case ":": (0x29, true)
        case "\"": (0x27, true)
        case "<": (0x2B, true)
        case ">": (0x2F, true)
        case "?": (0x2C, true)
        case "~": (0x32, true)
        case " ": (0x31, false)
        case "\t": (0x30, false)
        case "\n": (0x24, false)
        case "\r": (0x24, false)
        default: nil
        }
    }
}