Girdi & Durum Makinesi: Klavye, Pointer, Gamepad

Olaylar tik dışında gelir; ring buffer veya bayrak seti ile bir sonraki poll()'da tüketilir. Holodepth: buffer boyutu sabit (ör. 8 edge); taşma eski komutu düşürür, sınırsız büyüme bellek riskidir. Döngü yaprağındaki «input dilimi» burada dolar.

Buffer'ı tik başına bir kez temizlemek kritik bir kuraldır: aynı poll() çağrısı birden fazla kez okunursa (örneğin hem FSM hem entity katmanı tüketirse) bir edge komutu iki kez işlenebilir. Holodepth: poll()'u döngüde tek noktadan çağırın, sonucu o karenin tüm tüketicilerine aynı anlık görüntü olarak dağıtın.

Örnekler öğretim amaçlıdır; tuş eşlemesi ürün kararıdır. Aşağıdaki iskelet klavye ve pointer'ı aynı komut çıktısına indiren tek bir poll() yüzeyini gösterir.

Simüle · keyboard + pointer poll.

const HELD = new Set()
const EDGES = []
const MAX_EDGES = 8

const KEY_MAP = {
  KeyW: 'up', KeyA: 'left', KeyS: 'down', KeyD: 'right',
  Space: 'jump', Escape: 'pause',
}

function onKeyDown(e) {
  const cmd = KEY_MAP[e.code]
  if (!cmd) return
  if (!HELD.has(cmd)) EDGES.push(cmd)
  if (EDGES.length > MAX_EDGES) EDGES.shift()
  HELD.add(cmd)
  if (['Space', 'ArrowUp', 'ArrowDown'].includes(e.code)) e.preventDefault()
}

function onKeyUp(e) {
  const cmd = KEY_MAP[e.code]
  if (cmd) HELD.delete(cmd)
}

let pointerDown = false
let pointerNorm = { x: 0, y: 0 }

export function bindInput(canvas) {
  window.addEventListener('keydown', onKeyDown)
  window.addEventListener('keyup', onKeyUp)
  canvas.addEventListener('pointerdown', () => { pointerDown = true })
  canvas.addEventListener('pointerup', () => { pointerDown = false })
  canvas.addEventListener('pointermove', (e) => {
    const r = canvas.getBoundingClientRect()
    pointerNorm.x = ((e.clientX - r.left) / r.width) * 2 - 1
    pointerNorm.y = -(((e.clientY - r.top) / r.height) * 2 - 1)
  })
}

export function pollInput() {
  const edges = EDGES.splice(0, EDGES.length)
  return {
    edges,
    hold: new Set(HELD),
    pointer: { down: pointerDown, ...pointerNorm },
  }
}

export function unbindInput() {
  window.removeEventListener('keydown', onKeyDown)
  window.removeEventListener('keyup', onKeyUp)
  HELD.clear()
  EDGES.length = 0
}

Simüle · FSM lite + döngü köprüsü.

const STATES = ['menu', 'playing', 'paused', 'gameover']

export function createFsm(initial = 'menu') {
  let state = initial

  const transitions = {
    menu: { start: 'playing' },
    playing: { pause: 'paused', die: 'gameover' },
    paused: { resume: 'playing', quit: 'menu' },
    gameover: { restart: 'menu' },
  }

  return {
    get state() { return state },
    dispatch(event) {
      const next = transitions[state]?.[event]
      if (next && STATES.includes(next)) state = next
    },
    /** Faz hangi komutları işler */
    accepts(cmd) {
      if (state === 'menu') return ['start'].includes(cmd)
      if (state === 'playing') return ['up','down','left','right','jump','pause','fire'].includes(cmd)
      if (state === 'paused') return ['resume','quit'].includes(cmd)
      if (state === 'gameover') return ['restart'].includes(cmd)
      return false
    },
  }
}

/** onTick içinde: const inp = pollInput(); fsm + inp → entity komutları */

Bu kalıpların çoğu küçük prototipte fark edilmez; oyuncu sayısı veya cihaz çeşitliliği arttığında yüzeye çıkar.

• Mantık içinde doğrudan keydown dinlemek
• Edge ve hold ayrımı yapmamak
• FSM olmadan menü ve oyunu karıştırmak
• Sınırsız edge buffer
• Gamepad kopunca eski eksen değeri
• Aynı poll() sonucunu birden fazla tüketiciye tekrar tekrar okutmak
• Hexovian action map'i web'e taşıma beklentisi

Üç profil aynı komut sözlüğünü paylaşır; ayrışan şey hangi cihazın birincil, hangisinin yedek olduğu ve FSM'in hangi fazda hangi girdiyi kabul ettiğidir.

• 01 · Girdi

  Klavye arcade

  Yüzey

  WASD + space

  FSM

  menu / playing

  Risk

  preventDefault aşırısı

• 02 · Girdi

  Pointer aim

  Yüzey

  Normalize pointer + click

  FSM

  playing only fire

  Risk

  Raycast ile karışım

• 03 · Girdi

  Hibrit pad

  Yüzey

  Pad + klavye yedek

  FSM

  pause her yüzeyde

  Risk

  Çift komut çakışması

Input dilimi ms olarak küçük olmalı; ağır iş mantık katmanına taşınır. Platform FPS ile «input → tepki» gecikmesini hissedilen jank ile birlikte okuyun. Çok fazla preventDefault veya global listener sayısı ana iş parçacığını yorar.

Gecikmeyi ölçerken tek bir sayı yetmez: p50 «ortalama hissi», p99 «en kötü anı» temsil eder. Holodepth: input → görsel tepki arasındaki süreyi birkaç yüz örnekle toplayın, ortalamaya değil kuyruk değerine güvenin — oyuncu p99'u hisseder, p50'yi unutur.

Komut sözlüğü tek kaynak

Klavye, pointer ve pad aynı string komutlara map edilir; entity katmanı cihaz bilmez. Yeni bir cihaz (ör. dokunmatik ekran jesti) eklemek, yalnızca eşleme tablosuna bir satır eklemek demektir.

FSM faz sınırı

Her fazın kabul listesi kısa tutulur; «her yerde her şey» bakım borcudur. Bir komutun hangi fazlarda anlamlı olduğunu tabloya yazmak, kodu okuyanın aklında tutmasından daha güvenilirdir.

Tampon, döngünün uzantısıdır

Girdi tamponu döngü yaprağındaki «input dilimi»nin somut hali; ikisini ayrı kavram sanmak sıralama hatalarına yol açar.

Teşhis maddeleri

1. poll() tik başında mı?
2. Edge / hold ayrıldı mı?
3. Buffer sınırlı mı?
4. FSM geçişleri tabloda mı?
5. unbind/dispose var mı?
6. Gamepad kopuşu sıfırlanıyor mu?
7. Netcode veya glTF sızmış mı?

Komutlar üretildikten sonra sahne nesnelerine bağlanmalıdır. Üçüncü yaprak mesh ile oyun nesnesini hafif modelde eşler; update hook'ları döngüye takılır. Tam ECS Hexovian'da kalır.