feat: Speaker Toy

EXILED/Exiled.API/Features/Toys/Speaker.cs

@@ -5,6 +5,12 @@
 // </copyright>
 // -----------------------------------------------------------------------
 
+using System.IO;
+using UnityEngine;
+using VoiceChat;
+using VoiceChat.Networking;
+using VoiceChat.Playbacks;
+
 namespace Exiled.API.Features.Toys
 {
     using AdminToys;
@@ -80,5 +86,39 @@
             get => Base.NetworkMinDistance;
             set => Base.NetworkMinDistance = value;
         }
+
+        /// <summary>
+        /// Creates a new <see cref="Speaker"/>.
+        /// </summary>
+        /// <param name="position">The position of the <see cref="Speaker"/>.</param>
+        /// <param name="rotation">The rotation of the <see cref="Speaker"/>.</param>
+        /// <param name="scale">The scale of the <see cref="Speaker"/>.</param>
+        /// <param name="spawn">Whether the <see cref="Speaker"/> should be initially spawned.</param>
+        /// <returns>The new <see cref="Speaker"/>.</returns>
+        public static Speaker Create(Vector3? position /*= null*/, Vector3? rotation /*= null*/, Vector3? scale /*= null*/, bool spawn /*= true*/)
+        {
+            Speaker speaker = new(UnityEngine.Object.Instantiate(ToysHelper.Speaker))
+            {
+                Position = position ?? Vector3.zero,
+                Rotation = Quaternion.Euler(rotation ?? Vector3.zero),
+                Scale = scale ?? Vector3.one,
+            };
+
+            if (spawn)
+                speaker.Spawn();
+
+            speaker.Base.Playback = new SpeakerToyPlaybackBase();
+            speaker.Base.Playback.Buffer = new PlaybackBuffer();
+
+            return speaker;
+        }
+
+        /// <summary>
+        /// Todo.
+        /// </summary>
+        public void Play()
+        {
+            // TODO
+        }
     }
 }

EXILED/Exiled.API/Features/Toys/ToysHelper.cs

@@ -23,6 +23,7 @@ public static class ToysHelper
         private static ShootingTarget sportShootingTargetObject;
         private static ShootingTarget dboyShootingTargetObject;
         private static ShootingTarget binaryShootingTargetObject;
+        private static SpeakerToy speakerObject;
 
         /// <summary>
         /// Gets the base <see cref="PrimitiveObjectToy"/> to instantiate when creating a new primitive.
@@ -138,5 +139,28 @@ public static ShootingTarget BinaryShootingTargetObject
                 return binaryShootingTargetObject;
             }
         }
+
+        /// <summary>
+        /// Gets the base <see cref="Speaker"/> to instantiate when creating a new speaker.
+        /// </summary>
+        public static SpeakerToy Speaker
+        {
+            get
+            {
+                if (speakerObject is null)
+                {
+                    foreach (GameObject gameObject in NetworkClient.prefabs.Values)
+                    {
+                        if ((gameObject.name == "SpeakerToy") && gameObject.TryGetComponent(out SpeakerToy shootingTarget))
+                        {
+                            speakerObject = shootingTarget;
+                            break;
+                        }
+                    }
+                }
+
+                return speakerObject;
+            }
+        }
     }
 }