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