DroidScript
DroidScript
разработка мобильных приложений

Хранилище медиа-ресурсов

Справочник по DroidScript  
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 - унифицированный идентификатор ресурса
Справочник по DroidScript  
© 2016-2022  Александр Страшко