Skip to content

danog\MadelineProto\EventHandler\Media\Thumbnail: Represents a downloadable thumbnail of a media (JPEG, or WEBP for stickers), or a smaller size of a photo.

Back to index

Author: Daniil Gentili daniil@daniil.it

Represents a downloadable thumbnail of a media (JPEG, or WEBP for stickers), or a smaller size of a photo.

Properties

  • $type: string Thumbnail type, see https://core.telegram.org/api/files#image-thumbnail-types
  • $width: int Thumbnail width
  • $height: int Thumbnail height
  • $size: int Media filesize
  • $fileName: string Media file name
  • $fileExt: string Media file extension
  • $creationDate: int Media creation date
  • $mimeType: string Media MIME type
  • $ttl: ?int Time-to-live of media
  • $thumbs: list<(Thumbnail | InlineThumbnail)> Thumbnails, from the smallest to the biggest: for photos, the smaller sizes of the photo.

Includes the thumbnails inlined in the media (always the only thumbnail of secret chat media), which are downloaded from memory, without contacting Telegram.

  • $videoThumbs: list<VideoThumbnail> Animated thumbnails (MPEG4 videos), from the smallest to the biggest.
  • $spoiler: bool Whether the media should be hidden behind a spoiler
  • $botApiFileId: string File ID in bot API format (always present even for users)
  • $botApiFileUniqueId: string Unique file ID in bot API format (always present even for users)
  • $encrypted: bool Whether this media originates from a secret chat.
  • $protected: bool Whether this media is protected

Method list:

Methods:

getDownloadLink((string|null) $scriptUrl = NULL): string

Gets a download link for any file up to 4GB.

Parameters:

  • $scriptUrl: (string|null) Optional path to custom download script (not needed when running via web)

getStream((callable(float, float, float): voi)|null) $cb = NULL, int $offset = 0, int $end = -1, ?\Amp\Cancellation $cancellation = NULL): \Amp\ByteStream\ReadableStream&danog\MadelineProto\ResumableStream

Get a readable amp stream with the file contents.

The returned stream is resumable: it can be serialized, and once unserialized,
reading continues from the end of the last chunk read before serialization.

Parameters:

  • $cb: (callable(float, float, float): voi)|null) Progress callback
  • $offset: int
  • $end: int
  • $cancellation: ?\Amp\Cancellation

See also:

  • \Amp\Cancellation
  • \Amp\ByteStream\ReadableStream&danog\MadelineProto\ResumableStream

downloadToDir(string $dir = NULL, (callable(float, float, float): voi)|null) $cb = NULL, ?\Amp\Cancellation $cancellation = NULL): string

Download the media to working directory or passed path.

Parameters:

  • $dir: string Directory where to download the file
  • $cb: (callable(float, float, float): voi)|null) Progress callback
  • $cancellation: ?\Amp\Cancellation

See also:

  • \Amp\Cancellation

downloadToFile(string $file, (callable(float, float, float): voi)|null) $cb = NULL, ?\Amp\Cancellation $cancellation = NULL): string

Download the media to file.

Parameters:

  • $file: string Downloaded file path
  • $cb: (callable(float, float, float): voi)|null) Progress callback
  • $cancellation: ?\Amp\Cancellation

See also:

  • \Amp\Cancellation

getDownloadInfo(): array{ext: string, name: string, mime: string, size: int, InputFileLocation: array, key_fingerprint?: string, key?: string, iv?: string}


Generated by danog/phpdoc