ТЕХНИЧЕСКАЯ ДОКУМЕНТАЦИЯ

Как управлять службу обновления медиа-контента

> Медиадисплей > Интеграции > Интеграция с Google
Дата обновления: 12 июня 2026 г. Дата публикации: 4 июня 2026 г. Автор: Жапов Ананда

Через оснастку services.msc

  • Запуск / остановка – кнопки на панели инструментов.
  • Автоматический запуск – тип запуска «Автоматически».
  • Параметры запуска – можно добавить аргумент (например, menu) в редакторах реестра (regedit), потом копируем путь Компьютер\HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\MediaDisplayContentService, далее в файлах ImagePath в конце указываем аргумент menu. Если аргумент передан, служба загрузит соответствующий INI-файл (например, menu.ini).

Команды sc

sc start MediaDisplayContentService
sc stop MediaDisplayContentService
sc query MediaDisplayContentService

Изменение конфигурации

Чтобы сменить конфигурацию (например, с flight на menu):
1. Остановите службу.
2. Запустите ServiceInstall.bat от администратора.
3. Выберите 2 – Удалить службу.
4. Снова запустите ServiceInstall.bat, выберите нужный конфиг и установите службу заново.
5. Запустите службу.

Либо измените аргумент в реестре ImagePath с помощью Run и перезапустите службу.

Логирование и коды ошибок

Журнал событий Windows

Служба пишет события в собственный журнал MediaDisplayContentService (при его наличии) или в стандартный Application. Для просмотра:
- Откройте Просмотр событий (eventvwr.msc).
- Перейдите в Журналы приложений и служб → MediaDisplayContentService (если создан) или в Журналы Windows → Приложение.
- Отфильтруйте по источнику MediaDisplayContentService.

Коды событий

Служба использует те же коды ошибок, что и консольная утилита:

Код Название Описание
0 Success Информационное сообщение (успешное выполнение).
1 ConfigurationError Ошибка в конфигурационном INI-файле.
2 FileNotFound Не найден файл (credentials.json, конфиг).
3 GoogleApiError Проблема при обращении к Google Sheets API.
4 InvalidDataFormat Неверный формат данных (JSON).
5 NetworkError Ошибка сети или недоступен сервер Медиадисплей.

Пример записи ошибки в журнале:

image

Логи установки/удаления

Файл ServiceInstall.log в папке Log/ содержит хронологию операций установщика.

Устранение неполадок

Служба не запускается

  • Убедитесь, что установлен .NET Framework 4.7.2 (или версия, под которую скомпилирован проект).
  • Проверьте права на чтение credentials.json и конфигурационных INI-файлов.
  • Убедитесь, что папка MD4_GoogleConnector\Configs существует и содержит выбранный INI-файл.
  • Запустите службу вручную и посмотрите Просмотр событий → «MediaDisplayContentService» – там будет указана причина.

Ошибка “Источник не найден” при установке

  • Запустите ServiceInstall.bat от имени администратора.
  • Если ошибка повторяется, предварительно удалите старый источник:
    cmd sc delete MediaDisplayContentService

Данные не обновляются на экране

  • Проверьте ApiUrl – сервер Медиадисплей должен быть доступен.
  • Убедитесь, что ReceiverId совпадает с именем приёмника в настройках сервера.
  • Проверьте правильность ListRange / source в конфигурации (особенно названия листов, регистр).
  • Включите сохранение OutputFileName во временный файл и проверьте, генерируется ли JSON.

Журнал событий MediaDisplayContentService не появляется

  • Запустите install_eventlog.bat от администратора.
  • Если всё равно не создаётся – служба будет использовать журнал Application. Фильтруйте по источнику MediaDisplayContentService.

Служба пишет ошибку SecurityException

  • Это означает, что у службы нет прав на запись в EventLog. Решение: запустите install_eventlog.bat от администратора (создаст журнал) или дайте права учётной записи LOCAL SERVICE на чтение/запись в ветку реестра HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\EventLog\Application. Однако служба автоматически переключится на файловое логирование (в C:\ProgramData\MediaDisplay\Logs\), если не может писать в EventLog.