{"id":638,"date":"2026-06-24T05:20:37","date_gmt":"2026-06-24T05:20:37","guid":{"rendered":"https:\/\/www.mickeydesigns.com\/home\/?p=638"},"modified":"2026-06-24T05:32:27","modified_gmt":"2026-06-24T05:32:27","slug":"spatial-audio-mapper-help-troubleshooting-guide","status":"publish","type":"post","link":"https:\/\/www.mickeydesigns.com\/home\/spatial-audio-mapper-help-troubleshooting-guide\/","title":{"rendered":"Spatial Audio Mapper \u2014 Help &amp; Troubleshooting Guide"},"content":{"rendered":"\n<h1 class=\"wp-block-heading\"><strong>Spatial Audio Mapper \u2014 Help &amp; Troubleshooting<\/strong> Guide <\/h1>\n\n\n\n<!-- Spatial Audio Mapper \u2014 Help & Troubleshooting -->\n<!-- Paste this into a Custom HTML block in WordPress -->\n\n<style>\n.sam-guide { max-width: 800px; margin: 0 auto; font-size: 16px; line-height: 1.7; color: inherit; }\n.sam-guide h2 { font-size: 1.4em; margin: 2em 0 0.5em; padding-bottom: 0.3em; border-bottom: 1px solid #e0e0e0; }\n.sam-guide h3 { font-size: 1.1em; margin: 1.6em 0 0.4em; }\n.sam-guide p { margin: 0 0 1em; }\n.sam-guide ul, .sam-guide ol { margin: 0 0 1em 1.5em; padding: 0; }\n.sam-guide li { margin-bottom: 0.4em; }\n.sam-guide code { font-family: monospace; font-size: 0.9em; background: #f4f4f4; padding: 2px 5px; border-radius: 3px; }\n.sam-guide pre { background: #f4f4f4; border-left: 3px solid #ccc; padding: 1em; overflow-x: auto; border-radius: 3px; margin: 0 0 1em; }\n.sam-guide pre code { background: none; padding: 0; }\n.sam-guide table { width: 100%; border-collapse: collapse; margin: 0 0 1.5em; font-size: 0.95em; }\n.sam-guide th { background: #f4f4f4; text-align: left; padding: 8px 12px; border: 1px solid #ddd; font-weight: 600; }\n.sam-guide td { padding: 8px 12px; border: 1px solid #ddd; vertical-align: top; }\n.sam-guide blockquote { border-left: 3px solid #ccc; margin: 1em 0; padding: 0.6em 1.2em; background: #fafafa; color: #555; border-radius: 0 3px 3px 0; }\n.sam-guide blockquote p:last-child { margin: 0; }\n.sam-guide a { color: inherit; }\n.sam-guide strong { font-weight: 600; }\n.sam-toc { background: #fafafa; border: 0.5px solid #ddd; border-radius: 4px; padding: 1rem 1.25rem; margin: 0 0 2em; }\n.sam-toc h3 { margin: 0 0 0.6em; }\n.sam-toc ol { margin: 0; }\n<\/style>\n\n<div class=\"sam-guide\">\n\n<p>Welcome! This guide covers everything you need to get the most out of Spatial Audio Mapper on Apple Vision Pro, plus fixes for the most common issues people run into.<\/p>\n\n<p>If you don&#8217;t find an answer here, email <code>info@mickeydesigns.com<\/code> and include:<\/p>\n\n<ul>\n  <li>The version of Spatial Audio Mapper you&#8217;re running<\/li>\n  <li>Your visionOS version (Settings \u203a General \u203a About)<\/li>\n  <li>A short description of what you were doing when the issue happened<\/li>\n<\/ul>\n\n<div class=\"sam-toc\">\n  <h3>Table of Contents<\/h3>\n  <ol>\n    <li><a href=\"#what-it-does\">What the app does<\/a><\/li>\n    <li><a href=\"#getting-started\">Getting started<\/a><\/li>\n    <li><a href=\"#placing-editing\">Placing and editing sound sources<\/a><\/li>\n    <li><a href=\"#waves-interference\">Understanding the waves and interference nodes<\/a><\/li>\n    <li><a href=\"#audio-controls\">Audio &amp; output controls<\/a><\/li>\n    <li><a href=\"#troubleshooting\">Troubleshooting<\/a><\/li>\n    <li><a href=\"#privacy\">Privacy<\/a><\/li>\n    <li><a href=\"#contact\">Contact<\/a><\/li>\n  <\/ol>\n<\/div>\n\n<h2 id=\"what-it-does\">What the app does<\/h2>\n\n<p>Spatial Audio Mapper turns the room you&#8217;re in into an interactive acoustics visualization. You scan your space with LiDAR, tap real surfaces to drop spatial audio sources, and watch their wave particles travel and bounce around your actual room \u2014 including showing you where the waves from two sources collide as interference nodes.<\/p>\n\n<p>It&#8217;s part teaching tool, part demo of what spatial computing can do that nothing else can.<\/p>\n\n<h2 id=\"getting-started\">Getting started<\/h2>\n\n<h3>1. Open the app<\/h3>\n\n<p>Launch Spatial Audio Mapper from the Home View. You&#8217;ll see the main control window with a header, an Open Immersive Space button, and a few settings sections.<\/p>\n\n<h3>2. Open the immersive space<\/h3>\n\n<p>Tap Open Immersive Space. A prompt will appear that says:<\/p>\n\n<blockquote>\n  <p>Look around to scan your room<\/p>\n<\/blockquote>\n\n<p>Slowly look around your environment so the device can map walls, floor, and ceiling using LiDAR. As geometry is reconstructed, a faint wireframe will appear over your surroundings.<\/p>\n\n<p><strong>Tip:<\/strong> A slow, deliberate scan works better than darting your eyes around. Aim your gaze at each major wall, the floor, and the ceiling once.<\/p>\n\n<h3>3. Tap a surface to place a source<\/h3>\n\n<p>Once you see the wireframe, tap any wall, floor, or ceiling. A colored sphere appears at the exact point you tapped and immediately begins:<\/p>\n\n<ul>\n  <li>Playing a spatial audio tone from that location<\/li>\n  <li>Emitting glowing wave particles outward<\/li>\n<\/ul>\n\n<p>That&#8217;s it \u2014 you&#8217;re mapping your room&#8217;s sound.<\/p>\n\n<h2 id=\"placing-editing\">Placing and editing sound sources<\/h2>\n\n<h3>Choosing the starting color<\/h3>\n\n<p>In the main window, the New source section has a Color picker. Whatever color is selected there is the color of the next source you place. Existing sources are not affected.<\/p>\n\n<h3>Selecting a source<\/h3>\n\n<p>Tap any placed source to select it. A ring lights up around it and the Selected source panel appears in the main window.<\/p>\n\n<h3>Editing a selected source<\/h3>\n\n<p>From the Selected source panel you can:<\/p>\n\n<ul>\n  <li><strong>Change its color<\/strong> \u2014 applied instantly to the sphere and its wave particles.<\/li>\n  <li><strong>Adjust its frequency<\/strong> \u2014 slide between 80 Hz (low) and 1200 Hz (high). Audio and the wave pulse rate update live.<\/li>\n  <li><strong>Delete it<\/strong> \u2014 removes the source and its waves.<\/li>\n  <li><strong>Deselect<\/strong> \u2014 clears the selection without changing the source.<\/li>\n<\/ul>\n\n<h3>Removing sources<\/h3>\n\n<ul>\n  <li><strong>Delete one<\/strong> \u2014 select it and tap Delete source.<\/li>\n  <li><strong>Delete all<\/strong> \u2014 tap Clear All in the Placed sources section of the main window.<\/li>\n<\/ul>\n\n<h3>The 6-source limit<\/h3>\n\n<p>You can have up to 6 sources placed at once. Each source produces many physics-driven particles, so this limit keeps the visualization smooth and the audio mix clean. If you&#8217;ve already placed 6, an orange warning appears, and you&#8217;ll need to delete one before placing another.<\/p>\n\n<h2 id=\"waves-interference\">Understanding the waves and interference nodes<\/h2>\n\n<h3>Wave particles<\/h3>\n\n<p>Each source emits bursts of particles that travel outward at a fixed visual speed. The particles aren&#8217;t decorative \u2014 they physically bounce off the room mesh you scanned, mimicking how real sound reflects off real walls.<\/p>\n\n<p>Higher-frequency sources pulse out particles more often. Lower-frequency sources pulse more slowly.<\/p>\n\n<h3>Interference nodes<\/h3>\n\n<p>When wave particles from two different sources cross paths, you&#8217;ll see a small white flash at that point. This marks an interference node \u2014 the spatial-computing analog of where two real sound waves would constructively or destructively interfere.<\/p>\n\n<p><strong>Try this:<\/strong> place two sources of similar frequency on opposite walls and watch the flashes line up between them.<\/p>\n\n<h2 id=\"audio-controls\">Audio &amp; output controls<\/h2>\n\n<p>In the main window&#8217;s Output section:<\/p>\n\n<ul>\n  <li><strong>Spatial audio<\/strong> \u2014 toggle on\/off to mute or unmute all sources without removing them. Their visualization keeps running.<\/li>\n  <li><strong>Show sound waves<\/strong> \u2014 toggle off to hide the wave particles and focus only on the audio. Sources still emit and you can still hear them.<\/li>\n<\/ul>\n\n<p>These two toggles are independent \u2014 you can run audio-only, visualization-only, both, or neither.<\/p>\n\n<h2 id=\"troubleshooting\">Troubleshooting<\/h2>\n\n<h3>The wireframe never appears<\/h3>\n\n<p>The room isn&#8217;t being mapped. Try, in order:<\/p>\n\n<ol>\n  <li>Make sure you&#8217;ve granted the world-sensing permission when prompted at first launch.<\/li>\n  <li>Look slowly around the room \u2014 direct your gaze at each wall, the floor, and the ceiling at least once.<\/li>\n  <li>Make sure the room is reasonably well lit. LiDAR works in low light, but the visual passthrough that helps the device understand the room benefits from normal lighting.<\/li>\n  <li>Stand a few feet from any wall when starting \u2014 extremely close-up surfaces can be hard for the device to map.<\/li>\n  <li>Close the immersive space (toggle the button off) and reopen it to restart the scan.<\/li>\n<\/ol>\n\n<h3>My tap doesn&#8217;t place a source<\/h3>\n\n<p>A few possibilities:<\/p>\n\n<ul>\n  <li>You haven&#8217;t scanned enough yet. If no wireframe is visible at the tap location, that surface hasn&#8217;t been reconstructed yet. Look at it for a moment first.<\/li>\n  <li>You&#8217;re at the source limit. If &#8220;Placed sources: 6 \/ 6&#8221; is shown with an orange warning, delete a source first.<\/li>\n  <li>You&#8217;re tapping too fast. A 0.4-second debounce prevents accidental duplicates from a double-tap. Wait briefly and tap again.<\/li>\n  <li>You&#8217;re tapping an existing source. That selects it instead of placing a new one. Tap a clear area of a wall, floor, or ceiling.<\/li>\n<\/ul>\n\n<h3>I can&#8217;t hear anything<\/h3>\n\n<ol>\n  <li>Check the Spatial audio toggle in the Output section \u2014 make sure it&#8217;s on.<\/li>\n  <li>Check Apple Vision Pro&#8217;s system volume using the Digital Crown.<\/li>\n  <li>Confirm at least one source is placed and that you haven&#8217;t muted via the system controls.<\/li>\n  <li>If a frequency was set very low, walk closer to the source \u2014 extreme low frequencies can feel quiet on the built-in speakers.<\/li>\n  <li>Try removing all sources and placing a new one \u2014 this resets the audio engine state for that source.<\/li>\n<\/ol>\n\n<h3>The audio sounds like it&#8217;s coming from the wrong place<\/h3>\n\n<p>The audio is anchored to the exact 3D point you tapped. If a source seems off:<\/p>\n\n<ul>\n  <li>Confirm you&#8217;re hearing that source and not one in another part of the room.<\/li>\n  <li>Walk around it \u2014 true spatial audio shifts as you move; if it doesn&#8217;t, restart the immersive space.<\/li>\n  <li>If you&#8217;re wearing AirPods or other Bluetooth headphones, make sure Spatial Audio with head tracking is enabled in Control Center.<\/li>\n<\/ul>\n\n<h3>Wave particles look choppy or stutter<\/h3>\n\n<ul>\n  <li>Reduce the number of placed sources. 6 is the maximum, but very busy rooms or many low-frequency sources at once can be heavier than just a few.<\/li>\n  <li>Toggle Show sound waves off and on to reset the visualization system.<\/li>\n  <li>Close the immersive space and reopen it.<\/li>\n<\/ul>\n\n<h3>Interference flashes never appear<\/h3>\n\n<p>Interference nodes only appear where particles from two different sources physically cross. If you only have one source placed, you&#8217;ll never see one. Place at least two sources and give the particles a moment to travel and meet \u2014 flashes are most common in the space between sources.<\/p>\n\n<h3>The source I deleted is still making sound<\/h3>\n\n<p>Close and reopen the immersive space. If the issue persists, force-quit the app from the Home View and relaunch. Please email support with your visionOS version if this happens repeatedly.<\/p>\n\n<h3>The app crashes on launch<\/h3>\n\n<ol>\n  <li>Restart Apple Vision Pro (hold the top button and Digital Crown until you see the power slider).<\/li>\n  <li>Make sure visionOS is up to date (Settings \u203a General \u203a Software Update).<\/li>\n  <li>Delete and reinstall the app.<\/li>\n  <li>If it still crashes, contact support with your visionOS version.<\/li>\n<\/ol>\n\n<h3>The &#8220;Open Immersive Space&#8221; button does nothing<\/h3>\n\n<p>Another immersive app may already own the space. Close any other immersive experiences from the Home View, then try again.<\/p>\n\n<h2 id=\"privacy\">Privacy<\/h2>\n\n<p>Spatial Audio Mapper uses the room scan only at runtime, only to:<\/p>\n\n<ul>\n  <li>Render the wireframe overlay<\/li>\n  <li>Determine where you tapped<\/li>\n  <li>Let wave particles bounce off real surfaces<\/li>\n<\/ul>\n\n<p>Nothing is recorded, saved, or transmitted. There is no account system, no analytics, and no third-party tracking. The app does not make any network requests.<\/p>\n\n<h2 id=\"contact\">Contact<\/h2>\n\n<p>Questions, bug reports, or feature ideas:<\/p>\n\n<p><code>info@mickeydesigns.com<\/code><\/p>\n\n<p>Please include your visionOS version, the app version, and a short description of what you were doing when the issue happened \u2014 that gets you a useful reply fastest.<\/p>\n\n<\/div>\n","protected":false},"excerpt":{"rendered":"<p>Spatial Audio Mapper \u2014 Help &amp; Troubleshooting Guide Welcome! This guide covers everything you need to get the most out of Spatial Audio Mapper on Apple Vision Pro, plus fixes for the most common issues people run into. If you don&#8217;t find an answer here, email info@mickeydesigns.com and include: The version of Spatial Audio Mapper &#8230; <a title=\"Spatial Audio Mapper \u2014 Help &amp; Troubleshooting Guide\" class=\"read-more\" href=\"https:\/\/www.mickeydesigns.com\/home\/spatial-audio-mapper-help-troubleshooting-guide\/\" aria-label=\"Read more about Spatial Audio Mapper \u2014 Help &amp; Troubleshooting Guide\">Read more<\/a><\/p>\n","protected":false},"author":1,"featured_media":640,"comment_status":"closed","ping_status":"closed","sticky":false,"template":"elementor_header_footer","format":"standard","meta":{"footnotes":""},"categories":[20],"tags":[],"class_list":["post-638","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-help"],"_links":{"self":[{"href":"https:\/\/www.mickeydesigns.com\/home\/wp-json\/wp\/v2\/posts\/638","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/www.mickeydesigns.com\/home\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/www.mickeydesigns.com\/home\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/www.mickeydesigns.com\/home\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/www.mickeydesigns.com\/home\/wp-json\/wp\/v2\/comments?post=638"}],"version-history":[{"count":1,"href":"https:\/\/www.mickeydesigns.com\/home\/wp-json\/wp\/v2\/posts\/638\/revisions"}],"predecessor-version":[{"id":639,"href":"https:\/\/www.mickeydesigns.com\/home\/wp-json\/wp\/v2\/posts\/638\/revisions\/639"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/www.mickeydesigns.com\/home\/wp-json\/wp\/v2\/media\/640"}],"wp:attachment":[{"href":"https:\/\/www.mickeydesigns.com\/home\/wp-json\/wp\/v2\/media?parent=638"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/www.mickeydesigns.com\/home\/wp-json\/wp\/v2\/categories?post=638"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/www.mickeydesigns.com\/home\/wp-json\/wp\/v2\/tags?post=638"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}