Newer
Older
HoloAnatomy / Assets / HoloToolkit / SpatialSound / Scripts / UAudioManager / SpatialSoundSettings.cs
SURFACEBOOK2\jackwynne on 25 May 2018 4 KB v1
// Copyright (c) Microsoft Corporation. All rights reserved.
// Licensed under the MIT License. See LICENSE in the project root for license information.

using System;
using UnityEngine;

namespace HoloToolkit.Unity
{
    /// <summary>
    /// Room sizes for the Microsoft Spatial Sound Spatializer.
    /// </summary>
    public enum SpatialSoundRoomSizes
    {
        Small,          // Office to small conference room
        Medium,         // Large conference room
        Large,          // Auditorium
        None            // Similar to being outdoors
    }

    /// <summary>
    /// The SpatialSoundSettings class provides a set of methods that simplify making modifications
    /// to Microsoft Spatial Sound Spatializer parameters.
    /// </summary>
    public static class SpatialSoundSettings
    {
        public const SpatialSoundRoomSizes DefaultSpatialSoundRoom = SpatialSoundRoomSizes.Small;

        // Ranges and default values for the Microsoft Spatial Sound Spatializer parameters.
        // See: <https://msdn.microsoft.com/en-us/library/windows/desktop/mt186602(v=vs.85).aspx>
        // for more details.
        public const float MinimumGainDecibels = -96.0f;
        public const float MaximumGainDecibels = 12.0f;
        public const float MinimumUnityGainDistanceMeters = 0.05f;
        public const float MaximumUnityGainDistanceMeters = float.MaxValue;
        public const float DefaultMinGain = MinimumGainDecibels;
        public const float DefaultMaxGain = MaximumGainDecibels;
        public const float DefaultUnityGainDistance = 1.0f;

        /// <summary>
        /// The available Microsoft Spatial Sound Spatializer parameters.
        /// </summary>
        private enum SpatialSoundParameters
        {
            RoomSize = 1
        }

        /// <summary>
        /// Sets the Spatial Sound room size.
        /// </summary>
        /// <param name="audioSource">The AudioSource on which the room size will be set.</param>
        /// <param name="room">The desired room size.</param>
        public static void SetRoomSize(AudioSource audioSource, SpatialSoundRoomSizes room)
        {
            SetParameter(audioSource, SpatialSoundParameters.RoomSize, (float)room);
        }

        /// <summary>
        /// Sets the Spatial Sound minimum gain.
        /// </summary>
        /// <param name="audioSource">The AudioSource on which the minimum gain will be set.</param>
        /// <param name="room">The desired minimum gain, in decibels.</param>
        [Obsolete("This spatializer parameter is no longer used, volume attenuation is controlled by the unity volume curve.")]
        public static void SetMinGain(AudioSource audioSource, float gain)
        {
        }

        /// <summary>
        /// Sets the Spatial Sound maximum gain.
        /// </summary>
        /// <param name="audioSource">The AudioSource on which the maximum gain will be set.</param>
        /// <param name="room">The desired maximum gain, in decibels.</param>
        [Obsolete("This spatializer parameter is no longer used, volume attenuation is controlled by the unity volume curve.")]
        public static void SetMaxGain(AudioSource audioSource, float gain)
        {
        }

        /// <summary>
        /// Sets the Spatial Sound unity gain distance.
        /// </summary>
        /// <param name="audioSource">The AudioSource on which the unity gain distance will be set.</param>
        /// <param name="room">The distance, in meters, at which the AudioSource gain will be 0 decibels.</param>
        [Obsolete("This spatializer parameter is no longer used, volume attenuation is controlled by the unity volume curve.")]
        public static void SetUnityGainDistance(AudioSource audioSource, float distance)
        {
        }

        /// <summary>
        /// Sets a Spatial Sound parameter on an AudioSource.
        /// </summary>
        /// <param name="audioSource">The AudioSource on which the specified parameter will be set.</param>
        /// <param name="param">The Spatial Sound parameter to set.</param>
        /// <param name="value">The value to set for the Spatial Sound parameter.</param>
        private static void SetParameter(AudioSource audioSource, SpatialSoundParameters param, float value)
        {
            audioSource.SetSpatializerFloat((int)param, value);
        }
    }
}