SmsManager 類別

定義

命名空間:: Android.Telephony

組件:: Mono.Android.dll

重要

部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。

管理簡訊操作，如傳送資料、簡訊及 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

繼承: Object

JavaObject

Object
SmsManager

屬性: RegisterAttribute

備註

管理簡訊操作，如傳送資料、簡訊及 PDU 簡訊。透過呼叫靜態方法 #getDefault()來取得此物件。若要建立與特定訂閱 ID 相關的實例 SmsManager ，請呼叫 #getSmsManagerForSubscriptionId(int)。這通常用於同時支援多個有效訂閱的裝置。

關於如何在 Android 4.4（API 等級 19）及以上版本上，作為預設簡訊應用程式的資訊，請參見 android.provider.Telephony。

Java 文件 android.telephony.SmsManager。

本頁部分內容為基於 Open Source Project 所創建與分享的作品，並依授權條款所描述的使用進行修改。

欄位

名稱	Description
ExtraMmsData	用於以位元組陣列類型傳送結果資料的 MMS 意圖額外名稱
ExtraMmsHttpStatus	為整數型態 MMS HTTP 失敗的 HTTP 狀態碼提供意圖額外名稱
MmsConfigAliasEnabled	是否啟用別名（布林型別）
MmsConfigAliasMaxChars	最大別名字元數（int 類型）
MmsConfigAliasMinChars	最小別名字元數（int 類型）
MmsConfigAllowAttachAudio	是否允許為 MMS 訊息（布林類型）附加音訊
MmsConfigAppendTransactionId	是否要將交易 ID 附加到 MMS WAP 推播 M-Notification 上。
MmsConfigEmailGatewayNumber	電子郵件閘道號碼（字串類型）
MmsConfigGroupMmsEnabled	是否啟用群組 MMS（布林型）
MmsConfigHttpParams	一份可加入 MMS HTTP 請求的 HTTP 標頭清單，中間以「\|」分隔。（字串類型）
MmsConfigHttpSocketTimeout	MMS HTTP 套接字逾時（以毫秒計）（整數型別）
MmsConfigMaxImageHeight	最大 MMS 圖片高度（int 類型）
MmsConfigMaxImageWidth	最大 MMS 影像寬度（int 類型）
MmsConfigMaxMessageSize	最大 MMS 訊息大小（位元組）（整數型別）
MmsConfigMessageTextMaxSize	最大訊息文字大小（int 類型）
MmsConfigMmsDeliveryReportEnabled	是否啟用了 MMS 傳遞報告（布林型態）
MmsConfigMmsEnabled	是否啟用 MMS 以支援當前載波（布林型）
MmsConfigMmsReadReportEnabled	是否啟用了 MMS 讀取報告（布林類型）
MmsConfigMultipartSmsEnabled	是否啟用多部分簡訊（布林型態）
MmsConfigNaiSuffix	MMS HTTP 請求（字串類型）後附加於 NAI 標頭值的後綴
MmsConfigNotifyWapMmscEnabled	如果啟用此功能，請 M-NotifyResp。
MmsConfigRecipientLimit	MMS 訊息接收者的限制（整數型別）
MmsConfigSendMultipartSmsAsSeparateMessages	多部分簡訊是否應該分開發送
MmsConfigShowCellBroadcastAppLinks	如果是真的，請在簡訊設定中顯示手機訊號（琥珀警報）。
MmsConfigSmsDeliveryReportEnabled	是否啟用了 SMS 送達報告（布林型態）
MmsConfigSmsToMmsTextLengthThreshold	有些電信業者要求當文字長度達到此門檻（整數型態）時，必須將簡訊轉換成MMS。
MmsConfigSmsToMmsTextThreshold	當多部分簡訊的部分數量達到此門檻時，應將其轉換為MMS（整數型態）
MmsConfigSubjectMaxLength	最大訊息主旨長度（整數型別）
MmsConfigSupportHttpCharsetHeader	載信商 MMSC 是否支援 Content-Type 標頭中的字元集欄位。
MmsConfigSupportMmsContentDisposition	內容-處置欄位是否應該在 MMS PDU（布林型）中預期存在
MmsConfigUaProfTagName	UA Prof URL HTTP 標頭的名稱，用於 MMS HTTP 請求（字串類型）
MmsConfigUaProfUrl	UA Profile 的 MMS HTTP 請求標頭值（字串型別）
MmsConfigUserAgent	MMS HTTP 請求（字串類型）的 User-Agent 標頭值
MmsErrorDataDisabled	已淘汰. MMS APN 的資料被停用。
MmsErrorInactiveSubscription	已淘汰. 發送/下載的訂閱 ID 是非啟用的。
MmsErrorInvalidSubscriptionId	已淘汰. 發送/下載的訂閱ID是無效的。
MmsErrorMmsDisabledByCarrier	已淘汰. MMS 被電信業者停用。
ResultBluetoothDisconnected	已淘汰. 藍牙傳送失敗，因為藍牙斷線
ResultCancelled	已淘汰. 失敗是因為手術被取消了
ResultEncodingError	已淘汰. 因編碼錯誤而失敗
ResultErrorFdnCheckFailure	已淘汰. 失敗是因為 FDN 已啟用。
ResultErrorNone	已淘汰. 沒有錯誤。
ResultInternalError	已淘汰. 因內部錯誤而失敗
ResultInvalidArguments	已淘汰. 因論點無效而失敗
ResultInvalidBluetoothAddress	已淘汰. 藍牙傳送失敗，因為藍牙裝置地址無效
ResultInvalidSmscAddress	已淘汰. 因 SMSC 地址無效而失敗
ResultInvalidSmsFormat	已淘汰. 失敗是因為簡訊格式不正確
ResultInvalidState	已淘汰. 因狀態無效而失敗
ResultModemError	已淘汰. 因數據機錯誤而失敗
ResultNetworkError	已淘汰. 因網路錯誤而失敗
ResultNetworkReject	已淘汰. 因網路拒絕而失敗
ResultNoBluetoothService	已淘汰. 藍牙傳送失敗，因為藍牙服務無法使用。
ResultNoDefaultSmsApp	已淘汰. 由 BroadcastReceiver 設定為表示沒有預設的簡訊應用程式。
ResultNoMemory	已淘汰. 失敗是因為沒有記憶
ResultNoResources	已淘汰. 失敗是因為沒有資源
ResultOperationNotAllowed	已淘汰. 失敗是因為手術不被允許
ResultRadioNotAvailable	已淘汰. 失敗是因為無線電無法使用。
ResultReceiveDispatchFailure	已淘汰. SMS 收到派遣失敗。
ResultReceiveInjectedNullPdu	已淘汰. 簡訊接收注入的空PDU。
ResultReceiveNullMessageFromRil	已淘汰. SMS 從無線電介面層接收到空訊息。
ResultReceiveRuntimeException	已淘汰. SMS 收到遇到的執行時異常。
ResultReceiveSqlException	已淘汰. SMS 接收遇到 SQL 異常。
ResultReceiveUriException	已淘汰. SMS 在解析 URI 時收到例外。
ResultReceiveWhileEncrypted	已淘汰. 手機在加密狀態下收到簡訊短碼。
ResultRemoteException	已淘汰. 由 BroadcastReceiver 設定為在處理訊息時表示遠端例外。
ResultRequestNotSupported	已淘汰. 失敗是因為請求不被支援
ResultRilAborted	已淘汰. 行動中止
ResultRilAccessBarred	已淘汰. 禁止進入。
ResultRilBlockedDueToCall	已淘汰. 簡訊被封鎖是因為來電控制，例如。
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	已淘汰. 當沒有 SMS 要 ACK 時會收到 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	已淘汰. 緊急通話時傳送失敗
ResultSmsSendFailedAfterMaxRetry	已淘汰. 表示 SMS 發送操作失敗，因為所有允許的重試嘗試都用盡，且訊息未成功傳送。
ResultSmsSendRetryFailed	已淘汰. 未能發送簡訊重試
ResultSystemError	已淘汰. 因系統錯誤而失敗
ResultUnexpectedEventStopSending	已淘汰. 傳送失敗，因為使用者拒絕或取消了顯示的語音對話，該對話是高級短碼簡訊或速率限制的簡訊。
ResultUserNotAllowed	已淘汰. 用戶與訂閱無關聯。
SmsRpCauseCallBarring	已淘汰. RP-Cause 來電封鎖的價值
SmsRpCauseCongestion	已淘汰. RP-Cause 因網路擁塞導致的簡訊失效價值
SmsRpCauseDestinationOutOfOrder	已淘汰. RP-Cause 目的地的值是順序錯誤
SmsRpCauseFacilityNotImplemented	已淘汰. RP-Cause 當網路未提供所接收服務時的價值
SmsRpCauseFacilityNotSubscribed	已淘汰. RP-Cause 當 Reote 裝置未訂閱 SMS 服務時的價值
SmsRpCauseFacilityRejected	已淘汰. RP-Cause 當營運商拒絕簡訊服務時的價值
SmsRpCauseInformationElementNonExistent	已淘汰. RP-Cause 當網路未提供所接收服務時的價值
SmsRpCauseInterworkingUnspecified	已淘汰. RP-Cause 當網路未提供所接收服務時的價值
SmsRpCauseInvalidMandatoryInformation	已淘汰. RP-Cause 當網路未提供所接收服務時的價值
SmsRpCauseInvalidMessageReferenceValue	已淘汰. RP-Cause 價值 RP-MessageRefere
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 未識別用戶時的價值

