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
Доступен ли для пользователей с подпиской.
- 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
- 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#
- 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] #
Сокращение для:
- async get_supplement_async(*args, **kwargs) Optional[Supplement] #
Сокращение для:
- 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#
- 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#
- title: Optional[str] = None#
- property track_id: str#
Уникальный идентификатор трека состоящий из его номера и номера альбома или просто из номера.
- Type
str
- type: Optional[str] = None#
- version: Optional[str] = None#