using System;

namespace AcDream.Core.Audio;

/// <summary>
/// Diagnostic toggles for the audio subsystem, read once at startup per the
/// Code Structure Rules (one static owner per subsystem; no per-call-site
/// env reads).
/// </summary>
public static class AudioDiagnostics
{
    /// <summary>
    /// One console line per inbound server Sound event (0xF750) and per
    /// wire-sound play decision, with the drop reason when nothing plays.
    /// Used to pin whether interior soundscapes (inn chatter — server-bound
    /// ambient sound tables fired by emitter heartbeats) are absent because
    /// the server never sends them or because the client drops them.
    /// <para>Initial state from <c>ACDREAM_PROBE_SOUND_WIRE=1</c>.</para>
    /// </summary>
    public static bool ProbeWireSoundsEnabled { get; set; } =
        Environment.GetEnvironmentVariable("ACDREAM_PROBE_SOUND_WIRE") == "1";
}