屬性

名稱	Description
CarrierConfigValues	取得依電信而定的MMS設定值。
Class	回傳此 `Object`的執行時類別。 (繼承來源 Object)
Default	取得與預設訂閱 ID 綁定的 SmsManager。
DefaultSmsSubscriptionId	取得預設的簡訊訂閱 ID。
Handle	底層 Android 實例的帳號。 (繼承來源 Object)
JniIdentityHashCode	取得由互通執行時指派給此 Java 對等端的身份雜湊碼。 (繼承來源 Object)
JniManagedPeerState	管理簡訊操作，如傳送資料、簡訊及 PDU 簡訊。 (繼承來源 JavaObject)
JniPeerMembers	管理簡訊操作，如傳送資料、簡訊及 PDU 簡訊。
PeerReference	取得這個 Java 節點的 JNI 物件參考。 (繼承來源 Object)
SmscAddress	從（U）SIM 取得 SMSC 地址。
SmsCapacityOnIcc	取得 SIM 卡上 SMS 儲存空間的總容量。
SubscriptionId	取得相關的訂閱 ID。
ThresholdClass	此 API 支援 Mono for Android 基礎架構，並非直接從你的程式碼中使用。 (繼承來源 Object)
ThresholdType	此 API 支援 Mono for Android 基礎架構，並非直接從你的程式碼中使用。 (繼承來源 Object)

