用途
该技能为智能体提供在 .NET MAUI 应用中使用设备能力的最佳实践、模式与跨平台抽象方案,覆盖权限、传感器、文件选择器、地理位置、相机访问、通知以及平台特定 API。其目标是确保所有平台 API 的使用安全、一致,并符合 MAUI 的跨平台架构。
核心原则
- 权限优先设计:在访问设备能力前,始终请求并检查权限。
- 跨平台抽象:尽可能使用 MAUI Essentials API。
- 优雅降级:如果某平台不支持某能力,需妥善处理。
- 关注点分离:将平台 API 调用封装在服务与接口中。
- 用户透明:在请求权限时提供清晰说明。
支持的平台能力
- 地理位置
- 相机与媒体选择器
- 文件选择器
- 剪贴板
- 振动
- 手电筒
- 连接状态
- 传感器(加速度计、指南针、陀螺仪)
- 通知(本地)
- 权限
推荐目录结构
Services
└─ Platform
├─ Implementations
└─ Interfaces
智能体使用指南
- 生成使用设备能力的代码时:
- 始终先检查权限。
- 使用
Permissions.RequestAsync<T>()。 - 使用 MAUI Essentials API(例如 Geolocation、MediaPicker)。
- 将逻辑封装在服务中(例如
IGeolocationService)。
- 当被要求“访问相机”时,生成:
- 服务抽象
- 平台安全的实现
- 权限检查
- 当被要求“获取用户位置”时,应用:
- 权限检查
- 回退处理
- 取消令牌
范围之外
- 认证(由
maui-authentication覆盖) - UI 布局(由
maui-ui-best-practices覆盖) - 数据库存储(由
maui-data-storage覆盖)
安装与使用方式
暂未提供。
适用场景与限制
该技能适用于在 .NET MAUI 应用中需要访问设备能力(如地理位置、相机、文件、传感器、通知等)的代码生成场景。限制在于其仅聚焦平台 API 使用,不涉及认证、UI 布局与数据库存储;其他具体平台支持细节、版本要求与运行环境限制暂未提供。