Track

class yandex_music.track.track.Track

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

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

derived_colors

Производные цвета обложки трека.

Type:: yandex_music.CoverDerivedColors, optional

fade

Параметры затухания трека.

Type:: yandex_music.Fade, optional

smart_preview_params

Параметры умного превью трека.

Type:: yandex_music.SmartPreviewParams, optional

special_audio_resources

Специальные аудиоресурсы.

Type:: list из str, optional

disclaimers

Список дисклеймеров.

Type:: list из str, optional

background_video_id

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

Type:: str, optional

player_id

Идентификатор плеера видеошота.

Type:: str, optional

client

Клиент Yandex Music.

Type:: yandex_music.Client

get_download_info(get_direct_links=False, **kwargs)

Сокращение.

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

client.tracks_download_info(self.track_id, get_direct_links)

async get_download_info_async(get_direct_links=False, **kwargs)

Сокращение.

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

await client.tracks_download_info(self.track_id, get_direct_links)

get_supplement(*args, **kwargs)

Сокращение.

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

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

async get_supplement_async(*args, **kwargs)

Сокращение.

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

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

get_lyrics(*args, **kwargs)

Сокращение.

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

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

async get_lyrics_async(*args, **kwargs)

Сокращение.

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

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

get_cover_url(size='200x200')

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

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

get_og_image_url(size='200x200')

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

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

download_cover(filename, size='200x200')

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

Parameters:

filename (str) – Путь для сохранения файла с названием и расширением.
size (str, optional) – Размер обложки.

async download_cover_async(filename, size='200x200')

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

Parameters:

filename (str) – Путь для сохранения файла с названием и расширением.
size (str, optional) – Размер обложки.

download_og_image(filename, size='200x200')

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

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

Parameters:

filename (str) – Путь для сохранения файла с названием и расширением.
size (str, optional) – Размер обложки.

async download_og_image_async(filename, size='200x200')

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

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

Parameters:

filename (str) – Путь для сохранения файла с названием и расширением.
size (str, optional) – Размер обложки.

download_cover_bytes(size='200x200')

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

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

async download_cover_bytes_async(size='200x200')

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

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

download_og_image_bytes(size='200x200')

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

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

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

async download_og_image_bytes_async(size='200x200')

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

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

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

get_specific_download_info(codec, bitrate_in_kbps)

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

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, bitrate_in_kbps)

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

Parameters:

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

Returns:

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

Return type:

yandex_music.DownloadInfo | None

download(filename, codec='mp3', bitrate_in_kbps=192)

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

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 download_async(filename, codec='mp3', bitrate_in_kbps=192)

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

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='mp3', bitrate_in_kbps=192)

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

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='mp3', bitrate_in_kbps=192)

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

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

like(*args, **kwargs)

Сокращение.

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

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

async like_async(*args, **kwargs)

Сокращение.

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

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

dislike(*args, **kwargs)

Сокращение.

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

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

async dislike_async(*args, **kwargs)

Сокращение.

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

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

artists_name()

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

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

property track_id

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

Type:: str

classmethod de_json(data, client)

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

Parameters:

data (dict) – Поля и значения десериализуемого объекта.
client (yandex_music.Client, optional) – Клиент Yandex Music.

Returns:

Трек.

Return type:

yandex_music.Track