[Enhancement] Save To Gallery

DeviceTests/DeviceTests.Shared/DeviceTests.Shared.csproj

@@ -28,7 +28,8 @@
     <PackageReference Include="xunit.runner.devices" Version="2.5.25" />
     <PackageReference Include="UnitTests.HeadlessRunner" Version="2.0.0" />
     <PackageReference Include="System.Numerics.Vectors" Version="4.5.0" />
-    <ProjectReference Include="..\..\Xamarin.Essentials\Xamarin.Essentials.csproj" />
+    <ProjectReference Include="..\..\Xamarin.Essentials\Xamarin.Essentials.csproj" /> 
+    <EmbeddedResource Include="..\..\Content\Media\*" Link="Media\%(Filename)%(Extension)" />
   </ItemGroup>
   <ItemGroup Condition=" $(TargetFramework.StartsWith('uap10.0')) ">
     <PackageReference Include="Microsoft.NETCore.UniversalWindowsPlatform" Version="6.2.9" />

DeviceTests/DeviceTests.Shared/MediaGallery_Tests.cs

@@ -0,0 +1,36 @@
+using System.Linq;
+using System.Reflection;
+using System.Threading.Tasks;
+using Xamarin.Essentials;
+using Xunit;
+
+namespace DeviceTests.Shared
+{
+    public class MediaGallery_Tests
+    {
+        const string jpgName = "lomonosov.jpg";
+
+        [Fact]
+        [Trait(Traits.InteractionType, Traits.InteractionTypes.Human)]
+        public async Task SaveAsync()
+        {
+            var platform = DeviceInfo.Platform;
+            await MainThread.InvokeOnMainThreadAsync(async () =>
+            {
+                if (platform == DevicePlatform.iOS || platform == DevicePlatform.macOS)
+                    await Permissions.RequestAsync<Permissions.Photos>();
+                else if (platform == DevicePlatform.Android)
+                    await Permissions.RequestAsync<Permissions.StorageWrite>();
+            });
+
+            var assembly = typeof(MediaGallery_Tests).GetTypeInfo().Assembly;
+            var resourceName = assembly
+                .GetManifestResourceNames()
+                .FirstOrDefault(n => n.EndsWith(jpgName));
+
+            using var fileStream = assembly.GetManifestResourceStream(resourceName);
+
+            await MediaGallery.SaveAsync(MediaFileType.Image, fileStream, jpgName);
+        }
+    }
+}

Samples/Samples.Mac/Info.plist

@@ -45,5 +45,7 @@
 	</array>
 	<key>NSContactsUsageDescription</key>
 	<string>Contacts</string>
+	<key>NSPhotoLibraryUsageDescription</key>
+	<string>Photos</string>
 </dict>
 </plist>

Samples/Samples.UWP/Package.appxmanifest

@@ -32,6 +32,8 @@
   <Capabilities>
     <Capability Name="internetClient" />
     <uap:Capability Name="contacts"/>
+    <uap:Capability Name="picturesLibrary"/>
+    <uap:Capability Name="videosLibrary"/>
     <DeviceCapability Name="location" />
     <DeviceCapability Name="microphone"/>
     <DeviceCapability Name="webcam"/>

Samples/Samples/App.xaml.cs

