A special attribute that can be used to control the automatic sound caching of sounds in the sound server.
One of "permanent", "volatile", "never". "permanent" will cause this sample to be cached in the server permanently. This is useful for very frequently used sound events such as those used for input feedback. "volatile" may be used for cacheing sounds in the sound server temporarily. They will expire after some time or on cache pressure. Finally, "never" may be used for sounds that should never be cached, because they are only generated very seldomly or even only once at most (such as desktop login sounds).
If this attribute is not explicitly passed to play_simple or play_full it will default to "never". If it is not explicitly passed to cache it will default to "permanent".
If the list of attributes is handed on to the sound server this attribute is stripped from it.