UPnP-служба медиасервера UMS
UMS предоставляет расширенную UPnP-службу, через которую внешние точки управления могут взаимодействовать с дополнительными возможностями системы.
Использование
Служба доступна в пространстве имён schemas-upnp-org с типом службы UmsExtendedServices.
Для Java-точек управления, использующих JUPnP, вызовите findService на RemoteDevice UMS:
RemoteService umsServicesService = remoteDevice.findService(
new ServiceType("schemas-upnp-org", "UmsExtendedServices"));
Через этот интерфейс службы доступны следующие действия
Взаимодействие с MyMusic
К понравившимся альбомам можно перейти, используя идентификатор объекта MYMUSIC$ как глубокую ссылку, или через раздел My Albums в корневой папке.
Поддержание избранного особенно полезно в больших коллекциях альбомов, где ручной просмотр всей библиотеки может занимать много времени. Список понравившихся альбомов помогает пользователям быстро возвращаться к нужному контенту без повторных широких поисков или глубокой навигации по папкам.
На практике избранное даёт следующие преимущества:
- Более быстрый доступ к часто проигрываемым альбомам, даже в очень больших библиотеках.
- Улучшение повседневной навигации за счёт отделения предпочитаемого контента от полного каталога.
- Более согласованные сценарии воспроизведения для клиентов и автоматизаций, зависящих от стабильного выбора альбомов.
Входные параметры
Все действия в этом разделе требуют входной параметр. Альбом должен быть идентифицирован с помощью MusicBrainz ID или Discogs release ID. Необходимо указать как минимум один ID; в противном случае действие не будет выполнено.
Пример для альбома Мадонны Like a Virgin:
| Атрибут | Тип | Пример значения |
|---|---|---|
| MusicBrainzId | String | b69580b9-7050-3994-b544-4407a22c097a |
| DiscogsId | UnsignedIntegerFourBytes | 1069538 |
Если при добавлении альбома в понравившиеся были указаны оба параметра (MusicBrainzId и DiscogsId), то при удалении из понравившихся также необходимо указать оба.
LikeAlbum
Отмечает альбом как понравившийся.
DislikeAlbum
Убирает альбом из понравившихся.
IsAlbumLikedInput
Проверяет, отмечен ли альбом в данный момент как понравившийся. Если указаны оба ID— MusicBrainz и Discogs, — метод возвращает true, если хотя бы один из ID отмечен как понравившийся.
Backup Actions
Служба предоставляет действия для резервного копирования и восстановления.
Перед восстановлением необходимо создать резервную копию.
BackupAudioLikes
Создаёт резервную копию таблицы понравившихся аудиоальбомов, идентифицируемых по MusicBrainz или Discogs ID.
RestoreAudioLikes
Восстанавливает таблицу понравившихся альбомов. Перед выполнением этого действия вызовите BackupAudioLikes.
BackupRatings
Записывает данные оценок аудио в файл резервной копии, содержащий хеш файла и значение оценки.
RestoreRatings
Восстанавливает информацию об оценках из резервной копии, созданной с помощью BackupRatings.
Library Interactions
RescanMediaStore
Выполняет полное пересканирование музыкальной библиотеки.
RescanMediaStoreFolder
Выполняет пересканирование указанной папки без рекурсивного обхода. Входным параметром должен быть ObjectID папки.