Audio

PCM-Audio auf der Nintendo Switch — Sinustöne und Lautstärkeregelung.

libnx verwendet intern immer 48000 Hz. Der sampleRate-Parameter von Audio.Init() wird akzeptiert aber ignoriert.

API-Übersicht

MethodeBeschreibung
Audio.Init(sampleRate)PCM-Audio initialisieren (48000 Hz intern)
Audio.PlayTone(freq, amp, ms)Sinuston erzeugen und abspielen
Audio.SetVolume(vol)Master-Lautstärke setzen (0.0–1.0)
Audio.Stop()Wiedergabe stoppen
Audio.Exit()Audio-System freigeben

Parameter von PlayTone

ParameterTypBeschreibung
freqfloatFrequenz in Hz (z.B. 440.0f = Kammerton A)
ampfloatAmplitude / Lautstärke (0.0–1.0)
msintDauer in Millisekunden

Beispiel

public class MyApp : SwitchApp
{
    public override void OnInit()
    {
        Graphics.Init(1280, 720);
        Audio.Init(44100);  // sampleRate-Param wird ignoriert, intern 48kHz
    }

    public override void OnFrame()
    {
        Graphics.FillScreen(Color.Black);

        if (Input.IsDown(NpadButton.A))
            Audio.PlayTone(440.0f, 0.5f, 300);   // 440 Hz, 50%, 300ms

        if (Input.IsDown(NpadButton.B))
            Audio.PlayTone(880.0f, 0.3f, 150);   // Eine Oktave höher

        if (Input.IsDown(NpadButton.X))
        {
            Audio.SetVolume(0.2f);               // Lautstärke reduzieren
            Audio.PlayTone(220.0f, 1.0f, 500);
        }

        if (Input.IsDown(NpadButton.Plus))
        {
            Audio.Stop();
            Audio.Exit();
            Environment.Exit(0);
        }
    }
}

Technische Details

Interner Aufbau

  • 4 zirkuläre PCM-Puffer à 4096 Samples
  • Stereo, 16-bit PCM
  • Interne Sample-Rate: 48000 Hz
  • PlayTone blockiert nicht beim ersten Aufruf

Noten-Frequenzen (Hz)

C4: 261.6D4: 293.7 E4: 329.6F4: 349.2 G4: 392.0A4: 440.0 B4: 493.9C5: 523.3