@@ -24,10 +24,10 @@ public partial class App : Application
 
         public App()
         {
-            InitializeComponent();
-
             // Enable currently experimental features
-            Device.SetFlags(new string[] { "MediaElement_Experimental" });
+            Device.SetFlags(new string[] { "MediaElement_Experimental", "RadioButton_Experimental" });
+
+            InitializeComponent();
 
             VersionTracking.Track();
 

Samples/Samples/Helpers/EmbeddedResourceProvider.cs

@@ -0,0 +1,44 @@
+using System.IO;
+using System.Linq;
+using System.Reflection;
+using Xamarin.Forms;
+
+namespace Samples.Helpers
+{
+    public static class EmbeddedMedia
+    {
+        public const string baboonPng = "baboon.png";
+        public const string earthMp4 = "earth.mp4";
+        public const string lomonosovJpg = "lomonosov.jpg";
+        public const string newtonsCradleGif = "newtons_cradle.gif";
+    }
+
+    public static class EmbeddedResourceProvider
+    {
+        static readonly Assembly assembly = typeof(EmbeddedResourceProvider).GetTypeInfo().Assembly;
+        static readonly string[] resources = assembly.GetManifestResourceNames();
+
+        public static Stream Load(string name)
+        {
+            name = GetFullName(name);
+
+            if (string.IsNullOrWhiteSpace(name))
+                return null;
+
+            return assembly.GetManifestResourceStream(name);
+        }
+
+        public static ImageSource GetImageSource(string name)
+        {
+            name = GetFullName(name);
+
+            if (string.IsNullOrWhiteSpace(name))
+                return null;
+
+            return ImageSource.FromResource(name, assembly);
+        }
+
+        static string GetFullName(string name)
+            => resources.FirstOrDefault(n => n.EndsWith($".Media.{name}"));
+    }
+}

Samples/Samples/Samples.csproj

@@ -22,6 +22,7 @@
 
   <ItemGroup>
     <ProjectReference Include="..\..\Xamarin.Essentials\Xamarin.Essentials.csproj" />
+    <EmbeddedResource Include="..\..\Content\Media\*" Link="Media\%(Filename)%(Extension)" />
   </ItemGroup>
 
 </Project>

Samples/Samples/View/MediaGalleryPage.xaml

@@ -0,0 +1,63 @@
+<views:BasePage xmlns="http://xamarin.com/schemas/2014/forms"
+                xmlns:x="http://schemas.microsoft.com/winfx/2009/xaml"
+                xmlns:views="clr-namespace:Samples.View"
+                xmlns:viewmodels="clr-namespace:Samples.ViewModel"
+                x:Class="Samples.View.MediaGalleryPage"
+                x:DataType="viewmodels:MediaGalleryViewModel"
+                Title="Media Gallery">
+
+    <views:BasePage.BindingContext>
+        <viewmodels:MediaGalleryViewModel />
+    </views:BasePage.BindingContext>
+
+    <ScrollView>
+        <Grid RowSpacing="20" Padding="16">
+            <Grid.RowDefinitions>
+                <RowDefinition Height="auto"/>
+                <RowDefinition Height="auto"/>
+                <RowDefinition Height="400"/>
+                <RowDefinition Height="auto"/>
+                <RowDefinition Height="*"/>
+            </Grid.RowDefinitions>
+
+            <Label Grid.Row="0" Text="Save To Gallery From:"
+                   HorizontalTextAlignment="Center" FontAttributes="Bold" Margin="0"/>
+
+            <StackLayout Grid.Row="1" Orientation="Vertical" Margin="0" Padding="0" Spacing="8">
+                <RadioButton Text="Stream" IsChecked="{Binding FromStream}" Margin="0"/>
+                <RadioButton Text="ByteArray"  IsChecked="{Binding FromByteArray}" Margin="0"/>
+                <RadioButton Text="CacheDirectory"  IsChecked="{Binding FromCacheDirectory}" Margin="0"/>
+            </StackLayout>
+
+            <Grid Grid.Row="2" ColumnSpacing="8" RowSpacing="8">
+                <Grid.RowDefinitions>
+                    <RowDefinition Height="*"/>
+                    <RowDefinition Height="40"/>
+                    <RowDefinition Height="*"/>
+                    <RowDefinition Height="40"/>
+                </Grid.RowDefinitions>
+                <Grid.ColumnDefinitions>
+                    <ColumnDefinition Width="*"/>
+                    <ColumnDefinition Width="*"/>
+                </Grid.ColumnDefinitions>
+
+                <Image Grid.Row="0" Grid.Column="0" Source="{Binding PngSource}"/>
+                <Button Grid.Row="1" Grid.Column="0" Text="Png" Command="{Binding SavevPngCommand}"/>
+
+                <Image Grid.Row="0" Grid.Column="1" Source="{Binding JpgSource}"/>
+                <Button Grid.Row="1" Grid.Column="1" Text="Jpg" Command="{Binding SaveJpgCommand}"/>
+
+
+                <Image Grid.Row="2" Grid.Column="0" Source="{Binding GifSource}"/>
+                <Button Grid.Row="3" Grid.Column="0" Text="Gif" Command="{Binding SaveGifCommand}"/>
+
+                <Label Grid.Row="2" Grid.Column="1" Text="Imagine a video of Earth here"
+                       HorizontalTextAlignment="Center" VerticalTextAlignment="Center"/>
+                <Button Grid.Row="3" Grid.Column="1" Text="Video" Command="{Binding SaveVideoCommand}"/>
+            </Grid>
+
+            <Label Grid.Row="3" Text="Other features in the future"
+                   HorizontalTextAlignment="Center" FontAttributes="Bold"/>
+        </Grid>
+    </ScrollView>
+</views:BasePage>

Samples/Samples/View/MediaGalleryPage.xaml.cs

@@ -0,0 +1,10 @@
+namespace Samples.View
+{
+    public partial class MediaGalleryPage : BasePage
+    {
+        public MediaGalleryPage()
+        {
+            InitializeComponent();
+        }
+    }
+}

Samples/Samples/ViewModel/HomeViewModel.cs

@@ -240,6 +240,12 @@ public HomeViewModel()
                     typeof(WebAuthenticatorPage),
                     "Quickly and easily authenticate and wait for a callback.",
                     new[] { "auth", "authenticate", "authenticator", "web", "webauth" }),
