feat(Util): Add custom play audio at point

Author: jcs090218

Assets/JCSUnity/Scripts/Util/JCS_Util.cs

@@ -1243,6 +1243,30 @@ public static float GetLayerWeight(Animator ator, int index)
 
         #endregion
 
+        #region Audio
+
+        /// <summary>
+        /// Same with function `AudioSource.PlayClipAtPoint` with different
+        /// default `spatialBlend` value.
+        /// </summary>
+        public static void PlayClipAtPoint(
+            AudioClip clip, 
+            Vector3 position, 
+            float volume, 
+            float spatialBlend)
+        {
+            var gameObject = new GameObject("One shot audio");
+            gameObject.transform.position = position;
+            var audioSource = gameObject.AddComponent<AudioSource>();
+            audioSource.clip = clip;
+            audioSource.spatialBlend = spatialBlend;
+            audioSource.volume = volume;
+            audioSource.Play();
+            Object.Destroy(gameObject, clip.length * ((Time.timeScale < 0.01f) ? 0.01f : Time.timeScale));
+        }
+
+        #endregion
+
         #region Gameplay
 
         /// <summary>

docs/ScriptReference/Util/JCS_Util.md

@@ -53,4 +53,5 @@ All code utility is stored here.
 | IsSceneExists                        | Returns true if the scene 'name' exists and is in your Build settings, false otherwise.           |
 | SetLayerWeight                       | Sets the weight of the layer at the given name.                                                   |
 | GetLayerWeight                       | Returns the weight of the layer at the specified name.                                            |
+| PlayClipAtPoint                      | Same with function `AudioSource.PlayClipAtPoint` with different default `spatialBlend` value.     |
 | IsSameTribe                          | Check if the live object is the same tribe.                                                       |