47 行
1.7 KiB
Markdown
47 行
1.7 KiB
Markdown
# Асинхронный клиент
|
||
|
||
Приступив к работе первым делом необходимо создать экземпляр клиента.
|
||
|
||
Инициализация асинхронного клиента:
|
||
|
||
``` python
|
||
from yandex_music import ClientAsync
|
||
|
||
client = ClientAsync()
|
||
await client.init()
|
||
|
||
# или
|
||
|
||
client = await Client().init()
|
||
```
|
||
|
||
После успешного создания клиента вы вольны в выборе необходимого метода из API. Все они доступны у объекта класса `ClientAsync` и описаны ниже. Используйте навигацию из меню справа для быстрого доступа.
|
||
|
||
**Особенности использования асинхронного клиента**
|
||
|
||
При работе с асинхронной версией библиотеке стоит всегда помнить
|
||
следующие особенности:
|
||
- Клиент следует импортировать с названием `ClientAsync`, а не просто `Client`.
|
||
- При использовании методов-сокращений нужно выбирать метод с суффиксом `_async`.
|
||
|
||
Пояснение ко второму пункту:
|
||
|
||
``` python
|
||
from yandex_music import ClientAsync
|
||
|
||
client = await ClientAsync('token').init()
|
||
liked_short_track = (await client.users_likes_tracks())[0]
|
||
|
||
# правильно
|
||
full_track = await liked_short_track.fetch_track_async()
|
||
await full_track.download_async()
|
||
|
||
# НЕПРАВИЛЬНО
|
||
full_track = await liked_short_track.fetch_track()
|
||
await full_track.download()
|
||
```
|
||
|
||
```{eval-rst}
|
||
.. include:: yandex_music.client_async.rst
|
||
```
|