Bases: telegram.TelegramObject

This object represents a voice note.

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.

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 | datetime.timedelta) –

  Duration of the audio in seconds as defined by the sender.

  Changed in version v22.2: datetime.timedelta objects are accepted in addition to plain int values.

• mime_type (str, optional) – MIME type of the file as defined by the sender.

• file_size (int, optional) – File size in bytes.

file_id[source]¶

Identifier for this file, which can be used to download or reuse the file.

Type:

str

file_unique_id[source]¶

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[source]¶

Duration of the audio in seconds as defined by the sender.

Deprecated since version v22.2: In a future major version this attribute will be of type datetime.timedelta. You can opt-in early by setting PTB_TIMEDELTA=true or PTB_TIMEDELTA=1 as an environment variable.

Type:

int | datetime.timedelta

mime_type[source]¶

Optional. MIME type of the file as defined by the sender.

Type:

str

file_size[source]¶

Optional. File size in bytes.

Type:

int

async get_file(*, read_timeout=None, write_timeout=None, connect_timeout=None, pool_timeout=None, api_kwargs=None)[source]¶

Convenience wrapper over telegram.Bot.get_file()

For the documentation of the arguments, please see telegram.Bot.get_file().

Returns:

telegram.File

Raises:

telegram.error.TelegramError –