方法

名稱	Description
Clone()	建立並回傳此物件的副本。 (繼承來源 Object)
Construct(JniObjectReference, JniObjectReferenceOptions)	管理簡訊操作，如傳送資料、簡訊及 PDU 簡訊。 (繼承來源 JavaObject)
CreateAppSpecificSmsToken(PendingIntent)	為呼叫包裹建立一次性應用程式專用的來電簡訊請求。
CreateAppSpecificSmsTokenWithPackageInfo(String, PendingIntent)	為呼叫包裹建立一次性應用程式專用的來電簡訊請求。
CreateForSubscriptionId(Int32)	取得與特定訂閱 ID 關聯的 SmsManager 實例。
Dispose()	釋放該 Java 節點所持有的資源。 (繼承來源 Object)
Dispose(Boolean)	釋放該 Java 節點所持有的資源。 (繼承來源 Object)
DisposeUnlessReferenced()	管理簡訊操作，如傳送資料、簡訊及 PDU 簡訊。 (繼承來源 JavaObject)
DivideMessage(String)	將訊息文字分割成數個片段，且不大於最大 SMS 訊息大小。
DownloadMultimediaMessage(Context, String, Uri, Bundle, PendingIntent, Int64)	透過指定地點網址從電信業者下載MMS訊息 `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.`
DownloadMultimediaMessage(Context, String, Uri, Bundle, PendingIntent)	透過指定地點網址從電信業者下載MMS訊息
Equals(Object)	管理簡訊操作，如傳送資料、簡訊及 PDU 簡訊。 (繼承來源 JavaObject)
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, Int64)	發送 MMS 訊息 `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.`
SendMultimediaMessage(Context, Uri, String, Bundle, PendingIntent)	發送 MMS 訊息
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）的方法，但多了一個參數。
SendMultipartTextMessage(String, String, IList<String>, IList<PendingIntent>, IList<PendingIntent>)	發送多部分的簡訊簡訊。
SendTextMessage(String, String, String, PendingIntent, PendingIntent, Int64)	發送簡訊。
SendTextMessage(String, String, String, PendingIntent, PendingIntent)	發送簡訊。
SendTextMessageWithoutPersisting(String, String, String, PendingIntent, PendingIntent)	發送以簡訊為基礎的簡訊，但不寫入 SMS 服務提供者。
SetHandle(IntPtr, JniHandleOwnership)	設定 Handle 屬性。 (繼承來源 Object)
SetPeerReference(JniObjectReference, JniObjectReferenceOptions)	管理簡訊操作，如傳送資料、簡訊及 PDU 簡訊。 (繼承來源 JavaObject)
SetSmscAddress(String)	將 SMSC 位址設定在（U）SIM 上。
ToArray<T>()	從這個 Java 陣列包裝器建立一個受管理陣列。 (繼承來源 Object)
ToString()	回傳物件的字串表示。 (繼承來源 Object)
UnregisterFromRuntime()	將此 Java 節點從互通執行時中取消註冊。 (繼承來源 Object)
Wait()	導致目前執行緒等待被喚醒，通常是透過 <em>通知</><em 或 em>中斷</em> 來喚醒。 (繼承來源 Object)
Wait(Int64, Int32)	會讓目前執行緒等待喚醒，通常是透過 <em>通知</><em 或 em>中斷</em>，或是經過一定的真實時間。 (繼承來源 Object)
Wait(Int64)	會讓目前執行緒等待喚醒，通常是透過 <em>通知</><em 或 em>中斷</em>，或是經過一定的真實時間。 (繼承來源 Object)

