SmsManager.SendTextMessage 方法

定義

命名空間:: Android.Telephony

組件:: Mono.Android.dll

重要

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

多載

名稱	Description
SendTextMessage(String, String, String, PendingIntent, PendingIntent, Int64)	發送簡訊。
SendTextMessage(String, String, String, PendingIntent, PendingIntent)	發送簡訊。

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

發送簡訊。

[Android.Runtime.Register("sendTextMessage", "(Ljava/lang/String;Ljava/lang/String;Ljava/lang/String;Landroid/app/PendingIntent;Landroid/app/PendingIntent;J)V", "", ApiSince=30)]
public void SendTextMessage(string destinationAddress, string? scAddress, string text, Android.App.PendingIntent? sentIntent, Android.App.PendingIntent? deliveryIntent, long messageId);

[<Android.Runtime.Register("sendTextMessage", "(Ljava/lang/String;Ljava/lang/String;Ljava/lang/String;Landroid/app/PendingIntent;Landroid/app/PendingIntent;J)V", "", ApiSince=30)>]
member this.SendTextMessage : string * string * string * Android.App.PendingIntent * Android.App.PendingIntent * int64 -> unit

參數

destinationAddress: String

要傳送訊息的地址

scAddress: String

是服務中心地址或空，使用當前預設的 SMSC

text: String

要發送的訊息內容

sentIntent: PendingIntent

若未 NULL，則當訊息成功傳送或失敗時，該 <程式碼>會廣播為 PendingIntent</code> 。結果代碼會是<>成功代碼 Activity.RESULT_OK</code> ，或以下錯誤之一：<br<>代碼>RESULT_ERROR_GENERIC_FAILURE</code><br<>代碼>RESULT_ERROR_RADIO_OFF</code> <代碼>RESULT_ERROR_NULL_PDU</code> <代碼>RESULT_ERROR_NO_SERVICE</code><br<>代碼>RESULT_ERROR_LIMIT_EXCEEDED</code> ><RESULT_ERROR_FDN_CHECK_FAILURE</代碼><br<>代碼>RESULT_ERROR_SHORT_CODE_NOT_ALLOWED</代碼> <代碼>RESULT_ERROR_SHORT_CODE_NEVER_ALLOWED</代碼><br<>代碼>RESULT_RADIO_NOT_AVAILABLE</代碼> <代碼>RESULT_NETWORK_REJECT</代碼> <代碼 RESULT_INVALID_ARGUMENTS>/代碼> <代碼代碼>RESULT_INVALID_STATE<</代碼> <代碼>RESULT_NO_MEMORY/代碼><BR<>代碼代碼>RESULT_INVALID_SMS_FORMAT</代碼> <代碼 RESULT_SYSTEM_ERROR></代碼> <代碼>RESULT_MODEM_ERROR</代碼><BR<>代碼 RESULT_NETWORK_ERROR></代碼><BR<>代碼 RESULT_ENCODING_ERROR>/代碼> <代碼代碼>RESULT_INVALID_SMSC_ADDRESS<</代碼> 代碼><<RESULT_OPERATION_NOT_ALLOWED</代碼> <代碼 RESULT_INTERNAL_ERROR></代碼> <代碼>RESULT_NO_RESOURCES</代碼> <代碼>RESULT_CANCELLED</代碼><br<>代碼>RESULT_REQUEST_NOT_SUPPORTED</代碼> <代碼>RESULT_NO_BLUETOOTH_SERVICE</代碼> <代碼代碼RESULT_INVALID_BLUETOOTH_ADDRESS></code> <代碼>RESULT_BLUETOOTH_DISCONNECTED</code><br<>代碼代碼>RESULT_UNEXPECTED_EVENT_STOP_SENDING</code><br<>代碼 RESULT_SMS_BLOCKED_DURING_EMERGENCY<>/code><br<>代碼 RESULT_SMS_SEND_RETRY_FAILED>/code><br<>代碼 RESULT_REMOTE_EXCEPTION<></代碼> <代碼 RESULT_NO_DEFAULT_SMS_>APP</代碼><br<>代碼>RESULT_RIL_RADIO_NOT_AVAILABLE</代碼> <代碼>RESULT_RIL_SMS_SEND_FAIL_RETRY</代碼> <代碼>RESULT_RIL_NETWORK_REJECT</代碼><br<>代碼>RESULT_RIL_INVALID_STATE</代碼><br<>代碼 RESULT_RIL_INVALID_ARGUMENTS></代碼><br<>代碼代碼>RESULT_RIL_NO_MEMORY</code> <代碼>RESULT_RIL_REQUEST_RATE_LIMITED</代碼> <代碼代碼>RESULT_RIL_INVALID_SMS_FORMAT</代碼> <代碼 RESULT_RIL_SYSTEM_ERR></代碼><BR<>代碼>RESULT_RIL_ENCODING_ERR</代碼><BR<>代碼>RESULT_RIL_INVALID_SMSC_ADDRESS</代碼> <代碼 RESULT_RIL_MODEM_ERR></代碼> <代碼 RESULT_>RIL_NETWORK_ERR</代碼> <代碼 RESULT_RIL_INTERNAL_ERR></代碼> <代碼>RESULT_RIL_REQUEST_NOT_SUPPORTED</代碼> <代碼>RESULT_RIL_INVALID_MODEM_STATE</代碼><br<>代碼>RESULT_RIL_NETWORK_NOT_READY</代碼> <代碼>RESULT_RIL_OPERATION_NOT_ALLOWED</代碼> <代碼代碼RESULT_RIL_NO_>RESOURCES/code br>代碼 RESULT_RIL_CANCELLED<>/code> <>RESULT_RIL_SIM_ABSENT</code> <代碼>RESULT_RIL_SIMULTANEOUS_SMS_AND_CALL_NOT_ALLOWED</code> <代碼 RESULT_RIL_ACCESS_BARRED></code><br<>代碼代碼>RESULT_RIL_BLOCKED_DUE_TO_CALL</代碼> 用於<代碼RESULT_ERROR_><><<GENERIC_FAILURE</代碼>或任何RESULT_RIL錯誤，sentIntent 可能會包含額外的「errorCode」，其中包含無線電技術特定的值，通常僅用於故障排除。

