Share via


TelephonyManager.ActionRespondViaMessage Field

Definition

The Phone app sends this intent when a user opts to respond-via-message during an incoming call.

[Android.Runtime.Register("ACTION_RESPOND_VIA_MESSAGE")]
public const string ActionRespondViaMessage;
[<Android.Runtime.Register("ACTION_RESPOND_VIA_MESSAGE")>]
val mutable ActionRespondViaMessage : string

Field Value

Attributes

Remarks

The Phone app sends this intent when a user opts to respond-via-message during an incoming call. By default, the device's default SMS app consumes this message and sends a text message to the caller. A third party app can also provide this functionality by consuming this Intent with a android.app.Service and sending the message using its own messaging system.

The intent contains a URI (available from android.content.Intent#getData) describing the recipient, using either the sms:, smsto:, mms:, or mmsto: URI schema. Each of these URI schema carry the recipient information the same way: the path part of the URI contains the recipient's phone number or a comma-separated set of phone numbers if there are multiple recipients. For example, smsto:2065551234.

The intent may also contain extras for the message text (in android.content.Intent#EXTRA_TEXT) and a message subject (in android.content.Intent#EXTRA_SUBJECT).

<p class="note"><strong>Note:</strong> The intent-filter that consumes this Intent needs to be in a android.app.Service that requires the permission android.Manifest.permission#SEND_RESPOND_VIA_MESSAGE.</p>

For example, the service that receives this intent can be declared in the manifest file with an intent filter like this:

&lt;!-- Service that delivers SMS messages received from the phone "quick response" -->
            &lt;service android:name=".HeadlessSmsSendService"
                     android:permission="android.permission.SEND_RESPOND_VIA_MESSAGE"
                     android:exported="true" >
              &lt;intent-filter>
                &lt;action android:name="android.intent.action.RESPOND_VIA_MESSAGE" />
                &lt;category android:name="android.intent.category.DEFAULT" />
                &lt;data android:scheme="sms" />
                &lt;data android:scheme="smsto" />
                &lt;data android:scheme="mms" />
                &lt;data android:scheme="mmsto" />
              &lt;/intent-filter>
            &lt;/service>

Output: nothing.

Java documentation for android.telephony.TelephonyManager.ACTION_RESPOND_VIA_MESSAGE.

Portions of this page are modifications based on work created and shared by the Android Open Source Project and used according to terms described in the Creative Commons 2.5 Attribution License.

Applies to