Поделиться через


Файлы и папки в библиотеках музыки, изображений и видео

Добавьте существующие папки музыки, рисунков или видео в соответствующие библиотеки. Вы также можете удалить папки из библиотек, получить список папок в библиотеке и обнаружить сохраненные фотографии, музыку и видео.

Библиотека — это виртуальная коллекция папок, которая включает известную папку по умолчанию и любые другие папки, которые пользователь добавил в библиотеку с помощью приложения или одного из встроенных приложений. Например, библиотека "Рисунки" включает известную папку "Изображения" по умолчанию. Пользователь может добавлять папки или удалять их из библиотеки изображений с помощью приложения или встроенного приложения "Фотографии".

Необходимые компоненты

  • Общее представление об асинхронном программировании для приложений универсальной платформы Windows (UWP).

    Вы можете узнать, как писать асинхронные приложения в C# или Visual Basic, см . статью "Вызов асинхронных API" в C# или Visual Basic. Сведения о написании асинхронных приложений в C++см. в статье "Асинхронное программирование" в C++.

  • Права доступа к расположению

    В Visual Studio откройте файл манифеста приложения в конструкторе манифестов. На странице "Возможности" выберите библиотеки, которыми управляет ваше приложение.

    • Библиотека музыки
    • Библиотека изображений
    • Библиотека видео

    Дополнительные сведения см. в разделе "Разрешения на доступ к файлам".

Получение ссылки на библиотеку

Примечание.

Обязательно объявите соответствующую возможность. Дополнительные сведения см. в статье Объявление возможностей приложения.  

Чтобы получить ссылку на библиотеку музыки, рисунков или видео пользователя, вызовите метод StorageLibrary.GetLibraryAsync . Укажите соответствующее значение из перечисления KnownLibraryId.

var myPictures = await Windows.Storage.StorageLibrary.GetLibraryAsync(Windows.Storage.KnownLibraryId.Pictures);

Получение списка папок в библиотеке

Чтобы получить список папок в библиотеке, получите значение свойства StorageLibrary.Folders.

using Windows.Foundation.Collections;
IObservableVector<Windows.Storage.StorageFolder> myPictureFolders = myPictures.Folders;

Получение папки в библиотеке, в которой по умолчанию сохраняются новые файлы

Чтобы получить папку в библиотеке, в которой по умолчанию сохраняются новые файлы, получите значение свойства StorageLibrary.SaveFolder.

Windows.Storage.StorageFolder savePicturesFolder = myPictures.SaveFolder;

Добавление существующей папки в библиотеку

Чтобы добавить папку в библиотеку, вызовите StorageLibrary.RequestAddFolderAsync. Использование библиотеки изображений в качестве примера, вызывая этот метод, приводит к отображению средства выбора папок пользователю с помощью кнопки "Добавить эту папку в рисунки ". Если пользователь выбирает папку, то папка остается в исходном расположении на диске и становится элементом в свойстве StorageLibrary.Folder (и в встроенном приложении "Фотографии"), но папка не отображается как дочерний элемент папки "Изображения" в проводник.

Windows.Storage.StorageFolder newFolder = await myPictures.RequestAddFolderAsync();

Удаление папки из библиотеки

Чтобы удалить папку из библиотеки, вызовите метод StorageLibrary.RequestRemoveFolderAsync и укажите папку, которую нужно удалить. Вы можете использовать storageLibrary.Folder и элемент управления ListView (или аналогичный), чтобы пользователь мог выбрать папку для удаления.

При вызове StorageLibrary.RequestRemoveFolderAsync пользователь видит диалоговое окно подтверждения того, что папка "больше не будет отображаться в "Изображениях", но не будет удалена". Это означает, что папка остается в исходном расположении на диске, удаляется из свойства StorageLibrary.Folders и больше не включается в встроенное приложение "Фотографии".

В следующем примере предполагается, что пользователь выбрал папку для удаления из элемента управления ListView с именем lvPictureFolders.

bool result = await myPictures.RequestRemoveFolderAsync(folder);

Получение уведомлений об изменениях списка папок в библиотеке

Чтобы получить уведомление об изменениях списка папок в библиотеке, зарегистрируйте обработчик события StorageLibrary.DefinitionChanged библиотеки.

myPictures.DefinitionChanged += MyPictures_DefinitionChanged;

void HandleDefinitionChanged(Windows.Storage.StorageLibrary sender, object args)
{
    // ...
}

Папки библиотеки мультимедиа

Устройство предоставляет пять предопределенных расположений для пользователей и приложений для хранения файлов мультимедиа. Встроенные приложения хранят как созданный пользователем носитель, так и скачанный носитель в этих расположениях.

Расположения:

  • Папка рисунков . Содержит рисунки.

    • Папка "Свертка камеры". Содержит фотографии и видео с встроенной камеры.

    • Папка "Сохраненные рисунки ". Содержит изображения, сохраненные пользователем из других приложений.

  • Папка музыки . Содержит песни, подкасты и звуковые книги.

  • Папка видео . Содержит видео.

