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

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

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

Необходимые условия

• Общие сведения о асинхронном программировании для приложений WinUI

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

• Разрешения доступа к местоположению

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

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

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

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

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

• KnownLibraryId.Music
• KnownLibraryId.Pictures
• KnownLibraryId.Videos

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.Folder и больше не будет включена в встроенное приложение "Фотографии".

В следующем примере предполагается, что пользователь выбрал папку для удаления из элемента управления 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 , которые запрашивают известные папки, прозрачно объединяют результаты запроса из обоих расположений. Чтобы получить эти объединенные результаты, в файле манифеста приложения нет необходимости указывать функцию removableStorage.

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

Если вы запрашиваете содержимое библиотеки изображений путем вызова 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);
            }
        }
    }
}