deliveryIntent: PendingIntent

若未 NULL <，則在訊息送達接收者時，該代碼>PendingIntent</code> 會被廣播。狀態報告的原始 PDU 則在擴展資料（「pdu」）中。

messageId: Int64

一個唯一識別被請求發送訊息的 ID。用於日誌記錄與診斷目的。 ID（識別碼）可能是0。

屬性: RegisterAttribute

備註

發送簡訊。與類似 #sendTextMessage( String destinationAddress, String scAddress, String text, PendingIntent sentIntent, PendingIntent deliveryIntent)，但會新增一個可選的 messageId。

Java 文件 android.telephony.SmsManager.sendTextMessage(java.lang.String, java.lang.String, java.lang.String, android.app.PendingIntent, android.app.PendingIntent, long)。

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

適用於

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

發送簡訊。

[Android.Runtime.Register("sendTextMessage", "(Ljava/lang/String;Ljava/lang/String;Ljava/lang/String;Landroid/app/PendingIntent;Landroid/app/PendingIntent;)V", "")]
public void SendTextMessage(string? destinationAddress, string? scAddress, string? text, Android.App.PendingIntent? sentIntent, Android.App.PendingIntent? deliveryIntent);

[<Android.Runtime.Register("sendTextMessage", "(Ljava/lang/String;Ljava/lang/String;Ljava/lang/String;Landroid/app/PendingIntent;Landroid/app/PendingIntent;)V", "")>]
member this.SendTextMessage : string * string * string * Android.App.PendingIntent * Android.App.PendingIntent -> unit

參數

destinationAddress: String

要傳送訊息的地址

scAddress: String

是服務中心地址或空，使用當前預設的 SMSC

text: String

要發送的訊息內容

sentIntent: PendingIntent

