Compare commits
3 Commits
50da85be57
...
v0.0.8
| Author | SHA1 | Date | |
|---|---|---|---|
|
|
5541d0ad27 | ||
|
|
ea9f392896 | ||
|
|
6dcf39de56 |
2
.gitignore
vendored
2
.gitignore
vendored
@@ -361,4 +361,4 @@ MigrationBackup/
|
||||
|
||||
# Fody - auto-generated XML schema
|
||||
FodyWeavers.xsd
|
||||
/YaMusicCli/YaMusicCli.csproj
|
||||
YaMusicCli/
|
||||
|
||||
@@ -1,16 +0,0 @@
|
||||
using YandexMusic.API.Extensions.API;
|
||||
|
||||
internal class Program
|
||||
{
|
||||
private async static Task Main(string[] args)
|
||||
{
|
||||
var client = new YandexMusic.YandexMusicClient();
|
||||
var type = await client.Authorize("y0__xDy2budARje-AYg7rmliBc11LbYoMeUiwiO6f6mSCAMDYVIKg");
|
||||
var playlists = (await client.GetFavoritesAsync()).Where(t => t.Owner.Uid == client.Account.Uid).ToList();
|
||||
var playlist = await client.GetPlaylistAsync("97ae0768-8a40-8485-9fa4-b6c856bc6b21");
|
||||
var tracks = playlist.Tracks.Where(t => t.Id == "21696942").Select(t => t.Track).ToArray();
|
||||
var x = await playlist.RemoveTracksAsync(tracks);
|
||||
Console.WriteLine($"TC: {playlist.TrackCount}; {playlist.Title}");
|
||||
Console.ReadKey();
|
||||
}
|
||||
}
|
||||
@@ -36,6 +36,7 @@ public abstract class CommonRequestProvider : IRequestProvider
|
||||
Converters = {
|
||||
new JsonStringEnumConverter(JsonNamingPolicy.KebabCaseLower),
|
||||
new IntToStringConverter(),
|
||||
new StringToIntConverter(),
|
||||
new YExecutionContextConverter(api, storage),
|
||||
}
|
||||
};
|
||||
|
||||
42
YandexMusic.API/Converters/StringToIntConverter.cs
Normal file
42
YandexMusic.API/Converters/StringToIntConverter.cs
Normal file
@@ -0,0 +1,42 @@
|
||||
using System.Text.Json;
|
||||
using System.Text.Json.Serialization;
|
||||
|
||||
namespace YandexMusic.API.Converters;
|
||||
|
||||
public class StringToIntConverter : JsonConverter<int>
|
||||
{
|
||||
public override int Read(ref Utf8JsonReader reader, Type typeToConvert, JsonSerializerOptions options)
|
||||
{
|
||||
// Если текущий токен — строка
|
||||
if (reader.TokenType == JsonTokenType.String)
|
||||
{
|
||||
string? stringValue = reader.GetString();
|
||||
if (string.IsNullOrEmpty(stringValue))
|
||||
{
|
||||
throw new JsonException("Строка не может быть пустой или null для преобразования в int.");
|
||||
}
|
||||
|
||||
// Пробуем распарсить с учётом возможных пробелов и инвариантной культуры
|
||||
if (int.TryParse(stringValue.Trim(), out int result))
|
||||
{
|
||||
return result;
|
||||
}
|
||||
|
||||
throw new JsonException($"Невозможно преобразовать строку \"{stringValue}\" в int.");
|
||||
}
|
||||
|
||||
// Если токен — число (стандартное поведение)
|
||||
if (reader.TokenType == JsonTokenType.Number)
|
||||
{
|
||||
return reader.GetInt32();
|
||||
}
|
||||
|
||||
throw new JsonException($"Ожидалась строка или число, получен {reader.TokenType}.");
|
||||
}
|
||||
|
||||
public override void Write(Utf8JsonWriter writer, int value, JsonSerializerOptions options)
|
||||
{
|
||||
// Записываем число как обычное JSON-число
|
||||
writer.WriteNumberValue(value);
|
||||
}
|
||||
}
|
||||
@@ -1,4 +1,3 @@
|
||||
using System.Text.Json.Serialization;
|
||||
using YandexMusic.API.Models.Album;
|
||||
using YandexMusic.API.Models.Common;
|
||||
using YandexMusic.API.Models.Common.Cover;
|
||||
@@ -11,7 +10,6 @@ public class YArtistBriefInfo
|
||||
{
|
||||
public YButton ActionButton { get; set; }
|
||||
public List<YAlbum> Albums { get; set; }
|
||||
[JsonConverter(typeof(YCoverConverter))]
|
||||
public List<YCover> AllCovers { get; set; }
|
||||
public List<YAlbum> AlsoAlbums { get; set; }
|
||||
public YArtist Artist { get; set; }
|
||||
|
||||
@@ -1,33 +1,7 @@
|
||||
using System.Text.Json;
|
||||
using System.Text.Json.Serialization;
|
||||
|
||||
namespace YandexMusic.API.Models.Common.Cover;
|
||||
|
||||
public class YCoverConverter : JsonConverter<YCover>
|
||||
{
|
||||
public override YCover? Read(ref Utf8JsonReader reader, Type typeToConvert, JsonSerializerOptions options)
|
||||
{
|
||||
if (reader.TokenType != JsonTokenType.StartObject) return null;
|
||||
using var doc = JsonDocument.ParseValue(ref reader);
|
||||
var root = doc.RootElement;
|
||||
var type = root.TryGetProperty("type", out var t) ? t.GetString() : null;
|
||||
if (root.TryGetProperty("error", out _)) type = "error";
|
||||
|
||||
return type switch
|
||||
{
|
||||
"color" => JsonSerializer.Deserialize<YCoverColor>(root.GetRawText(), options),
|
||||
"error" => JsonSerializer.Deserialize<YCoverError>(root.GetRawText(), options),
|
||||
"from-artist-photos" or "from-album-cover" => JsonSerializer.Deserialize<YCoverImage>(root.GetRawText(), options),
|
||||
"pic" => JsonSerializer.Deserialize<YCoverPic>(root.GetRawText(), options),
|
||||
"mosaic" => JsonSerializer.Deserialize<YCoverMosaic>(root.GetRawText(), options),
|
||||
_ => new YCover() { Type = YCoverType.Error }
|
||||
};
|
||||
}
|
||||
|
||||
public override void Write(Utf8JsonWriter writer, YCover value, JsonSerializerOptions options)
|
||||
=> JsonSerializer.Serialize(writer, value, options);
|
||||
}
|
||||
|
||||
[JsonConverter(typeof(YCoverConverter))]
|
||||
public class YCover
|
||||
{
|
||||
|
||||
29
YandexMusic.API/Models/Common/Cover/YCoverConverter.cs
Normal file
29
YandexMusic.API/Models/Common/Cover/YCoverConverter.cs
Normal file
@@ -0,0 +1,29 @@
|
||||
using System.Text.Json;
|
||||
using System.Text.Json.Serialization;
|
||||
|
||||
namespace YandexMusic.API.Models.Common.Cover;
|
||||
|
||||
public class YCoverConverter : JsonConverter<YCover>
|
||||
{
|
||||
public override YCover? Read(ref Utf8JsonReader reader, Type typeToConvert, JsonSerializerOptions options)
|
||||
{
|
||||
if (reader.TokenType != JsonTokenType.StartObject) return null;
|
||||
using var doc = JsonDocument.ParseValue(ref reader);
|
||||
var root = doc.RootElement;
|
||||
var type = root.TryGetProperty("type", out var t) ? t.GetString() : null;
|
||||
if (root.TryGetProperty("error", out _)) type = "error";
|
||||
|
||||
return type switch
|
||||
{
|
||||
"color" => JsonSerializer.Deserialize<YCoverColor>(root.GetRawText(), options),
|
||||
"error" => JsonSerializer.Deserialize<YCoverError>(root.GetRawText(), options),
|
||||
"from-artist-photos" or "from-album-cover" => JsonSerializer.Deserialize<YCoverImage>(root.GetRawText(), options),
|
||||
"pic" => JsonSerializer.Deserialize<YCoverPic>(root.GetRawText(), options),
|
||||
"mosaic" => JsonSerializer.Deserialize<YCoverMosaic>(root.GetRawText(), options),
|
||||
_ => new YCover() { Type = YCoverType.Error }
|
||||
};
|
||||
}
|
||||
|
||||
public override void Write(Utf8JsonWriter writer, YCover value, JsonSerializerOptions options)
|
||||
=> JsonSerializer.Serialize(writer, value, options);
|
||||
}
|
||||
@@ -227,4 +227,4 @@ var storage = new AuthStorage(settings: debug);
|
||||
**Версия**: 0.0.1
|
||||
**Платформа**: .NET 10
|
||||
**Язык**: C# 12
|
||||
**Обновлено**: 2024
|
||||
**Обновлено**: 2026
|
||||
|
||||
201
YandexMusic/README.md
Normal file
201
YandexMusic/README.md
Normal file
@@ -0,0 +1,201 @@
|
||||
# YandexMusicClient
|
||||
|
||||
Асинхронный клиент для работы с API Яндекс.Музыки на C#.
|
||||
Предоставляет удобные методы для авторизации, получения треков, альбомов, плейлистов, управления библиотекой, радио, очередями, а также поддержку WebSocket‑плеера Ynison.
|
||||
|
||||
---
|
||||
|
||||
## 📦 Возможности
|
||||
|
||||
- ✅ Полная поддержка API Яндекс.Музыки (треки, альбомы, исполнители, плейлисты, радио, очереди)
|
||||
- ✅ Авторизация по токену, QR‑коду, e‑mail, паролю приложения, капче
|
||||
- ✅ Управление библиотекой (лайки/дизлайки треков, альбомов, исполнителей, плейлистов)
|
||||
- ✅ Поиск по всем типам контента
|
||||
- ✅ Создание и редактирование плейлистов
|
||||
- ✅ Загрузка пользовательских треков (UGC)
|
||||
- ✅ Работа с радиостанциями
|
||||
- ✅ Управление очередями воспроизведения
|
||||
- ✅ WebSocket‑плеер Ynison для синхронизации состояния между устройствами
|
||||
|
||||
---
|
||||
|
||||
## 🚀 Установка
|
||||
|
||||
### NuGet (если библиотека опубликована)
|
||||
```bash
|
||||
dotnet add package YandexMusic
|
||||
```
|
||||
|
||||
### Или добавьте проект вручную
|
||||
Склонируйте репозиторий и добавьте ссылку на проект `YandexMusic` в ваше решение.
|
||||
|
||||
---
|
||||
|
||||
## 🏁 Быстрый старт
|
||||
|
||||
### 1. Инициализация клиента и авторизация по токену
|
||||
|
||||
```csharp
|
||||
using YandexMusic;
|
||||
|
||||
var client = new YandexMusicClient();
|
||||
string token = "ваш_токен_доступа";
|
||||
|
||||
bool success = await client.Authorize(token);
|
||||
if (success)
|
||||
{
|
||||
Console.WriteLine($"Авторизован как {client.Account.DisplayName}");
|
||||
}
|
||||
else
|
||||
{
|
||||
Console.WriteLine("Ошибка авторизации");
|
||||
}
|
||||
```
|
||||
|
||||
### 2. Получение трека по ID
|
||||
|
||||
```csharp
|
||||
var track = await client.GetTrackAsync("12345678");
|
||||
if (track != null)
|
||||
{
|
||||
Console.WriteLine($"{track.Artists[0].Name} - {track.Title}");
|
||||
}
|
||||
```
|
||||
|
||||
### 3. Получение плейлиста
|
||||
|
||||
```csharp
|
||||
// плейлист пользователя с uid = 1234567890 и kind = 5
|
||||
var playlist = await client.GetPlaylistAsync("1234567890", "5");
|
||||
Console.WriteLine($"Плейлист: {playlist.Title}, треков: {playlist.TrackCount}");
|
||||
```
|
||||
|
||||
### 4. Поиск треков
|
||||
|
||||
```csharp
|
||||
var searchResult = await client.SearchAsync("Imagine Dragons", YSearchType.Track);
|
||||
if (searchResult?.Tracks?.Results != null)
|
||||
{
|
||||
foreach (var track in searchResult.Tracks.Results)
|
||||
Console.WriteLine($"{track.Artists[0].Name} - {track.Title}");
|
||||
}
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 📚 Примеры использования
|
||||
|
||||
### 🔹 Работа с библиотекой (лайки)
|
||||
|
||||
```csharp
|
||||
// Получить лайкнутые треки
|
||||
var likedTracks = await client.GetLikedTracksAsync();
|
||||
|
||||
// Получить дизлайкнутых исполнителей
|
||||
var dislikedArtists = await client.GetDislikedArtistsAsync();
|
||||
```
|
||||
|
||||
### 🔹 Создание плейлиста
|
||||
|
||||
```csharp
|
||||
var newPlaylist = await client.CreatePlaylistAsync("Мой новый плейлист");
|
||||
Console.WriteLine($"Создан плейлист {newPlaylist.Title} (kind={newPlaylist.Kind})");
|
||||
```
|
||||
|
||||
### 🔹 Загрузка собственного трека (UGC)
|
||||
|
||||
```csharp
|
||||
// Сначала создайте или получите плейлист, куда загружать
|
||||
var playlist = await client.GetPlaylistAsync("uid", "kind");
|
||||
|
||||
// Загрузка из файла
|
||||
string uploadResult = await client.UploadTrackToPlaylistAsync(playlist, "my_song.mp3", @"C:\music\my_song.mp3");
|
||||
|
||||
// Загрузка из массива байтов
|
||||
byte[] audioData = File.ReadAllBytes(@"C:\music\my_song.mp3");
|
||||
string result = await client.UploadTrackToPlaylistAsync(playlist, "my_song.mp3", audioData);
|
||||
```
|
||||
|
||||
### 🔹 Радио
|
||||
|
||||
```csharp
|
||||
// Получить список рекомендованных станций
|
||||
var stations = await client.GetRadioDashboardAsync();
|
||||
var firstStation = stations.First();
|
||||
|
||||
// Получить треки станции
|
||||
var stationTracks = await firstStation.GetTracksAsync();
|
||||
foreach (var seqItem in stationTracks)
|
||||
{
|
||||
Console.WriteLine(seqItem.Track.Title);
|
||||
}
|
||||
```
|
||||
|
||||
### 🔹 Очереди воспроизведения
|
||||
|
||||
```csharp
|
||||
// Получить все очереди
|
||||
var queues = await client.GetQueuesAsync();
|
||||
|
||||
// Создать новую очередь
|
||||
var newQueue = await client.CreateQueueAsync(new YQueue { ... });
|
||||
```
|
||||
|
||||
### 🔹 Ynison – WebSocket плеер (синхронизация между устройствами)
|
||||
|
||||
```csharp
|
||||
// Подключиться к Ynison
|
||||
await client.ConnectYnisonAsync();
|
||||
|
||||
// Подписаться на события
|
||||
if (client.Ynison != null)
|
||||
{
|
||||
client.Ynison.OnReceive += (sender, args) =>
|
||||
{
|
||||
Console.WriteLine($"Новое состояние: {args.State.PlayerState.Status.Paused}");
|
||||
};
|
||||
}
|
||||
|
||||
// ... работа
|
||||
|
||||
// Отключиться
|
||||
await client.DisconnectYnisonAsync();
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## ⚠️ Обработка ошибок
|
||||
|
||||
Методы клиента выбрасывают исключения в случае ошибок API или сети. Рекомендуется оборачивать вызовы в try-catch:
|
||||
|
||||
```csharp
|
||||
try
|
||||
{
|
||||
var track = await client.GetTrackAsync("невалидный_id");
|
||||
}
|
||||
catch (HttpRequestException ex)
|
||||
{
|
||||
Console.WriteLine($"Ошибка сети: {ex.Message}");
|
||||
}
|
||||
catch (YErrorResponse ex)
|
||||
{
|
||||
Console.WriteLine($"Ошибка API: {ex.Error.Message}");
|
||||
}
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 📄 Лицензия
|
||||
|
||||
Данная библиотека распространяется под лицензией MIT.
|
||||
Неофициальный клиент, не связан с компанией Яндекс.
|
||||
|
||||
---
|
||||
|
||||
## 🤝 Вклад
|
||||
|
||||
Pull Request'ы приветствуются. Сообщения об ошибках и предложения по улучшению оформляйте через Issues.
|
||||
|
||||
---
|
||||
|
||||
**Приятного использования!** 🎵
|
||||
@@ -1,13 +1,16 @@
|
||||
<Project Sdk="Microsoft.NET.Sdk">
|
||||
|
||||
<PropertyGroup>
|
||||
<TargetFramework>net10.0</TargetFramework>
|
||||
<ImplicitUsings>enable</ImplicitUsings>
|
||||
<Nullable>enable</Nullable>
|
||||
</PropertyGroup>
|
||||
<PropertyGroup>
|
||||
<TargetFramework>net10.0</TargetFramework>
|
||||
<ImplicitUsings>enable</ImplicitUsings>
|
||||
<Nullable>enable</Nullable>
|
||||
<Authors>FrigaT</Authors>
|
||||
<Description>Асинхронная библиотека для неофициального API Яндекс Музыки.</Description>
|
||||
<PackageTags>yandex;music;api;async</PackageTags>
|
||||
</PropertyGroup>
|
||||
|
||||
<ItemGroup>
|
||||
<ProjectReference Include="..\YandexMusic.API\YandexMusic.API.csproj" />
|
||||
</ItemGroup>
|
||||
<ItemGroup>
|
||||
<ProjectReference Include="..\YandexMusic.API\YandexMusic.API.csproj" />
|
||||
</ItemGroup>
|
||||
|
||||
</Project>
|
||||
|
||||
Reference in New Issue
Block a user