Add WoW-style footsteps and improve third-person movement/collision

include/audio/footstep_manager.hpp

@@ -0,0 +1,65 @@
+#pragma once
+
+#include <cstdint>
+#include <random>
+#include <string>
+#include <vector>
+#include <sys/types.h>
+
+namespace wowee {
+namespace pipeline { class AssetManager; }
+
+namespace audio {
+
+enum class FootstepSurface : uint8_t {
+    STONE = 0,
+    DIRT,
+    GRASS,
+    WOOD,
+    METAL,
+    WATER,
+    SNOW
+};
+
+class FootstepManager {
+public:
+    FootstepManager();
+    ~FootstepManager();
+
+    bool initialize(pipeline::AssetManager* assets);
+    void shutdown();
+
+    void update(float deltaTime);
+    void playFootstep(FootstepSurface surface, bool sprinting);
+
+    bool isInitialized() const { return assetManager != nullptr; }
+    bool hasAnySamples() const { return sampleCount > 0; }
+
+private:
+    struct Sample {
+        std::string path;
+        std::vector<uint8_t> data;
+    };
+
+    struct SurfaceSamples {
+        std::vector<Sample> clips;
+    };
+
+    void preloadSurface(FootstepSurface surface, const std::vector<std::string>& candidates);
+    void stopCurrentProcess();
+    void reapFinishedProcess();
+    bool playRandomStep(FootstepSurface surface, bool sprinting);
+    static const char* surfaceName(FootstepSurface surface);
+
+    pipeline::AssetManager* assetManager = nullptr;
+    SurfaceSamples surfaces[7];
+    size_t sampleCount = 0;
+
+    std::string tempFilePath = "/tmp/wowee_footstep.wav";
+    pid_t playerPid = -1;
+
+    std::mt19937 rng;
+};
+
+} // namespace audio
+} // namespace wowee