在 .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<fileresult></fileresult>,为空表示用户取消操作 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就能覆盖绝大多数图片选择需求,不复杂但容易忽略预处理参数和平台兼容性细节。
