Added in API level 10000

PeopleContract.Intents

Kotlin |Java

public static final class PeopleContract.Intents
extends Object

java.lang.Object
↳	android.provider.PeopleContract.Intents

Standard intent actions, extras, and interaction constants used to bridge client applications with communication flows in People Directory applications.

For People Directory applications: To support initiating interactions from system UI, dialers, or contacts apps, directory applications must declare an Activity in their manifest with an intent filter matching ACTION_START_PEOPLE_INTERACTION. When launched, the Activity should read EXTRA_PEOPLE_INTERACTION_TYPE and EXTRA_PEOPLE_QUERY_ARGS to connect the user with the target person or group.

For client applications: Clients do not send these intents directly. Instead, clients call createPeopleInteractionRequest(ContentResolver,String,Bundle) to obtain a pre-configured, secure PendingIntent from the system that launches the target directory's interaction Activity.

Summary

Constants
`String`	`ACTION_START_PEOPLE_INTERACTION` Activity Action: Initiates an interactive communication session (such as text messaging, voice calling, or video calling) with a person or group within a People Directory application.
`String`	`EXTRA_PEOPLE_INTERACTION_TYPE` Intent extra key used with `ACTION_START_PEOPLE_INTERACTION` specifying the type of communication to start.
`String`	`EXTRA_PEOPLE_QUERY_ARGS` Intent extra key used with `ACTION_START_PEOPLE_INTERACTION` specifying the target person or group for the interaction.
`String`	`PEOPLE_INTERACTION_TYPE_MESSAGE` Interaction type indicating a request to initiate a text or chat messaging session.
`String`	`PEOPLE_INTERACTION_TYPE_VIDEO` Interaction type indicating a request to initiate a video calling session.
`String`	`PEOPLE_INTERACTION_TYPE_VOICE` Interaction type indicating a request to initiate an audio or voice calling session.

Inherited methods

From class


        
          java.lang.Object

`Object`	`clone()` Creates and returns a copy of this object.
`boolean`	`equals(Object obj)` Indicates whether some other object is "equal to" this one.
`void`	`finalize()` Called by the garbage collector on an object when garbage collection determines that there are no more references to the object.
`final Class<?>`	`getClass()` Returns the runtime class of this `Object`.
`int`	`hashCode()` Returns a hash code value for the object.
`final void`	`notify()` Wakes up a single thread that is waiting on this object's monitor.
`final void`	`notifyAll()` Wakes up all threads that are waiting on this object's monitor.
`String`	`toString()` Returns a string representation of the object.
`final void`	`wait(long timeoutMillis, int nanos)` Causes the current thread to wait until it is awakened, typically by being notified or interrupted, or until a certain amount of real time has elapsed.
`final void`	`wait(long timeoutMillis)` Causes the current thread to wait until it is awakened, typically by being notified or interrupted, or until a certain amount of real time has elapsed.
`final void`	`wait()` Causes the current thread to wait until it is awakened, typically by being notified or interrupted.

Constants

ACTION_START_PEOPLE_INTERACTION

Added in API level 10000

public static final String ACTION_START_PEOPLE_INTERACTION

Activity Action: Initiates an interactive communication session (such as text messaging, voice calling, or video calling) with a person or group within a People Directory application.

Input: EXTRA_PEOPLE_INTERACTION_TYPE specifies the requested interaction type (one of the PEOPLE_INTERACTION_TYPE_* constants). EXTRA_PEOPLE_QUERY_ARGS specifies a query arguments Bundle identifying the target person or group record.

For client applications: Obtain a PendingIntent for this action by calling PeopleContract.createPeopleInteractionRequest(ContentResolver,String,Bundle).

For People Directory applications: Declare an Activity handling this action to receive communication requests from clients and system components. This Activity must declare android:exported="true" in its manifest to be launchable by the system-minted PendingIntent.

Constant Value: "android.provider.action.START_PEOPLE_INTERACTION"

EXTRA_PEOPLE_INTERACTION_TYPE

Added in API level 10000

public static final String EXTRA_PEOPLE_INTERACTION_TYPE

Intent extra key used with ACTION_START_PEOPLE_INTERACTION specifying the type of communication to start.

Type: TEXT (must be one of PEOPLE_INTERACTION_TYPE_MESSAGE, PEOPLE_INTERACTION_TYPE_VOICE, or PEOPLE_INTERACTION_TYPE_VIDEO).

Constant Value: "android.provider.extra.PEOPLE_INTERACTION_TYPE"

EXTRA_PEOPLE_QUERY_ARGS

Added in API level 10000

public static final String EXTRA_PEOPLE_QUERY_ARGS

Intent extra key used with ACTION_START_PEOPLE_INTERACTION specifying the target person or group for the interaction.

To identify the target person or group record, retrieve the query arguments bundle using intent.getBundleExtra(Intents.EXTRA_PEOPLE_QUERY_ARGS), then extract the list of query bundles using queryArgs.getParcelableArrayList(QUERY_ARG_QUERIES, Bundle.class). Inspect each bundle for PeopleContract.QUERY_ARG_SELECTION_TYPE (e.g., Persons.Query.SELECTION_TYPE_LOOKUP_KEY) and its matching string array under PeopleContract.QUERY_ARG_SELECTION_VALUE.

This bundle must contain exactly one target sub-query generated using Persons.Query.Builder or Groups.Query.Builder.

Type: Bundle (constructed using Persons.Query.Builder or Groups.Query.Builder).

Constant Value: "android.provider.extra.PEOPLE_QUERY_ARGS"

PEOPLE_INTERACTION_TYPE_MESSAGE

Added in API level 10000

public static final String PEOPLE_INTERACTION_TYPE_MESSAGE

Interaction type indicating a request to initiate a text or chat messaging session.

Constant Value: "com.android.people.PEOPLE_INTERACTION_TYPE_MESSAGE"

PEOPLE_INTERACTION_TYPE_VIDEO

Added in API level 10000

public static final String PEOPLE_INTERACTION_TYPE_VIDEO

Interaction type indicating a request to initiate a video calling session.

Constant Value: "com.android.people.PEOPLE_INTERACTION_TYPE_VIDEO"

PEOPLE_INTERACTION_TYPE_VOICE

Added in API level 10000

public static final String PEOPLE_INTERACTION_TYPE_VOICE

Interaction type indicating a request to initiate an audio or voice calling session.

Constant Value: "com.android.people.PEOPLE_INTERACTION_TYPE_VOICE"