SmsManager 类

定义

管理短信操作,例如发送数据、文本和 pdu 短信。

[Android.Runtime.Register("android/telephony/SmsManager", DoNotGenerateAcw=true)]
public sealed class SmsManager : Java.Lang.Object
[<Android.Runtime.Register("android/telephony/SmsManager", DoNotGenerateAcw=true)>]
type SmsManager = class
    inherit Object
继承
SmsManager
属性

注解

管理短信操作,例如发送数据、文本和 pdu 短信。 通过调用静态方法 #getDefault()获取此对象。 若要创建与特定订阅 ID 关联的 实例 SmsManager ,请调用 #getSmsManagerForSubscriptionId(int)。 这通常用于同时支持多个活动订阅的设备。

有关如何在 Android 4.4 (API 级别 19) 及更高级别上充当默认短信应用的信息,请参阅 android.provider.Telephony

android.telephony.SmsManagerJava 文档。

此页面的部分内容是基于 创建和共享的工作进行的修改,并根据 署名许可中所述的术语使用。

字段

ExtraMmsData

以字节数组类型发送结果数据的 MMS 的意向额外名称

ExtraMmsHttpStatus

整数类型中 MMS HTTP 失败的 HTTP 状态代码的意向额外名称

MmsConfigAliasEnabled

是否 (布尔类型) 启用别名

MmsConfigAliasMaxChars

