Android 12 Developer Preview is here! Try it out, and give us your feedback!

Person

public class Person
extends Object

java.lang.Object
   ↳ androidx.core.app.Person

Provides an immutable reference to an entity that appears repeatedly on different surfaces of the platform. For example, this could represent the sender of a message.

Summary

Nested classes

class Person.Builder

Builder for the immutable Person class. 

Public methods

static Person fromBundle(Bundle bundle)

Extracts and returns the Person written to the bundle.

IconCompat getIcon()

Returns the icon for this Person or null if no icon was provided.

String getKey()

Returns the key for this Person or null if no key was provided.

CharSequence getName()

Returns the name for this Person or null if no name was provided.

String getUri()

Returns the raw URI for this Person or null if no URI was provided.

boolean isBot()

Returns whether or not this Person is a machine rather than a human.

boolean isImportant()

Returns whether or not this Person is important to the user of this device with regards to how frequently they interact.

Person.Builder toBuilder()

Creates and returns a new Person.Builder initialized with this Person's data.

Bundle toBundle()

Writes and returns a new Bundle that represents this Person.

Inherited methods

Public methods

fromBundle

public static Person fromBundle (Bundle bundle)

Extracts and returns the Person written to the bundle. A bundle can be created from a Person using toBundle().

Parameters
bundle Bundle

Returns
Person

getIcon

public IconCompat getIcon ()

Returns the icon for this Person or null if no icon was provided.

Returns
IconCompat

getKey

public String getKey ()

Returns the key for this Person or null if no key was provided. This is provided as a unique identifier between other Persons.

Returns
String

getName

public CharSequence getName ()

Returns the name for this Person or null if no name was provided. This could be a full name, nickname, username, etc.

Returns
CharSequence

getUri

public String getUri ()

Returns the raw URI for this Person or null if no URI was provided. A URI can be any of the following:

*Note for these schemas, the path portion of the URI must exist in the contacts database in their appropriate column, otherwise the reference should be discarded.

Returns
String

isBot

public boolean isBot ()

Returns whether or not this Person is a machine rather than a human. Used primarily to identify automated tooling.

Returns
boolean

isImportant

public boolean isImportant ()

Returns whether or not this Person is important to the user of this device with regards to how frequently they interact.

Returns
boolean

toBuilder

public Person.Builder toBuilder ()

Creates and returns a new Person.Builder initialized with this Person's data.

Returns
Person.Builder

toBundle

public Bundle toBundle ()

Writes and returns a new Bundle that represents this Person. This bundle can be converted back by using fromBundle(Bundle).

Returns
Bundle