The Audio Profiler module monitors the performance of the audio system in your application, such as the total load and voice counts. To open the Profiler window, go to menu: Window > Analysis > Profiler.
The Audio ProfilerA window that helps you to optimize your game. It shows how much time is spent in the various areas of your game. For example, it can report the percentage of time spent rendering, animating, or in your game logic. More info
See in Glossary module’s chart tracks the time spent on the audio in your application. The timings are divided into four categories. To change the order of the categories in the chart, you can drag and drop them in the chart’s legend. You can also click a category’s colored legend to toggle its display.
Chart | Description |
---|---|
Playing Audio Sources | The total number of audio sources playing in the SceneA Scene contains the environments and menus of your game. Think of each unique Scene file as a unique level. In each Scene, you place your environments, obstacles, and decorations, essentially designing and building your game in pieces. More info See in Glossary at the frame selected. This is useful to monitor to see if the audio is overloaded. |
Audio Voices | The number of audio (FMOD channels) voices used in the selected frame. |
Total Audio CPU | The amount of CPU usage the audio used in the selected frame. |
Total Audio Memory | The amount of RAM the audio engine used in the selected frame. |
When you select the Audio Profiler module, the details pane below it displays a breakdown of the audio data for the selected frame. There are two views you can use to inspect the audio profiler data: Simple and Detailed. To change the display, use the top-left dropdown in the details pane (set to Simple by default).
The Simple view contains the following information about the audio data for the frame you selected.
Data | Description |
---|---|
Total Audio Sources | Total number of audio sourcesA component which plays back an Audio Clip in the scene to an audio listener or through an audio mixer. More info See in Glossary in the Scene. |
Playing Audio Sources | Total number of audio sources playing in the Scene |
Paused Audio Sources | The total number of paused audio sources in the Scene. |
Audio Clip Count | Total number of audio clipsA container for audio data in Unity. Unity supports mono, stereo and multichannel audio assets (up to eight channels). Unity can import .aif, .wav, .mp3, and .ogg audio file format, and .xm, .mod, .it, and .s3m tracker module formats. More info See in Glossary in the Scene. |
Audio Voices | The total number of audio channels (FMOD channels) your Project uses. |
Total Audio CPU | The total amount of CPU the audio uses. |
DSP CPU | The amount of CPU your Project uses by mixing, audio effectsAny effect that can modify the output of Audio Mixer components, such as filtering frequency ranges of a sound or applying reverb. More info See in Glossary, and decompression of non-streamed sounds that have the Compressed In Memory load type. This does not cover the CPU required for sounds that Unity decodes in the background whose load type is Decompress On Load and have the Load In Background flag checked. |
Streaming CPU | The amount of CPU your Project uses to stream the audio in your application. |
Other CPU | General CPU overhead not covered by the above. |
Total Audio Memory | The amount of memory the audio uses in your Project. |
Streaming File Memory | The amount of memory that audio files with the load type of Streaming use for short-term buffering of compressed audio data as it is progressively read from disk. |
Streaming Decode Memory | The amount of memory that audio files with the load type of Streaming use for buffering the decoded sample stream. |
Sample Sound Memory | The amount of memory that audio files with the load type of Decompress On Load use for the decompressed sample data. Note: Unity pools the memory that the audio system allocates and it keeps growing until it reaches saturation over the run time of your application. The audio system internally reuses the allocated memory, which cannot be compacted during runtime. |
Other Memory | Overhead caused by various subsystems in the audio system. |
The Detailed view contains all of the information in the Simple view, and additionally contains detailed per-frame logging of audio events. You can view these either as Channels, Groups, or Channels and Groups. To open this view, open the dropdown at the top of the module details pane, select Detailed, and then select one of the views from the toolbarA row of buttons and basic controls at the top of the Unity Editor that allows you to interact with the Editor in various ways (e.g. scaling, translation). More info
See in Glossary at the top of the pane.
The Groups view shows the hierarchy of the buses in the audio mixer. The Channels and Groups view displays this information alongside information about the playing sounds.
Select the Reset play count on play to reset the number in the Plays column the next time you click Play in the Player window, or when you connect to a new target device.
The information in the detailed view is arranged into the following columns:
Column | Description |
---|---|
Object | The GameObjectThe fundamental object in Unity scenes, which can represent characters, props, scenery, cameras, waypoints, and more. A GameObject’s functionality is defined by the Components attached to it. More info See in Glossary that contains the Audio Source playing the audio. |
Asset | The audio Asset that the corresponding GameObject Audio Source is playing. |
Volume | The volume the Audio Source applies to the audio. This is a combination of its overall volume property, and the dynamic volume that the distance-dependent attenuation curve applies. |
Audibility | The actual level at which the audio plays. This is the sum of the Audio Source’s volume and the other attenuations the mixer channels apply to it. |
Plays | The number of times Unity has played the audio. This information is useful to debug logic errors where Unity might not use some audio files. |
3D | Displays YES if the audio uses dynamic distance-dependent attenuation and directional panning. |
Paused | Displays YES if the audio is paused in this frame. |
Muted | Displays YES if the audio is muted in this frame. |
Virtual | Displays YES if the audio is suspended because of the Max Real Voice Count, which you can set in the Audio Project Settings. The Max Real Voice Count sets the maximum amount of Audio Sources that Unity simultaneously plays at once. If this displays true, Unity has prioritized other audio that has higher audibility or priority in this frame. |
OneShot | Displays YES if AudioSource.PlayOneShot() played the audio. |
Looped | Displays YES if AudioSource.Play() played the audio. |
Distance | The distance from the Audio Source to the AudioListener. |
MinDist | The minimum distance defined on the AudioSource curve editor. This defines a spherical region around the audio where the volume stays at a constant level within it. |
MaxDist | The maximum distance defined on the Audio Source curve editor. This defines a spherical region around the audio where the volume stays at a constant level outside of it. |
Time | The current relative time in the audio’s playback. While the audio playback is paused, this time does not advance. |
Duration | The length of the audio in seconds. |
Did you find this page useful? Please give it a rating:
Thanks for rating this page!
What kind of problem would you like to report?
Thanks for letting us know! This page has been marked for review based on your feedback.
If you have time, you can provide more information to help us fix the problem faster.
Provide more information
You've told us this page needs code samples. If you'd like to help us further, you could provide a code sample, or tell us about what kind of code sample you'd like to see:
You've told us there are code samples on this page which don't work. If you know how to fix it, or have something better we could use instead, please let us know:
You've told us there is information missing from this page. Please tell us more about what's missing:
You've told us there is incorrect information on this page. If you know what we should change to make it correct, please tell us:
You've told us this page has unclear or confusing information. Please tell us more about what you found unclear or confusing, or let us know how we could make it clearer:
You've told us there is a spelling or grammar error on this page. Please tell us what's wrong:
You've told us this page has a problem. Please tell us more about what's wrong:
Thank you for helping to make the Unity documentation better!
Your feedback has been submitted as a ticket for our documentation team to review.
We are not able to reply to every ticket submitted.
When you visit any website, it may store or retrieve information on your browser, mostly in the form of cookies. This information might be about you, your preferences or your device and is mostly used to make the site work as you expect it to. The information does not usually directly identify you, but it can give you a more personalized web experience. Because we respect your right to privacy, you can choose not to allow some types of cookies. Click on the different category headings to find out more and change our default settings. However, blocking some types of cookies may impact your experience of the site and the services we are able to offer.
More information
These cookies enable the website to provide enhanced functionality and personalisation. They may be set by us or by third party providers whose services we have added to our pages. If you do not allow these cookies then some or all of these services may not function properly.
These cookies allow us to count visits and traffic sources so we can measure and improve the performance of our site. They help us to know which pages are the most and least popular and see how visitors move around the site. All information these cookies collect is aggregated and therefore anonymous. If you do not allow these cookies we will not know when you have visited our site, and will not be able to monitor its performance.
These cookies may be set through our site by our advertising partners. They may be used by those companies to build a profile of your interests and show you relevant adverts on other sites. They do not store directly personal information, but are based on uniquely identifying your browser and internet device. If you do not allow these cookies, you will experience less targeted advertising. Some 3rd party video providers do not allow video views without targeting cookies. If you are experiencing difficulty viewing a video, you will need to set your cookie preferences for targeting to yes if you wish to view videos from these providers. Unity does not control this.
These cookies are necessary for the website to function and cannot be switched off in our systems. They are usually only set in response to actions made by you which amount to a request for services, such as setting your privacy preferences, logging in or filling in forms. You can set your browser to block or alert you about these cookies, but some parts of the site will not then work. These cookies do not store any personally identifiable information.