int 类型) (最大别名字符计数

MmsConfigAliasMinChars

int 类型) (最小别名字符计数

MmsConfigAllowAttachAudio

是否允许为 mms 消息附加音频 (布尔类型)

MmsConfigAppendTransactionId

是否将事务 ID 追加到 MMS WAP 推送 M-Notification。

MmsConfigEmailGatewayNumber

Email网关编号 (字符串类型)

MmsConfigGroupMmsEnabled

是否为当前运营商启用了组 MMS (布尔类型)

MmsConfigHttpParams

要添加到 MMS HTTP 请求的 HTTP 标头列表,用“|”分隔 (字符串类型)

MmsConfigHttpSocketTimeout

MMS HTTP 套接字超时,以毫秒为单位 (int 类型)

MmsConfigMaxImageHeight

最大彩信图像高度 (int 类型)

MmsConfigMaxImageWidth

最大彩信图像宽度 (int 类型)

MmsConfigMaxMessageSize

int 类型) (最大彩信大小(以字节为单位)

MmsConfigMessageTextMaxSize

最大消息文本大小 (int 类型)

MmsConfigMmsDeliveryReportEnabled

是否 (布尔类型启用彩信送达报告)

MmsConfigMmsEnabled

是否为当前运营商启用了 MMS (布尔类型)

MmsConfigMmsReadReportEnabled

是否 (布尔类型启用彩信读取报告)

MmsConfigMultipartSmsEnabled

是否 (布尔类型启用多部分 SMS)

MmsConfigNaiSuffix

要追加到 MMS HTTP 请求的 NAI 标头值的后缀 (字符串类型)

MmsConfigNotifyWapMmscEnabled

如果启用此功能,则为 M-NotifyResp。

MmsConfigRecipientLimit

(int 类型) 的彩信收件人限制

MmsConfigSendMultipartSmsAsSeparateMessages

是否应将多部分短信作为单独的消息发送

MmsConfigShowCellBroadcastAppLinks

如果为 true,请在短信设置) 显示 (琥珀色警报的单元格广播。

MmsConfigSmsDeliveryReportEnabled

是否 (布尔类型启用短信传送报告)

MmsConfigSmsToMmsTextLengthThreshold

某些运营商要求在文本长度达到此阈值时将短信转换为彩信 (int 类型)

MmsConfigSmsToMmsTextThreshold

当多部分短信的部件数达到此阈值时,它应转换为 MMS (int 类型)

MmsConfigSubjectMaxLength

最大邮件主题长度 (int 类型)

MmsConfigSupportHttpCharsetHeader

运营商 MMSC 是否支持 Content-Type 标头中的字符集字段。

MmsConfigSupportMmsContentDisposition

MMS PDU (布尔类型)

MmsConfigUaProfTagName

MMS HTTP 请求的 UA Prof URL HTTP 标头的名称 (字符串类型)

MmsConfigUaProfUrl

MMS HTTP 请求的 UA 配置文件 URL 标头值 (字符串类型)

MmsConfigUserAgent

MMS HTTP 请求的 User-Agent 标头值 (字符串类型)

MmsErrorDataDisabled
已过时.

为 MMS 接入点禁用数据。

MmsErrorInactiveSubscription
已过时.

发送/下载的订阅 ID 处于非活动状态。

MmsErrorInvalidSubscriptionId
已过时.

发送/下载的订阅 ID 无效。

ResultBluetoothDisconnected
已过时.

由于蓝牙断开连接,通过蓝牙发送失败

ResultCancelled
已过时.

失败,因为操作已取消

ResultEncodingError
已过时.

由于编码错误而失败

ResultErrorFdnCheckFailure
已过时.

失败,因为启用了 FDN。

ResultErrorNone
已过时.

无错误。

ResultInternalError
已过时.

由于内部错误而失败

ResultInvalidArguments
已过时.

由于参数无效而失败

ResultInvalidBluetoothAddress
已过时.

由于蓝牙设备地址无效,无法通过蓝牙发送

ResultInvalidSmscAddress
已过时.

由于短信地址无效而失败

ResultInvalidSmsFormat
已过时.

失败,因为短信格式无效

ResultInvalidState
已过时.

由于无效状态而失败

ResultModemError
已过时.

由于调制解调器错误而失败

ResultNetworkError
已过时.

由于网络错误而失败

ResultNetworkReject
已过时.

由于网络拒绝而失败

ResultNoBluetoothService
已过时.

由于蓝牙服务不可用,无法通过蓝牙发送

ResultNoDefaultSmsApp
已过时.

由 BroadcastReceiver 设置以指示没有默认短信应用。

ResultNoMemory
已过时.

由于没有内存而失败

ResultNoResources
已过时.

失败,因为没有资源

ResultOperationNotAllowed
已过时.

失败,因为不允许操作

ResultRadioNotAvailable
已过时.

失败,因为无线电不可用

ResultReceiveDispatchFailure
已过时.

短信接收调度失败。

ResultReceiveInjectedNullPdu
已过时.

SMS 接收注入的 null PDU。

ResultReceiveNullMessageFromRil
已过时.

SMS 收到来自无线电接口层的空消息。

ResultReceiveRuntimeException
已过时.

SMS 接收遇到运行时异常。

ResultReceiveSqlException
已过时.

短信接收遇到 SQL 异常。

ResultReceiveUriException
已过时.

SMS 在分析 URI 时收到异常。

ResultReceiveWhileEncrypted
已过时.

手机处于加密状态时收到的短信短代码。

ResultRemoteException
已过时.

由 BroadcastReceiver 设置,以指示处理消息时出现远程异常。

ResultRequestNotSupported
已过时.

失败,因为请求不受支持

ResultRilAborted
已过时.

操作已中止

ResultRilAccessBarred
已过时.

访问被禁止。

ResultRilBlockedDueToCall
已过时.

由于呼叫控制,短信被阻止,e.

ResultRilCancelled
已过时.

请求已取消。

ResultRilDeviceInUse
已过时.

无法执行操作,因为设备当前正在使用中

ResultRilEncodingErr
已过时.

短信未正确编码。

ResultRilGenericError
已过时.

短信发送期间发生 RIL 错误。

ResultRilInternalErr
已过时.

调制解调器在处理请求时遇到意外错误情况。

ResultRilInvalidArguments
已过时.

无线电在请求中收到了无效参数。

ResultRilInvalidModemState
已过时.

无线电无法处理处于当前调制解调器状态的请求。

ResultRilInvalidResponse
已过时.

当其中一个 RIL 层收到来自下层的无法识别的响应时出现 RIL 内部错误。

ResultRilInvalidSimState
已过时.

无法处理当前 SIM 状态的请求

ResultRilInvalidSmscAddress
已过时.

指定的 SMSC 地址无效。

ResultRilInvalidSmsFormat
已过时.

无线电返回一个错误,指示无效的短信格式。

ResultRilInvalidState
已过时.

无线电返回了对当前状态的意外请求。

ResultRilModemErr
已过时.

供应商 RIL 收到了意外或不正确的响应。

ResultRilNetworkErr
已过时.

无线电从网络收到错误。

ResultRilNetworkNotReady
已过时.

网络尚未准备好执行请求。

ResultRilNetworkReject
已过时.

网络拒绝了短信请求。

ResultRilNoMemory
已过时.

无线电没有足够的内存来处理请求。

ResultRilNoNetworkFound
已过时.

找不到网络

ResultRilNoResources
已过时.

没有足够的资源来处理请求。

ResultRilNoSmsToAck
已过时.

当没有要确认的短信时收到 ACK

ResultRilNoSubscription
已过时.

设备没有订阅

ResultRilOperationNotAllowed
已过时.

无线电报告不允许请求。

ResultRilRadioNotAvailable
已过时.

无线电未启动或正在重置。

ResultRilRequestNotSupported
已过时.

无线电不支持该请求。

ResultRilRequestRateLimited
已过时.

由于请求过于频繁,无线电拒绝了该操作。

ResultRilSimAbsent
已过时.

无线电无法设置可检索 CDMA 订阅的位置,因为 SIM 或 RUIM 不存在。

ResultRilSimBusy
已过时.

SIM 卡正忙

ResultRilSimError
已过时.

从 SIM 卡卡收到错误

ResultRilSimFull
已过时.

目标 EF 已满

ResultRilSimPin2
已过时.

操作需要输入 SIM 卡 PIN2

ResultRilSimPuk2
已过时.

操作需要输入 SIM PUK2

ResultRilSimultaneousSmsAndCallNotAllowed
已过时.

不允许同时使用 1X 语音和短信。

ResultRilSmsSendFailRetry
已过时.

无线电无法发送短信,需要重试。

ResultRilSubscriptionNotAvailable
已过时.

无法从指定位置找到 CDMA 订阅

ResultRilSystemErr
已过时.

无线电遇到平台或系统错误。

ResultSmsBlockedDuringEmergency
已过时.

紧急呼叫期间发送失败

ResultSmsSendRetryFailed
已过时.

未能发送短信重试

ResultSystemError
已过时.

由于系统错误而失败

ResultUnexpectedEventStopSending
已过时.

发送失败,因为用户拒绝或取消了针对高级短代码短信或速率受限短信显示的对话框。

ResultUserNotAllowed
已过时.

用户不与订阅关联。

SmsRpCauseCallBarring
已过时.

调用限制的 RP-Cause 值

SmsRpCauseCongestion
已过时.

RP-Cause 由于网络拥塞而导致短信失败的值

SmsRpCauseDestinationOutOfOrder
已过时.

目标 RP-Cause 值无序

SmsRpCauseFacilityNotImplemented
已过时.

当网络不提供收到的服务时,RP-Cause 值

SmsRpCauseFacilityNotSubscribed
已过时.

Reote 设备未订阅 SMS Facilty 时 RP-Cause 值

SmsRpCauseFacilityRejected
已过时.

如果操作员拒绝短信,则 RP-Cause 值

SmsRpCauseInformationElementNonExistent
已过时.

当网络不提供收到的服务时,RP-Cause 值

SmsRpCauseInterworkingUnspecified
已过时.

当网络不提供收到的服务时,RP-Cause 值

SmsRpCauseInvalidMandatoryInformation
已过时.

当网络不提供收到的服务时,RP-Cause 值

SmsRpCauseInvalidMessageReferenceValue
已过时.

RP-MessageRefere 时 RP-Cause 值

SmsRpCauseMessageIncompatibleWithProtocolState
已过时.

当网络不提供收到的服务时,RP-Cause 值

SmsRpCauseMessageTypeNonExistent
已过时.

当网络不提供收到的服务时,RP-Cause 值

SmsRpCauseNetworkOutOfOrder
已过时.

RP-Cause 网络无序时的值

SmsRpCauseOperatorDeterminedBarring
已过时.

运算符限制的 RP-Cause

SmsRpCauseProtocolError
已过时.

当网络不提供收到的服务时,RP-Cause 值

SmsRpCauseReserved
已过时.

保留号码的 RP-Cause 值

SmsRpCauseResourcesUnavailable
已过时.

RP-Cause 网络资源不可用时的值

SmsRpCauseSemanticallyIncorrectMessage
已过时.

当网络不提供收到的服务时,RP-Cause 值

SmsRpCauseShortMessageTransferRejected
已过时.

网络拒绝的邮件传输 RP-Cause 值

SmsRpCauseTemporaryFailure
已过时.

临时故障 RP-Cause 值

SmsRpCauseUnallocatedNumber
已过时.

未分配的数字原因

SmsRpCauseUnidentifiedSubscriber
已过时.

未标识订阅服务器时 RP-Cause 值

SmsRpCauseUnknownSubscriber
已过时.

未标识订阅服务器时 RP-Cause 值

属性

CarrierConfigValues

获取依赖于运营商的 MMS 配置值。

Class

返回此 Object的运行时类。

(继承自 Object)
Default

获取与默认订阅 ID 关联的 SmsManager。

DefaultSmsSubscriptionId

获取默认短信订阅 ID。

Handle

基础 Android 实例的句柄。

(继承自 Object)
JniIdentityHashCode

管理短信操作,例如发送数据、文本和 pdu 短信。

(继承自 Object)
JniPeerMembers

管理短信操作,例如发送数据、文本和 pdu 短信。

PeerReference

管理短信操作,例如发送数据、文本和 pdu 短信。

(继承自 Object)
SmscAddress

从 (U) SIM 卡获取 SMSC 地址。

SmsCapacityOnIcc

获取 SIM 卡卡上的短信存储的总容量。

SubscriptionId

获取关联的订阅 ID。

ThresholdClass

此 API 支持 Mono for Android 基础结构,不应直接从代码使用。

(继承自 Object)
ThresholdType

此 API 支持 Mono for Android 基础结构,不应直接从代码使用。

(继承自 Object)

方法

Clone()

创建并返回此对象的副本。

(继承自 Object)
CreateAppSpecificSmsToken(PendingIntent)

为呼叫包创建单次使用应用特定的传入短信请求。

CreateAppSpecificSmsTokenWithPackageInfo(String, PendingIntent)

为呼叫包创建单次使用应用特定的传入短信请求。

CreateForSubscriptionId(Int32)

获取与特定订阅 ID 关联的 SmsManager 实例。

Dispose()

管理短信操作,例如发送数据、文本和 pdu 短信。

(继承自 Object)
Dispose(Boolean)

管理短信操作,例如发送数据、文本和 pdu 短信。

(继承自 Object)
DivideMessage(String)

将消息文本划分为多个片段,不超过最大短信大小。

DownloadMultimediaMessage(Context, String, Uri, Bundle, PendingIntent)

按给定位置 URL 从运营商下载彩信

        &lt;p class="note"&gt;&lt;strong&gt;Note:&lt;/strong&gt; If <code data-dev-comment-type="c">#getDefault()</code> is used to instantiate this
        manager on a multi-SIM device, this operation may fail downloading the MMS message because no
        suitable default subscription could be found.
DownloadMultimediaMessage(Context, String, Uri, Bundle, PendingIntent, Int64)

按给定位置 URL 从运营商下载彩信

        Same as <code data-dev-comment-type="c">#downloadMultimediaMessage(Context context, String locationUrl,
             Uri contentUri, Bundle configOverrides, PendingIntent downloadedIntent)</code>,
             but adds an optional messageId.
