yandex_music.track.track#

class yandex_music.track.track.Track(id: Union[str, int], title: Optional[str] = None, available: Optional[bool] = None, artists: List[Artist] = None, albums: List[Album] = None, available_for_premium_users: Optional[bool] = None, lyrics_available: Optional[bool] = None, poetry_lover_matches: List[PoetryLoverMatch] = None, best: Optional[bool] = None, real_id: Optional[Union[str, int]] = None, og_image: Optional[str] = None, type: Optional[str] = None, cover_uri: Optional[str] = None, major: Optional[Major] = None, duration_ms: Optional[int] = None, storage_dir: Optional[str] = None, file_size: Optional[int] = None, substituted: Optional[Track] = None, matched_track: Optional[Track] = None, normalization: Optional[Normalization] = None, error: Optional[str] = None, can_publish: Optional[bool] = None, state: Optional[str] = None, desired_visibility: Optional[str] = None, filename: Optional[str] = None, user_info: Optional[User] = None, meta_data: Optional[MetaData] = None, regions: Optional[List[str]] = None, available_as_rbt: Optional[bool] = None, content_warning: Optional[str] = None, explicit: Optional[bool] = None, preview_duration_ms: Optional[int] = None, available_full_without_permission: Optional[bool] = None, version: Optional[str] = None, remember_position: Optional[bool] = None, background_video_uri: Optional[str] = None, short_description: Optional[str] = None, is_suitable_for_children: Optional[bool] = None, client: Optional[Client] = None)#

Bases: YandexMusicObject

Класс, представляющий трек.

Note

Известные значения поля content_warning: explicit.

Известные значения поля type: music.

Поля can_publish, state, desired_visibility, filename, user_info доступны только у треков что были загружены пользователем.

Обычно у подкастов поле remember_position == True, а у треков remember_position == False.

Полное описание можно получить используя Track.get_supplement().

id#

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

Type

int | str

title#

Название.

Type

str, optional

available#

Доступен ли для прослушивания.

Type

bool, optional

artists#

Исполнители.

Type

list из yandex_music.Artist, optional

albums#

Альбомы.

Type

list из yandex_music.Album, optional

available_for_premium_users#

Доступен ли для пользователей с подпиской.

Type

bool, optional

lyrics_available#

Доступен ли текст песни.

Type

bool, optional

poetry_lover_matches#

Список слов TODO.

Type

list из yandex_music.PoetryLoverMatch, optional

best#

Лучшей ли трек TODO.

Type

bool, optional

real_id#

TODO.

Type

int | str, optional

og_image#

Ссылка на превью Open Graph.

Type

str, optional

type#

Тип.

Type

str, optional

cover_uri#

Ссылка на изображение с обложкой.

Type

str, optional

major#

Мейджор-лейбл.

Type

yandex_music.Major, optional

duration_ms#

Длительность трека в миллисекундах.

Type

int, optional

storage_dir#

В какой папке на сервере хранится файл TODO.

Type

str, optional

file_size#

Размер файла. TODO добавить единицу измерения.

Type

int, optional

substituted#

Замещённый трек.

Type

yandex_music.Track, optional

matched_track#

Соответствующий трек TODO.

Type

yandex_music.Track, optional

normalization#

Значения для нормализации трека.

Type

list из yandex_music.Normalization, optional

error#

Сообщение об ошибке.

Type

str, optional

can_publish#

Может ли быть опубликован.

Type

bool, optional

state#

Состояние, например, playable.

Type

str, optional

desired_visibility#

Видимость трека.

Type

str, optional

filename#

Название файла.

Type

str, optional

user_info#

Информация о пользователе, который загрузил трек.

Type

yandex_music.User, optional

meta_data#

Информация о метаданных трека.

Type

yandex_music.MetaData, optional

regions#

Регион TODO.

Type

list из str, optional

available_as_rbt#

TODO.

Type

bool, optional

content_warning#

Тип откровенного контента.

Type

str, optional

explicit#

Содержит ли откровенный контент.

Type

bool, optional

preview_duration_ms#

TODO.

Type

int, optional

available_full_without_permission#

Доступен ли без подписки.

Type

bool, optional

version#

Версия.

Type

str, optional

remember_position#

Если True, то запоминатся последняя позиция прослушивания, иначе позиция не запоминается.

Type

bool, optional

background_video_uri#

Ссылка на видеошот.

Type

str, optional

short_description#

Краткое опсание эпизода подкаста.

Type

str, optional

is_suitable_for_children#

Подходит ли для детей TODO.

Type

bool, optional

client#

Клиент Yandex Music.

Type

yandex_music.Client

albums: List[Album] = None#
artists: List[Artist] = None#
artists_name() List[str]#

Получает имена всех исполнителей.

Returns

Имена исполнителей.

Return type

list из str

available: Optional[bool] = None#
available_as_rbt: Optional[bool] = None#
available_for_premium_users: Optional[bool] = None#
available_full_without_permission: Optional[bool] = None#
background_video_uri: Optional[str] = None#
best: Optional[bool] = None#
can_publish: Optional[bool] = None#
client: Optional[Client] = None#
content_warning: Optional[str] = None#
cover_uri: Optional[str] = None#
classmethod de_json(data: dict, client: Client) Optional[Track]#

Десериализация объекта.

Parameters
  • data (dict) – Поля и значения десериализуемого объекта.

  • client (yandex_music.Client, optional) – Клиент Yandex Music.

