SmsManager.SendMultipartTextMessage 方法

定義

命名空間:: Android.Telephony

組件:: Mono.Android.dll

重要

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

多載

名稱	Description
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）的方法，但多了一個參數。

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

發送多部分的簡訊簡訊。

[Android.Runtime.Register("sendMultipartTextMessage", "(Ljava/lang/String;Ljava/lang/String;Ljava/util/ArrayList;Ljava/util/ArrayList;Ljava/util/ArrayList;)V", "")]
public void SendMultipartTextMessage(string? destinationAddress, string? scAddress, System.Collections.Generic.IList<string>? parts, System.Collections.Generic.IList<Android.App.PendingIntent>? sentIntents, System.Collections.Generic.IList<Android.App.PendingIntent>? deliveryIntents);

[<Android.Runtime.Register("sendMultipartTextMessage", "(Ljava/lang/String;Ljava/lang/String;Ljava/util/ArrayList;Ljava/util/ArrayList;Ljava/util/ArrayList;)V", "")>]
member this.SendMultipartTextMessage : string * string * System.Collections.Generic.IList<string> * System.Collections.Generic.IList<Android.App.PendingIntent> * System.Collections.Generic.IList<Android.App.PendingIntent> -> unit

參數

destinationAddress: String

要傳送訊息的地址

scAddress: String

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

parts: IList<String>

一個 ArrayList 字串，依序構成原始訊息

sentIntents: IList<PendingIntent>

若非空，則 S ArrayListPendingIntent（每個訊息部分各一個）在對應訊息部分已傳送時廣播。結果代碼會是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」，其中包含無線電技術特定的值，通常只適用於正在排查。

deliveryIntents: IList<PendingIntent>

若非空，則 ArrayList S PendingIntent（每個訊息部分各一個）在對應訊息部分送達接收者時廣播。狀態報告的原始 PDU 則在擴展資料（「pdu」）中。

屬性: RegisterAttribute

備註

發送多部分的簡訊簡訊。被callee應該已經透過呼叫 divideMessage，將訊息分割成正確大小的部分。

<強>注意： 使用此方法需要你的應用程式取得權限 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.sendMultipartTextMessage(java.lang.String, java.lang.String, java.util.ArrayList<java.lang.String>, java.util.ArrayList<android.app.PendingIntent>, java.util.ArrayList<android.app.PendingIntent>)。

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

適用於

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

發送多部分的簡訊簡訊。

[Android.Runtime.Register("sendMultipartTextMessage", "(Ljava/lang/String;Ljava/lang/String;Ljava/util/List;Ljava/util/List;Ljava/util/List;J)V", "", ApiSince=30)]
public void SendMultipartTextMessage(string destinationAddress, string? scAddress, System.Collections.Generic.IList<string> parts, System.Collections.Generic.IList<Android.App.PendingIntent>? sentIntents, System.Collections.Generic.IList<Android.App.PendingIntent>? deliveryIntents, long messageId);

[<Android.Runtime.Register("sendMultipartTextMessage", "(Ljava/lang/String;Ljava/lang/String;Ljava/util/List;Ljava/util/List;Ljava/util/List;J)V", "", ApiSince=30)>]
member this.SendMultipartTextMessage : string * string * System.Collections.Generic.IList<string> * System.Collections.Generic.IList<Android.App.PendingIntent> * System.Collections.Generic.IList<Android.App.PendingIntent> * int64 -> unit

參數

destinationAddress: String

要傳送訊息的地址

scAddress: String

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

parts: IList<String>

一個<代碼 ArrayList</串代碼>，依>序組成原始訊息

sentIntents: IList<PendingIntent>

若非 null，則會在<發送對應訊息部分後廣播一組>ArrayList</><PendingIntent></code>s 代碼（每個訊息部分一個）。結果代碼會是<>成功代碼 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」，其中包含無線電技術特定的值，通常僅用於故障排除。

deliveryIntents: IList<PendingIntent>

若非 null，則會有一個<程式碼>ArrayList</>程式碼 <>PendingIntent</code>s（每個訊息部分一個），當對應的訊息部分送達收件人時，該程式碼會被廣播。狀態報告的原始 PDU 則在擴展資料（「pdu」）中。

messageId: Int64

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

屬性: RegisterAttribute

備註

發送多部分的簡訊簡訊。與 #sendMultipartTextMessage（String， String， ArrayList， ArrayList， ArrayList）相同，但新增一個可選的 messageId。

Java 文件 android.telephony.SmsManager.sendMultipartTextMessage(java.lang.String, java.lang.String, java.util.List<java.lang.String>, java.util.List<android.app.PendingIntent>, java.util.List<android.app.PendingIntent>, long)。

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

適用於

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

類似於 #sendMultipartTextMessage（String， String， ArrayList， ArrayList， ArrayList）的方法，但多了一個參數。

[Android.Runtime.Register("sendMultipartTextMessage", "(Ljava/lang/String;Ljava/lang/String;Ljava/util/List;Ljava/util/List;Ljava/util/List;Ljava/lang/String;Ljava/lang/String;)V", "", ApiSince=30)]
public void SendMultipartTextMessage(string destinationAddress, string? scAddress, System.Collections.Generic.IList<string> parts, System.Collections.Generic.IList<Android.App.PendingIntent>? sentIntents, System.Collections.Generic.IList<Android.App.PendingIntent>? deliveryIntents, string packageName, string? attributionTag);

[<Android.Runtime.Register("sendMultipartTextMessage", "(Ljava/lang/String;Ljava/lang/String;Ljava/util/List;Ljava/util/List;Ljava/util/List;Ljava/lang/String;Ljava/lang/String;)V", "", ApiSince=30)>]
member this.SendMultipartTextMessage : string * string * System.Collections.Generic.IList<string> * System.Collections.Generic.IList<Android.App.PendingIntent> * System.Collections.Generic.IList<Android.App.PendingIntent> * string * string -> unit

參數

destinationAddress: String

要傳送訊息的地址

scAddress: String

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

parts: IList<String>

一個<代碼 ArrayList</串代碼>，依>序組成原始訊息

sentIntents: IList<PendingIntent>

deliveryIntents: IList<PendingIntent>

packageName: String

若與使用者 ID 相關的套件名稱為空，則該套件作為預設的套件名稱。

attributionTag: String

屬性: RegisterAttribute

備註

類似於 #sendMultipartTextMessage（String， String， ArrayList， ArrayList， ArrayList）的方法，但多了一個參數。

<強>注意： 此方法用於電話框架內部使用，且永遠不會觸發簡訊消歧義對話框。如果在擁有多個有效訂閱的裝置上呼叫此方法，且 SmsManager 該實例已建立為 #getDefault()，且未定義使用者定義的預設訂閱，則與此訊息相關的訂閱 ID 將為 INVALID，導致簡訊會發送到與邏輯槽 0 相關的訂閱。用 #getSmsManagerForSubscriptionId(int) 來確保簡訊是用正確的訂閱方式發送的。

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

適用於