Update sendVoice & sendDice methods

Author: eldarQa

src/BotApi.php

@@ -812,14 +812,17 @@ public function sendAnimation(
      * On success, the sent Message is returned.
      * Bots can currently send voice messages of up to 50 MB in size, this limit may be changed in the future.
      *
-     * @param int|string $chatId chat_id or @channel_name
+     * @param int|string       $chatId chat_id or @channel_name
      * @param \CURLFile|string $voice
-     * @param int|null $duration
-     * @param int|null $replyToMessageId
+     * @param string           $caption Voice message caption, 0-1024 characters after entities parsing
+     * @param int|null         $duration
+     * @param int|null         $replyToMessageId
      * @param Types\ReplyKeyboardMarkup|Types\ReplyKeyboardHide|Types\ForceReply|
      *        Types\ReplyKeyboardRemove|null $replyMarkup
-     * @param bool $disableNotification
-     * @param string|null $parseMode
+     * @param bool             $disableNotification
+     * @param bool             $allowSendingWithoutReply Pass True, if the message should be sent even if the specified
+     *     replied-to message is not found
+     * @param string|null      $parseMode
      *
      * @return \TelegramBot\Api\Types\Message
      * @throws \TelegramBot\Api\InvalidArgumentException
@@ -828,19 +831,23 @@ public function sendAnimation(
     public function sendVoice(
         $chatId,
         $voice,
+        $caption = null,
         $duration = null,
         $replyToMessageId = null,
         $replyMarkup = null,
         $disableNotification = false,
+        $allowSendingWithoutReply = false,
         $parseMode = null
     ) {
         return Message::fromResponse($this->call('sendVoice', [
             'chat_id' => $chatId,
             'voice' => $voice,
+            'caption' => $caption,
             'duration' => $duration,
             'reply_to_message_id' => $replyToMessageId,
             'reply_markup' => is_null($replyMarkup) ? $replyMarkup : $replyMarkup->toJson(),
             'disable_notification' => (bool)$disableNotification,
+            'allow_sending_without_reply' => $allowSendingWithoutReply,
             'parse_mode' => $parseMode
         ]));
     }
@@ -1943,28 +1950,38 @@ public function sendPoll(
      * On success, the sent Message is returned. (Yes, we're aware of the “proper” singular of die.
      * But it's awkward, and we decided to help it change. One dice at a time!)
      *
-     * @param $chatId string|int Unique identifier for the target chat or username of the target channel
+     * @param      $chatId string|int Unique identifier for the target chat or username of the target channel
      *                (in the format @channelusername)
+     * @param      $emoji string Emoji on which the dice throw animation is based. Currently, must be one of “🎲”,
+     *     “🎯”, “🏀”, “⚽”, or “🎰”. Dice can have values 1-6 for “🎲” and “🎯”, values 1-5 for “🏀” and “⚽”, and
+     *     values 1-64 for “🎰”. Defaults to “🎲
      * @param bool $disableNotification Sends the message silently. Users will receive a notification with no sound.
      * @param null $replyToMessageId If the message is a reply, ID of the original message
+     * @param bool $$allowSendingWithoutReply Pass True, if the message should be sent even if the specified replied-to
+     *     message is not found,
      * @param null $replyMarkup Additional interface options. A JSON-serialized object for an inline keyboard,
      *                          custom reply keyboard, instructions to remove reply
      *                          keyboard or to force a reply from the user.
+     *
      * @return bool|Message
      * @throws Exception
      * @throws HttpException
      * @throws InvalidJsonException
      */
     public function sendDice(
         $chatId,
+        $emoji,
         $disableNotification = false,
         $replyToMessageId = null,
+        $allowSendingWithoutReply = false,
         $replyMarkup = null
     ) {
         return Message::fromResponse($this->call('sendDice', [
             'chat_id' => $chatId,
+            'emoji' => $emoji,
             'disable_notification' => (bool) $disableNotification,
             'reply_to_message_id' => (int) $replyToMessageId,
+            'allow_sending_without_reply' => (bool) $allowSendingWithoutReply,
             'reply_markup' => $replyMarkup === null ? $replyMarkup : $replyMarkup->toJson(),
         ]));
     }

src/Types/Voice.php

@@ -19,27 +19,36 @@ class Voice extends BaseType implements TypeInterface
      *
      * @var array
      */
-    static protected $requiredParams = ['file_id', 'duration'];
+    static protected $requiredParams = ['file_id', 'file_unique_id', 'duration'];
 
     /**
      * {@inheritdoc}
      *
      * @var array
      */
     static protected $map = [
-        'file_id' => true,
-        'duration' => true,
-        'mime_type' => true,
-        'file_size' => true
+        'file_id'        => true,
+        'file_unique_id' => true,
+        'duration'       => true,
+        'mime_type'      => true,
+        'file_size'      => true,
     ];
 
     /**
-     * Unique identifier for this file
+     * Identifier for this file, which can be used to download or reuse the file
      *
      * @var string
      */
     protected $fileId;
 
+    /**
+     * Unique identifier for this file, which is supposed to be the same over time and for different bots. Can't be
+     * used to download or reuse the file.
+     *
+     * @var string
+     */
+    protected $fileUniqueId;
+
     /**
      * Duration of the audio in seconds as defined by sender
      *
@@ -77,6 +86,22 @@ public function setFileId($fileId)
         $this->fileId = $fileId;
     }
 
+    /**
+     * @return string
+     */
+    public function getFileUniqueId()
+    {
+        return $this->fileUniqueId;
+    }
+
+    /**
+     * @param string $fileUniqueId
+     */
+    public function setFileUniqueId($fileUniqueId)
+    {
+        $this->fileUniqueId = $fileUniqueId;
+    }
+
     /**
      * @return int
      */