3 Commits

Author SHA1 Message Date
FrigaT
5541d0ad27 fix Artist api
All checks were successful
Release / pack-and-publish (release) Successful in 40s
2026-04-16 18:43:07 +03:00
FrigaT
ea9f392896 Добавлен конвертер string->int
All checks were successful
Release / pack-and-publish (release) Successful in 9m39s
2026-04-14 21:25:59 +03:00
FrigaT
6dcf39de56 Добавлен readme
All checks were successful
Release / pack-and-publish (release) Successful in 30s
2026-04-14 02:54:03 +03:00
10 changed files with 286 additions and 54 deletions

2
.gitignore vendored
View File

@@ -361,4 +361,4 @@ MigrationBackup/
# Fody - auto-generated XML schema
FodyWeavers.xsd
/YaMusicCli/YaMusicCli.csproj
YaMusicCli/

View File

@@ -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();
}
}

View File

@@ -36,6 +36,7 @@ public abstract class CommonRequestProvider : IRequestProvider
Converters = {
new JsonStringEnumConverter(JsonNamingPolicy.KebabCaseLower),
new IntToStringConverter(),
new StringToIntConverter(),
new YExecutionContextConverter(api, storage),
}
};

View 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);
}
}

View File

@@ -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; }

View File

@@ -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
{

View 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);
}

View File

@@ -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
View File

@@ -0,0 +1,201 @@
# YandexMusicClient
Асинхронный клиент для работы с API Яндекс.Музыки на C#.
Предоставляет удобные методы для авторизации, получения треков, альбомов, плейлистов, управления библиотекой, радио, очередями, а также поддержку WebSocketплеера Ynison.
---
## 📦 Возможности
- ✅ Полная поддержка API Яндекс.Музыки (треки, альбомы, исполнители, плейлисты, радио, очереди)
- ✅ Авторизация по токену, QRкоду, email, паролю приложения, капче
- ✅ Управление библиотекой (лайки/дизлайки треков, альбомов, исполнителей, плейлистов)
- ✅ Поиск по всем типам контента
- ✅ Создание и редактирование плейлистов
- ✅ Загрузка пользовательских треков (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.
---
**Приятного использования!** 🎵

View File

@@ -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>