[Enhancement] Save To Gallery

[dimonovdd]

Description of Change

implementation to saving media files with metadata on iOS, MacOS, Android and UWP.

Related to issue

• [Enhancement] Save to gallery! #1455
• [Enhancement] SaveToAlbum -> MediaPicker.CapturePhotoAsync #1548
• [Enhancement] Store Image to the Photo Gallery #1668

API Changes

public static class MediaGallery
{
    public static Task SaveAsync(MediaFileType type, string filePath);
    public static Task SaveAsync(MediaFileType type, byte[] data, string fileName);
    public static Task SaveAsync(MediaFileType type, Stream fileStream, string fileName);
}

public enum MediaFileType
{
     Image,
     Video
}

PR Checklist

• Has tests
• Has samples
• Rebased on top of main at time of PR
• Changes adhere to coding standard
• Updated documentation

[dimonovdd]

Hi @mattleibow. I finished a draft implementation of saving video and image files with metadata on ios.
But as you remember, I don't have a real iphone. Could you check it on real devices please?

[dimonovdd]

@jamesmontemagno
You wrote about the complexity of the implementation in the comments on this issue. Could you check this pull request, please?
This is still a draft, but I tested it as best I could

[follesoe]

Great to see work on Essentials API to store media in the gallery! We have this exact need in our app, and as some of the APIs are obsolete in Android 11 I am about to start working on that area of the app again. I will try to copy in the work-in-progress version of this API and test it in practice in our app, and report back any findings. For now, the first thing that needs to be addressed is the new permission level for Photos in iOS 14 (on the iOS side).

[dimonovdd]

Hi @sung-su
I made a draft implementation for several platforms. Is it possible to do this for Tizen?

[jamesmontemagno]

Are all of these APIs available on iOS 10+ and Android 5+?

[dimonovdd]

Are all of these APIs available on iOS 10+ and Android 5+?

Yes. I tested this on android 5.0. Apple documentation says this should work on iOS 8.0. But I only tested this on version 12, 13, and 14.
There are tests for this feature.

Let me know if the naming of classes and methods is correct. I want to create documentation

[opbld33]

Docs Build status updates of commit b5d5a6e:

❌ Validation status: errors

Please follow instructions here which may help to resolve issue.

File	Status	Preview URL	Details
	❌Error		Details

• [Error-InsufficientPermissionOnRepo] User mimisasouvanh does not have sufficient permission on https://github.com/xamarin/Essentials repository. Hint: required permission 'Read', actual permission 'None'.

For more details, please refer to the build report.

If you see build warnings/errors with permission issues, it might be due to single sign-on (SSO) enabled on Microsoft's GitHub organizations. Please follow instructions here to re-authorize your GitHub account to Docs Build.

Note: Broken links written as relative paths are included in the above build report. For broken links written as absolute paths or external URLs, see the broken link report.

Note: Your PR may contain errors or warnings unrelated to the files you changed. This happens when external dependencies like GitHub alias, Microsoft alias, cross repo links are updated. Please use these instructions to resolve them.

For any questions, please:

• Try searching the docs.microsoft.com contributor guides
• Post your question in the Docs support channel

[jfversluis]

We won't be doing this for Xamarin.Essentials anymore. Thanks for the time and effort here!