telegram.Audio¶
-
class
telegram.
Audio
(file_id: str, file_unique_id: str, duration: int, performer: str = None, title: str = None, mime_type: str = None, file_size: int = None, thumb: telegram.files.photosize.PhotoSize = None, bot: Bot = None, **kwargs)¶ Bases:
telegram.base.TelegramObject
This object represents an audio file to be treated as music by the Telegram clients.
Objects of this class are comparable in terms of equality. Two objects of this class are considered equal, if their
file_unique_id
is equal.-
file_id
¶ Identifier for this file.
Type: str
-
file_unique_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.
Type: str
-
duration
¶ Duration of the audio in seconds.
Type: int
-
performer
¶ Optional. Performer of the audio as defined by sender or by audio tags.
Type: str
-
title
¶ Optional. Title of the audio as defined by sender or by audio tags.
Type: str
-
mime_type
¶ Optional. MIME type of the file as defined by sender.
Type: str
-
file_size
¶ Optional. File size.
Type: int
-
thumb
¶ Optional. Thumbnail of the album cover to which the music file belongs.
Type: telegram.PhotoSize
-
bot
¶ Optional. The Bot to use for instance methods.
Type: telegram.Bot
Parameters: - 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 sender. - performer (
str
, optional) – Performer of the audio as defined by sender or by audio tags. - title (
str
, optional) – Title of the audio as defined by sender or by audio tags. - mime_type (
str
, optional) – MIME type of the file as defined by sender. - file_size (
int
, optional) – File size. - thumb (
telegram.PhotoSize
, optional) – Thumbnail of the album cover to which the music file belongs. - bot (
telegram.Bot
, optional) – The Bot to use for instance methods. - **kwargs (
dict
) – Arbitrary keyword arguments.
-
get_file
(timeout: int = None, api_kwargs: Dict[str, Any] = None) → File¶ Convenience wrapper over
telegram.Bot.get_file
Parameters: - timeout (
int
|float
, optional) – If this value is specified, use it as the read timeout from the server (instead of the one specified during creation of the connection pool). - api_kwargs (
dict
, optional) – Arbitrary keyword arguments to be passed to the Telegram API.
Returns: Raises: telegram.TelegramError
- timeout (
-