ItemSoundHandler.c

См. документацию.

class SoundParameters
{
    float m_FadeIn  = 0;
    float m_FadeOut = 0;
    bool m_Loop   = false;
}
 
/*
Provides functionality to start item related sound from server and synchronize it to clients 
Useful in situations where unique animation can't be used to bind the sound
 
Steps to add new item sound:
    1) Add new sound ID to SoundConstants class
    2) Override InitItemSounds() method on subject item to link the new sound ID to a soundset 
        2.5) Generally soundset is retreived by adding override to the subject item class, but retreiving from config or using other means could also be used here
    3) Start sound using ItemBase::StartItemSoundServer(int id) called from server side
        3.5) For looped sounds which do not end on their own, use ItemBase::StopItemSoundServer(int id)
 
Limitations:
    Avoid starting two sounds at the same time using this handler as just single variable is used for synchronization (can be solved by secondary synch var if need arises)
 
*/
class ItemSoundHandler : Managed
{
    protected ItemBase m_Parent;
    
    protected ref map<int, ref EffectSound> m_PlayingSounds;
    protected ref map<int, string> m_AvailableSoundsets;
    protected ref map<int, ref SoundParameters> m_SoundParamsMap;
    
    void ItemSoundHandler(ItemBase parent)
    {
        m_Parent = parent;
        Init();
    }
    
    void ~ItemSoundHandler()
    {
        if (!m_PlayingSounds)
            return;
        
        foreach (EffectSound sound : m_PlayingSounds)
        {
            if (sound)
                sound.SoundStop();
        }
    }
    
    void Init()
    {
        m_PlayingSounds = new map<int, ref EffectSound>();
        m_AvailableSoundsets = new map<int, string>();
        m_SoundParamsMap = new map<int, ref SoundParameters>();
    }
    
    void PlayItemSoundClient(int id, int slotId = InventorySlots.INVALID)
    {       
        InventoryItemType itemType = m_Parent.GetInventoryItemType();
        
        string soundSet = GetSoundSetForEvent(id, slotId);
        if (soundSet == string.Empty)
        {
            Debug.Log("No soundset defined for sound event id " + typename.EnumToString(SoundConstants, id) + ". Item: " + m_Parent.GetType() + " | Slot ID: " + slotId);
            return;
        }
        
        if (m_PlayingSounds.Get(id)) // already playing
            return;
        
        EffectSound sound;
        SoundParameters params = m_SoundParamsMap.Get(id);
        vector position = m_Parent.GetPosition();     
        
        if (params)
            sound = SEffectManager.PlaySoundCachedParams(soundSet, position, params.m_FadeIn, params.m_FadeOut, params.m_Loop);
        else
            sound = SEffectManager.PlaySound(soundSet, position);
        
        if (sound)
            sound.SetAutodestroy(true);
        else
            Debug.Log("Null when creating sound from set: " + soundSet + " Item: " + m_Parent.GetType() );
        
        m_PlayingSounds.Insert(id, sound);
    }
    
    string GetSoundSetForEvent(int id, int slotId = InventorySlots.INVALID)
    {
        string soundSet;
        InventoryItemType itemType = m_Parent.GetInventoryItemType();
        
        switch (id)
        {
            case SoundConstants.ITEM_ATTACH:
            {
                if (itemType)
                    soundSet = itemType.GetSlotAttachSoundSet(slotId);
                if (soundSet == "")
                    soundSet = m_AvailableSoundsets[id];
                break;
            }
            case SoundConstants.ITEM_DETACH:
            {
                if (itemType)
                    soundSet = itemType.GetSlotDetachSoundSet(slotId);
                if (soundSet == "")
                    soundSet = m_AvailableSoundsets[id];
                break;
            }
            default:
            {
                soundSet = m_AvailableSoundsets[id];
                break;
            }
        }
        return soundSet;
    }
    
    void StopItemSoundClient(int id)
    {
        if (g_Game.IsHeadlessOrDedicatedServer())
            return;
                
        EffectSound sound = m_PlayingSounds.Get(id);
        if (sound)
        {
            sound.SetSoundFadeOut(0.1);
            sound.SoundStop();
        }
        
        m_PlayingSounds.Remove(id);
    }
    
    void AddSound(int sound, string soundset, SoundParameters params = null)
    {
        m_AvailableSoundsets.Insert(sound, soundset);
        
        if (params)
            m_SoundParamsMap.Insert(sound, params);
    }
}