Equals(Object)

指示其他某个对象是否“等于”此对象。

(继承自 Object)
GetHashCode()

返回对象的哈希代码值。

(继承自 Object)
GetSmsManagerForSubscriptionId(Int32)

获取与特定订阅 ID 关联的 SmsManager 实例。

GetSmsMessagesForFinancialApp(Bundle, IExecutor, SmsManager+FinancialSmsCallback)

获取呼叫财务应用的短信。

InjectSmsPdu(Byte[], String, PendingIntent)

将 SMS PDU 注入 Android 应用程序框架。

JavaFinalize()

当垃圾回收确定不再引用对象时,由对象上的垃圾回收器调用。

(继承自 Object)
Notify()

唤醒正在等待此对象的监视器的单个线程。

(继承自 Object)
NotifyAll()

唤醒正在等待此对象的监视器的所有线程。

(继承自 Object)
SendDataMessage(String, String, Int16, Byte[], PendingIntent, PendingIntent)

将基于数据的短信发送到特定应用程序端口。

SendMultimediaMessage(Context, Uri, String, Bundle, PendingIntent)

发送彩信

        &lt;p class="note"&gt;&lt;strong&gt;Note:&lt;/strong&gt; If <code data-dev-comment-type="c">#getDefault()</code> is used to instantiate this
        manager on a multi-SIM device, this operation may fail sending the MMS message because no
        suitable default subscription could be found.
