Добавлен вывод названия трека и обложки в плеере

This commit is contained in:
FrigaT
2026-04-14 19:38:33 +03:00
parent acf02c85a7
commit 0381ef74ab
8 changed files with 139 additions and 29 deletions

View File

@@ -6,8 +6,7 @@
/// </summary>
public interface IAudioPlayerService
{
// ---------- Состояние плеера (для чтения) ----------
#region Состояние плеера (для чтения)
/// <summary>ID текущего воспроизводимого трека (null, если ничего не играет).</summary>
string? CurrentTrackId { get; }
@@ -26,13 +25,21 @@ public interface IAudioPlayerService
/// <summary>Отформатированная общая длительность (мм:сс).</summary>
string TotalTime { get; }
// ---------- Команды управления (вызываются из компонентов) ----------
/// <summary>Отформатированное название текущего трека.</summary>
string? CurrentTrackTitle { get; }
/// <summary>URL обложки текущего трека.</summary>
string? CurrentTrackCoverUrl { get; }
#endregion
#region Команды управления (вызываются из компонентов)
/// <summary>Загрузить и начать воспроизведение трека.</summary>
/// <param name="trackId">ID трека.</param>
/// <param name="accessToken">Опциональный access-токен (если не указан, будет взят из хранилища).</param>
/// <param name="sharedPlaylistId">ID расшаренного плейлиста (для неавторизованного доступа).</param>
Task LoadAndPlayAsync(string trackId, string? accessToken = null, string? sharedPlaylistId = null);
/// <param name="title">Название трека. (Если не передано, вызывает api для получения)</param>
/// <param name="coverUrl">URL обложки трека. (Если не передано, вызывает api для получения)</param>
Task LoadAndPlayAsync(string trackId, string? accessToken = null, string? sharedPlaylistId = null, string? title = null, string? coverUrl = null);
/// <summary>Воспроизвести (если трек загружен и на паузе).</summary>
Task PlayAsync();
@@ -48,20 +55,18 @@ public interface IAudioPlayerService
/// <summary>Установить громкость (0100).</summary>
Task SetVolumeAsync(double volume);
#endregion
// ---------- События для подписки на изменения состояния ----------
#region События для подписки на изменения состояния
/// <summary>
/// Событие, возникающее при любом изменении состояния плеера:
/// смена трека, старт/пауза/стоп, обновление прогресса, изменение громкости, окончание трека.
/// Подписывайтесь на него, чтобы перерисовывать UI (например, иконку "пауза/плей").
/// </summary>
event Action? OnStateChanged;
#endregion
// ---------- События для связи с реальным компонентом AudioPlayer ----------
// (Эти события вызываются сервисом, а компонент AudioPlayer на них подписывается,
// чтобы выполнить фактические операции с HTML5 Audio.)
#region События для связи с реальным компонентом AudioPlayer (Эти события вызываются сервисом)
/// <summary>Запрос на загрузку и воспроизведение трека.</summary>
event Func<string, string?, string?, Task>? OnLoadAndPlayRequested;
@@ -79,10 +84,9 @@ public interface IAudioPlayerService
/// <summary>Запрос на изменение громкости (0100).</summary>
event Func<double, Task>? OnVolumeChangeRequested;
#endregion
// ---------- Методы для обновления состояния из AudioPlayer ----------
// (Вызываются компонентом AudioPlayer, когда реальный аудиоэлемент меняет своё состояние.)
#region Методы для обновления состояния из AudioPlayer (Вызываются компонентом AudioPlayer, когда реальный аудиоэлемент меняет своё состояние.)
/// <summary>Уведомить сервис о том, что трек начал или прекратил играть.</summary>
void SetPlayingState(bool isPlaying);
@@ -94,4 +98,5 @@ public interface IAudioPlayerService
/// <summary>Уведомить об окончании трека.</summary>
void NotifyTrackEnded();
#endregion
}