背景 MAUI的出现,赋予了广大Net开发者开发多平台应用的能力,MAUI 是Xamarin.Forms演变而来,但是相比Xamarin性能更好,可扩展性更强,结构更简单。但是MAUI对于平台相关的实现并不完整。所以MASA团队开展了一个实验性项目,意在对微软MAUI的补充和扩展
项目地址https://github.com/BlazorComponent/MASA.Blazor/tree/feature/Maui/src/Masa.Blazor.Maui.Plugin
每个功能都有单独的demo演示项目,考虑到app安装文件体积(虽然MAUI已经集成裁剪功能,但是该功能对于代码本身有影响),届时每一个功能都会以单独的nuget包的形式提供,方便测试,现在项目才刚刚开始,但是相信很快就会有可以交付的内容啦。
前言 本系列文章面向移动开发小白,从零开始进行平台相关功能开发,演示如何参考平台的官方文档使用MAUI技术来开发相应功能。
介绍 项目中有需要从相册多选图片的需求,MAUI提供的MediaPicker.PickPhotoAsync 无多选功能,FilePicker.PickMultipleAsync 虽然可以实现多选,但是多选文件需要长按,而且没有预览和返回按钮,用户交互效果不好。作为安卓开发小白,本人目前找到两种UI交互良好而且不需要定制选取界面的方法和大家分享。
一、MAUI实现方式演示效果 MediaPicker.Default.PickPhotoAsync 效果
FilePicker.Default.PickMultipleAsync 效果
二、实现方式 思路
https://developer.android.google.cn/about/versions/13/features/photopicker?hl=zh-cn
我们参考一下官方文档,下面为选择多张照片或者多个视频的示例
1 2 3 4 5 6 7 8 9 JAVA代码 final int maxNumPhotosAndVideos = 10 ;Intent intent = new Intent (MediaStore.ACTION_PICK_IMAGES);intent.putExtra(MediaStore.EXTRA_PICK_IMAGES_MAX, maxNumPhotosAndVideos); startActivityForResult(intent, PHOTO_PICKER_MULTI_SELECT_REQUEST_CODE);
处理照片选择器结果
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 JAVA代码 @Override protected void onActivityResult ( int requestCode, int resultCode, final Intent data) { if (resultCode != Activity.RESULT_OK) { return ; } switch (requestCode) { case REQUEST_PHOTO_PICKER_SINGLE_SELECT: Uri currentUri = data.getData(); return ; case REQUEST_PHOTO_PICKER_MULTI_SELECT: for (int i = 0 ; i < data.getClipData().getItemCount(); i++) { Uri currentUri = data.getClipData().getItemAt(i).getUri(); } return ; } }
限定选择内容范围 默认情况下,照片选择器会既显示照片又显示视频。您还可以在 setType() 方法中设置 MIME 类型,以便按“仅显示照片”或“仅显示视频”进行过滤
1 2 3 4 5 6 7 8 9 10 JAVA代码 Intent intent = new Intent (MediaStore.ACTION_PICK_IMAGES);intent.setType("video/*" ); startActivityForResult(intent, PHOTO_PICKER_VIDEO_SINGLE_SELECT_REQUEST_CODE);
总结流程如下: 1、通过Intent(MediaStore.ACTION_PICK_IMAGES) 初始化一个打开相册的Intent 2、intent.setType 设置过滤条件 3、通过startActivityForResult 打开新的Activity (打开相册),并通过重写onActivityResult 获取选取照片的返回数据 4、从返回的Intent 中拿到文件的Uri 从而获取文件内容 注意:在一个Activity 中,可能会使用startActivityForResult() 方法打开多个不同的Activity 处理不同的业务 ,这时可以在onActivityResult 中通过requestCode 区分不同业务。
编写实现代码 新建MAUI Blazor项目MediaPickSample ,新建Service 文件夹,添加IPhotoPickerService.cs 接口,添加GetImageAsync1-3 ,前两种为使用MAUI的两种方式实现,用做对比,不过多介绍,本文重点关注Intent 方式实现的GetImageAsync3 。示例方法的返回值为文件名+文件base64的字典形式。
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 namespace MediaPickSample.Service { public interface IPhotoPickerService { Task<Dictionary<string , string >> GetImageAsync1(); Task<Dictionary<string , string >> GetImageAsync2(); Task<Dictionary<string , string >> GetImageAsync3(); } }
由于StartActivityForResult 需要在MainActivity 中调用,我们先定义一个MainActivity 的静态示例Instance ,方便在业务中使用。 编辑Platforms->Android->MainActivity.cs 文件
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 public class MainActivity : MauiAppCompatActivity { internal static MainActivity Instance { get ; private set ; } public static readonly int PickImageId = 1000 ; public TaskCompletionSource<Dictionary<string , string >> PickImageTaskCompletionSource { set ; get ; } protected override void OnCreate (Bundle savedInstanceState ) { Instance = this ; base .OnCreate(savedInstanceState); } protected override void OnActivityResult (int requestCode, Result resultCode, Android.Content.Intent intent ) { base .OnActivityResult(requestCode, resultCode, intent); if (requestCode == PickImageId) { if ((resultCode == Result.Ok) && (intent != null )) { var imageNames = intent.ClipData; if (imageNames != null ) { var uris = new List<Android.Net.Uri>(); for (int i = 0 ; i < imageNames.ItemCount; i++) { var imageUri = imageNames.GetItemAt(i).Uri; uris.Add(imageUri); } var fileList = Instance.GetImageDicFromUris(uris); PickImageTaskCompletionSource.SetResult(fileList); } } else { PickImageTaskCompletionSource.SetResult(new Dictionary<string , string >()); } } } }
首先我们定义了MainActivity 的静态实例Instance ,并在OnCreate 事件中赋值 然后添加重写方法OnActivityResult ,通过requestCode == PickImageId 判断是从相册选取多个文件的业务(我们关注的业务),通过intent.ClipData 获取数据,然后遍历这些数据依次通过GetItemAt(i).Uri 获取所有的文件Uri ,然后再通过我们封装的GetImageDicFromUris 方法获取所有文件的内容。GetImageDicFromUris 方法如下
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 protected Dictionary<string , string > GetImageDicFromUris (List<Android.Net.Uri> list ){ Dictionary<string , string > fileList = new Dictionary<string , string >(); for (int i = 0 ; i < list.Count; i++) { var imageUri = list[i]; var documentFile = DocumentFile.FromSingleUri(Instance, imageUri); if (documentFile != null ) { using (var stream = Instance.ContentResolver.OpenInputStream(imageUri)) { stream.Seek(0 , SeekOrigin.Begin); var bs = new byte [stream.Length]; var log = Convert.ToInt32(stream.Length); stream.Read(bs, 0 , log); var base64Str = Convert.ToBase64String(bs); fileList.Add($"{Guid.NewGuid()} .{Path.GetExtension(documentFile.Name)} " , base64Str); } } } return fileList; }
DocumentFile 位于AndroidX.DocumentFile.Provider 命名空间,FromSingleUri 方法通过Uri 返回DocumentFile ,然后通过ContentResolver.OpenInputStream 读出文件流 ContentResolver 的内容比较多,可以参考官方文档,这里我们简单理解它是一个内容提供程序即可
https://developer.android.google.cn/guide/topics/providers/content-provider-basics?hl=zh-cn
下面开始实现IPhotoPickerService 接口 在Platforms->Android 新建AndroidPhotoPickerService.cs
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 namespace MediaPickSample.PlatformsAndroid { public class AndroidPhotoPickerService : IPhotoPickerService { public async Task<Dictionary<string , string >> GetImageAsync1() { ... } public async Task<Dictionary<string , string >> GetImageAsync2() { ... } public Task<Dictionary<string , string >> GetImageAsync3() { Intent intent = new Intent(Intent.ActionPick); intent.SetDataAndType(MediaStore.Images.Media.ExternalContentUri, "image/*" ); intent.PutExtra(Intent.ExtraAllowMultiple,true ); MainActivity.Instance.StartActivityForResult(Intent.CreateChooser(intent, "Select Picture" ), MainActivity.PickImageId); MainActivity.Instance.PickImageTaskCompletionSource = new TaskCompletionSource<Dictionary<string , string >>(); return MainActivity.Instance.PickImageTaskCompletionSource.Task; } } }
我们只关注Intent 实现的GetImageAsync3 方法
首先先初始化一个Intent.ActionPick 类型的Intent ,选择数据我们需要使用ACTION_PICK 类型。 常见的Intent 类型参考官方文档
https://developer.android.google.cn/guide/components/intents-common?hl=zh-cn
intent.SetDataAndType 方法设置Intent 的数据和MIME 数据类型
https://developer.android.com/reference/android/content/Intent#setDataAndType(android.net.Uri, java.lang.String)
intent.PutExtra 设置可以多选 然后就可以通过MainActivity 的静态实例Instance 的StartActivityForResult 方法启动这个intent 了,我们这里通过Intent.CreateChooser 给Intent 设置了一个标题,并传递requestCode 用以区分业务。
编写演示代码 修改Index.razor文件,界面使用的是MASA Blazor
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 @page "/" @using Masa.BuildingBlocks.Storage.ObjectStorage; @using MediaPickSample.Service; <MCard Color="#FFFFFF" Class="mx-auto rounded-3 mt-3" Elevation="0" > <MCardText> <div class ="d-flex" style="flex-wrap: wrap" > @if (_phoneDictionary.Any()) { @foreach (var phone in _phoneDictionary) { <div style="position: relative; height: 90px; width: 90px;" class ="mr-2 mb-2" > <MImage Src="@phone.Value" AspectRatio="1" Class="grey lighten-2" > <PlaceholderContent> <MRow Class="fill-height" Align="@AlignTypes.Center" Justify="@JustifyTypes.Center" > <MProgressCircular Indeterminate></MProgressCircular> </MRow> </PlaceholderContent> </MImage> <MButton Small Icon Tile Style="position: absolute; top: 0; right: 0; background: #000000; opacity: 0.5;" Dark OnClick="() => RemoveItem(phone.Key)" > <MIcon> mdi-close </MIcon> </MButton> </div> } } <MBottomSheet> <ActivatorContent> <MButton XLarge Icon Style="background: #F7F8FA;border-radius: 2px; height:80px;width:80px; " @attributes="@context.Attrs" > <MIcon XLarge Color="#D8D8D8" >mdi-camera</MIcon> </MButton> </ActivatorContent> <ChildContent> <MCard> <MList> <MListItem OnClick="GetImageAsync1" ><MListItemContent><MListItemTitle>Maui-MediaPicker</MListItemTitle></MListItemContent></MListItem> <MListItem OnClick="GetImageAsync2" ><MListItemContent><MListItemTitle>Maui-FilePicker</MListItemTitle></MListItemContent></MListItem> <MListItem OnClick="GetImageAsync3" ><MListItemContent><MListItemTitle>Intent</MListItemTitle></MListItemContent></MListItem> </MList> </MCard> </ChildContent> </MBottomSheet> </div> </MCardText> </MCard> @code { [Inject ] private IPhotoPickerService _photoPickerService { get ; set ; } [Inject ] private IClient _client { get ; set ; } private Dictionary<string , string > _phoneDictionary { get ; set ; } = new Dictionary<string , string >(); private async Task GetImageAsync1 () { ... } private async Task GetImageAsync2 () { ... } private async Task GetImageAsync3 () { var photoDic = await _photoPickerService.GetImageAsync3(); foreach (var photo in photoDic) { var fileUrl = await UploadImageAsync(photo.Value, Path.GetExtension(photo.Key)); _phoneDictionary.Add(photo.Key, fileUrl); } } private void RemoveItem (string key ) { _phoneDictionary.Remove(key); } private async Task<string > UploadImageAsync (string fileBase64, string fileExtension ) { byte [] fileBytes = Convert.FromBase64String(fileBase64); var newFileName = $"{Guid.NewGuid() + fileExtension} " ; var newFileFullPath = $"images/xxx/xxx/{newFileName} " ; using (var fileStream = new MemoryStream(fileBytes)) { try { await InvokeAsync(StateHasChanged); await _client.PutObjectAsync("xxx" , newFileFullPath, fileStream); return $"https://img-cdn.xxx.cn/{newFileFullPath} " ; } catch (Exception ex) { if (ex.Message.Contains("x-oss-hash-crc64ecma" )) { return $"https://img-cdn.xxx.cn/{newFileFullPath} " ; } else { return string .Empty; } } } } }
代码比较简单,不过多介绍,这里的UploadImageAsync 方法使用的是Masa.BuildingBlocks.Storage 提供的SDK实现上传到阿里云存储。 不要忘记在MauiProgram.cs添加依赖注入
1 2 3 4 #if ANDROID builder.Services.AddSingleton<IPhotoPickerService, AndroidPhotoPickerService>(); #endif
在AndroidManifest.xml 添加必要的权限-android.permission.READ_EXTERNAL_STORAG ,并添加**android:usesCleartextTraffic=”true”**(上传阿里云使用)
1 2 3 4 5 6 7 8 9 10 <?xml version="1.0" encoding="utf-8" ?> <manifest xmlns:android ="http://schemas.android.com/apk/res/android" > <application android:allowBackup ="true" android:icon ="@mipmap/appicon" android:usesCleartextTraffic ="true" android:roundIcon ="@mipmap/appicon_round" android:supportsRtl ="true" > </application > <uses-permission android:name ="android.permission.ACCESS_NETWORK_STATE" /> <uses-permission android:name ="android.permission.INTERNET" /> <uses-permission android:name ="android.permission.READ_EXTERNAL_STORAGE" /> </manifest >
三、演示效果
下一篇我们介绍另外一种实现方式。
如果你对我们的 MASA Framework 感兴趣,无论是代码贡献、使用、提 Issue,欢迎联系我们
WeChat:MasaStackTechOps QQ:7424099