Lesson 237: Wwise DSP Init Boot Path Receipt on BUILD_RECEIPT (2026)
Direct answer: Before summer playtest Windows promotion, file wwise_dsp_init_receipt_v1.json proving Plugins/Wwise x64 sits beside the shipped exe, AK::SoundEngine::Init returns success on a clean VM, and one posted event auditions within 5 seconds—then promote BUILD_RECEIPT wwise_dsp_init_receipt. Distinct from Lesson 226 packaged inventory (wwise_dsp_packaged_receipt_v1) and FMOD bank strip.

Why this matters now (June 2027 summer playtest Windows)
June 2027 teams ship sprite sheet hash rows then invite playtesters on a new Steam Windows depot. Wwise Editor resolves DSP from the SDK; installed playtest builds on laptops without Wwise fail AK::SoundEngine::Init when CI copies banks but strips Plugins/Wwise. Q1 Lesson 226 filed wwise_dsp_packaged_receipt_v1 for post-fest recovery inventory—this lesson files wwise_dsp_init_receipt_v1 for the Q3 playtest wave with dsp_plugins_ok and promotion_allowed on BUILD_RECEIPT.
The Wwise DSP path preflight is the ninety-second checklist; Wwise Init help is triage—237 is the course milestone.
Beginner path (clean VM boot probe)
| Step | Action | Success check |
|---|---|---|
| 1 | Confirm Plugins/Wwise/ beside exe |
Multiple .dll files |
| 2 | Install from Steam on clean PC | No Wwise SDK on machine |
| 3 | Launch; open Wwise.log |
AK_Success on Init |
| 4 | Post logo sting / menu click event | Audible ≤ 5 s |
| 5 | File wwise_dsp_init_receipt_v1.json |
dsp_plugins_ok: true |
| 6 | BUILD_RECEIPT column | wwise_dsp_init_receipt GREEN |
Time: ~68 minutes first CI copy wiring; ~20 minutes when inventory pin is stable.
Developer path (gates D1–D6)
| Gate | Check | Fail when |
|---|---|---|
| D1 | Wwise + integration versions pinned | wwise_version_pin_v1.json missing |
| D2 | Plugins/Wwise x64 inventory beside exe |
Effect DLLs missing post-build |
| D3 | CI post-build DSP copy logged | Hand-copy only on one machine |
| D4 | AK::SoundEngine::Init on clean VM |
Init OK in Editor only |
| D5 | Boot posted event probe | Banks present but silent |
| D6 | Receipt + BUILD_RECEIPT | Promote without clean VM proof |
D1 — Version pin
{
"schema": "wwise_version_pin_v1",
"wwise_authoring": "2024.1.x",
"unity_integration": "2024.1.y",
"platform": "Windows_x64"
}
Fail when authoring banks are 2024 but packaged DLLs are 2023.
D2–D3 — Path + CI copy
| Check | Pass |
|---|---|
AkSoundEngineDLL.dll beside exe |
Yes |
Full DSP effect set per wwise_dsp_init_inventory.txt |
Yes |
CI log post_build_copy_wwise_dsp: ok |
Yes |
GeneratedSoundBanks/Windows/Init.bnk present |
Yes (banks alone insufficient) |
Archive inventory beside packaged inventory cousin—init receipt references path + Init, not full sha256 inventory merge.
wwise_dsp_init_receipt_v1.json
{
"schema": "wwise_dsp_init_receipt_v1",
"build_label": "summer-playtest-2027-rc1",
"wwise_authoring": "2024.1.x",
"unity_integration": "2024.1.y",
"platform": "Windows_x64",
"dsp_plugin_folder": "Plugins/Wwise",
"dll_count": 12,
"init_result": "AK_Success",
"boot_probe_event_id": "UI_Logo_Sting",
"audible_within_ms": 1200,
"clean_vm_tested": true,
"ci_copy_step": "post_build_copy_wwise_dsp.sh",
"gates": {
"D1_version_pin": "pass",
"D2_dsp_inventory": "pass",
"D3_ci_copy": "pass",
"D4_init_clean_vm": "pass",
"D5_boot_probe": "pass",
"D6_build_receipt": "pass"
},
"dsp_plugins_ok": true,
"promotion_allowed": true,
"cousin_receipts": {
"wwise_dsp_packaged": "release-evidence/audio/WWISE_DSP_PACKAGED_RECEIPT.json"
}
}
Pin under release-evidence/audio/WWISE_DSP_INIT_RECEIPT.json.
BUILD_RECEIPT row (D6)
| Column | Pass when |
|---|---|
wwise_dsp_init_receipt |
dsp_plugins_ok: true + path |
wwise_dsp_packaged |
Lesson 226 independent column |
audio_bank_strip |
Lesson 231 FMOD only |
ALTER TABLE release_publish_gate ADD COLUMN IF NOT EXISTS
wwise_dsp_init_blocked BOOLEAN NOT NULL DEFAULT false;
Pair with Thursday BUILD_RECEIPT review—one Audio / Wwise Init row.
Relationship to guide vs Lesson 226
| Artifact | Role |
|---|---|
| Wwise DSP path preflight | D1–D6 editor checklist |
| Wwise Init help | Symptom fix |
| Lesson 226 | Q1 wwise_dsp_packaged_receipt_v1 inventory |
| This lesson | Q3 wwise_dsp_init_receipt_v1 on BUILD_RECEIPT |
| SoundBank boot preflight | wwise_bank_boot_receipt_v1—run after 237 GREEN |
Proof table (surfaces)
| Surface | Clean VM Init | Boot probe | Notes |
|---|---|---|---|
| playtest_june Steam | Required | Required | Primary Q3 proof |
| fest_public Steam | Spot-check same DLL set | Same event id | Diff depot, same copy script |
| Editor Play Mode | — | — | Do not file receipt from Editor |
Key takeaways
wwise_dsp_init_receipt≠wwise_dsp_packaged_receipt—do not merge JSON schemas.- Prove on clean VM Steam install—SDK on dev PC masks D2.
- Lesson 226 — Q1 inventory cousin; 237 — Q3 init path gate.
- Lesson 236 — same wave, art subsystem.
- Q3 capstone 244 wires 237 with 236–243.
- 12-free Wwise Windows DSP resources — bookmark lane.
- Do not conflate with Unity FMOD bank strip.
- Wednesday smoke — add Init log screenshot row.
Common mistakes
- Filing receipt from Editor while Lesson 226 is red—cousin columns are independent.
- Copying only
AkSoundEngineDLL.dll—effects still failAK_PluginNotRegistered. - Promoting playtest depot built from CI job that strips
Plugins/. - Using packaged receipt schema for init path audit.
- Skipping boot probe (D5) because Init log looked green.
Troubleshooting
| Symptom | Lane |
|---|---|
| Init fail, banks present | D2 inventory + help |
| Init OK, no event audio | D5 boot probe; bank load help |
| playtest OK, fest silent | Diff CI artifact—compare dll_count |
| FMOD errors in log | Lesson 231 |
Mini exercise (60 minutes)
- Remove one effect DLL—reproduce Init fail on clean VM.
- Restore CI copy; pass D1–D5.
- File
wwise_dsp_init_receipt_v1.json; link cousin 226 path if both apply. - BUILD_RECEIPT
wwise_dsp_init_receiptGREEN. - Schedule Guide Q3 #2 bank boot preflight after promotion.
Continuity — Q3 2027 summer playtest wave (236–244)
| Lesson | Receipt focus |
|---|---|
| 236 | Sprite sheet hash |
| 237 (this) | Wwise DSP init boot path |
| 238 | Godot save isolation |
| 239–244 | Feedback → Q3 capstone |
Previous: Lesson 236 — Clip Studio sprite sheet hash.
Next: Lesson 238 — Godot playtest save isolation — published.
FAQ
Same as Wwise DSP path guide?
Guide = checklist; 237 = BUILD_RECEIPT wwise_dsp_init_receipt column.
Same as Lesson 226?
226 uses wwise_dsp_packaged_receipt_v1 (Q1 inventory); 237 uses wwise_dsp_init_receipt_v1 (Q3 init path).
Need both receipts GREEN?
Yes when you ship Wwise on Windows—cousin columns, not substitutes.
WebGL playtest?
Out of scope—see FMOD WebGL fest demo.
Summer playtest silence often starts at Init path—pin DSP beside exe, prove clean VM boot, file init receipt, then promote on BUILD_RECEIPT.