Keyboard input (GetKey, GetKeyDown) in Unity - Step-by-Step Execution

Concept Flow - Keyboard input (GetKey, GetKeyDown)

Start Frame

↓

Check GetKeyDown

↓

Trigger GetKeyDown Action

↓

Check GetKey

↓

Trigger GetKey Action

↓

End Frame

↩Back to Start Frame

Each frame, Unity checks if a key was just pressed (GetKeyDown) or is being held (GetKey), then triggers actions accordingly.

Execution Sample

Unity

void Update() {
  if (Input.GetKeyDown(KeyCode.Space)) {
    Debug.Log("Jump!");
  }
  if (Input.GetKey(KeyCode.Space)) {
    Debug.Log("Holding space");
  }
}

This code logs "Jump!" once when space is first pressed, and "Holding space" every frame while space is held.

Execution Table

Frame	Space Key State	Input.GetKeyDown(Space)	Input.GetKey(Space)	Action Taken	Output
1	Not pressed	False	False	None
2	Pressed this frame	True	True	GetKeyDown and GetKey triggered	Jump! Holding space
3	Held down	False	True	GetKey triggered	Holding space
4	Held down	False	True	GetKey triggered	Holding space
5	Released	False	False	None

💡 Space key released at frame 5, so no input detected.

Variable Tracker

Variable	Start	After Frame 1	After Frame 2	After Frame 3	After Frame 4	After Frame 5
Space Key State	Not pressed	Not pressed	Pressed this frame	Held down	Held down	Released
Input.GetKeyDown(Space)	False	False	True	False	False	False
Input.GetKey(Space)	False	False	True	True	True	False

Key Moments - 2 Insights

Why does GetKeyDown only trigger once even if the key is held?

GetKeyDown returns true only on the exact frame the key is first pressed, as shown in frame 2 of the execution_table. Subsequent frames with the key held down return false for GetKeyDown.

Why does GetKey return true on multiple frames?

GetKey returns true every frame the key is held down, as seen in frames 2, 3, and 4 in the execution_table, allowing continuous detection while holding.

Visual Quiz - 3 Questions

Look at the execution_table, what is Input.GetKeyDown(Space) at frame 3?

A True

B Null

C False

D Depends on previous frame

💡 Hint

Check the 'Input.GetKeyDown(Space)' column at frame 3 in the execution_table.

At which frame does the action 'Jump!' get logged?

A Frame 2

B Frame 1

C Frame 3

D Frame 5

💡 Hint

Look at the 'Action Taken' and 'Output' columns in the execution_table.

If the space key is held for 4 frames, how many times does 'Holding space' get logged?

A 1

B 4

C 3

D 2

💡 Hint

Check the 'Output' column for frames where Input.GetKey(Space) is true.

Concept Snapshot

Unity keyboard input:
- GetKeyDown detects key pressed this frame (once)
- GetKey detects key held down (every frame)
- Use in Update() for frame-based input
- GetKeyDown triggers action once per press
- GetKey triggers action continuously while held

Full Transcript

In Unity, keyboard input is checked every frame inside the Update() method. The function Input.GetKeyDown returns true only on the exact frame when a key is first pressed. This triggers actions that should happen once, like jumping. Input.GetKey returns true every frame while the key is held down, useful for continuous actions like running or charging. The execution table shows how these functions behave over several frames when the space key is pressed, held, and released. Beginners often confuse GetKeyDown with GetKey because GetKeyDown triggers only once per press, while GetKey triggers repeatedly while holding. Understanding this difference helps control game actions precisely.

Practice

1. What does Input.GetKeyDown(KeyCode.Space) detect in Unity?

easy

A. If the space key is being held down continuously

B. If any key is pressed

C. If the space key is released

D. The exact frame when the space key is first pressed

Solution

1. Step 1: Understand GetKeyDown behavior

   Input.GetKeyDown returns true only on the first frame the key is pressed.

2. Step 2: Apply to space key

   When KeyCode.Space is used, it detects the first press of the space bar only.

3. Final Answer:

   The exact frame when the space key is first pressed -> Option D

4. Quick Check:

   GetKeyDown = first press frame [OK]

Hint: GetKeyDown triggers only once on key press [OK]

Common Mistakes:

• Confusing GetKeyDown with GetKey
• Thinking it detects key release
• Assuming it detects any key

2. Which of the following is the correct syntax to check if the "W" key is being held down in Unity?

easy

A. Input.GetKey(KeyCode.W)

B. Input.GetKeyDown(KeyCode.W)

C. Input.GetKeyUp(KeyCode.W)

D. Input.IsKeyPressed(KeyCode.W)

