Добавьте файлы проекта.

2026-04-10 12:12:33 +03:00
parent 9615cf42ee
commit 11d0b0d72f
383 changed files with 9661 additions and 0 deletions
--- a/YandexMusic.API/API/YTrackAPIAsync.cs
+++ b/YandexMusic.API/API/YTrackAPIAsync.cs
@@ -0,0 +1,308 @@
+using System.Security.Cryptography;
+using System.Text;
+
+using YandexMusic.API.Common;
+using YandexMusic.API.Models.Common;
+using YandexMusic.API.Models.Track;
+using YandexMusic.API.Requests.Track;
+
+namespace YandexMusic.API
+{
+    /// <summary>
+    /// API для взаимодействия с треками
+    /// </summary>
+    public partial class YTrackAPI : YCommonAPI
+    {
+        #region Вспомогательные функции
+
+        private string BuildLinkForDownload(YTrackDownloadInfo mainDownloadResponse, YStorageDownloadFile storageDownload)
+        {
+            string path = storageDownload.Path;
+            string host = storageDownload.Host;
+            string ts = storageDownload.Ts;
+            string s = storageDownload.S;
+            string codec = mainDownloadResponse.Codec;
+
+            string secret = $"XGRlBW9FXlekgbPrRHuSiA{path.Substring(1, path.Length - 1)}{s}";
+            MD5 md5 = MD5.Create();
+            byte[] md5Hash = md5.ComputeHash(Encoding.UTF8.GetBytes(secret));
+            HMACSHA1 hmacsha1 = new();
+            byte[] hmasha1Hash = hmacsha1.ComputeHash(md5Hash);
+            string sign = BitConverter.ToString(hmasha1Hash).Replace("-", "").ToLower();
+
+            string link = $"https://{host}/get-{codec}/{sign}/{ts}{path}";
+
+            return link;
+        }
+
+        #endregion Вспомогательные функции
+
+
+
+        public YTrackAPI(YandexMusicApi yandex) : base(yandex)
+        {
+        }
+
+        /// <summary>
+        /// Получение треков
+        /// </summary>
+        /// <param name="storage">Хранилище</param>
+        /// <param name="trackId">Идентификатор трека</param>
+        /// <returns></returns>
+        public Task<YResponse<List<YTrack>>> GetAsync(AuthStorage storage, string trackId)
+        {
+            return new YGetTracksBuilder(api, storage)
+                .Build(new[] { trackId })
+                .GetResponseAsync();
+        }
+
+        /// <summary>
+        /// Получение треков
+        /// </summary>
+        /// <param name="storage">Хранилище</param>
+        /// <param name="trackIds">Идентификаторы треков</param>
+        /// <returns></returns>
+        public Task<YResponse<List<YTrack>>> GetAsync(AuthStorage storage, IEnumerable<string> trackIds)
+        {
+            return new YGetTracksBuilder(api, storage)
+                .Build(trackIds)
+                .GetResponseAsync();
+        }
+
+        /// <summary>
+        /// Получение метаданных для загрузки
+        /// </summary>
+        /// <param name="storage">Хранилище</param>
+        /// <param name="trackKey">Ключ трека в формате {идентифактор трека:идентификатор альбома}</param>
+        /// <param name="direct">Должен ли ответ содержать прямую ссылку на загрузку</param>
+        /// <returns></returns>
+        public Task<YResponse<List<YTrackDownloadInfo>>> GetMetadataForDownloadAsync(AuthStorage storage, string trackKey, bool direct = false)
+        {
+            return new YTrackDownloadInfoBuilder(api, storage)
+                .Build((trackKey, direct))
+                .GetResponseAsync();
+        }
+
+        /// <summary>
+        /// Получение метаданных для загрузки
+        /// </summary>
+        /// <param name="storage">Хранилище</param>
+        /// <param name="track">Трек</param>
+        /// <param name="direct">Должен ли ответ содержать прямую ссылку на загрузку</param>
+        /// <returns></returns>
+        public Task<YResponse<List<YTrackDownloadInfo>>> GetMetadataForDownloadAsync(AuthStorage storage, YTrack track, bool direct = false)
+        {
+            return GetMetadataForDownloadAsync(storage, track.GetKey().ToString(), direct);
+        }
+
+        /// <summary>
+        /// Получение информации для формирования ссылки для загрузки
+        /// </summary>
+        /// <param name="storage">Хранилище</param>
+        /// <param name="metadataInfo">Метаданные для загрузки</param>
+        /// <returns></returns>
+        public Task<YStorageDownloadFile> GetDownloadFileInfoAsync(AuthStorage storage, YTrackDownloadInfo metadataInfo)
+        {
+            return new YStorageDownloadFileBuilder(api, storage)
+                .Build(metadataInfo.DownloadInfoUrl)
+                .GetResponseAsync();
+        }
+
+        /// <summary>
+        /// Получение ссылки для загрузки
+        /// </summary>
+        /// <param name="storage">Хранилище</param>
+        /// <param name="trackKey">Ключ трека в формате {идентификатор трека:идентификатор альбома}</param>
+        /// <returns></returns>
+        public async Task<string> GetFileLinkAsync(AuthStorage storage, string trackKey)
+        {
+            YResponse<List<YTrackDownloadInfo>> meta = await GetMetadataForDownloadAsync(storage, trackKey);
+            YTrackDownloadInfo info = meta.Result
+                .OrderByDescending(i => i.BitrateInKbps)
+                .First(m => m.Codec == "mp3");
+            YStorageDownloadFile storageDownload = await GetDownloadFileInfoAsync(storage, info);
+            return BuildLinkForDownload(info, storageDownload);
+        }
+
+        /// <summary>
+        /// Получение ссылки для загрузки
+        /// </summary>
+        /// <param name="storage">Хранилище</param>
+        /// <param name="track">Трек</param>
+        /// <returns></returns>
+        public Task<string> GetFileLinkAsync(AuthStorage storage, YTrack track)
+        {
+            return GetFileLinkAsync(storage, track.GetKey().ToString());
+        }
+
+        /// <summary>
+        /// Отправка текущего состояния прослушиваемого трека
+        /// <param name="storage">Хранилище</param>
+        /// <param name="track">Трек</param>
+        /// <param name="from">Наименования клиента, с которого происходит прослушивание</param>
+        /// <param name="fromCache">Проигрывается ли трек с кеша</param>
+        /// <param name="playId">Уникальный идентификатор проигрывания</param>
+        /// <param name="playlistId">Уникальный идентификатор плейлиста, если таковой прослушивается</param>
+        /// <param name="totalPlayedSeconds">Сколько было всего воспроизведено трека в секундах</param>
+        /// <param name="endPositionSeconds">Окончательное значение воспроизведенных секунд</param>
+        /// </summary>
+        /// <returns></returns>
+        public Task<string> SendPlayTrackInfoAsync(AuthStorage storage, YTrack track, string from, bool fromCache = false, string playId = "", string playlistId = "", double totalPlayedSeconds = 0, double endPositionSeconds = 0)
+        {
+            return new YSendTrackInfoBuilder(api, storage)
+                .Build((track, from, fromCache, playId, playlistId, totalPlayedSeconds, endPositionSeconds))
+                .GetResponseAsync();
+        }
+
+        #region GetSupplement
+
+        /// <summary>
+        /// Получение дополнительной информации для трека
+        /// </summary>
+        /// <param name="storage">Хранилище</param>
+        /// <param name="trackId">Идентификатор трека</param>
+        /// <returns></returns>
+        public Task<YResponse<YTrackSupplement>> GetSupplementAsync(AuthStorage storage, string trackId)
+        {
+            return new YGetTrackSupplementBuilder(api, storage)
+                .Build(trackId)
+                .GetResponseAsync();
+        }
+
+        /// <summary>
+        /// Получение дополнительной информации для трека
+        /// </summary>
+        /// <param name="storage">Хранилище</param>
+        /// <param name="track">Трек</param>
+        /// <returns></returns>
+        public Task<YResponse<YTrackSupplement>> GetSupplementAsync(AuthStorage storage, YTrack track)
+        {
+            return new YGetTrackSupplementBuilder(api, storage)
+                .Build(track.GetKey().ToString())
+                .GetResponseAsync();
+        }
+
+        #endregion GetSupplement
+
+        #region GetSimilar
+
+        /// <summary>
+        /// Получение похожих треков
+        /// </summary>
+        /// <param name="storage">Хранилище</param>
+        /// <param name="trackId">Идентификатор трека</param>
+        /// <returns></returns>
+        public Task<YResponse<YTrackSimilar>> GetSimilarAsync(AuthStorage storage, string trackId)
+        {
+            return new YGetTrackSimilarBuilder(api, storage)
+                .Build(trackId)
+                .GetResponseAsync();
+        }
+
+        /// <summary>
+        /// Получение похожих треков
+        /// </summary>
+        /// <param name="storage">Хранилище</param>
+        /// <param name="track">Трек</param>
+        /// <returns></returns>
+        public Task<YResponse<YTrackSimilar>> GetSimilarAsync(AuthStorage storage, YTrack track)
+        {
+            return new YGetTrackSimilarBuilder(api, storage)
+                .Build(track.GetKey().ToString())
+                .GetResponseAsync();
+        }
+
+        #endregion GetSimilar
+
+        #region Получение данных трека
+
+        #region В файл
+
+        /// <summary>
+        /// Выгрузка в файл
+        /// </summary>
+        /// <param name="storage">Хранилище</param>
+        /// <param name="trackKey">Ключ трека в формате {идентификатор трека:идентификатор альбома}</param>
+        /// <param name="filePath">Путь для файла</param>
+        public async Task ExtractToFileAsync(AuthStorage storage, string trackKey, string filePath)
+        {
+            string url = await GetFileLinkAsync(storage, trackKey);
+            await new DataDownloader(storage).ToFile(url, filePath);
+        }
+
+        /// <summary>
+        /// Выгрузка в файл
+        /// </summary>
+        /// <param name="storage">Хранилище</param>
+        /// <param name="track">Трек</param>
+        /// <param name="filePath">Путь для файла</param>
+        public Task ExtractToFileAsync(AuthStorage storage, YTrack track, string filePath)
+        {
+            return ExtractToFileAsync(storage, track.GetKey().ToString(), filePath);
+        }
+
+        #endregion В файл
+
+        #region В массив байт
+
+        /// <summary>
+        /// Получение двоичного массива данных
+        /// </summary>
+        /// <param name="storage">Хранилище</param>
+        /// <param name="trackKey">Ключ трека в формате {идентификатор трека:идентификатор альбома}</param>
+        /// <returns></returns>
+        public async Task<byte[]> ExtractDataAsync(AuthStorage storage, string trackKey)
+        {
+            string url = await GetFileLinkAsync(storage, trackKey);
+            return await new DataDownloader(storage).AsBytes(url);
+        }
+
+        /// <summary>
+        /// Получение двоичного массива данных
+        /// </summary>
+        /// <param name="storage">Хранилище</param>
+        /// <param name="track">Трек</param>
+        /// <returns></returns>
+        public Task<byte[]> ExtractDataAsync(AuthStorage storage, YTrack track)
+        {
+            return ExtractDataAsync(storage, track.GetKey().ToString());
+        }
+
+        #endregion В массив байт
+
+        #region В поток
+
+        /// <summary>
+        /// Получение потока данных
+        /// </summary>
+        /// <param name="storage">Хранилище</param>
+        /// <param name="trackKey">Ключ трека в формате {идентификатор трека:идентификатор альбома}</param>
+        /// <param name="httpCompletionOption">Параметры передачи управления при http запросе</param>
+        /// <returns></returns>
+        public async Task<Stream> ExtractStreamAsync(AuthStorage storage, string trackKey,
+            HttpCompletionOption httpCompletionOption = HttpCompletionOption.ResponseContentRead)
+        {
+            string url = await GetFileLinkAsync(storage, trackKey);
+            return await new DataDownloader(storage).AsStream(url, httpCompletionOption);
+        }
+
+        /// <summary>
+        /// Получение потока данных
+        /// </summary>
+        /// <param name="storage">Хранилище</param>
+        /// <param name="track">Трек</param>
+        /// <param name="httpCompletionOption">Параметры передачи управления при http запросе</param>
+        /// <returns></returns>
+        public Task<Stream> ExtractStreamAsync(AuthStorage storage, YTrack track,
+            HttpCompletionOption httpCompletionOption = HttpCompletionOption.ResponseContentRead)
+        {
+            return ExtractStreamAsync(storage, track.GetKey().ToString(), httpCompletionOption);
+        }
+
+        #endregion В поток
+
+        #endregion Получение данных трека
+
+
+    }
+}