SendMultimediaMessage(Context, Uri, String, Bundle, PendingIntent, Int64)

发送彩信

        Same as <code data-dev-comment-type="c">#sendMultimediaMessage(Context context, Uri contentUri, String locationUrl,
                  Bundle configOverrides, PendingIntent sentIntent)</code>, but adds an optional messageId.
SendMultipartTextMessage(String, String, IList<String>, IList<PendingIntent>, IList<PendingIntent>)

发送基于多部分文本的短信。

SendMultipartTextMessage(String, String, IList<String>, IList<PendingIntent>, IList<PendingIntent>, Int64)

发送基于多部分文本的短信。

SendMultipartTextMessage(String, String, IList<String>, IList<PendingIntent>, IList<PendingIntent>, String, String)

与 #sendMultipartTextMessage (String、String、ArrayList、ArrayList、ArrayList、ArrayList) 方法类似,具有附加参数。

SendTextMessage(String, String, String, PendingIntent, PendingIntent)

发送基于文本的短信。

SendTextMessage(String, String, String, PendingIntent, PendingIntent, Int64)

发送基于文本的短信。

SendTextMessageWithoutPersisting(String, String, String, PendingIntent, PendingIntent)

发送基于文本的短信,而无需将其写入 SMS 提供程序。

SetHandle(IntPtr, JniHandleOwnership)

