.NET 多平台应用 UI(.NET MAUI)支持的每个平台都提供可从 C# 访问的唯一操作系统和平台 API。 .NET MAUI 提供跨平台 API 来访问此平台的大部分功能,其中包括访问传感器、访问运行应用的设备的相关信息、检查网络连接、安全地存储数据以及启动基于浏览器的身份验证流。
.NET MAUI 将这些跨平台 API 分为不同的功能区域。
应用程序模型
.NET MAUI 在 Microsoft.Maui.ApplicationModel 命名空间中提供以下功能:
| 功能性 | 说明 |
|---|---|
| 应用操作 | 该 AppActions 类使你能够创建和响应应用快捷方式,从而提供启动应用的其他方法。 有关详细信息,请参阅 应用操作。 |
| 应用信息 | 该 AppInfo 类提供对基本应用信息(包括应用名称和版本)以及设备的当前活动主题的访问权限。 有关详细信息,请参阅 应用信息。 |
| 浏览器 | 该 Browser 类使应用能够在应用内浏览器或系统浏览器中打开 Web 链接。 有关详细信息,请参阅 Browser。 |
| Launcher | 该 Launcher 类使应用能够打开 URI,并且通常在深层链接到其他应用的自定义 URI 方案时使用。 有关详细信息,请参阅 Launcher。 |
| 主线程 | 类 MainThread 使你可以在 UI 线程上运行代码。 有关详细信息,请参阅 主线程。 |
| Maps | 该 Map 类使应用能够将系统地图应用程序打开到特定位置或地标。 有关详细信息,请参阅 “地图”。 |
| 权限 | 通过该 Permissions 类,可以在运行时检查和请求权限。 有关详细信息,请参阅权限。 |
| 版本跟踪 | 该VersionTracking类允许您检查应用程序的版本号和内部版本号,并确定应用程序是否首次启动。 有关详细信息,请参阅 版本跟踪。 |
通信
.NET MAUI 在 Microsoft.Maui.ApplicationModel.Communication 命名空间中提供以下功能:
| 功能性 | 说明 |
|---|---|
| 联系人 | 该 Contacts 类使应用能够选择联系人并阅读有关该联系人的信息。 有关详细信息,请参阅 “联系人”。 |
该 Email 类可用于打开默认电子邮件应用,并可以使用指定的收件人、主题和正文创建新电子邮件。 有关详细信息,请参阅 电子邮件。 |
|
| 网络 | 通过 Connectivity 命名空间中的 Microsoft.Maui.Networking 类,可以检查应用正在运行的设备的网络可访问性。 有关详细信息,请参阅连接性。 |
| 拨号器 | 该 PhoneDialer 类使应用能够在拨号器中打开电话号码。 有关详细信息,请参阅 电话拨号程序。 |
| SMS(消息传递) | 该 Sms 类可用于打开默认短信应用,并使用收件人和消息预加载它。 有关详细信息,请参阅 短信。 |
| Web Authenticator | 通过 WebAuthenticator 命名空间中的 Microsoft.Maui.Authentication 类,可以启动基于浏览器的身份验证流,该流侦听注册到应用的特定 URL 的回调。 有关详细信息,请参阅 Web 验证器。 |
设备功能
.NET MAUI 在 Microsoft.Maui.Devices 命名空间中提供以下功能:
| 功能性 | 说明 |
|---|---|
| 电池 | 该 Battery 类使应用能够检查设备的电池信息,并监视电池是否有变化。 有关详细信息,请参阅 “电池”。 |
| 设备显示 | 该 DeviceDisplay 类使应用能够读取有关设备的屏幕指标的信息。 有关详细信息,请参阅 设备显示。 |
| 设备信息 | 该 DeviceInfo 类使应用能够读取有关应用正在运行的设备的信息。 有关详细信息,请参阅 设备信息。 |
| 设备传感器 | 命名空间中的 Microsoft.Maui.Devices.Sensors 类型提供对设备的加速计、晴雨表、指南针、陀螺仪、磁力计和方向传感器的访问。 有关详细信息,请参阅 设备传感器。 |
| 手电筒 | 该 FlashLight 类可以切换设备相机的闪光灯,以模拟手电筒。 有关详细信息,请参阅 手电筒。 |
| Geocoding | 该 Geocoding 类在 Microsoft.Maui.Devices.Sensors 命名空间中提供 API,用于将地点标记地理编码为位置坐标,并将坐标反向地理编码为地点标记。 有关详细信息,请参阅 Geocoding。 |
| 地理位置 | 命名空间 Geolocation 中的 Microsoft.Maui.Devices.Sensors 类提供用于检索设备的当前地理位置坐标的 API。 有关详细信息,请参阅 地理位置。 |
| 触觉反馈 |
HapticFeedback类控件在设备上的触觉反馈,通常显示为温柔的振动感觉,以向用户提供响应。 有关详细信息,请参阅 触觉反馈。 |
| 振动 | 该 Vibration 类使你能够在所需时间内启动和停止振动功能。 有关详细信息,请参阅 振动。 |
媒体
.NET MAUI 在 Microsoft.Maui.Media 命名空间中提供以下功能:
| 功能性 | 说明 |
|---|---|
| 媒体选择器 | 该 MediaPicker 类使你能够提示用户在设备上选取或拍摄照片或视频。 有关详细信息,请参阅 媒体选取器。 |
| Screenshot | 该 Screenshot 类使你能够捕获应用的当前显示屏幕。 有关详细信息,请参阅 屏幕截图。 |
| 文本到语音转换 | 该 TextToSpeech 类使应用能够利用内置的文本转语音引擎从设备朗讲文本。 有关详细信息,请参阅 文本转语音。 |
| 单位转换器 | 该 UnitConverters 类提供单元转换器,帮助你从一个度量单位转换为另一个单位。 有关详细信息,请参阅 单元转换器。 |
共享
.NET MAUI 在 Microsoft.Maui.ApplicationModel.DataTransfer 命名空间中提供以下功能:
| 功能性 | 说明 |
|---|---|
| 剪贴板 | 该 Clipboard 类允许应用在系统剪贴板中复制和粘贴文本。 有关详细信息,请参阅 剪贴板。 |
| 共享文件和文本 | 该 Share 类提供一个 API,用于将数据(如文本或 Web 链接)发送到设备的共享函数。 有关详细信息,请参阅 “共享”。 |
存储
.NET MAUI 在 Microsoft.Maui.Storage 命名空间中提供以下功能:
| 功能性 | 说明 |
|---|---|
| 文件选取器 | 通过 FilePicker 该类,可以提示用户从设备中选择一个或多个文件。 有关详细信息,请参阅 文件选取器。 |
| 文件系统助手 | 该 FileSystem 类提供访问应用的缓存和数据文件夹的帮助程序方法,并帮助访问存储在应用包中的文件。 有关详细信息,请参阅 文件系统帮助程序。 |
| Preferences |
Preferences类有助于将应用程序首选项存储在键/值存储中。 有关详细信息,请参阅 首选项。 |
| 安全存储 | 类SecureStorage 有助于安全地存储简单的键/值对。 有关详细信息,请参阅 安全存储。 |
访问平台 API
.NET MAUI 平台特定功能允许你使用仅在特定平台上可用的特定功能。 有关详细信息,请参阅 Android 平台特定、iOS 平台特定和 Windows 平台特定。
如果 .NET MAUI 不提供任何用于访问特定平台 API 的 API,则可以编写自己的代码来访问所需的平台 API。 有关详细信息,请参阅 调用平台代码。