若非 NULL PendingIntent ，則在訊息成功傳送或失敗時廣播。結果代碼會是Activity.RESULT_OK成功，或以下錯誤之一： RESULT_ERROR_GENERIC_FAILURE<brRESULT_ERROR_RADIO_OFF<>br br>RESULT_ERROR_FDN_CHECK_FAILURE<><<RESULT_ERROR_SHORT_CODE_NOT_ALLOWED>RESULT_ERROR_SHORT_CODE_NEVER_ALLOWED<>RESULT_RADIO_NOT_AVAILABLERESULT_ERROR_LIMIT_EXCEEDED><RESULT_NETWORK_REJECT<>RESULT_INVALID_ARGUMENTS<>RESULT_INVALID_STATE>RESULT_SYSTEM_ERROR><<RESULT_INVALID_SMS_FORMAT>><RESULT_MODEM_ERRORRESULT_NO_MEMORY<><><RESULT_ENCODING_ERROR<RESULT_OPERATION_NOT_ALLOWED>RESULT_NETWORK_ERROR<>RESULT_INVALID_SMSC_ADDRESS>>RESULT_ERROR_NULL_PDU<>RESULT_ERROR_NO_SERVICE< RESULT_INTERNAL_ERROR BR>>RESULT_SMS_BLOCKED_DURING_EMERGENCY<><<RESULT_INVALID_BLUETOOTH_ADDRESS>RESULT_BLUETOOTH_DISCONNECTED<>RESULT_UNEXPECTED_EVENT_STOP_SENDINGRESULT_NO_BLUETOOTH_SERVICE><RESULT_SMS_SEND_RETRY_FAILED<>RESULT_REMOTE_EXCEPTION<>RESULT_NO_DEFAULT_SMS_APP><>RESULT_RIL_RADIO_NOT_AVAILABLE<RESULT_RIL_SMS_SEND_FAIL_RETRY<><RESULT_RIL_NETWORK_REJECTRESULT_RIL_NO_MEMORY<><RESULT_RIL_INVALID_ARGUMENTS>><RESULT_RIL_INVALID_STATERESULT_RIL_REQUEST_RATE_LIMITED><RESULT_REQUEST_NOT_SUPPORTED<>><RESULT_RIL_SYSTEM_ERRRESULT_RIL_INVALID_SMS_FORMAT<><>RESULT_RIL_ENCODING_ERRRESULT_CANCELLED><RESULT_NO_RESOURCES<>RESULT_RIL_INVALID_SMSC_ADDRESS RESULT_RIL_MODEM_ERR br>RESULT_RIL_INTERNAL_ERR<brRESULT_RIL_REQUEST_NOT_SUPPORTED<>><RESULT_RIL_OPERATION_NOT_ALLOWED>RESULT_RIL_NO_RESOURCES<RESULT_RIL_NETWORK_NOT_READY><<RESULT_RIL_INVALID_MODEM_STATE>>RESULT_RIL_CANCELLEDRESULT_RIL_SIMULTANEOUS_SMS_AND_CALL_NOT_ALLOWED><<>RESULT_RIL_SIM_ABSENTRESULT_RIL_ACCESS_BARRED<><RESULT_RIL_BLOCKED_DUE_TO_CALL<>> 對於RESULT_ERROR_GENERIC_FAILURE任何RESULT_RIL錯誤，sentIntent 可能會包含額外的「errorCode」，其中包含無線電技術特定的值，通常只適用於正在排查。

deliveryIntent: PendingIntent

若非 NULL PendingIntent ，則在訊息送達接收端時即廣播此訊息。狀態報告的原始 PDU 則在擴展資料（「pdu」）中。

屬性: RegisterAttribute

例外狀況

IllegalArgumentException

若 destinationAddress 或文字為空

備註

發送簡訊。

<強>注意： 使用此方法需要你的應用程式取得權限 android.Manifest.permission#SEND_SMS 。

Note： 從 Android 4.4（API 等級 19）開始，如果 且僅當<>某應用程式未被選為預設簡訊應用程式時，系統會自動將使用此方法發送的訊息寫入 SMS 提供者（預設 SMS 應用程式始終負責將發送訊息寫入 SMS 提供者）。關於如何作為預設簡訊應用程式的行為資訊，請參見 android.provider.Telephony。

Note： 如果 #getDefault() 使用在多 SIM 裝置上實例化此管理器，此操作可能會因找不到合適的預設訂閱而失敗，無法發送簡訊。此時若sentIntent非空，則PendingIntent會以錯誤碼RESULT_ERROR_GENERIC_FAILURE及包含布林值true的額外字串"noDefault"傳送。關於此操作可能失敗的條件，請參見 #getDefault() 相關資訊。

Java 文件 android.telephony.SmsManager.sendTextMessage(java.lang.String, java.lang.String, java.lang.String, android.app.PendingIntent, android.app.PendingIntent)。

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

適用於