菜单
Audio in FlatRedBall2. Use when working with sound effects, background music, AudioManager, loading Song or SoundEffect, volume control, or collision sound triggers.
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
基于 SOC 职业分类
Gum Integration in FlatRedBall2. Use when working with UI, HUD, menus, buttons, labels, text display, StackPanel, Panel, layout, Gum Forms controls, Add, AddOverlay, screen-space vs world-space UI, blurry or low-res text, FontSize, text opacity/alpha, or any Gum-related question. Also trigger when user asks about displaying text on screen.
TMX map file creation and editing for FlatRedBall2. Use when creating or modifying Tiled .tmx level files, placing collision tiles, resizing maps, or adding layers. Covers the base template, StandardTileset tile IDs, layer conventions, and CSV tile data format.
Writing headless tests for the Animation Editor (Avalonia). Triggers: AnimationEditor.App.Tests, [AvaloniaFact], TestServices, CreateMainWindow, service wiring in tests, UI-thread RunJobs.
Sprite animation in FlatRedBall2. Use for AnimationChain, AnimationChainList, .achx files, Aseprite/.ase loading, Sprite.PlayAnimation, frame-based texture flipping, looping/non-looping animations, AnimationFinished events, and per-frame collision shapes (hitboxes/hurtboxes, static object collision).
Entities and Factories in FlatRedBall2. Use when working with Entity subclasses, Factory<T>, spawning/creating/destroying entities, entity lifecycle, Add, shape children, CustomInitialize/CustomActivity, or Engine.GetFactory<T>(). Trigger on any entity creation, destruction, or factory question.
Level Data in FlatRedBall2. Use when working with level layouts, level progression, loading TMX maps, generating collision from tile layers, or transitioning between levels. Covers TMX-based level setup, TileShapes generation, and level advancement patterns.
| name | audio |
| description | Audio in FlatRedBall2. Use when working with sound effects, background music, AudioManager, loading Song or SoundEffect, volume control, or collision sound triggers. |
Engine.Audio // AudioManager instance on FlatRedBallService
Two paths. In the Common/Desktop template layout, prefer the direct path — it matches how every other raw asset (png, tmx, achx) is handled, with audio files living alongside them in Common/Content/. Reach for MGCB only when a format limit forces it (MP3).
Drop the file in Common/Content/ (e.g. Common/Content/Audio/song.ogg); it is linked into the Desktop output's Content/ automatically, no .mgcb entry needed. Load by full path with extension.
Song (music) — OGG only. Song.FromUri accepts only OGG Vorbis on DesktopGL; MP3 fails at runtime (NVorbis backend).
var song = Song.FromUri("song", new Uri(Path.GetFullPath("Content/Audio/song.ogg")));
SoundEffect — WAV only. SoundEffect.FromStream accepts only PCM WAV. OGG/MP3 effects need the MGCB path below.
using var stream = File.OpenRead("Content/Audio/hit.wav");
var sfx = SoundEffect.FromStream(stream);
Engine.Content.Track(sfx); // disposes on screen transition
Usings: System.IO, Microsoft.Xna.Framework.Audio, Microsoft.Xna.Framework.Media.
Needed only when the direct path's format limits bite. The .mgcb lives in the .Desktop head, not Common: MonoGame.Content.Builder.Task runs only on the head, so a mgcb added to Common is silently never built. Put the #begin entry and the source file under Desktop/Content/. See multiplatform-conversion for the content-split rationale.
#begin Audio/song.mp3
/importer:Mp3Importer
/processor:SongProcessor
/build:Audio/song.mp3
Load with the asset name minus the source extension — /build:Audio/song.mp3 builds to Audio/song.xnb:
var song = Engine.Content.Load<Song>("Audio/song"); // not "Audio/song.mp3"
// ContentLoader disposes Load<>'d assets on screen transition — no Track() needed
Usings: Microsoft.Xna.Framework.Audio, Microsoft.Xna.Framework.Media.
Engine.Audio.Play(sfx); // play with defaults
Engine.Audio.Play(sfx, volume: 0.5f, pitch: 0f, pan: 0f);
Engine.Audio.IsPlaying(sfx); // true if any instance is active
Per-frame dedup: calling Play(sfx) multiple times in a single frame (e.g., from CollisionOccurred firing on multiple pairs) plays the sound only once. Cross-frame overlap is allowed.
Engine.Audio.PlaySong(song); // loops by default
Engine.Audio.PlaySong(song, loop: false);
Engine.Audio.PauseSong(); // holds position
Engine.Audio.ResumeSong(); // resumes from position
Engine.Audio.StopSong(); // clears position
Engine.Audio.PlayPlaylist(song1, song2, song3); // plays sequentially, loops back to start
Engine.Audio.SoundVolume = 0.8f; // [0, 1], default 1
Engine.Audio.MusicVolume = 0.5f; // [0, 1], default 1; takes effect immediately
Engine.Audio.SoundEnabled = false; // silences new Play() calls; active instances finish naturally
Engine.Audio.MusicEnabled = false; // pauses current song immediately; true resumes it
Engine.Audio.StopSong() in CustomDestroy, or music keeps playing into the next screen.Song.FromUri only works with OGG — on DesktopGL (NVorbis), Song.FromUri fails at runtime with MP3. Use the MGCB pipeline and Engine.Content.Load<Song> for MP3 files.Load<> name drops the source extension — Load<Song>("Audio/song"), not "Audio/song.ogg". Passing the extension makes MonoGame look for song.ogg.xnb (the pipeline builds song.xnb) and throws FileNotFoundException. The .mgcb defining it must be in the .Desktop head, not Common.FromStream — call Engine.Content.Track(sfx) when using SoundEffect.FromStream so it is disposed on screen transition. MGCB-loaded assets (Engine.Content.Load<SoundEffect>) are disposed automatically by the ContentLoader — do not call Track for those.Play(sfx) in a CollisionOccurred handler is safe to call unconditionally; it fires at most once per frame regardless of how many pairs collide.