Returns

Трек.

Return type

yandex_music.Track

classmethod de_list(data: dict, client: Client) List[Track]#

Десериализация списка объектов.

Parameters
  • data (list) – Список словарей с полями и значениями десериализуемого объекта.

  • client (yandex_music.Client, optional) – Клиент Yandex Music.

Returns

Треки.

Return type

list из yandex_music.Track

desired_visibility: Optional[str] = None#
dislike(*args, **kwargs) bool#

Сокращение для:

client.users_likes_tracks_remove(track.id, user.id *args, **kwargs)

async dislike_async(*args, **kwargs) bool#

Псевдоним для dislike_async

download(filename: str, codec: str = 'mp3', bitrate_in_kbps: int = 192) None#

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

Note

Известные значения codec: mp3, aac.

Известные значения bitrate_in_kbps: 64, 128, 192, 320.

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

  • codec (str, optional) – Кодек из доступных в self.download_info.

  • bitrate_in_kbps (int, optional) – Битрейт из доступных в self.download_info для данного кодека.

Raises

yandex_music.exceptions.InvalidBitrateError – Если в self.download_info не найден подходящий трек.

async downloadAsync(filename: str, codec: str = 'mp3', bitrate_in_kbps: int = 192) None#

Псевдоним для download_async

downloadCover(filename: str, size: str = '200x200') None#

Псевдоним для download_cover

async downloadCoverAsync(filename: str, size: str = '200x200') None#

Псевдоним для download_cover_async

downloadOgImage(filename: str, size: str = '200x200') None#

Псевдоним для download_og_image

async downloadOgImageAsync(filename: str, size: str = '200x200') None#

Псевдоним для download_og_image_async

async download_async(filename: str, codec: str = 'mp3', bitrate_in_kbps: int = 192) None#

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

Note

Известные значения codec: mp3, aac.

Известные значения bitrate_in_kbps: 64, 128, 192, 320.

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

  • codec (str, optional) – Кодек из доступных в self.download_info.

  • bitrate_in_kbps (int, optional) – Битрейт из доступных в self.download_info для данного кодека.

Raises

yandex_music.exceptions.InvalidBitrateError – Если в self.download_info не найден подходящий трек.

download_cover(filename: str, size: str = '200x200') None#

Загрузка обложки.

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

  • size (str, optional) – Размер обложки.

async download_cover_async(filename: str, size: str = '200x200') None#

Загрузка обложки.

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

  • size (str, optional) – Размер обложки.

download_og_image(filename: str, size: str = '200x200') None#

Загрузка обложки.

Предпочтительнее использовать self.download_cover().

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

  • size (str, optional) – Размер обложки.

async download_og_image_async(filename: str, size: str = '200x200') None#

Загрузка обложки.

Предпочтительнее использовать self.download_cover_async().

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

  • size (str, optional) – Размер обложки.

duration_ms: Optional[int] = None#
error: Optional[str] = None#
explicit: Optional[bool] = None#
file_size: Optional[int] = None#
filename: Optional[str] = None#
getDownloadInfo(get_direct_links=False) List[DownloadInfo]#

Псевдоним для get_download_info

async getDownloadInfoAsync(get_direct_links=False) List[DownloadInfo]#

Псевдоним для get_download_info_async

getSupplement(*args, **kwargs) Optional[Supplement]#

Псевдоним для get_supplement

async getSupplementAsync(*args, **kwargs) Optional[Supplement]#

Псевдоним для get_supplement_async

get_download_info(get_direct_links=False) List[DownloadInfo]#

Сокращение для:

client.tracks_download_info(self.track_id, get_direct_links)

async get_download_info_async(get_direct_links=False) List[DownloadInfo]#

Сокращение для:

await client.tracks_download_info(self.track_id, get_direct_links)

get_supplement(*args, **kwargs) Optional[Supplement]#

Сокращение для:

client.track_supplement(track.id, *args, **kwargs)

async get_supplement_async(*args, **kwargs) Optional[Supplement]#

Сокращение для:

await client.track_supplement(track.id, *args, **kwargs)

id: Union[str, int]#
is_suitable_for_children: Optional[bool] = None#
like(*args, **kwargs) bool#

Сокращение для:

client.users_likes_tracks_add(track.id, user.id, *args, **kwargs)

async likeAsync(*args, **kwargs) bool#

Псевдоним для like_async

async like_async(*args, **kwargs) bool#

Сокращение для:

await client.users_likes_tracks_add(track.id, user.id, *args, **kwargs)

lyrics_available: Optional[bool] = None#
major: Optional[Major] = None#
matched_track: Optional[Track] = None#
meta_data: Optional[MetaData] = None#
normalization: Optional[Normalization] = None#
og_image: Optional[str] = None#
poetry_lover_matches: List[PoetryLoverMatch] = None#
preview_duration_ms: Optional[int] = None#
real_id: Optional[Union[str, int]] = None#
regions: Optional[List[str]] = None#
remember_position: Optional[bool] = None#
short_description: Optional[str] = None#
state: Optional[str] = None#
storage_dir: Optional[str] = None#
substituted: Optional[Track] = None#
title: Optional[str] = None#
property trackId: str#

Псевдоним для track_id

property track_id: str#

Уникальный идентификатор трека состоящий из его номера и номера альбома или просто из номера.

Type

str

type: Optional[str] = None#
user_info: Optional[User] = None#
version: Optional[str] = None#