设置 Handle 属性。

(继承自 Object)
SetSmscAddress(String)

设置 (U) SIM 卡上的 SMSC 地址。

ToArray<T>()

管理短信操作,例如发送数据、文本和 pdu 短信。

(继承自 Object)
ToString()

返回对象的字符串表示形式。

(继承自 Object)
UnregisterFromRuntime()

管理短信操作,例如发送数据、文本和 pdu 短信。

(继承自 Object)
Wait()

导致当前线程等待,直到它被唤醒,通常是通过 em <通知/em> 或 <em>interrupted</em>。<>

(继承自 Object)
Wait(Int64)

导致当前线程等待,直到它被唤醒,通常是通过 em <通知/em> 或 <em>interrupted</em>,或直到经过一定数量的实时。<>

(继承自 Object)
Wait(Int64, Int32)

导致当前线程等待,直到它被唤醒,通常是通过 em <通知/em> 或 <em>interrupted</em>,或直到经过一定数量的实时。<>

(继承自 Object)

显式接口实现

IJavaPeerable.Disposed()

管理短信操作,例如发送数据、文本和 pdu 短信。

(继承自 Object)
IJavaPeerable.DisposeUnlessReferenced()

管理短信操作,例如发送数据、文本和 pdu 短信。

(继承自 Object)
IJavaPeerable.Finalized()

管理短信操作,例如发送数据、文本和 pdu 短信。

(继承自 Object)
IJavaPeerable.JniManagedPeerState

管理短信操作,例如发送数据、文本和 pdu 短信。

(继承自 Object)
IJavaPeerable.SetJniIdentityHashCode(Int32)

管理短信操作,例如发送数据、文本和 pdu 短信。

(继承自 Object)
IJavaPeerable.SetJniManagedPeerState(JniManagedPeerStates)

管理短信操作,例如发送数据、文本和 pdu 短信。

(继承自 Object)
IJavaPeerable.SetPeerReference(JniObjectReference)

管理短信操作,例如发送数据、文本和 pdu 短信。

(继承自 Object)

扩展方法

JavaCast<TResult>(IJavaObject)

执行 Android 运行时检查的类型转换。

JavaCast<TResult>(IJavaObject)

管理短信操作,例如发送数据、文本和 pdu 短信。

GetJniTypeName(IJavaPeerable)

管理短信操作,例如发送数据、文本和 pdu 短信。

适用于