yandex_music.track.track#

Bases: YandexMusicObject

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

Note

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

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

Известные значения поля track_sharing_flag: VIDEO_ALLOWED, COVER_ONLY.

Известные значения поля track_source: OWN, OWN_REPLACED_TO_UGC.

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

Поля 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

track_source#

Источник трека.

Type:: str, optional

available_for_options#

Возможные опции для трека.

Type:: list из str, optional

r128#

Параметры нормализации громкости трека в соответствии с рекомендацией EBU R 128.

Type:: yandex_music.R128, optional

lyrics_info#

Данные о наличии текстов трека.

Type:: yandex_music.LyricsInfo, optional

track_sharing_flag#

TODO.

Type:: str, optional

client#

Клиент Yandex Music.

Type:: yandex_music.Client

albums: List[Album] = None#

artists: List[Artist] = None#

artistsName() → List[str]#: Псевдоним для artists_name

artists_name() → List[str]#

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

Returns:: Имена исполнителей.
Return type:: list из str

available: bool | None = None#

available_as_rbt: bool | None = None#

available_for_options: List[str] | None = None#

available_for_premium_users: bool | None = None#

available_full_without_permission: bool | None = None#

background_video_uri: str | None = None#

best: bool | None = None#

can_publish: bool | None = None#

client: Client | None = None#

content_warning: str | None = None#

cover_uri: str | None = None#

classmethod de_json(data: dict, client: Client) → Track | None#

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

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: str | None = None#

dislike(*args, **kwargs) → bool#

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

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

async dislikeAsync(*args, **kwargs) → bool#: Псевдоним для dislike_async

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

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

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

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

downloadBytes(codec: str = 'mp3', bitrate_in_kbps: int = 192) → bytes#: Псевдоним для download_bytes

async downloadBytesAsync(codec: str = 'mp3', bitrate_in_kbps: int = 192) → bytes#: Псевдоним для download_bytes_async

downloadCover(filename: str, size: str = '200x200') → None#: Псевдоним для download_cover

async downloadCoverAsync(filename: str, size: str = '200x200') → None#: Псевдоним для download_cover_async

downloadCoverBytes(size: str = '200x200') → bytes#: Псевдоним для download_cover_bytes

async downloadCoverBytesAsync(size: str = '200x200') → bytes#: Псевдоним для download_cover_bytes_async

downloadOgImage(filename: str, size: str = '200x200') → None#: Псевдоним для download_og_image

async downloadOgImageAsync(filename: str, size: str = '200x200') → None#: Псевдоним для download_og_image_async

downloadOgImageBytes(size: str = '200x200') → bytes#: Псевдоним для download_og_image_bytes

async downloadOgImageBytesAsync(size: str = '200x200') → bytes#: Псевдоним для download_og_image_bytes_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_bytes(codec: str = 'mp3', bitrate_in_kbps: int = 192) → bytes#

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

Note

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

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

Parameters:

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

Raises:

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

Returns:

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

Return type:

bytes

async download_bytes_async(codec: str = 'mp3', bitrate_in_kbps: int = 192) → bytes#

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

Note

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

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

Parameters:

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

Raises:

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

Returns:

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

Return type:

bytes

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_cover_bytes(size: str = '200x200') → bytes#

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

Parameters:: size (str, optional) – Размер обложки.
Returns:: Обложка в виде байтов.
Return type:: bytes

async download_cover_bytes_async(size: str = '200x200') → bytes#

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

Parameters:: size (str, optional) – Размер обложки.
Returns:: Обложка в виде байтов.
Return type:: bytes

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) – Размер обложки.

download_og_image_bytes(size: str = '200x200') → bytes#

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

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

Parameters:: size (str, optional) – Размер обложки.
Returns:: Обложка в виде байтов.
Return type:: bytes

async download_og_image_bytes_async(size: str = '200x200') → bytes#

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

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

Parameters:: size (str, optional) – Размер обложки.
Returns:: Обложка в виде байтов.
Return type:: bytes

duration_ms: int | None = None#

error: str | None = None#

explicit: bool | None = None#

file_size: int | None = None#

filename: str | None = None#

getCoverUrl(size: str = '200x200') → str#: Псевдоним для get_cover_url

getDownloadInfo(get_direct_links=False) → List[DownloadInfo]#: Псевдоним для get_download_info

async getDownloadInfoAsync(get_direct_links=False) → List[DownloadInfo]#: Псевдоним для get_download_info_async

getLyrics(*args, **kwargs) → TrackLyrics | None#: Псевдоним для get_lyrics

async getLyricsAsync(*args, **kwargs) → TrackLyrics | None#: Псевдоним для get_lyrics_async

getOgImageUrl(size: str = '200x200') → str#: Псевдоним для get_og_image_url

getSpecificDownloadInfo(codec: str, bitrate_in_kbps: int) → DownloadInfo | None#: Псевдоним для get_specific_download_info

async getSpecificDownloadInfoAsync(codec: str, bitrate_in_kbps: int) → DownloadInfo | None#: Псевдоним для get_specific_download_info_async

getSupplement(*args, **kwargs) → Supplement | None#: Псевдоним для get_supplement

async getSupplementAsync(*args, **kwargs) → Supplement | None#: Псевдоним для get_supplement_async

get_cover_url(size: str = '200x200') → str#

Возвращает URL обложки.

Parameters:: size (str, optional) – Размер обложки.
Returns:: URL обложки.
Return type:: str

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_lyrics(*args, **kwargs) → TrackLyrics | None#

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

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

async get_lyrics_async(*args, **kwargs) → TrackLyrics | None#

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

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

get_og_image_url(size: str = '200x200') → str#

Возвращает URL OG обложки.

Parameters:: size (str, optional) – Размер обложки.
Returns:: URL обложки.
Return type:: str

get_specific_download_info(codec: str, bitrate_in_kbps: int) → DownloadInfo | None#

Возвращает вариант загрузки по критериям.

Parameters:

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

Returns:

Вариант загрузки трека или None.

Return type:

yandex_music.DownloadInfo | None

async get_specific_download_info_async(codec: str, bitrate_in_kbps: int) → DownloadInfo | None#

Возвращает вариант загрузки по критериям.

Parameters:

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

Returns:

Вариант загрузки трека или None.

Return type:

yandex_music.DownloadInfo | None

get_supplement(*args, **kwargs) → Supplement | None#

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

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

async get_supplement_async(*args, **kwargs) → Supplement | None#

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

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

id: str | int#

is_suitable_for_children: bool | None = 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: bool | None = None#

lyrics_info: LyricsInfo | None = None#

major: Major | None = None#

matched_track: Track | None = None#

meta_data: MetaData | None = None#

normalization: Normalization | None = None#

og_image: str | None = None#

poetry_lover_matches: List[PoetryLoverMatch] = None#

preview_duration_ms: int | None = None#

r128: R128 | None = None#

real_id: str | int | None = None#

regions: List[str] | None = None#

remember_position: bool | None = None#

short_description: str | None = None#

state: str | None = None#

storage_dir: str | None = None#

substituted: Track | None = None#

title: str | None = None#

property trackId: str#: Псевдоним для track_id

property track_id: str#

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

Type:: str

track_sharing_flag: str | None = None#

track_source: str | None = None#

type: str | None = None#

user_info: User | None = None#

version: str | None = None#