Audio Effects

Voeg geluid toe aan je platformer met AudioStreamPlayer3D

Overzicht

Voeg verschillende geluiden toe aan je platformer:

• Jump sound - Geluid wanneer de player springt

• Land sound - Geluid wanneer de player landt

• Coin pickup sound - Geluid bij het verzamelen van munten

• Block break sound - Geluid wanneer breakable blocks breken

Player Jump Sound

Begin met een geluid wanneer de player springt.

1. Open objects/Player.tscn

2. Selecteer de Player root node

3. Rechts-klik > Add Child Node > AudioStreamPlayer3D

4. Hernoem deze node naar JumpSound

5. Sla de scene op

Scene hierarchy:

Player (CharacterBody3D)
├── Capsule (imported scene)
├── CollisionShape3D (CapsuleShape3D)
├── AnimationPlayer
├── ParticlesTrail (GPUParticles3D)
└── JumpSound (AudioStreamPlayer3D)

Jump Sound Instellen

1. Selecteer de JumpSound node

2. In de Inspector, vind Stream

3. Klik op het dropdown > Load

4. Navigeer naar res://audio/jump.wav (of je eigen jump sound file)

5. Selecteer het audio bestand en klik Open

6. Zet Autoplay op UIT

7. Expand Stream en zorg dat Loop UIT staat

3D Audio Settings

1. Selecteer de JumpSound node

2. In de Inspector, onder Attenuation:

   • Unit Size: 8.0 (geluid blijft op vol volume tot 8 meter)

   • Max Distance: 40.0 (geluid is onhoorbaar na 40 meter)

3. Onder Attenuation, vind Model

4. Klik het dropdown en selecteer Inverse Square

Jump Sound Triggeren via Script

1. Open scripts/Player.cs

2. Voeg een referentie toe voor de audio player.

using Godot;

public partial class Player : CharacterBody3D
{
    [Export] private GpuParticles3D _trailParticles;
    [Export] private AudioStreamPlayer3D _jumpSound;

    private float _speed = 5.0f;
    private float _jumpForce = 8.0f;

    // ... rest van de code
}

1. Haal de jump sound node op in _Ready():

public override void _Ready()
{
    _jumpSound = GetNode<AudioStreamPlayer3D>("JumpSound");
}

1. Nu speel je het geluid af wanneer de player springt. Dit gebeurt in _PhysicsProcess() waar we de jump input checken:

public override void _PhysicsProcess(double delta)
{
    // ... bestaande movement code ...

    // Jump
    if (Input.IsActionJustPressed("jump") && IsOnFloor())
    {
        Velocity = new Vector3(Velocity.X, _jumpForce, Velocity.Z);

        // Speel jump sound
        if (_jumpSound != null)
        {
            _jumpSound.Play();
        }
    }

    // ... rest van de code
}

Uitleg: We gebruiken IsActionJustPressed() om te detecteren wanneer de speler de jump knop indrukt. Op dat moment spelen we het jump sound af. Het geluid speelt alleen wanneer de player op de grond is (IsOnFloor()), dus niet tijdens dubbele sprongen.

Player Land Sound

Voeg nu een geluid toe wanneer de player landt na een sprong.

1. Open objects/Player.tscn

2. Selecteer de Player root node

3. Rechts-klik > Add Child Node > AudioStreamPlayer3D

4. Hernoem deze node naar LandSound

5. Sla de scene op

Scene hierarchy:

Player (CharacterBody3D)
├── Capsule (imported scene)
├── CollisionShape3D (CapsuleShape3D)
├── AnimationPlayer
├── ParticlesTrail (GPUParticles3D)
├── JumpSound (AudioStreamPlayer3D)
└── LandSound (AudioStreamPlayer3D)

Land Sound Instellen

1. Selecteer de LandSound node

2. In de Inspector, vind Stream

3. Klik op het dropdown > Load

4. Navigeer naar res://audio/land.wav

5. Selecteer het bestand en klik Open

6. Zet Autoplay op UIT

7. Expand Stream en zorg dat Loop UIT staat

8. Onder Attenuation, stel dezelfde waarden in als JumpSound:

   • Unit Size: 8.0

   • Max Distance: 40.0

   • Model: Inverse Square

Land Sound Script

Om te detecteren wanneer de player landt, moet je bijhouden of de player in de vorige frame in de lucht was.

1. Open scripts/Player.cs

2. Voeg een referentie toe voor de land sound en een variabele om bij te houden of we in de lucht waren:

using Godot;

