Хранилище медиа-ресурсов
07.05.2017
Медиамагазин (хранилище медиаресурсов) предназначен для получения информации о звуковых ресурсах, расположенных во внутреннем или внешнем хранилище устройства. К медиаданным относятся звуковые файлы, системные сигналы, сигналы будильника, уведомлений, рингтоны, графика и др.
Медиамагазин создаётся с помощью конструктора CreatуMediaStore:
app.CreateMediaStore();
Базовый пример
Выполнить в DS
Методы:
- GetAlbumArt( {} img, int id, (str) options ) - возвращает информацию об альбоме
Выполнить в DS
app.ShowPopup( myObject.GetAlbumArt() );
- GetSongArt( {} img, int id, (str) options ) - возвращает информацию об исполнителе
Выполнить в DS
app.ShowPopup( myObject.GetSongArt() );
- GetType() - возвращает тип объекта
Выполнить в DS
app.ShowPopup( myObject.GetType() );
- QueryAlbums( str filter, [(str)] sort, (str) options ) - запрашивает медиаданные по альбомам. Доступна фильтрация, сортировка и опции
Выполнить в DS
myObject.QueryAlbums();
- QueryArtists( str filter, [(str)] sort, (str) options ) - запрашивает медиаданные по артистам. Доступна фильтрация, сортировка и опции
Выполнить в DS
app.ShowPopup( myObject.QueryArtists() );
- QueryMedia( str filter, [(str)] sort, (str) options ) - запрашивает медиаданные. Доступна фильтрация, сортировка и опции 'internal' или 'external'. Опции сортировки:
- album - альбом
- artist - исполнитель
- genre - жанр (действует, если не задана опция artist)
- title - название (действует, если не задана опция artist)
- composer - композитор (действует, если не задана опция artist)
- author - автор (действует, если не задана опция artist)
- duration - длительность (действует, если не задана опция artist)
Выполнить в DS
myObject.QueryMedia( '', 'artist,album', 'external' );
- SetOnAlbumsResult( callback ) - задаёт ФОВ для получения данных по альбомам. Во входной параметр ФОВ система передаёт массив объектов со следующими полями:
- int id - идентификатор альбома
- str album - название альбома
- str artist - название исполнителя
- int numSongs - количество песен
- SetOnArtistsResult( callback ) - задаёт ФОВ для получения данных по артистам. Во входной параметр ФОВ система передаёт массив объектов со следующими полями:
- int id - идентификатор исполнителя
- str artist - название исполнителя
- int numAlbums - количество альбомов
- int numTracks - количество треков
- SetOnMediaResult( callback([{}]) ) - задаёт ФОВ для обработки медиаданных. Во входной параметр ФОВ система передаёт массив объектов со следующими полями:
- str title - название медиаресурса
- int albumId - идентификатор альбома
- str album - название альбома:
- 'ui' - сигналы интерфейса
- 'alarms' - будильник
- 'notifications' - уведомления
- 'ringtones' - рингтоны
- int artistId - идентификатор исполнителя
- str artist - название исполнителя
- int duration - продолжительность воспроизвнедения в мс
- int size - размер в байтах
- str uri - унифицированный идентификатор ресурса