+                new SampleItem(
+                    "🖼",
+                    "Media Gallery",
+                    typeof(MediaGalleryPage),
+                    "Quickly and easily manage media files",
+                    new[] { "save", "media", "gallery", "image", "video", "jpg", "png" })
             };
             filteredItems = samples;
             filterText = string.Empty;

Samples/Samples/ViewModel/MediaGalleryViewModel.cs

@@ -0,0 +1,92 @@
+using System;
+using System.IO;
+using System.Net;
+using System.Threading.Tasks;
+using System.Windows.Input;
+using Samples.Helpers;
+using Xamarin.Essentials;
+using Xamarin.Forms;
+
+namespace Samples.ViewModel
+{
+    public class MediaGalleryViewModel : BaseViewModel
+    {
+        public MediaGalleryViewModel()
+        {
+            SavevPngCommand = new Command(() => Save(MediaFileType.Image, EmbeddedMedia.baboonPng));
+            SaveJpgCommand = new Command(() => Save(MediaFileType.Image, EmbeddedMedia.lomonosovJpg));
+            SaveGifCommand = new Command(() => Save(MediaFileType.Image, EmbeddedMedia.newtonsCradleGif));
+            SaveVideoCommand = new Command(() => Save(MediaFileType.Video, EmbeddedMedia.earthMp4));
+
+            PngSource = EmbeddedResourceProvider.GetImageSource(EmbeddedMedia.baboonPng);
+            JpgSource = EmbeddedResourceProvider.GetImageSource(EmbeddedMedia.lomonosovJpg);
+            GifSource = EmbeddedResourceProvider.GetImageSource(EmbeddedMedia.newtonsCradleGif);
+        }
+
+        public bool FromStream { get; set; } = true;
+
+        public bool FromByteArray { get; set; }
+
+        public bool FromCacheDirectory { get; set; }
+
+        public ImageSource PngSource { get; }
+
+        public ImageSource JpgSource { get; }
+
+        public ImageSource GifSource { get; }
+
+        public ICommand SavevPngCommand { get; }
+
+        public ICommand SaveJpgCommand { get; }
+
+        public ICommand SaveGifCommand { get; }
+
+        public ICommand SaveVideoCommand { get; }
+
+        async void Save(MediaFileType type, string name)
+        {
+            try
+            {
+                using var stream = EmbeddedResourceProvider.Load(name);
+
+                if (FromStream)
+                {
+                    await MediaGallery.SaveAsync(type, stream, name);
+                }
+                else if (FromByteArray)
+                {
+                    using var memoryStream = new MemoryStream();
+                    stream.CopyTo(memoryStream);
+
+                    await MediaGallery.SaveAsync(type, memoryStream.ToArray(), name);
+                }
+                else if (FromCacheDirectory)
+                {
+                    var filePath = SaveFileToCache(stream, name);
+
+                    await MediaGallery.SaveAsync(type, filePath);
+                }
+
+                await DisplayAlertAsync("Save Completed Successfully");
+            }
+            catch (Exception ex)
+            {
+                await DisplayAlertAsync(ex.Message);
+            }
+        }
+
+        string SaveFileToCache(Stream data, string fileName)
+        {
+            var filePath = Path.Combine(FileSystem.CacheDirectory, fileName);
+
+            if (File.Exists(filePath))
+                File.Delete(filePath);
+
+            var stream = File.Create(filePath);
+            data.CopyTo(stream);
+            stream.Close();
+
+            return filePath;
+        }
+    }
+}