語言

SmsManager.SendTextMessage 方法

定義

多載

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 ,則在訊息成功傳送或失敗時廣播。 結果代碼將顯示Activity.RESULT_OK成功,或以下其中一種錯誤:<br><代碼>RESULT_ERROR_GENERIC_FAILURE</代碼><br><代碼>RESULT_ERROR_RADIO_OFF</代碼><br><代碼>RESULT_ERROR_NULL_PDU</代碼><br<>代碼>RESULT_ERROR_NO_SERVICE</代碼><br><代碼>RESULT_ERROR_LIMIT_EXCEEDED</代碼><br><代碼>RESULT_ERROR_FDN_CHECK_FAILURE</代碼 br><代碼 RESULT_ERROR_SHORT_CODE_NOT_ALLOWED/代碼><BR<>代碼 RESULT_ERROR_SHORT_CODE_NEVER_ALLOWED></代碼><BR<>代碼>RESULT_RADIO_NOT_AVAILABLE</代碼><BR><代碼 RESULT_NETWORK_REJECT<>/代碼><BR<>代碼 RESULT_INVALID_ARGUMENTS></代碼><BR><代碼>RESULT_INVALID_STATE</代碼><BR><代碼 RESULT_NO_MEMORY><>><</代碼><br<>代碼>RESULT_INVALID_SMS_FORMAT</代碼><br><代碼>RESULT_SYSTEM_ERROR</代碼><br<>代碼>RESULT_MODEM_ERROR</代碼><br<>代碼>RESULT_NETWORK_ERROR</代碼><br<>代碼>RESULT_ENCODING_ERROR</代碼><br><代碼>代碼 RESULT_INVALID_SMSC_ADDRESS</代碼><br><代碼 RESULT_OPERATION_NOT_ALLOWED></代碼><br><代碼>RESULT_INTERNAL_ERROR</代碼><br<>代碼>RESULT_NO_RESOURCES</代碼><br><代碼>RESULT_CANCELLED</代碼><br><代碼>RESULT_REQUEST_NOT_SUPPORTED</代碼><br><代碼>RESULT_NO_BLUETOOTH_SERVICE</代碼><br><代碼>RESULT_INVALID_BLUETOOTH_ADDRESS</代碼 br>><<代碼>RESULT_BLUETOOTH_DISCONNECTED</代碼><br><代碼>RESULT_UNEXPECTED_EVENT_STOP_SENDING</代碼><br><代碼>RESULT_SMS_BLOCKED_DURING_EMERGENCY</代碼><br><代碼>RESULT_SMS_SEND_RETRY_FAILED</代碼><br<>代碼 RESULT_REMOTE_EXCEPTION></代碼><br><代碼>RESULT_NO_DEFAULT_SMS_APP</代碼><br 代碼><>RESULT_RIL_RADIO_NOT_AVAILABLE</代碼><br<>代碼>RESULT_RIL_SMS_SEND_FAIL_RETRY</代碼><br><代碼>RESULT_RIL_NETWORK_REJECT</代碼><br><代碼>RESULT_RIL_INVALID_STATE</代碼><br<>代碼>RESULT_RIL_INVALID_ARGUMENTS</代碼><br 代碼>代碼><RESULT_RIL_NO_MEMORY</代碼><br><代碼>RESULT_RIL_REQUEST_RATE_LIMITED</代碼><br><代碼>RESULT_RIL_INVALID_SMS_FORMAT</代碼><br><代碼>RESULT_RIL_SYSTEM_ERR</代碼><br<>代碼 RESULT_RIL_ENCODING_ERR<>/代碼><br><代碼>RESULT_RIL_INVALID_SMSC_ADDRESS</代碼><br 代碼>RESULT_RIL_MODEM_ERR><</代碼><br<>代碼 RESULT_RIL_NETWORK_ERR/><代碼><BR><代碼 RESULT_RIL_INTERNAL_ERR<>/代碼><BR><代碼 RESULT_RIL_REQUEST_NOT_SUPPORTED></代碼><BR><代碼 RESULT_RIL_INVALID_MODEM_STATE<>/代碼><BR<>代碼 RESULT_RIL_NETWORK_NOT_READY></代碼><BR><代碼 代碼>RESULT_RIL_OPERATION_NOT_ALLOWED</代碼><BR<>代碼 代碼>RESULT_RIL_NO_RESOURCES</代碼><BR><代碼>RESULT_RIL_CANCELLED</代碼><br<>代碼>RESULT_RIL_SIM_ABSENT</代碼><br><代碼>RESULT_RIL_SIMULTANEOUS_SMS_AND_CALL_NOT_ALLOWED</代碼><br<>代碼>RESULT_RIL_ACCESS_BARRED</代碼><br<>代碼>代碼 RESULT_RIL_BLOCKED_DUE_TO_CALL</代碼><br> For RESULT_ERROR_GENERIC_FAILURE或任何RESULT_RIL錯誤,sentIntent 可能會包含額外的「errorCode」,其中包含無線電技術專屬的值,通常僅用於故障排除。<BR>

