peyk.platforms.telegram.types.audio

Classes

Audio(file_id, file_unique_id, duration[, ...])

This object represents an audio file to be treated as music by the Telegram clients.

class peyk.platforms.telegram.types.audio.Audio(file_id: str, file_unique_id: str, duration: int, performer: str | None = None, title: str | None = None, file_name: str | None = None, mime_type: str | None = None, file_size: int | None = None, thumbnail: PhotoSize | None = None)[source]

Bases: object

This object represents an audio file to be treated as music by the Telegram clients.

Variables:
  • file_id (str) – Identifier for this file, which can be used to download or reuse the file

  • file_unique_id (str) – 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.

  • duration (int) – Duration of the audio in seconds as defined by the sender

  • performer (str | None) – Performer of the audio as defined by the sender or by audio tags

  • title (str | None) – Title of the audio as defined by the sender or by audio tags

  • file_name (str | None) – Original filename as defined by the sender

  • mime_type (str | None) – MIME type of the file as defined by the sender

  • file_size (int | None) – 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.

  • thumbnail (peyk.platforms.telegram.types.photo_size.PhotoSize | None) – Thumbnail of the album cover to which the music file belongs

file_id: str
file_unique_id: str
duration: int
performer: str | None = None
title: str | None = None
file_name: str | None = None
mime_type: str | None = None
file_size: int | None = None
thumbnail: PhotoSize | None = None
classmethod from_dict(data: dict | None) Audio | None[source]

Parse a Telegram API mapping into this type.

Parameters:

data – Raw Telegram API mapping, or None.

Returns:

Parsed type instance, or None when data is None.