AudioImporterSampleSettings

Description

This structure contains a collection of settings used to define how an AudioClip should be imported.

Unity uses this structure with the AudioImporter to define how to import and load the AudioClip within the Scene. This is useful if you want to change the import settings of a group of audio clips to the same settings programmatically. You can also change these in the Inspector of the audio clip.

// This script creates a custom menu item. If you click this item, it reimports the audio files
// (from a certain directory) with new import settings. The settings contain overrides for 
// multiple platforms (Default, Standalone, and Android). 

using UnityEditor;
using UnityEngine;

public class AudioImporterSampleSettingsExample : MonoBehaviour
{
    [MenuItem("Tools/Apply Audio Overrides for Multiple Platforms")]
    public static void ApplyOverrides()
    {
        // Path to your audio files. Place your audio files in the following directory.
        string folderPath = "Assets/Sounds"; 
        // Find all audio clips in this folder. 
        string[] guids = AssetDatabase.FindAssets("t:AudioClip", new[] { folderPath });

        // Loop through the audio clips in the folder. 
        foreach (string guid in guids)
        {
            string assetPath = AssetDatabase.GUIDToAssetPath(guid);
            // Get the importer for this audio file. 
            AudioImporter importer = AssetImporter.GetAtPath(assetPath) as AudioImporter;

            // Change settings for the default platform. 
            AudioImporterSampleSettings defaultSettings = new AudioImporterSampleSettings
            {
                loadType = AudioClipLoadType.DecompressOnLoad,
                compressionFormat = AudioCompressionFormat.PCM,
                sampleRateSetting = AudioSampleRateSetting.PreserveSampleRate,
                sampleRateOverride = 44100,
                quality = 1.0f
            };
            importer.defaultSampleSettings = defaultSettings;

            // Set override settings for Standalone platform. 
            AudioImporterSampleSettings standaloneSettings = new AudioImporterSampleSettings
            {
                loadType = AudioClipLoadType.CompressedInMemory, 
                compressionFormat = AudioCompressionFormat.Vorbis, 
                sampleRateSetting = AudioSampleRateSetting.OptimizeSampleRate,
                quality = 0.5f
            };
            importer.SetOverrideSampleSettings(BuildTargetGroup.Standalone, standaloneSettings);

            // Set override settings for the Android platform. 
            AudioImporterSampleSettings androidSettings = new AudioImporterSampleSettings
            {
                loadType = AudioClipLoadType.Streaming, 
                compressionFormat = AudioCompressionFormat.ADPCM, 
                sampleRateSetting = AudioSampleRateSetting.OptimizeSampleRate,
                quality = 0.6f 
            };
            importer.SetOverrideSampleSettings(BuildTargetGroup.Android, androidSettings);


            // Reimport the audio file with new changes. 
            AssetDatabase.ImportAsset(assetPath, ImportAssetOptions.ForceUpdate);
            Debug.Log($"Successfully applied overrides for: {assetPath}");
        }
    }
}

Properties