明確介面實作

名稱	Description
IJavaPeerable.Disposed()	管理簡訊操作，如傳送資料、簡訊及 PDU 簡訊。 (繼承來源 JavaObject)
IJavaPeerable.Finalized()	管理簡訊操作，如傳送資料、簡訊及 PDU 簡訊。 (繼承來源 JavaObject)
IJavaPeerable.JniObjectReferenceControlBlock	管理簡訊操作，如傳送資料、簡訊及 PDU 簡訊。 (繼承來源 JavaObject)
IJavaPeerable.SetJniIdentityHashCode(Int32)	管理簡訊操作，如傳送資料、簡訊及 PDU 簡訊。 (繼承來源 JavaObject)
IJavaPeerable.SetJniManagedPeerState(JniManagedPeerStates)	管理簡訊操作，如傳送資料、簡訊及 PDU 簡訊。 (繼承來源 JavaObject)
IJavaPeerable.SetPeerReference(JniObjectReference)	管理簡訊操作，如傳送資料、簡訊及 PDU 簡訊。 (繼承來源 JavaObject)

擴充方法

名稱	Description
GetJniTypeName(IJavaPeerable)	取得實例 `self`類型的 JNI 名稱。
JavaAs<TResult>(IJavaPeerable)	試著強制`self`輸入 `TResult`，檢查強制在 Java 端是否有效。
JavaCast<TResult>(IJavaObject)	執行 Android 執行時檢查型別轉換。
JavaCast<TResult>(IJavaObject)	管理簡訊操作，如傳送資料、簡訊及 PDU 簡訊。
TryJavaCast<TResult>(IJavaPeerable, TResult)	試著強制`self`輸入 `TResult`，檢查強制在 Java 端是否有效。

適用於