Add sendAudio method to Bot

2024-10-08 13:41:56 -04:00 · 2024-10-08 13:41:56 -04:00 · 3623b63eaa
commit 3623b63eaa
parent a9a6d5a2b3
6 changed files with 214 additions and 0 deletions
--- a/src/TgBotLib/Methods/SendAudio.php
+++ b/src/TgBotLib/Methods/SendAudio.php
@ -0,0 +1,136 @@
+<?php
+
+    namespace TgBotLib\Methods;
+
+    use TgBotLib\Abstracts\Method;
+    use TgBotLib\Bot;
+    use TgBotLib\Enums\Methods;
+    use TgBotLib\Enums\Types\ParseMode;
+    use TgBotLib\Exceptions\TelegramException;
+    use TgBotLib\Interfaces\ObjectTypeInterface;
+    use TgBotLib\Objects\Message;
+    use TgBotLib\Objects\MessageEntity;
+    use TgBotLib\Objects\ReplyParameters;
+
+    class SendAudio extends Method
+    {
+        /**
+         * Use this method to send audio files, if you want Telegram clients to display them in the music player.
+         * Your audio must be in the .MP3 or .M4A format. On success, the sent Message is returned. Bots can currently
+         * send audio files of up to 50 MB in size, this limit may be changed in the future.
+         *
+         * For sending voice messages, use the SendVoice method instead.
+         *
+         * @param Bot $bot
+         * @param array $parameters
+         * @return Message
+         * @throws TelegramException
+         */
+        public static function execute(Bot $bot, array $parameters=[]): Message
+        {
+            // Handle object conversions
+            if(isset($parameters['parse_mode']) && $parameters['parse_mode'] instanceof ParseMode)
+            {
+                $parameters['parse_mode'] = $parameters['parse_mode']->value;
+            }
+
+            if(isset($parameters['caption_entities']) && is_array($parameters['caption_entities']))
+            {
+                $entities = [];
+                foreach($parameters['caption_entities'] as $entity)
+                {
+                    if($entity instanceof MessageEntity)
+                    {
+                        $entities[] = $entity->toArray();
+                    }
+                    else
+                    {
+                        $entities[] = $entity;
+                    }
+                }
+                $parameters['caption_entities'] = $entities;
+            }
+
+            if(isset($parameters['reply_parameters']) && $parameters['reply_parameters'] instanceof ReplyParameters)
+            {
+                $parameters['reply_parameters'] = $parameters['reply_parameters']->toArray();
+            }
+
+            if(isset($parameters['reply_markup']) && $parameters['reply_markup'] instanceof ObjectTypeInterface)
+            {
+                $parameters['reply_markup'] = $parameters['reply_markup']->toArray();
+            }
+
+            // Handle file uploads
+            $hasLocalAudio = isset($parameters['audio']) && is_string($parameters['audio']) && file_exists($parameters['audio']) && is_file($parameters['audio']);
+            $hasLocalThumb = isset($parameters['thumbnail']) && is_string($parameters['thumbnail']) && file_exists($parameters['thumbnail']) && is_file($parameters['thumbnail']);
+
+            if ($hasLocalAudio || $hasLocalThumb)
+            {
+                $files = [];
+
+                if ($hasLocalAudio)
+                {
+                    $files['audio'] = $parameters['audio'];
+                    unset($parameters['audio']);
+                }
+
+                if ($hasLocalThumb)
+                {
+                    $files['thumbnail'] = $parameters['thumbnail'];
+                    unset($parameters['thumbnail']);
+                }
+
+                if (count($files) > 1)
+                {
+                    // Multiple files to upload
+                    $curl = self::buildMultiUpload($bot, Methods::SEND_AUDIO->value, $files, $parameters);
+                }
+                else
+                {
+                    // Single file to upload
+                    $fileParam = array_key_first($files);
+                    $curl = self::buildUpload($bot, Methods::SEND_AUDIO->value, $fileParam, $files[$fileParam], $parameters);
+                }
+
+                return Message::fromArray(self::executeCurl($curl));
+            }
+
+            // If no local files to upload, use regular POST method
+            return Message::fromArray(self::executeCurl(self::buildPost($bot, Methods::SEND_AUDIO->value, $parameters)));
+        }
+
+        /**
+         * @inheritDoc
+         */
+        public static function getRequiredParameters(): ?array
+        {
+            return [
+                'chat_id',
+                'audio'
+            ];
+        }
+
+        /**
+         * @inheritDoc
+         */
+        public static function getOptionalParameters(): ?array
+        {
+            return [
+                'business_connection_id',
+                'message_thread_id',
+                'caption',
+                'parse_mode',
+                'caption_entities',
+                'duration',
+                'performer',
+                'title',
+                'thumbnail',
+                'disable_notification',
+                'protect_content',
+                'message_effect_id',
+                'reply_parameters',
+                'reply_markup'
+            ];
+        }
+    }