diff --git a/CHANGELOG.md b/CHANGELOG.md index 967b0ec..deba948 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -12,6 +12,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0 * Added LinkPreviewOptions object * Added PaidMedia, PaidMediaPhoto, PaidMediaPreview, PaidMediaVideo & PaidMediaType Enum * Added PaidMediaInfo Object + * Added Story object ### Changed * Refactored the way HTTP requests are handled & methods are called diff --git a/src/TgBotLib/Objects/Telegram/Story.php b/src/TgBotLib/Objects/Telegram/Story.php new file mode 100644 index 0000000..cc15dfa --- /dev/null +++ b/src/TgBotLib/Objects/Telegram/Story.php @@ -0,0 +1,149 @@ +file_id; + } + + /** + * 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. + * + * @return string + */ + public function getFileUniqueId(): string + { + return $this->file_unique_id; + } + + /** + * Video width as defined by the sender + * + * @return int + */ + public function getWidth(): int + { + return $this->width; + } + + /** + * Video height as defined by the sender + * + * @return int + */ + public function getHeight(): int + { + return $this->height; + } + + /** + * Duration of the video in seconds as defined by the sender + * + * @return int + */ + public function getDuration(): int + { + return $this->duration; + } + + /** + * Optional. Video thumbnail + * + * @return PhotoSize|null + */ + public function getThumbnail(): ?PhotoSize + { + return $this->thumbnail; + } + + /** + * Optional. Original filename as defined by the sender + * + * @return string|null + */ + public function getFileName(): ?string + { + return $this->file_name; + } + + /** + * Optional. MIME type of the file as defined by the sender + * + * @return string|null + */ + public function getMimeType(): ?string + { + return $this->mime_type; + } + + /** + * Optional. File size in bytes. It can be bigger than 2^31 and some programming languages may have + * difficulty/silent defects in interpreting it. But it has at most 52 significant bits, so a signed 64-bit + * integer or double-precision float type are safe for storing this value. + * + * @return int|null + */ + public function getFileSize(): ?int + { + return $this->file_size; + } + + /** + * @inheritDoc + */ + public function toArray(): array + { + return [ + 'file_id' => $this->file_id, + 'file_unique_id' => $this->file_unique_id, + 'width' => $this->width, + 'height' => $this->height, + 'duration' => $this->duration, + 'thumbnail' => $this->thumbnail ? $this->thumbnail->toArray() : null, + 'file_name' => $this->file_name, + 'mime_type' => $this->mime_type, + 'file_size' => $this->file_size, + ]; + } + + /** + * @inheritDoc + */ + public static function fromArray(array $data): ObjectTypeInterface + { + $object = new self(); + + $object->file_id = $data['file_id']; + $object->file_unique_id = $data['file_unique_id']; + $object->width = $data['width']; + $object->height = $data['height']; + $object->duration = $data['duration']; + $object->thumbnail = isset($data['thumbnail']) ? PhotoSize::fromArray($data['thumbnail']) : null; + $object->file_name = $data['file_name'] ?? null; + $object->mime_type = $data['mime_type'] ?? null; + $object->file_size = $data['file_size'] ?? null; + + return $object; + } +} \ No newline at end of file