public partial class Player : CharacterBody3D
{
    [Export] private GpuParticles3D _trailParticles;
    [Export] private AudioStreamPlayer3D _jumpSound;
    [Export] private AudioStreamPlayer3D _landSound;

    private float _speed = 5.0f;
    private float _jumpForce = 8.0f;

    private bool _wasInAir = false;

    // ... rest van de code
}

1. Haal de land sound node op in _Ready():

public override void _Ready()
{
    _jumpSound = GetNode<AudioStreamPlayer3D>("JumpSound");
    _landSound = GetNode<AudioStreamPlayer3D>("LandSound");
}

1. Nu detecteren we landing aan het einde van _PhysicsProcess():

public override void _PhysicsProcess(double delta)
{
    // ... bestaande movement code ...

    MoveAndSlide();

    // Update trail particles op basis van snelheid
    if (_trailParticles != null)
    {
        var horizontalVelocity = new Vector2(Velocity.X, Velocity.Z).Length();
        _trailParticles.Emitting = horizontalVelocity > _speed * 0.5f;
    }

    // Detecteer landing
    if (IsOnFloor() && _wasInAir)
    {
        // Speel land sound
        if (_landSound != null)
        {
            _landSound.Play();
        }
    }

    // Onthoud of we in de lucht waren voor volgende frame
    _wasInAir = !IsOnFloor();
}

Uitleg: We gebruiken _wasInAir om bij te houden of de player in de vorige frame in de lucht was. Als de player NU op de grond is (IsOnFloor()) maar in de vorige frame in de lucht WAS (_wasInAir), dan is de player net geland en spelen we het land sound af.

Test Jump en Land Sounds

Test met F5!

Je zou nu moeten horen:

• Wanneer je springt (spatiebalk), speelt een jump geluid

• Wanneer je landt na een sprong, speelt een land geluid

• Het land geluid speelt NIET wanneer je van een platform afloopt zonder te springen

Als geluiden niet werken:

• Check of Autoplay UIT staat bij beide sounds

• Controleer of de audio bestanden correct zijn ingeladen

• Zorg dat beide nodes correct worden opgehaald in _Ready()

• Check of Play() wordt aangeroepen op de juiste momenten

Coin Pickup Sound

Voeg nu een geluid toe wanneer de player een munt verzamelt.

1. Open objects/Coin.tscn

2. Selecteer de Coin root node (Area3D)

3. Rechts-klik > Add Child Node > AudioStreamPlayer3D

4. Hernoem deze node naar PickupSound

5. Sla de scene op

Scene hierarchy:

Coin (Area3D)
├── coin (imported scene)
├── CollisionShape3D (SphereShape3D)
├── AnimationPlayer
└── PickupSound (AudioStreamPlayer3D)

Coin Sound Instellen

1. Selecteer de PickupSound node

2. In de Inspector, vind Stream

3. Klik op het dropdown > Load

4. Navigeer naar res://audio/coin_pickup.wav

5. Selecteer het bestand en klik Open

6. Zet Autoplay op UIT

7. Expand Stream en zorg dat Loop UIT staat

8. Onder Attenuation:

   • Unit Size: 5.0 (kleinere range voor pickup sounds)

   • Max Distance: 30.0

   • Model: Inverse Square

Coin Sound Script

Je moet het geluid afspelen wanneer de coin wordt verzameld, maar de coin pas verwijderen NADAT het geluid klaar is.

1. Open scripts/Coin.cs

2. Voeg een referentie toe voor de audio player:

using Godot;

public partial class Coin : Area3D
{
    [Signal]
    public delegate void CollectedEventHandler();

    private AudioStreamPlayer3D _pickupSound;

    private void OnBodyEntered(Node3D body)
    {
        if (body is Player)
        {
            GetNode<CollisionShape3D>("CollisionShape3D").SetDeferred("disabled", true);

            EmitSignal(SignalName.Collected);

            GD.Print("Coin collected!");
            QueueFree();
        }
    }
}

1. Haal de pickup sound node op in _Ready():

using Godot;

public partial class Coin : Area3D
{
    [Signal]
    public delegate void CollectedEventHandler();

    private AudioStreamPlayer3D _pickupSound;

    public override void _Ready()
    {
        _pickupSound = GetNode<AudioStreamPlayer3D>("PickupSound");
    }

    private void OnBodyEntered(Node3D body)
    {
        if (body is Player)
        {
            GetNode<CollisionShape3D>("CollisionShape3D").SetDeferred("disabled", true);

            EmitSignal(SignalName.Collected);

            GD.Print("Coin collected!");
            QueueFree();
        }
    }
}

