CSharp_Practice/Tasks/PatternServiceLocatorTask.txt at main · VladimirVaize/CSharp_Practice · GitHub

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
Service Locator — это отличный паттерн, который часто используют в играх для доступа к глобальным сервисам
(звук, сохранения, логирование, менеджер сцен), не передавая ссылки через 10 слоев объектов.

Задание: "Система звукового менеджера с Service Locator"

Контекст

Ты делаешь консольную RPG.
В игре есть разные звуковые события: игрок атакует, получает урон, подбирает предмет, открывает дверь.
У тебя есть SoundManager, который умеет воспроизводить звуки
(в консоли это будет просто вывод текста типа *Звук атаки*).

Проблема: SoundManager нужен везде — в классе Player, в классе Enemy, в классе Chest.
Передавать его через конструктор каждого объекта утомительно. Решение: Service Locator.

Что нужно сделать

1. Создай интерфейс IAudioService
   Методы:
   - void PlaySound(string soundName)
   - void SetVolume(float volume) - от 0.0 до 1.0

2. Создай класс SoundManager, который реализует IAudioService

- PlaySound(string soundName) — выводит в консоль:
  "Воспроизведение звука: {soundName}"
- SetVolume(float volume) — сохраняет громкость в поле _currentVolume и выводит:
  "Громкость установлена на {volume * 100}%"

3. Создай класс ServiceLocator

- Статический класс (или с статическим методом)
- Содержит поле private static IAudioService _audioService
- Метод RegisterAudioService(IAudioService service) — регистрирует сервис
- Метод GetAudioService() — возвращает зарегистрированный сервис
- Важно: Если сервис не зарегистрирован, GetAudioService() должен выбрасывать исключение
  InvalidOperationException с понятным сообщением

4. В методе Main продемонстрируй работу:

- Создай экземпляр SoundManager
- Зарегистрируй его в ServiceLocator
- Создай класс Player (без привязки к SoundManager в конструкторе!)
  с методом Attack(), который воспроизводит звук атаки
- Создай класс Enemy с методом TakeDamage(), который воспроизводит звук получения урона
- Покажи, как из Player.Attack() и Enemy.TakeDamage() вызывается PlaySound() через Service Locator

Дополнительные условия

- Не используй статические поля внутри SoundManager (кроме синглтона, если захочешь — но это не обязательно).
  Service Locator уже решает задачу глобального доступа.
- Service Locator должен быть единственным местом, где хранится ссылка на IAudioService

Пример ожидаемого вывода в консоли:

Регистрация звукового сервиса...
Игрок атакует!
Воспроизведение звука: sword_swing
Враг получил урон!
Воспроизведение звука: enemy_hurt
Громкость установлена на 50%
Игрок атакует!
Воспроизведение звука: sword_swing

Бонус (если захочешь усложнить):

Добавь возможность замены сервиса во время выполнения.
В Main создай второй сервис PremiumSoundManager (тоже реализует IAudioService),
который выводит звуки с префексом [Premium].
Перерегистрируй его и покажи, что теперь звуки воспроизводятся через новый сервис.

Почему это задание важно:

Service Locator часто используют в игровых движках
(например, в Unity его вариации встречаются в архитектуре некоторых проектов).
Он позволяет:

- Не таскать через всю игру ссылки на менеджеры
- Легко заменять реализацию сервиса (например, для тестирования или разных платформ)