推荐使用 MediaPicker.PickPhotosAsync 选择图片,支持多选、压缩、自动旋转;单张用 PickPhotoAsync,Android 13+ 默认启用无需权限的 Photo Picker,旧版需存储权限,iOS 自动申请相册权限,Windows/macOS 暂不支持相册选择。

在 .NET MAUI 中,从相册选择图片推荐使用 MediaPicker.PickPhotosAsync,这是官方封装的跨平台媒体选择器,支持多选、尺寸压缩、自动旋转等实用功能,且 Android 13+ 默认调用系统照片选择器(Photo Picker),无需额外权限。
基础单张图片选择
调用 PickPhotoAsync 即可打开系统相册,用户选一张后返回 FileResult:
- 代码简洁,一行即可启动:
var file = await MediaPicker.PickPhotoAsync(); - 若用户取消,返回
null,需判空处理 - 支持直接读取流:
using var stream = await file.OpenReadAsync();
多张图片批量选择
使用 PickPhotosAsync 并设置 SelectionLimit 参数,例如最多选 10 张:
var results = await MediaPicker.PickPhotosAsync(new MediaPickerOptions { SelectionLimit = 10 });- 返回
List,为空表示用户取消操作 - Android 13+ 自动启用 Photo Picker 多选界面;旧版本回退到传统图库(需存储权限)
图片预处理选项(可选)
在 MediaPickerOptions 中可指定常见后处理行为,避免手动压缩或旋转:
-
MaximumWidth / MaximumHeight:等比缩放至指定尺寸内(单位像素) -
CompressionQuality = 85:JPEG 压缩质量(0–100) -
RotateImage = true:按 EXIF 自动校正方向 -
PreserveMetaData = false:默认不保留元数据(减小体积)
平台注意事项
大部分场景无需额外配置,但要注意:
- Android:MAUI 8+ 在 Android 13+ 上默认使用 Photo Picker(无需
READ_MEDIA_IMAGES权限);Android 12 及以下仍需申请存储权限 - iOS:自动适配相册权限,首次调用会弹出授权请求
- Windows/macOS:目前仅支持拍照,暂不支持相册选择(
PickPhotosAsync返回空列表)
基本上就这些。用好 PickPhotosAsync 就能覆盖绝大多数图片选择需求,不复杂但容易忽略预处理参数和平台兼容性细节。