Пользователи или приложения также могут хранить файлы мультимедиа за пределами папок библиотеки мультимедиа на SD-карте. Чтобы надежно найти файл мультимедиа на SD-карте, проверьте содержимое SD-карты или попросите пользователя найти файл с помощью средства выбора файлов. Дополнительные сведения см. в статье "Доступ к SD-карте".

Запрос библиотек мультимедиа

Чтобы получить коллекцию файлов, укажите библиотеку и тип нужных файлов.

using Windows.Storage;
using Windows.Storage.Search;

private async void getSongs()
{
    QueryOptions queryOption = new QueryOptions
        (CommonFileQuery.OrderByTitle, new string[] { ".mp3", ".mp4", ".wma" });

    queryOption.FolderDepth = FolderDepth.Deep;

    Queue<IStorageFolder> folders = new Queue<IStorageFolder>();

    var files = await KnownFolders.MusicLibrary.CreateFileQueryWithOptions
      (queryOption).GetFilesAsync();

    foreach (var file in files)
    {
        // do something with the music files
    }
}

Результаты запроса включают внутреннее и съемные хранилища

Пользователи могут хранить файлы по умолчанию на необязательной SD-карте. Однако приложения могут отказаться от разрешения хранения файлов на SD-карте. В результате библиотеки мультимедиа могут быть разделены по внутреннему хранилищу устройства и SD-карте.

Для обработки этой возможности вам не нужно писать дополнительный код. Методы в пространстве имен Windows.Storage , которые запрашивают известные папки, прозрачно объединяют результаты запроса из обоих расположений. Чтобы получить эти объединенные результаты, в файле манифеста приложения не нужно указывать возможность съемныхStorage .

Рассмотрим состояние хранилища устройства, показанное на следующем рисунке:

изображения на телефоне и sd card

Если вы запрашиваете содержимое библиотеки изображений путем вызова await KnownFolders.PicturesLibrary.GetFilesAsync(), результаты включают как internalPic.jpg, так и SDPic.jpg.

Работа с фотографиями

На устройствах, где камера сохраняет как изображение с низким разрешением, так и изображение с высоким разрешением каждого изображения, глубокие запросы возвращают только изображение с низким разрешением.

Каталог камеры и папка "Сохраненные изображения" не поддерживают глубокие запросы.

Открытие фотографии в приложении, с помощью которого она снята

Если вы хотите разрешить пользователю снова открыть фотографию позже в приложении, которое его захватило, можно сохранить CreatorAppId с метаданными фотографии с помощью кода, аналогичного следующему примеру. В этом примере testPhoto — это StorageFile.

IDictionary<string, object> propertiesToSave = new Dictionary<string, object>();

propertiesToSave.Add("System.CreatorOpenWithUIOptions", 1);
propertiesToSave.Add("System.CreatorAppId", appId);

testPhoto.Properties.SavePropertiesAsync(propertiesToSave).AsyncWait();   

Использование методов потоков для добавления файла в библиотеку мультимедиа

При доступе к библиотеке мультимедиа с помощью известной папки, такой как KnownFolders.PictureLibrary, и для добавления файла в библиотеку мультимедиа необходимо закрыть все открываемые вами потоки. В противном случае эти методы не могут добавить файл в библиотеку мультимедиа должным образом, так как хотя бы один поток по-прежнему имеет дескриптор файла.

Например, при выполнении следующего кода файл не добавляется в библиотеку мультимедиа. В строке кода using (var destinationStream = (await destinationFile.OpenAsync(FileAccessMode.ReadWrite)).GetOutputStreamAt(0)) методы OpenAsync и GetOutputStreamAt открывают поток. Однако только поток, открытый методом GetOutputStreamAt , удаляется в результате инструкции using . Другой поток остается открытым и предотвращает сохранение файла.

StorageFolder testFolder = await StorageFolder.GetFolderFromPathAsync(@"C:\test");
StorageFile sourceFile = await testFolder.GetFileAsync("TestImage.jpg");
StorageFile destinationFile = await KnownFolders.CameraRoll.CreateFileAsync("MyTestImage.jpg");
using (var sourceStream = (await sourceFile.OpenReadAsync()).GetInputStreamAt(0))
{
    using (var destinationStream = (await destinationFile.OpenAsync(FileAccessMode.ReadWrite)).GetOutputStreamAt(0))
    {
        await RandomAccessStream.CopyAndCloseAsync(sourceStream, destinationStream);
    }
}

Чтобы использовать методы потоков для успешного добавления файла в библиотеку мультимедиа, закройте все открываемые вами потоки, как показано в следующем примере.

StorageFolder testFolder = await StorageFolder.GetFolderFromPathAsync(@"C:\test");
StorageFile sourceFile = await testFolder.GetFileAsync("TestImage.jpg");
StorageFile destinationFile = await KnownFolders.CameraRoll.CreateFileAsync("MyTestImage.jpg");

using (var sourceStream = await sourceFile.OpenReadAsync())
{
    using (var sourceInputStream = sourceStream.GetInputStreamAt(0))
    {
        using (var destinationStream = await destinationFile.OpenAsync(FileAccessMode.ReadWrite))
        {
            using (var destinationOutputStream = destinationStream.GetOutputStreamAt(0))
            {
                await RandomAccessStream.CopyAndCloseAsync(sourceInputStream, destinationStream);
            }
        }
    }
}