deliveryIntent
PendingIntent

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

messageId
Int64

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

屬性

備註

發送簡訊。 與 類似 #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成功,或以下錯誤之一:<br>RESULT_ERROR_GENERIC_FAILURE<br>RESULT_ERROR_RADIO_OFF<br br>RESULT_ERROR_NULL_PDU<>RESULT_ERROR_NO_SERVICE<>RESULT_ERROR_LIMIT_EXCEEDED<>RESULT_ERROR_FDN_CHECK_FAILURE<>RESULT_ERROR_SHORT_CODE_NOT_ALLOWED<>RESULT_ERROR_SHORT_CODE_NEVER_ALLOWED<>RESULT_RADIO_NOT_AVAILABLE<>RESULT_NETWORK_REJECT<>RESULT_INVALID_ARGUMENTS<>RESULT_INVALID_STATE<>RESULT_NO_MEMORY<>RESULT_INVALID_SMS_FORMAT<>RESULT_SYSTEM_ERROR<>RESULT_MODEM_ERROR<>RESULT_NETWORK_ERROR<>RESULT_ENCODING_ERROR<>RESULT_INVALID_SMSC_ADDRESS<>RESULT_OPERATION_NOT_ALLOWED<BR>RESULT_INTERNAL_ERROR<BR>BRRESULT_NO_RESOURCES<>RESULT_CANCELLED<>RESULT_REQUEST_NOT_SUPPORTED<>RESULT_NO_BLUETOOTH_SERVICE<>RESULT_INVALID_BLUETOOTH_ADDRESS<>RESULT_BLUETOOTH_DISCONNECTED<>RESULT_UNEXPECTED_EVENT_STOP_SENDING<>RESULT_SMS_BLOCKED_DURING_EMERGENCY<>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_REJECT<>RESULT_RIL_INVALID_STATE<>RESULT_RIL_INVALID_ARGUMENTS<>RESULT_RIL_NO_MEMORY<>RESULT_RIL_REQUEST_RATE_LIMITED<>RESULT_RIL_INVALID_SMS_FORMAT<>RESULT_RIL_SYSTEM_ERR<>RESULT_RIL_ENCODING_ERR<>RESULT_RIL_INVALID_SMSC_ADDRESS<br>RESULT_RIL_MODEM_ERR<br br>RESULT_RIL_NETWORK_ERR<br>RESULT_RIL_INTERNAL_ERR<br>RESULT_RIL_REQUEST_NOT_SUPPORTED<>RESULT_RIL_INVALID_MODEM_STATE<>RESULT_RIL_NETWORK_NOT_READY<>RESULT_RIL_OPERATION_NOT_ALLOWED<>RESULT_RIL_NO_RESOURCES<>RESULT_RIL_CANCELLED<>RESULT_RIL_SIM_ABSENT<>RESULT_RIL_SIMULTANEOUS_SMS_AND_CALL_NOT_ALLOWED<>RESULT_RIL_ACCESS_BARRED<>RESULT_RIL_BLOCKED_DUE_TO_CALL<> 對於RESULT_ERROR_GENERIC_FAILURE任何RESULT_RIL錯誤,sentIntent 可能會包含額外的「errorCode」,其中包含無線電技術特定的值,通常只適用於正在排查。<BR>

deliveryIntent
PendingIntent

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

屬性

例外狀況

若 destinationAddress 或文字為空

備註

發送簡訊。

注意: 使用此方法需要您的應用程式擁有權限 android.Manifest.permission#SEND_SMS 。

注意: 從 Android 4.4(API 等級 19)開始,只有 當且僅當 應用程式未被選為預設 SMS 應用程式時,系統會自動將使用此方法發送的訊息寫入 SMS 提供者(預設 SMS 應用程式始終負責將已發送訊息寫入 SMS 提供者)。 關於如何作為預設簡訊應用程式的行為資訊,請參見 android.provider.Telephony。

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

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

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

適用於