tgbotlib/src/TgBotLib/Objects/Telegram/Game.php

<?php

    /** @noinspection PhpMissingFieldTypeInspection */

    namespace TgBotLib\Objects\Telegram;

    use TgBotLib\Interfaces\ObjectTypeInterface;

    class Game implements ObjectTypeInterface
    {
        /**
         * @var string
         */
        private $title;

        /**
         * @var string
         */
        private $description;

        /**
         * @var PhotoSize[]
         */
        private $photo;

        /**
         * @var string|null
         */
        private $text;
        /**
         * @var MessageEntity[]|null
         */
        private $text_entities;

        /**
         * @var Animation|null
         */
        private $animation;

        /**
         * Title of the game
         *
         * @return string
         */
        public function getTitle(): string
        {
            return $this->title;
        }

        /**
         * Description of the game
         *
         * @return string
         */
        public function getDescription(): string
        {
            return $this->description;
        }

        /**
         * Photo that will be displayed in the game message in chats.
         *
         * @return PhotoSize[]
         */
        public function getPhoto(): array
        {
            return $this->photo;
        }

        /**
         * Optional. Brief description of the game or high scores included in the game message. Can be automatically
         * edited to include current high scores for the game when the bot calls setGameScore, or manually edited using
         * editMessageText. 0-4096 characters.
         *
         * @see https://core.telegram.org/bots/api#setgamescore
         * @see https://core.telegram.org/bots/api#editmessagetext
         * @return string|null
         */
        public function getText(): ?string
        {
            return $this->text;
        }

        /**
         * Optional. Special entities that appear in text, such as usernames, URLs, bot commands, etc.
         *
         * @return MessageEntity[]|null
         */
        public function getTextEntities(): ?array
        {
            return $this->text_entities;
        }

        /**
         * Optional. Animation that will be displayed in the game message in chats. Upload via BotFather
         *
         * @see https://t.me/botfather
         * @return Animation|null
         */
        public function getAnimation(): ?Animation
        {
            return $this->animation;
        }

        /**
         * Returns an array representation of this object.
         *
         * @return array
         */
        public function toArray(): array
        {
            return [
                'title' => $this->title,
                'description' => $this->description,
                'photo' => isset($this->photo) ? array_map(function ($photo) {
                    return $photo->toArray();
                }, $this->photo) : null,
                'text' => $this->text,
                'text_entities' => isset($this->text_entities) ? array_map(function ($text_entity) {
                    return $text_entity->toArray();
                }, $this->text_entities) : null,
                'animation' => ($this->animation instanceof ObjectTypeInterface) ? $this->animation->toArray() : null,
            ];
        }

        /**
         * Constructs object from an array representation
         *
         * @param array $data
         * @return Game
         */
        public static function fromArray(array $data): self
        {
            $object = new self();

            $object->description = $data['description'] ?? null;
            $object->title = $data['title'] ?? null;
            $object->photo = isset($data['photo']) && is_array($data['photo']) ? array_map(function ($photo) {
                return PhotoSize::fromArray($photo);
            }, $data['photo']) : null;
            $object->text = $data['text'] ?? null;
            $object->text_entities = isset($data['text_entities']) && is_array($data['text_entities']) ? array_map(function ($text_entity) {
                return MessageEntity::fromArray($text_entity);
            }, $data['text_entities']) : null;
            $object->animation = ($data['animation']) ? Animation::fromArray($data['animation']) : null;

            return $object;
        }
    }