語言

SmsManager.SendDataMessage 方法

定義

發送基於資料的簡訊到特定的應用程式埠口。

[Android.Runtime.Register("sendDataMessage", "(Ljava/lang/String;Ljava/lang/String;S[BLandroid/app/PendingIntent;Landroid/app/PendingIntent;)V", "")]
public void SendDataMessage(string? destinationAddress, string? scAddress, short destinationPort, byte[]? data, Android.App.PendingIntent? sentIntent, Android.App.PendingIntent? deliveryIntent);
[<Android.Runtime.Register("sendDataMessage", "(Ljava/lang/String;Ljava/lang/String;S[BLandroid/app/PendingIntent;Landroid/app/PendingIntent;)V", "")>]
member this.SendDataMessage : string * string * int16 * byte[] * Android.App.PendingIntent * Android.App.PendingIntent -> unit

參數

destinationAddress
String

要傳送訊息的地址

scAddress
String

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

destinationPort
Int16

傳送訊息的埠口

data
Byte[]

要發送的訊息內容

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 。

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

Java 文件 android.telephony.SmsManager.sendDataMessage(java.lang.String, java.lang.String, short, byte[], android.app.PendingIntent, android.app.PendingIntent)。

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

適用於