1. Speel nu het geluid af wanneer de coin wordt verzameld:

private void OnBodyEntered(Node3D body)
{
    if (body is Player)
    {
        GetNode<CollisionShape3D>("CollisionShape3D").SetDeferred("disabled", true);

        // Speel pickup sound
        if (_pickupSound != null)
        {
            _pickupSound.Play();
        }

        EmitSignal(SignalName.Collected);

        GD.Print("Coin collected!");
        QueueFree();
    }
}

1. Er is een probleem: QueueFree() verwijdert de coin meteen, maar dan kan het geluid niet meer afspelen! Je moet wachten tot het geluid klaar is. Je subscribet op het Finished signal:

public override void _Ready()
{
    _pickupSound = GetNode<AudioStreamPlayer3D>("PickupSound");

    // Subscribe op Finished signal
    if (_pickupSound != null)
    {
        _pickupSound.Finished += OnPickupSoundFinished;
    }
}

private void OnBodyEntered(Node3D body)
{
    if (body is Player)
    {
        GetNode<CollisionShape3D>("CollisionShape3D").SetDeferred("disabled", true);

        // Speel pickup sound
        if (_pickupSound != null)
        {
            _pickupSound.Play();
        }

        // Verberg de coin visueel
        Visible = false;

        EmitSignal(SignalName.Collected);

        GD.Print("Coin collected!");
    }
}

private void OnPickupSoundFinished()
{
    // Verwijder de coin nadat het geluid klaar is
    QueueFree();
}

Uitleg: Verberg de coin meteen met Visible = false en schakel collision uit, maar verwijder de node pas wanneer het pickup sound klaar is. De speler ziet de coin verdwijnen en hoort het geluid volledig.

Block Break Sound

Als laatste voeg je een geluid toe wanneer breakable blocks breken.

1. Open objects/BreakableBlock.tscn

2. Selecteer de BreakableBlock root node

3. Rechts-klik > Add Child Node > AudioStreamPlayer3D

4. Hernoem deze node naar BreakSound

5. Sla de scene op

Break Sound Instellen

1. Selecteer de BreakSound node

2. In de Inspector, vind Stream

3. Klik op het dropdown > Load

4. Navigeer naar res://audio/block_break.wav

5. Selecteer het bestand en klik Open

6. Zet Autoplay op UIT

7. Expand Stream en zorg dat Loop UIT staat

8. Onder Attenuation:

   • Unit Size: 7.0

   • Max Distance: 35.0

   • Model: Inverse Square

Break Sound Script

1. Open scripts/BreakableBlock.cs

2. Voeg een referentie toe voor de audio player:

using Godot;

public partial class BreakableBlock : RigidBody3D
{
    [Signal]
    public delegate void BrokenEventHandler();

    [Export] private float _breakVelocity = 3.0f;

    private AudioStreamPlayer3D _breakSound;

    private void OnBodyShapeEntered(Rid bodyRid, Node body, int bodyShapeIndex, int localShapeIndex)
    {
        float impactSpeed = LinearVelocity.Length();

        if (impactSpeed >= _breakVelocity)
        {
            EmitSignal(SignalName.Broken);
            GD.Print("Block breaking!");
            QueueFree();
        }
    }
}

1. Haal de break sound node op in _Ready():

public override void _Ready()
{
    _breakSound = GetNode<AudioStreamPlayer3D>("BreakSound");
}

1. Nu spelen we het geluid af en wachten tot het klaar is:

public override void _Ready()
{
    _breakSound = GetNode<AudioStreamPlayer3D>("BreakSound");

    // Subscribe op Finished signal
    if (_breakSound != null)
    {
        _breakSound.Finished += OnBreakSoundFinished;
    }
}

private void OnBodyShapeEntered(Rid bodyRid, Node body, int bodyShapeIndex, int localShapeIndex)
{
    float impactSpeed = LinearVelocity.Length();

    if (impactSpeed >= _breakVelocity)
    {
        EmitSignal(SignalName.Broken);

        // Speel break sound
        if (_breakSound != null)
        {
            _breakSound.Play();
        }

        // Verberg het block visueel
        Visible = false;

        // Schakel collision uit
        GetNode<CollisionShape3D>("CollisionShape3D").SetDeferred("disabled", true);

        GD.Print("Block breaking!");
    }
}

private void OnBreakSoundFinished()
{
    // Verwijder het block nadat het geluid klaar is
    QueueFree();
}

Test alle Audio

Test met F5!

Je zou nu moeten horen:

• Jump sound: Wanneer je springt (spatiebalk)

