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
| Methode | Beschreibung |
|---|---|
| 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
| Parameter | Typ | Beschreibung |
|---|---|---|
| freq | float | Frequenz in Hz (z.B. 440.0f = Kammerton A) |
| amp | float | Amplitude / Lautstärke (0.0–1.0) |
| ms | int | Dauer 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