SmsManager.SendTextMessage Método
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Sobrecargas
| Nome | Description |
|---|---|
| SendTextMessage(String, String, String, PendingIntent, PendingIntent, Int64) |
Enviar um SMS baseado em texto. |
| SendTextMessage(String, String, String, PendingIntent, PendingIntent) |
Enviar um SMS baseado em texto. |
SendTextMessage(String, String, String, PendingIntent, PendingIntent, Int64)
Enviar um SMS baseado em texto.
[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
Parâmetros
- destinationAddress
- String
o endereço para o qual enviar a mensagem
- scAddress
- String
é o endereço do centro de serviço ou nulo para usar o SMSC padrão atual
- text
- String
o corpo da mensagem a ser enviada
- sentIntent
- PendingIntent
se não FOR NULL, esse <código>PendingIntent</code> será transmitido quando a mensagem for enviada com êxito ou falhar. O código de resultado será <>código Activity.RESULT_OK</código> para êxito ou um destes erros:<br><code>RESULT_ERROR_GENERIC_FAILURE</code><br<>code>RESULT_ERROR_RADIO_OFF</code><br><code>RESULT_ERROR_NULL_PDU</code><br<>code>RESULT_ERROR_NO_SERVICE</code><br><code>RESULT_ERROR_LIMIT_EXCEEDED/code br code RESULT_ERROR_LIMIT_EXCEEDED</code><br code>><<código RESULT_ERROR_FDN_CHECK_FAILURE/code><br>><RESULT_ERROR_SHORT_CODE_NOT_ALLOWED</code><br<>code>RESULT_ERROR_SHORT_CODE_NEVER_ALLOWED</code><br><code>RESULT_RADIO_NOT_AVAILABLE</code><br<>code>RESULT_NETWORK_REJECT</code><br><code>RESULT_INVALID_ARGUMENTS</code><br<>code>RESULT_INVALID_STATE</code><br><>code RESULT_NO_MEMORY</code><br><code>RESULT_INVALID_SMS_FORMAT</code><br<>code>RESULT_SYSTEM_ERROR</code><br><code>RESULT_MODEM_ERROR</code><br<>code>RESULT_NETWORK_ERROR</code><br><code>RESULT_ENCODING_ERROR</code><br<>code>RESULT_INVALID_SMSC_ADDRESS/code br code RESULT_INVALID_SMSC_ADDRESS</code><br<code>><código RESULT_OPERATION_NOT_ALLOWED/code><br<>>RESULT_INTERNAL_ERROR</code><br<>code>RESULT_NO_RESOURCES</code><br<>code>RESULT_CANCELLED</code><br<>code>RESULT_REQUEST_NOT_SUPPORTED</code><br><code>RESULT_NO_BLUETOOTH_SERVICE</code br code>RESULT_INVALID_BLUETOOTH_ADDRESS/code><br RESULT_INVALID_BLUETOOTH_ADDRESS><<Código /code><br><>RESULT_BLUETOOTH_DISCONNECTED</code><br<>code>RESULT_UNEXPECTED_EVENT_STOP_SENDING</code><br><code>RESULT_SMS_BLOCKED_DURING_EMERGENCY</code><br<>code>RESULT_SMS_SEND_RETRY_FAILED</code><br><code>RESULT_REMOTE_EXCEPTION</code><br><code RESULT_NO_DEFAULT_SMS_> Código app</code><br>><RESULT_RIL_RADIO_NOT_AVAILABLE</code><br<>code>RESULT_RIL_SMS_SEND_FAIL_RETRY</code><br><code>RESULT_RIL_NETWORK_REJECT</code><br<>code>RESULT_RIL_INVALID_STATE</code><br><code>RESULT_RIL_INVALID_ARGUMENTS</code><br<>code>RESULT_RIL_NO_MEMORY/code RESULT_RIL_NO_MEMORY</code><br><>code RESULT_RIL_REQUEST_RATE_LIMITED</code><br><code>RESULT_RIL_INVALID_SMS_FORMAT</code><br<>code>RESULT_RIL_SYSTEM_ERR</code><br<>code>RESULT_RIL_ENCODING_ERR</code><br<>code>RESULT_RIL_INVALID_SMSC_ADDRESS</code><br><code>RESULT_RIL_MODEM_ERR</code><br><code>RESULT_ <código RIL_NETWORK_ERR/code><br<>>RESULT_RIL_INTERNAL_ERR</code><br<>code>RESULT_RIL_REQUEST_NOT_SUPPORTED</code><br><code>RESULT_RIL_INVALID_MODEM_STATE</code><br<>code>RESULT_RIL_NETWORK_NOT_READY</code><br><code>RESULT_RIL_OPERATION_NOT_ALLOWED</code><br><code RESULT_RIL_NO_> Código resources</code><br><>RESULT_RIL_CANCELLED</code><br><code>RESULT_RIL_SIM_ABSENT</code><br<>code>RESULT_RIL_SIMULTANEOUS_SMS_AND_CALL_NOT_ALLOWED</code><br<>code>RESULT_RIL_ACCESS_BARRED</code><br><code>RESULT_RIL_BLOCKED_DUE_TO_CALL</code><br> For <code RESULT_ERROR_><GENERIC_FAILURE/código> ou qualquer um dos erros de RESULT_RIL, o sentIntent pode incluir o "errorCode" extra que contém um valor específico da tecnologia de rádio, geralmente útil apenas para solução de problemas.<br>
- deliveryIntent
- PendingIntent
se não FOR NULL, esse <código>PendingIntent</code> será transmitido quando a mensagem for entregue ao destinatário. O pdu bruto do relatório de status está nos dados estendidos ("pdu").
- messageId
- Int64
Uma ID que identifica exclusivamente a mensagem solicitada a ser enviada. Usado para fins de registro em log e diagnóstico. A ID pode ser 0.
- Atributos
Comentários
Enviar um SMS baseado em texto. O mesmo que #sendTextMessage( String destinationAddress, String scAddress, String text, PendingIntent sentIntent, PendingIntent deliveryIntent), mas adiciona uma messageId opcional.
Partes desta página são modificações baseadas no trabalho criado e compartilhado pelo Project Open Source do Open Source e usadas de acordo com os termos descritos na Creative Commons 2.5.
Aplica-se a
SendTextMessage(String, String, String, PendingIntent, PendingIntent)
Enviar um SMS baseado em texto.
[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
Parâmetros
- destinationAddress
- String
o endereço para o qual enviar a mensagem
- scAddress
- String
é o endereço do centro de serviço ou nulo para usar o SMSC padrão atual
- text
- String
o corpo da mensagem a ser enviada
- sentIntent
- PendingIntent
se não FOR NULL, isso PendingIntent será transmitido quando a mensagem for enviada com êxito ou falhar.
O código de resultado será Activity.RESULT_OK para êxito ou um destes erros:<br><RESULT_ERROR_GENERIC_FAILUREbr>RESULT_ERROR_RADIO_OFF<br><<RESULT_ERROR_NULL_PDURESULT_ERROR_NO_SERVICE>br<>RESULT_ERROR_LIMIT_EXCEEDEDbr<RESULT_INVALID_STATE<<RESULT_INVALID_ARGUMENTS>>>><RESULT_NETWORK_REJECT<>RESULT_ERROR_SHORT_CODE_NEVER_ALLOWED<RESULT_ERROR_SHORT_CODE_NOT_ALLOWEDRESULT_ERROR_FDN_CHECK_FAILURE><RESULT_RADIO_NOT_AVAILABLE>RESULT_NO_MEMORYRESULT_INVALID_SMS_FORMAT><><br<>RESULT_SYSTEM_ERRORbr br<RESULT_MODEM_ERROR>br br br>RESULT_INVALID_SMSC_ADDRESSRESULT_OPERATION_NOT_ALLOWED><<RESULT_ENCODING_ERROR>>RESULT_NETWORK_ERROR<<br>RESULT_INTERNAL_ERROR<br>RESULT_NO_RESOURCES<br br><RESULT_CANCELLED><RESULT_REQUEST_NOT_SUPPORTEDbr><RESULT_NO_BLUETOOTH_SERVICERESULT_INVALID_BLUETOOTH_ADDRESS<>br<>RESULT_BLUETOOTH_DISCONNECTEDbrRESULT_UNEXPECTED_EVENT_STOP_SENDING><br>RESULT_SMS_BLOCKED_DURING_EMERGENCY<br<>RESULT_SMS_SEND_RETRY_FAILEDbr br><RESULT_REMOTE_EXCEPTIONbr>RESULT_NO_DEFAULT_SMS_APP<RESULT_RIL_RADIO_NOT_AVAILABLE<>brRESULT_RIL_SMS_SEND_FAIL_RETRY><brRESULT_RIL_NETWORK_REJECT><br>RESULT_RIL_INVALID_STATE<brRESULT_RIL_INVALID_ARGUMENTS<>brRESULT_RIL_NO_MEMORY><br><RESULT_RIL_REQUEST_RATE_LIMITEDbr br><RESULT_RIL_INVALID_SMS_FORMATbr br brRESULT_RIL_ENCODING_ERR><>RESULT_RIL_SYSTEM_ERR<>RESULT_RIL_INVALID_SMSC_ADDRESS<br><RESULT_RIL_MODEM_ERRbr br><RESULT_RIL_INTERNAL_ERRRESULT_RIL_NETWORK_ERR<>br>RESULT_RIL_REQUEST_NOT_SUPPORTED<<RESULT_RIL_INVALID_MODEM_STATE>brRESULT_RIL_NETWORK_NOT_READY<>brRESULT_RIL_OPERATION_NOT_ALLOWED<>br<RESULT_RIL_NO_RESOURCES>br><RESULT_RIL_CANCELLEDbr>RESULT_RIL_SIM_ABSENT<br br>RESULT_RIL_SIMULTANEOUS_SMS_AND_CALL_NOT_ALLOWED<br>RESULT_RIL_ACCESS_BARRED<br><RESULT_RIL_BLOCKED_DUE_TO_CALL> For RESULT_ERROR_GENERIC_FAILURE ou qualquer um dos erros de RESULT_RIL, o sentIntent pode incluir o "errorCode" extra que contém um valor específico da tecnologia de rádio, geralmente útil apenas para solução de problemas.<br>
- deliveryIntent
- PendingIntent
se não FOR NULL, isso PendingIntent será transmitido quando a mensagem for entregue ao destinatário. O pdu bruto do relatório de status está nos dados estendidos ("pdu").
- Atributos
Exceções
se destinationAddress ou text estiverem vazios
Comentários
Enviar um SMS baseado em texto.
<Observação forte>:/strong> Usar esse método requer que seu aplicativo tenha a android.Manifest.permission#SEND_SMS permissão<.
<observação forte>:/forte> Começando com o Android 4.4 (nível de API 19), se <eles>e somente se</em> um aplicativo não estiverem selecionados como o aplicativo SMS padrão, o sistema gravará automaticamente mensagens enviadas usando esse método para o Provedor de SMS (o aplicativo SMS padrão é sempre responsável por escrever suas mensagens enviadas para o< provedor de SMS). Para obter informações sobre como se comportar como o aplicativo SMS padrão, consulte android.provider.Telephony.
<Observação forte>:</strong> Se #getDefault() for usada para instanciar esse gerenciador em um dispositivo com vários SIM, essa operação poderá falhar ao enviar a mensagem SMS porque nenhuma assinatura padrão adequada pode ser encontrada. Nesse caso, se sentIntent não for nulo, ele PendingIntent será enviado com um código RESULT_ERROR_GENERIC_FAILURE de erro e uma cadeia de caracteres "noDefault" extra contendo o valor booliano true. Consulte #getDefault() mais informações sobre as condições em que essa operação pode falhar.
Partes desta página são modificações baseadas no trabalho criado e compartilhado pelo Project Open Source do Open Source e usadas de acordo com os termos descritos na Creative Commons 2.5.