• Land sound: Wanneer je landt na een sprong

• Coin pickup sound: Wanneer je een munt verzamelt (3D spatialized)

• Block break sound: Wanneer een breakable block breekt

Als geluiden niet werken:

• Check of alle audio bestanden correct zijn ingeladen

• Controleer of Play() wordt aangeroepen op de juiste momenten

• Zorg dat Finished signals correct zijn geconnect

• Check of nodes correct worden opgehaald in _Ready()

• Controleer je computer volume instellingen

• Zorg dat objects niet worden verwijderd voordat geluiden klaar zijn

Complete Scripts

Klik hier voor de volledige scripts met audio

Player.cs (relevante delen)

using Godot;

public partial class Player : CharacterBody3D
{
    [Export] private GpuParticles3D _trailParticles;
    [Export] private AudioStreamPlayer3D _jumpSound;
    [Export] private AudioStreamPlayer3D _landSound;

    private float _speed = 5.0f;
    private float _jumpForce = 8.0f;

    private bool _wasInAir = false;

    public override void _Ready()
    {
        _jumpSound = GetNode<AudioStreamPlayer3D>("JumpSound");
        _landSound = GetNode<AudioStreamPlayer3D>("LandSound");
    }

    public override void _PhysicsProcess(double delta)
    {
        // ... bestaande movement code ...

        // Jump
        if (Input.IsActionJustPressed("jump") && IsOnFloor())
        {
            Velocity = new Vector3(Velocity.X, _jumpForce, Velocity.Z);

            // Speel jump sound
            if (_jumpSound != null)
            {
                _jumpSound.Play();
            }
        }

        MoveAndSlide();

        // Update trail particles op basis van snelheid
        if (_trailParticles != null)
        {
            var horizontalVelocity = new Vector2(Velocity.X, Velocity.Z).Length();
            _trailParticles.Emitting = horizontalVelocity > _speed * 0.5f;
        }

        // Detecteer landing
        if (IsOnFloor() && _wasInAir)
        {
            // Speel land sound
            if (_landSound != null)
            {
                _landSound.Play();
            }
        }

        // Onthoud of we in de lucht waren voor volgende frame
        _wasInAir = !IsOnFloor();
    }
}

Coin.cs

using Godot;

public partial class Coin : Area3D
{
    [Signal]
    public delegate void CollectedEventHandler();

    private AudioStreamPlayer3D _pickupSound;

    public override void _Ready()
    {
        _pickupSound = GetNode<AudioStreamPlayer3D>("PickupSound");

        // Subscribe op Finished signal
        if (_pickupSound != null)
        {
            _pickupSound.Finished += OnPickupSoundFinished;
        }
    }

    private void OnBodyEntered(Node3D body)
    {
        if (body is Player)
        {
            GetNode<CollisionShape3D>("CollisionShape3D").SetDeferred("disabled", true);

            // Speel pickup sound
            if (_pickupSound != null)
            {
                _pickupSound.Play();
            }

            // Verberg de coin visueel
            Visible = false;

            EmitSignal(SignalName.Collected);

            GD.Print("Coin collected!");
        }
    }

    private void OnPickupSoundFinished()
    {
        // Verwijder de coin nadat het geluid klaar is
        QueueFree();
    }
}

BreakableBlock.cs

using Godot;

public partial class BreakableBlock : RigidBody3D
{
    [Signal]
    public delegate void BrokenEventHandler();

    [Export] private float _breakVelocity = 3.0f;

    private AudioStreamPlayer3D _breakSound;

    public override void _Ready()
    {
        _breakSound = GetNode<AudioStreamPlayer3D>("BreakSound");

        // Subscribe op Finished signal
        if (_breakSound != null)
        {
            _breakSound.Finished += OnBreakSoundFinished;
        }
    }

    private void OnBodyShapeEntered(Rid bodyRid, Node body, int bodyShapeIndex, int localShapeIndex)
    {
        float impactSpeed = LinearVelocity.Length();

        if (impactSpeed >= _breakVelocity)
        {
            EmitSignal(SignalName.Broken);

            // Speel break sound
            if (_breakSound != null)
            {
                _breakSound.Play();
            }

            // Verberg het block visueel
            Visible = false;

            // Schakel collision uit
            GetNode<CollisionShape3D>("CollisionShape3D").SetDeferred("disabled", true);

            GD.Print("Block breaking!");
        }
    }

    private void OnBreakSoundFinished()
    {
        // Verwijder het block nadat het geluid klaar is
        QueueFree();
    }
}