using FMODUnity;
using FMOD.Studio;
// Типы включены для справки и не должны явно включаться в функциональный код

// воспроизводит звуковое событие как 2D-звук
RuntimeManager.PlayOneShot(EventReference soundEvent);

// воспроизводит звуковое событие в фиксированной точке
RuntimeManager.PlayOneShot(EventReference soundEvent, Vector3 startLocation);

// воспроизводит звуковое событие с привязкой к объекту
RuntimeManager.PlayOneShotAttached(EventReference soundEvent, GameObject targetObject);

// создаёт и сохраняет экземпляр звукового события
EventInstance soundInstance = RuntimeManager.CreateInstance(EventReference soundEvent);

// запускает воспроизведение указанного экземпляра звукового события
soundInstance.start();

// останавливает воспроизведение с затуханием или без него
soundInstance.stop(STOP_MODE.ALLOWFADEOUT);
soundInstance.stop(STOP_MODE.IMMEDIATE);

// прикрепляет экземпляр к объекту для трёхмерного позиционирования
RuntimeManager.AttachInstanceToGameObject(soundInstance, gameObject);
RuntimeManager.AttachInstanceToGameObject(soundInstance, transform, rigidbody);

// вручную настраивает 3D-атрибуты экземпляра
soundInstance.set3DAttributes(RuntimeUtils.To3DAttributes(transform));

// получает звуковую шину (lowercase 'bus:/'!)
Bus aBus = RuntimeManager.GetBus("bus:/SFX");

// останавливает все события на шине
aBus.stopAllEvents(STOP_MODE.ALLOWFADEOUT);

// снимает ближайшую точку сустейна (Key Off)
// ВАЖНО: в FMOD 2.02+ метод triggerCue() переименован в keyOff()
soundInstance.keyOff();

// устанавливает значение параметра по имени
soundInstance.setParameterByName(string parameterName, float parameterValue);

// устанавливает значение параметра по кэшированному идентификатору (быстрее)
soundInstance.setParameterByID(PARAMETER_ID parameterID, float parameterValue);

// устанавливает несколько параметров за один вызов
soundInstance.setParametersByIDs(PARAMETER_ID[] ids, float[] values, int count);

// освобождает инстанс из памяти (обязательно к каждому CreateInstance)
soundInstance.release();

// устанавливает глобальный параметр (не привязан к event)
RuntimeManager.StudioSystem.setParameterByName("TimeOfDay", 0.5f);

using UnityEngine;
using FMODUnity;

public class FMODUnityPositioningASound : MonoBehaviour
{
    [SerializeField] private EventReference aSound;
    [SerializeField] private Vector3 aLocation;

    public void PlayASoundAtALocation()
    {
        RuntimeManager.PlayOneShot(aSound, aLocation);
    }
}

using UnityEngine;
using FMODUnity;

public class FMODUnityPositioningAnotherSound : MonoBehaviour
{
    [SerializeField] private EventReference aSound;
    [SerializeField] private GameObject anObject;

    public void PlayASoundOnAnObject()
    {
        RuntimeManager.PlayOneShotAttached(aSound, anObject);
    }
}

using UnityEngine;
using FMOD.Studio;
using FMODUnity;

public class FMODUnityCallingCues : MonoBehaviour
{
    [SerializeField] private EventReference someMusic;
    private EventInstance someMusicInstance;

    private void Awake()
    {
        someMusicInstance = RuntimeManager.CreateInstance(someMusic);
        someMusicInstance.start();
    }

    // Старый API:  someMusicInstance.triggerCue();  // больше не компилируется в 2.02+
    // Новый API:  someMusicInstance.keyOff();       // правильно
    public void TriggerSomeCue()
    {
        someMusicInstance.keyOff();
    }

    private void OnDestroy()
    {
        someMusicInstance.stop(STOP_MODE.IMMEDIATE);
        someMusicInstance.release();
    }
}

using UnityEngine;
using FMODUnity;

public class FMODUnityEmitterReferences : MonoBehaviour
{
    [SerializeField] private StudioEventEmitter anEmitter;
    [SerializeField] private string parameterName = "Intensity";
    [SerializeField] private float parameterValue = 1f;

    public void PlayEmitterAndSetParameter()
    {
        anEmitter.Play();
        anEmitter.SetParameter(parameterName, parameterValue);
    }

    public void StopEmitter()
    {
        anEmitter.Stop();
    }
}

using UnityEngine;
using FMOD.Studio;
using FMODUnity;

public class FMODUnitySnapshots : MonoBehaviour
{
    // Путь вида "snapshot:/Underwater", "snapshot:/Slowmo" и т.д.
    [SerializeField] private EventReference aGroupSnapshot;
    private EventInstance snapshotInstance;
    private bool isActive;

    private void Awake()
    {
        snapshotInstance = RuntimeManager.CreateInstance(aGroupSnapshot);
    }

    public void StartSnapshot()
    {
        if (isActive) return;
        snapshotInstance.start();
        isActive = true;
    }

    public void StopSnapshot()
    {
        if (!isActive) return;
        // ALLOWFADEOUT уважает snapshot AHDSR (плавный переход обратно)
        snapshotInstance.stop(STOP_MODE.ALLOWFADEOUT);
        isActive = false;
    }

    private void OnDestroy()
    {
        snapshotInstance.release();
    }
}