Треки

class yandex_music._client_async.tracks.TracksMixin

Треки.

Миксин для методов, связанных с треками.

async tracks(track_ids, with_positions=True, *args, **kwargs)

Получение трека/треков.

Parameters:

  • track_ids (str | int | list из str | list из int) – Уникальный идентификатор трека или треков.

  • with_positions (bool, optional) – С позициями TODO.

  • *args – Произвольные аргументы (будут переданы в запрос).

  • **kwargs – Произвольные именованные аргументы (будут переданы в запрос).

Returns:

Трек или Треки.

Return type:

list из yandex_music.Track

Raises:

yandex_music.exceptions.YandexMusicError – Базовое исключение библиотеки.

async tracks_download_info(track_id, get_direct_links=False, *args, **kwargs)

Получение информации о доступных вариантах загрузки трека.

Parameters:

  • track_id (str | list из str) – Уникальный идентификатор трека или треков.

  • get_direct_links (bool, optional) – Получить ли при вызове метода прямую ссылку на загрузку.

  • *args – Произвольные аргументы (будут переданы в запрос).

  • **kwargs – Произвольные именованные аргументы (будут переданы в запрос).

Returns:

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

Return type:

list из yandex_music.DownloadInfo | None

Raises:

yandex_music.exceptions.YandexMusicError – Базовое исключение библиотеки.

async track_supplement(track_id, *args, **kwargs)

Получение дополнительной информации о треке.

Warning

Получение текста из дополнительной информации устарело. Используйте yandex_music.ClientAsync.tracks_lyrics().

Parameters:

  • track_id (str | int) – Уникальный идентификатор трека.

  • *args – Произвольные аргументы (будут переданы в запрос).

  • **kwargs – Произвольные именованные аргументы (будут переданы в запрос).

Returns:

Дополнительная информация о треке.

Return type:

yandex_music.Supplement

Raises:

yandex_music.exceptions.YandexMusicError – Базовое исключение библиотеки.

async tracks_lyrics(track_id, format_='TEXT', **kwargs)

Получение текста трека.

Note

Для работы с методом необходима авторизация.

Известные значения для аргумента format:

  • LRC - формат с временными метками.

  • TEXT - простой текст.

Parameters:

  • track_id (str | int) – Уникальный идентификатор трека.

  • format (str) – Формат текста.

  • **kwargs – Произвольные именованные аргументы (будут переданы в запрос).

Returns:

Информация о тексте трека.

Return type:

yandex_music.TrackLyrics | None

Raises:
async tracks_similar(track_id, *args, **kwargs)

Получение похожих треков.

Parameters:

  • track_id (str | int) – Уникальный идентификатор трека.

  • *args – Произвольные аргументы (будут переданы в запрос).

  • **kwargs – Произвольные именованные аргументы (будут переданы в запрос).

Returns:

Похожие треки на другой трек.

Return type:

yandex_music.SimilarTracks

Raises:

yandex_music.exceptions.YandexMusicError – Базовое исключение библиотеки.

async play_audio(track_id, from_, album_id, playlist_id=None, from_cache=False, play_id=None, uid=None, timestamp=None, track_length_seconds=0, total_played_seconds=0, end_position_seconds=0, client_now=None, *args, **kwargs)

Метод для отправки текущего состояния прослушиваемого трека.

Parameters:

  • track_id (str | int) – Уникальный идентификатор трека.

  • from (str) – Наименования клиента с которого происходит прослушивание.

  • album_id (str | int) – Уникальный идентификатор альбома.

  • playlist_id (str, optional) – Уникальный идентификатор плейлиста, если таковой прослушивается.

  • from_cache (bool, optional) – Проигрывается ли трек с кеша.

  • play_id (str, optional) – Уникальный идентификатор проигрывания.

  • uid (int, optional) – Уникальный идентификатор пользователя.

  • timestamp (str, optional) – Текущая дата и время в ISO.

  • track_length_seconds (int, optional) – Продолжительность трека в секундах.

  • total_played_seconds (int, optional) – Сколько было всего воспроизведено трека в секундах.

  • end_position_seconds (int, optional) – Окончательное значение воспроизведенных секунд.

  • client_now (str, optional) – Текущая дата и время клиента в ISO.

  • *args – Произвольные аргументы (будут переданы в запрос).

  • **kwargs – Произвольные именованные аргументы (будут переданы в запрос).

Returns:

True при успешном выполнении запроса, иначе False.

Return type:

bool

Raises:

yandex_music.exceptions.YandexMusicError – Базовое исключение библиотеки.

async after_track(next_track_id, context_item, prev_track_id=None, context='playlist', types='shot', from_='mobile-landing-origin-default', *args, **kwargs)

Получение рекламы или шота от Алисы после трека.

Note

При получения шота от Алисы prev_track_id можно не указывать.

Если context = ‘playlist’, то в context_item необходимо передать {OWNER_PLAYLIST}:{ID_PLAYLIST}. Плейлист с Алисой имеет владельца с id = 940441070.

ID плейлиста можно получить из блоков landing’a. Получить шот чужого плейлиста нельзя.

Известные значения context: playlist.

Известные значения types: shot, ad.

Parameters:

  • prev_track_id (str | int) – Уникальный идентификатор предыдущего трека.

  • next_track_id (str | int) – Уникальный идентификатор следующего трека.

  • context_item (str) – Уникальный идентификатор контекста.

  • context (str, optional) – Место, откуда было вызвано получение.

  • types (str, optional) – Тип того, что вернуть после трека.

  • from (str, optional) – Место, с которого попали в контекст.

  • *args – Произвольные аргументы (будут переданы в запрос).

  • **kwargs – Произвольные именованные аргументы (будут переданы в запрос).

Returns:

Шот от Алисы или None.

Return type:

yandex_music.ShotEvent

Raises:

yandex_music.exceptions.YandexMusicError – Базовое исключение библиотеки.

async tracks_trailer(track_id, *args, **kwargs)

Получение трейлера трека.

Parameters:

  • track_id (str | int) – Уникальный идентификатор трека.

  • *args – Произвольные аргументы (будут переданы в запрос).

  • **kwargs – Произвольные именованные аргументы (будут переданы в запрос).

Returns:

Трейлер трека или None.

Return type:

yandex_music.TrackTrailer | None

Raises:

yandex_music.exceptions.YandexMusicError – Базовое исключение библиотеки.

async tracks_full_info(track_id, *args, **kwargs)

Получение полной информации о треке.

Parameters:

  • track_id (str | int) – Уникальный идентификатор трека.

  • *args – Произвольные аргументы (будут переданы в запрос).

  • **kwargs – Произвольные именованные аргументы (будут переданы в запрос).

Returns:

Полная информация о треке или None.

Return type:

yandex_music.TrackFullInfo | None

Raises:

yandex_music.exceptions.YandexMusicError – Базовое исключение библиотеки.