FileDownloadInfo

class yandex_music.track.file_download_info.FileDownloadInfo

Класс, представляющий информацию о файле трека для загрузки.

Note

Известные значения поля quality: lossless, hq, nq.

Известные значения поля codec: flac, flac-mp4, aac-mp4, he-aac-mp4, aac, he-aac, mp3. Кодеки с суффиксом -mp4 поставляются в контейнере MP4.

Известные значения поля transport: raw, encraw. При encraw файл зашифрован ключом из поля key, методы загрузки расшифровывают его автоматически.

Для flac-mp4 поле bitrate равно 0.

track_id: str

Уникальный идентификатор трека из запроса.

quality: str

Качество.

codec: str

Кодек.

bitrate: int

Битрейт в кбит/с.

transport: str

Способ доставки файла.

url: str

Ссылка на файл.

urls: list из str

Ссылки на файл на разных серверах.

real_id: stroptional

Уникальный идентификатор трека.

gain: booloptional

Усиление.

key: stroptional

Ключ расшифровки в шестнадцатеричном виде для encraw.

client: yandex_music.Clientoptional

Клиент Yandex Music.

download_bytes(timeout=<yandex_music.utils.request_base.DefaultTimeout object>)

Загрузка трека и возврат в виде байтов.

Note

Файл в encraw расшифровывается.

Parameters:

timeout (int | float, optional) – Время ожидания ответа сервера в секундах. Ограничивает ожидание соединения и каждой порции данных, а не всю загрузку. По умолчанию используется значение клиента.

Returns:

Трек в виде байтов.

Return type:

bytes

async download_bytes_async(timeout=<yandex_music.utils.request_base.DefaultTimeout object>)

Загрузка трека и возврат в виде байтов.

Note

Файл в encraw расшифровывается.

Parameters:

timeout (int | float, optional) – Время ожидания в секундах. Ограничивает всё время запроса целиком, включая загрузку файла. По умолчанию используется значение клиента.

Returns:

Трек в виде байтов.

Return type:

bytes

download(filename, timeout=<yandex_music.utils.request_base.DefaultTimeout object>)

Загрузка трека.

Note

Файл в encraw расшифровывается. Контейнер не меняется: flac-mp4 и aac-mp4 сохраняются как MP4.

Parameters:
  • filename (str) – Путь и(или) название файла вместе с расширением.

  • timeout (int | float, optional) – Время ожидания ответа сервера в секундах. Ограничивает ожидание соединения и каждой порции данных, а не всю загрузку. По умолчанию используется значение клиента.

async download_async(filename, timeout=<yandex_music.utils.request_base.DefaultTimeout object>)

Загрузка трека.

Note

Файл в encraw расшифровывается. Контейнер не меняется: flac-mp4 и aac-mp4 сохраняются как MP4.

Parameters:
  • filename (str) – Путь и(или) название файла вместе с расширением.

  • timeout (int | float, optional) – Время ожидания в секундах. Ограничивает всё время запроса целиком, включая загрузку файла. По умолчанию используется значение клиента.