Solution

1. Step 1: Identify method for continuous key hold

   Input.GetKey returns true every frame the key is held down.

2. Step 2: Match syntax for "W" key

   The correct syntax is Input.GetKey(KeyCode.W) to check if "W" is held.

3. Final Answer:

   Input.GetKey(KeyCode.W) -> Option A

4. Quick Check:

   GetKey = held down check [OK]

Hint: Use GetKey for continuous key press detection [OK]

Common Mistakes:

• Using GetKeyDown instead of GetKey for hold detection
• Using non-existent method IsKeyPressed
• Confusing GetKeyUp with GetKey

3. What will be printed if the following Unity code runs and the player holds down the "A" key for 3 seconds?

void Update() {
  if (Input.GetKeyDown(KeyCode.A)) {
    Debug.Log("Pressed A");
  }
  if (Input.GetKey(KeyCode.A)) {
    Debug.Log("Holding A");
  }
}

medium

A. "Pressed A" printed many times, "Holding A" once

B. "Pressed A" and "Holding A" printed once each

C. "Pressed A" once and "Holding A" many times over 3 seconds

D. No output because GetKeyDown doesn't detect held keys

Solution

1. Step 1: Understand GetKeyDown behavior

   Input.GetKeyDown(KeyCode.A) triggers only once when the key is first pressed.

2. Step 2: Understand GetKey behavior

   Input.GetKey(KeyCode.A) triggers every frame while the key is held down, so it prints repeatedly during 3 seconds.

3. Final Answer:

   "Pressed A" once and "Holding A" many times over 3 seconds -> Option C

4. Quick Check:

   GetKeyDown = once, GetKey = continuous [OK]

Hint: GetKeyDown prints once; GetKey prints repeatedly while held [OK]

Common Mistakes:

• Thinking GetKeyDown prints repeatedly
• Confusing GetKey with GetKeyDown
• Assuming no output for held keys

4. Identify the error in this Unity code snippet:

void Update() {
  if (Input.GetKeyDown("space")) {
    Debug.Log("Jump!");
  }
}

medium

A. The code is correct and will print "Jump!"

B. GetKeyDown requires a KeyCode, not a string

C. The method name should be GetKeyUp

D. Debug.Log cannot be called inside Update

Solution

1. Step 1: Verify GetKeyDown parameter

   Input.GetKeyDown requires a KeyCode parameter, not a string like "space".

2. Step 2: Confirm error

   Passing a string will cause a compile-time error; the correct usage is Input.GetKeyDown(KeyCode.Space).

3. Final Answer:

   GetKeyDown requires a KeyCode, not a string -> Option B

4. Quick Check:

   GetKeyDown("space") is invalid [OK]

Hint: GetKeyDown requires KeyCode enum, not string [OK]

Common Mistakes:

• Believing GetKeyDown accepts strings
• Thinking Debug.Log can't be in Update
• Suggesting GetKeyUp instead

5. You want to make a player jump only once when the spacebar is pressed, but also allow holding the left arrow key to move continuously. Which code snippet correctly implements this behavior?

void Update() {
  // Your code here
}

hard

A. if (Input.GetKeyDown(KeyCode.Space)) { Jump(); } if (Input.GetKey(KeyCode.LeftArrow)) { MoveLeft(); }

B. if (Input.GetKey(KeyCode.Space)) { Jump(); } if (Input.GetKeyDown(KeyCode.LeftArrow)) { MoveLeft(); }

C. if (Input.GetKeyUp(KeyCode.Space)) { Jump(); } if (Input.GetKey(KeyCode.LeftArrow)) { MoveLeft(); }

D. if (Input.GetKeyDown(KeyCode.Space)) { Jump(); } if (Input.GetKeyDown(KeyCode.LeftArrow)) { MoveLeft(); }

Solution

1. Step 1: Use GetKeyDown for single jump press

   Jump should trigger once when spacebar is first pressed, so use Input.GetKeyDown(KeyCode.Space).

2. Step 2: Use GetKey for continuous left movement

   Holding left arrow should move continuously, so use Input.GetKey(KeyCode.LeftArrow).

3. Final Answer:

   if (Input.GetKeyDown(KeyCode.Space)) { Jump(); } if (Input.GetKey(KeyCode.LeftArrow)) { MoveLeft(); } -> Option A

4. Quick Check:

   Jump = GetKeyDown, Move = GetKey [OK]

Hint: Jump once with GetKeyDown; move continuously with GetKey [OK]

Common Mistakes:

• Using GetKey for jump causes repeated jumps
• Using GetKeyDown for movement causes single-step moves
• Using GetKeyUp incorrectly for jump