Share via

Xamarin.Essentials：SMS

  • 项目

SMS 类允许应用程序使用要发送到收件人的指定消息打开默认短信应用程序。

入门

若要开始使用此 API，请阅读 Xamarin.Essentials 的入门指南，确保在项目中正确安装和设置库。

若要访问短信功能，需要以下特定于平台的设置。

如果项目的目标 Android 版本设置为 Android 11 (R API 30)，则必须使用与新的包可见性要求一起使用的查询来更新 Android 清单。

打开 Properties 文件夹下的 AndroidManifest.xml 文件，并在“manifest”节点内添加以下代码 ：

<queries>
  <intent>
    <action android:name="android.intent.action.VIEW" />
    <data android:scheme="smsto"/>
  </intent>
</queries>

使用 SMS

在类中添加对 Xamarin.Essentials 的引用：

using Xamarin.Essentials;

SMS 功能通过调用 ComposeAsync 方法工作，该方法是包含消息收件人和消息正文（两者都是可选的）的 SmsMessage。

public class SmsTest
{
    public async Task SendSms(string messageText, string recipient)
    {
        try
        {
            var message = new SmsMessage(messageText, new []{ recipient });
            await Sms.ComposeAsync(message);
        }
        catch (FeatureNotSupportedException ex)
        {
            // Sms is not supported on this device.
        }
        catch (Exception ex)
        {
            // Other error has occurred.
        }
    }
}

此外，还可以向 SmsMessage 传入多个收件人：

public class SmsTest
{
    public async Task SendSms(string messageText, string[] recipients)
    {
        try
        {
            var message = new SmsMessage(messageText, recipients);
            await Sms.ComposeAsync(message);
        }
        catch (FeatureNotSupportedException ex)
        {
            // Sms is not supported on this device.
        }
        catch (Exception ex)
        {
            // Other error has occurred.
        }
    }
}

API

在第 9 频道和 YouTube 上查找更多 Xamarin 视频。