page.title=Common Intents
page.tags="IntentFilter"
@jd:body
<div id="qv-wrapper">
<div id="qv">
<h2>In this document
<a href="#" onclick="hideNestedItems('#tocIntents',this);return false;" class="header-toggle">
<span class="more">show more</span>
<span class="less" style="display:none">show less</span></a></h2>
<ol id="tocIntents" class="hide-nested">
<li><a href="#Clock">Alarm Clock</a>
<ol>
<li><a href="#CreateAlarm">Create an alarm</a></li>
<li><a href="#CreateTimer">Create a timer</a></li>
<li><a href="#ShowAlarms">Show all alarms</a></li>
</ol>
</li>
<li><a href="#Calendar">Calendar</a>
<ol>
<li><a href="#AddEvent">Add a calendar event</a></li>
</ol>
</li>
<li><a href="#Camera">Camera</a>
<ol>
<li><a href="#ImageCapture">Capture a picture or video and return it</a></li>
<li><a href="#CameraStill">Start a camera app in still image mode</a></li>
<li><a href="#CameraVideo">Start a camera app in video mode</a></li>
</ol>
</li>
<li><a href="#Contacts">Contacts/People App</a>
<ol>
<li><a href="#PickContact">Select a contact</a></li>
<li><a href="#PickContactDat">Select specific contact data</a></li>
<li><a href="#ViewContact">View a contact</a></li>
<li><a href="#EditContact">Edit an existing contact</a></li>
<li><a href="#InsertContact">Insert a contact</a></li>
</ol>
</li>
<li><a href="#Email">Email</a>
<ol>
<li><a href="#ComposeEmail">Compose an email with optional attachments</a></li>
</ol>
</li>
<li><a href="#Storage">File Storage</a>
<ol>
<li><a href="#GetFile">Retrieve a specific type of file</a></li>
<li><a href="#OpenFile">Open a specific type of file</a></li>
</ol>
</li>
<li><a href="#Local">Local Actions</a>
<ol>
<li><a href="#CallCar">Call a car</a></li>
</ol>
</li>
<li><a href="#Maps">Maps</a>
<ol>
<li><a href="#ViewMap">Show a location on a map</a></li>
</ol>
</li>
<li><a href="#Music">Music or Video</a>
<ol>
<li><a href="#PlayMedia">Play a media file</a></li>
<li><a href="#PlaySearch">Play music based on a search query</a></li>
</ol>
</li>
<li><a href="#NewNote">New Note</a>
<ol>
<li><a href="#CreateNote">Create a note</a></li>
</ol>
</li>
<li><a href="#Phone">Phone</a>
<ol>
<li><a href="#DialPhone">Initiate a phone call</a></li>
</ol>
</li>
</li>
<li><a href="#Search">Search</a>
<ol>
<li><a href="#SearchOnApp">Search in a specific app</a></li>
<li><a href="#SearchWeb">Perform a web search</a></li>
</ol>
</li>
<li><a href="#Settings">Settings</a>
<ol>
<li><a href="#OpenSettings">Open a specific section of Settings</a></li>
</ol>
</li>
<li><a href="#Messaging">Text Messaging</a>
<ol>
<li><a href="#SendMessage">Compose an SMS/MMS message with attachment</a></li>
</ol>
</li>
<li><a href="#Browser">Web Browser</a>
<ol>
<li><a href="#ViewUrl">Load a web URL</a></li>
</ol>
</li>
<li><a href="#AdbIntents">Verify Intents with the Android Debug Bridge</a></li>
<li><a href="#Now">Intents Fired by Google Now</a></li>
</ol>
<h2>See also</h2>
<ol>
<li><a href="{@docRoot}guide/components/intents-filters.html">Intents and Intent
Filters</a></li>
</ol>
</div>
</div>
<!-- Google Now box styles -->
<style type="text/css">
.now-box {
border-color: rgb(204,204,204);
border-style: solid;
border-width: 1px;
float: right;
margin: 0px 0px 20px 15px;
padding: 17px;
width: 200px;
}
.now-box li {
font-size: 13px;
font-style: italic;
margin-top: 0px;
}
.now-box ul {
margin-bottom: 0px;
}
.now-img {
width: 30px;
margin-bottom: 0px !important;
}
.now-img-cont {
float: left;
margin-right: 10px;
}
.now-title {
font-weight: bold;
margin-top: 7px;
}
.now-list {
font-size: 13px;
margin-bottom: 10px !important;
list-style-type: none;
}
.now-list li {
font-style: italic;
}
</style>
<p>An intent allows you to start an activity in another app by describing a simple
action you'd like to perform (such as "view a map" or "take a picture")
in an {@link android.content.Intent} object. This type of intent is
called an <em>implicit</em> intent because it does not specify the app component
to start, but instead specifies an <em>action</em> and provides some
<em>data</em> with which to perform the action.</p>
<p>When you call
{@link android.content.Context#startActivity startActivity()} or
{@link android.app.Activity#startActivityForResult startActivityForResult()} and pass it an
implicit intent, the system <a href="{@docRoot}guide/components/intents-filters.html#Resolution"
>resolves the intent</a> to an app that can handle the intent
and starts its corresponding {@link android.app.Activity}. If there's more than one app
that can handle the intent, the system presents the user with a dialog to pick which app
to use.</p>
<p>This page describes several implicit intents that you can use to perform common actions,
organized by the type of app that handles the intent. Each section also shows how you can
create an <a href="{@docRoot}guide/components/intents-filters.html#Receiving">intent filter</a> to
advertise your app's ability to perform the same action.</p>
<p class="caution"><strong>Caution:</strong> If there are no apps on the device that can receive
the implicit intent, your app will crash when it calls {@link android.content.Context#startActivity
startActivity()}. To first verify that an app exists to receive the intent, call {@link
android.content.Intent#resolveActivity resolveActivity()} on your {@link android.content.Intent}
object. If the result is non-null, there is at least one app that can handle the intent and
it's safe to call {@link android.content.Context#startActivity startActivity()}. If the result is
null, you should not use the intent and, if possible, you should disable the feature that invokes
the intent.</p>
<p>If you're not familiar with how to create intents or intent filters, you should first read
<a href="{@docRoot}guide/components/intents-filters.html">Intents and Intent Filters</a>.</p>
<p>To learn how to fire the intents listed on this page from your development host, see
<a href="#AdbIntents">Verify Intents with the Android Debug Bridge</a>.</p>
<h4>Google Now</h4>
<p><a href="http://www.google.com/landing/now/">Google Now</a> fires some of the intents listed
on this page in response to voice commands. For more information, see
<a href="#Now">Intents Fired by Google Now</a>.</p>
<h2 id="Clock">Alarm Clock</h2>
<h3 id="CreateAlarm">Create an alarm</h3>
<!-- Google Now box -->
<div class="now-box">
<div class="now-img-cont">
<a href="#Now">
<img src="{@docRoot}guide/components/images/voice-icon.png" class="now-img" width="30"
height="30" alt=""/>
</a>
</div>
<p class="now-title">Google Now</p>
<ul>
<li>"set an alarm for 7 am"</li>
</ul>
</div>
<p>To create a new alarm, use the {@link android.provider.AlarmClock#ACTION_SET_ALARM}
action and specify alarm details such as the time and message using extras defined below.</p>
<p class="note"><strong>Note:</strong> Only the hour, minutes, and message extras are available
in Android 2.3 (API level 9) and higher. The other extras were added in later versions of the
platform.</p>
<dl>
<dt><b>Action</b></dt>
<dd>{@link android.provider.AlarmClock#ACTION_SET_ALARM}</dd>
<dt><b>Data URI</b></dt>
<dd>None</dd>
<dt><b>MIME Type</b></dt>
<dd>None
</dd>
<dt><b>Extras</b></dt>
<dd>
<dl>
<dt>{@link android.provider.AlarmClock#EXTRA_HOUR}</dt>
<dd>The hour for the alarm.</dd>
<dt>{@link android.provider.AlarmClock#EXTRA_MINUTES}</dt>
<dd>The minutes for the alarm.</dd>
<dt>{@link android.provider.AlarmClock#EXTRA_MESSAGE}</dt>
<dd>A custom message to identify the alarm.</dd>
<dt>{@link android.provider.AlarmClock#EXTRA_DAYS}</dt>
<dd>An {@link java.util.ArrayList} including each week day on which this alarm should
be repeated. Each day must be declared with an integer from the {@link java.util.Calendar}
class such as {@link java.util.Calendar#MONDAY}.
<p>For a one-time alarm, do not specify this extra.</dd>
<dt>{@link android.provider.AlarmClock#EXTRA_RINGTONE}</dt>
<dd>A {@code content:} URI specifying a ringtone to use with the alarm, or {@link
android.provider.AlarmClock#VALUE_RINGTONE_SILENT} for no ringtone.
<p>To use the default ringtone, do not specify this extra.</dd>
<dt>{@link android.provider.AlarmClock#EXTRA_VIBRATE}</dt>
<dd>A boolean specifying whether to vibrate for this alarm.</dd>
<dt>{@link android.provider.AlarmClock#EXTRA_SKIP_UI}</dt>
<dd>A boolean specifying whether the responding app should skip its UI when setting the alarm.
If true, the app should bypass any confirmation UI and simply set the specified alarm.</dd>
</dl>
</dd>
</dl>
<p><b>Example intent:</b></p>
<pre>
public void createAlarm(String message, int hour, int minutes) {
Intent intent = new Intent(AlarmClock.ACTION_SET_ALARM)
.putExtra(AlarmClock.EXTRA_MESSAGE, message)
.putExtra(AlarmClock.EXTRA_HOUR, hour)
.putExtra(AlarmClock.EXTRA_MINUTES, minutes);
if (intent.resolveActivity(getPackageManager()) != null) {
startActivity(intent);
}
}
</pre>
<div class="note"><strong>Note:</strong>
<p>In order to invoke the {@link
android.provider.AlarmClock#ACTION_SET_ALARM} intent, your app must have the
{@link android.Manifest.permission#SET_ALARM} permission:</p>
<pre>
<uses-permission android:name="com.android.alarm.permission.SET_ALARM" />
</pre>
</div>
<p><b>Example intent filter:</b></p>
<pre>
<activity ...>
<intent-filter>
<action android:name="android.intent.action.SET_ALARM" />
<category android:name="android.intent.category.DEFAULT" />
</intent-filter>
</activity>
</pre>
<h3 id="CreateTimer">Create a timer</h3>
<!-- Google Now box -->
<div class="now-box">
<div class="now-img-cont">
<a href="#Now">
<img src="{@docRoot}guide/components/images/voice-icon.png" class="now-img"
width="30" height="30" alt=""/>
</a>
</div>
<p class="now-title">Google Now</p>
<ul>
<li>"set timer for 5 minutes"</li>
</ul>
</div>
<p>To create a countdown timer, use the {@link android.provider.AlarmClock#ACTION_SET_TIMER}
action and specify timer details such as the duration using extras defined below.</p>
<p class="note"><strong>Note:</strong> This intent was added
in Android 4.4 (API level 19).</p>
<dl>
<dt><b>Action</b></dt>
<dd>{@link android.provider.AlarmClock#ACTION_SET_TIMER}</dd>
<dt><b>Data URI</b></dt>
<dd>None</dd>
<dt><b>MIME Type</b></dt>
<dd>None
</dd>
<dt><b>Extras</b></dt>
<dd>
<dl>
<dt>{@link android.provider.AlarmClock#EXTRA_LENGTH}</dt>
<dd>The length of the timer in seconds.</dd>
<dt>{@link android.provider.AlarmClock#EXTRA_MESSAGE}</dt>
<dd>A custom message to identify the timer.</dd>
<dt>{@link android.provider.AlarmClock#EXTRA_SKIP_UI}</dt>
<dd>A boolean specifying whether the responding app should skip its UI when setting the timer.
If true, the app should bypass any confirmation UI and simply start the specified timer.</dd>
</dl>
</dd>
</dl>
<p><b>Example intent:</b></p>
<pre>
public void startTimer(String message, int seconds) {
Intent intent = new Intent(AlarmClock.ACTION_SET_TIMER)
.putExtra(AlarmClock.EXTRA_MESSAGE, message)
.putExtra(AlarmClock.EXTRA_LENGTH, seconds)
.putExtra(AlarmClock.EXTRA_SKIP_UI, true);
if (intent.resolveActivity(getPackageManager()) != null) {
startActivity(intent);
}
}
</pre>
<div class="note"><strong>Note:</strong>
<p>In order to invoke the {@link
android.provider.AlarmClock#ACTION_SET_TIMER} intent, your app must have the
{@link android.Manifest.permission#SET_ALARM} permission:</p>
<pre>
<uses-permission android:name="com.android.alarm.permission.SET_ALARM" />
</pre>
</div>
<p><b>Example intent filter:</b></p>
<pre>
<activity ...>
<intent-filter>
<action android:name="android.intent.action.SET_TIMER" />
<category android:name="android.intent.category.DEFAULT" />
</intent-filter>
</activity>
</pre>
<h3 id="ShowAlarms">Show all alarms</h3>
<p>To show the list of alarms, use the {@link android.provider.AlarmClock#ACTION_SHOW_ALARMS}
action.</p>
<p>Although not many apps will invoke this intent (it's primarily used by system apps),
any app that behaves as an alarm clock should implement
this intent filter and respond by showing the list of current alarms.</p>
<p class="note"><strong>Note:</strong> This intent was added
in Android 4.4 (API level 19).</p>
<dl>
<dt><b>Action</b></dt>
<dd>{@link android.provider.AlarmClock#ACTION_SHOW_ALARMS}</dd>
<dt><b>Data URI</b></dt>
<dd>None</dd>
<dt><b>MIME Type</b></dt>
<dd>None
</dd>
</dl>
<p><b>Example intent filter:</b></p>
<pre>
<activity ...>
<intent-filter>
<action android:name="android.intent.action.SHOW_ALARMS" />
<category android:name="android.intent.category.DEFAULT" />
</intent-filter>
</activity>
</pre>
<h2 id="Calendar">Calendar</h2>
<h3 id="AddEvent">Add a calendar event</h3>
<p>To add a new event to the user's calendar, use the {@link android.content.Intent#ACTION_INSERT}
action and specify the data URI with {@link android.provider.CalendarContract.Events#CONTENT_URI
Events.CONTENT_URI}. You can then specify various event details using extras defined below.</p>
<dl>
<dt><b>Action</b></dt>
<dd>{@link android.content.Intent#ACTION_INSERT}</dd>
<dt><b>Data URI</b></dt>
<dd>{@link android.provider.CalendarContract.Events#CONTENT_URI
Events.CONTENT_URI}</dd>
<dt><b>MIME Type</b></dt>
<dd>{@code "vnd.android.cursor.dir/event"}
</dd>
<dt><b>Extras</b></dt>
<dd>
<dl>
<dt>{@link android.provider.CalendarContract#EXTRA_EVENT_ALL_DAY}</dt>
<dd>A boolean specifying whether this is an all-day event.</dd>
<dt>{@link android.provider.CalendarContract#EXTRA_EVENT_BEGIN_TIME}</dt>
<dd>The start time of the event (milliseconds since epoch).</dd>
<dt>{@link android.provider.CalendarContract#EXTRA_EVENT_END_TIME}</dt>
<dd>The end time of the event (milliseconds since epoch).</dd>
<dt>{@link android.provider.CalendarContract.EventsColumns#TITLE}</dt>
<dd>The event title.</dd>
<dt>{@link android.provider.CalendarContract.EventsColumns#DESCRIPTION}</dt>
<dd>The event description.</dd>
<dt>{@link android.provider.CalendarContract.EventsColumns#EVENT_LOCATION}</dt>
<dd>The event location.</dd>
<dt>{@link android.content.Intent#EXTRA_EMAIL}</dt>
<dd>A comma-separated list of email addresses that specify the invitees.</dd>
</dl>
<p>Many more event details can be specified using the constants defined in the
{@link android.provider.CalendarContract.EventsColumns} class.</p>
</dd>
</dl>
<p><b>Example intent:</b></p>
<pre>
public void addEvent(String title, String location, Calendar begin, Calendar end) {
Intent intent = new Intent(Intent.ACTION_INSERT)
.setData(Events.CONTENT_URI)
.putExtra(Events.TITLE, title)
.putExtra(Events.EVENT_LOCATION, location)
.putExtra(CalendarContract.EXTRA_EVENT_BEGIN_TIME, begin)
.putExtra(CalendarContract.EXTRA_EVENT_END_TIME, end);
if (intent.resolveActivity(getPackageManager()) != null) {
startActivity(intent);
}
}
</pre>
<p><b>Example intent filter:</b></p>
<pre>
<activity ...>
<intent-filter>
<action android:name="android.intent.action.INSERT" />
<data android:mimeType="vnd.android.cursor.dir/event" />
<category android:name="android.intent.category.DEFAULT" />
</intent-filter>
</activity>
</pre>
<h2 id="Camera">Camera</h2>
<h3 id="ImageCapture">Capture a picture or video and return it</h3>
<p>To open a camera app and receive the resulting photo or video, use the {@link
android.provider.MediaStore#ACTION_IMAGE_CAPTURE} or {@link
android.provider.MediaStore#ACTION_VIDEO_CAPTURE} action. Also specify the URI location where you'd
like the camera to save the photo or video, in the {@link android.provider.MediaStore#EXTRA_OUTPUT}
extra.</p>
<dl>
<dt><b>Action</b></dt>
<dd>{@link android.provider.MediaStore#ACTION_IMAGE_CAPTURE} or<br>
{@link android.provider.MediaStore#ACTION_VIDEO_CAPTURE}</dd>
<dt><b>Data URI Scheme</b></dt>
<dd>None</dd>
<dt><b>MIME Type</b></dt>
<dd>None</dd>
<dt><b>Extras</b></dt>
<dd>
<dl>
<dt>{@link android.provider.MediaStore#EXTRA_OUTPUT}</dt>
<dd>The URI location where the camera app should save the photo or
video file (as a {@link android.net.Uri} object).</dd>
</dl>
</dd>
</dl>
<p>When the camera app successfully returns
focus to your activity (your app receives the {@link android.app.Activity#onActivityResult
onActivityResult()} callback), you can access the photo or video at the URI you specified
with the {@link android.provider.MediaStore#EXTRA_OUTPUT} value.</p>
<p class="note"><strong>Note:</strong> When you use {@link
android.provider.MediaStore#ACTION_IMAGE_CAPTURE} to capture a photo, the camera may also return a
downscaled copy (a thumbnail) of the photo in the result {@link
android.content.Intent}, saved as a {@link android.graphics.Bitmap} in an extra field named
<code>"data"</code>.</p>
<p><b>Example intent:</b></p>
<pre>
static final int REQUEST_IMAGE_CAPTURE = 1;
static final Uri mLocationForPhotos;
public void capturePhoto(String targetFilename) {
Intent intent = new Intent(MediaStore.ACTION_IMAGE_CAPTURE);
intent.putExtra(MediaStore.EXTRA_OUTPUT,
Uri.withAppendedPath(mLocationForPhotos, targetFilename));
if (intent.resolveActivity(getPackageManager()) != null) {
startActivityForResult(intent, REQUEST_IMAGE_CAPTURE);
}
}
@Override
protected void onActivityResult(int requestCode, int resultCode, Intent data) {
if (requestCode == REQUEST_IMAGE_CAPTURE && resultCode == RESULT_OK) {
Bitmap thumbnail = data.getParcelable("data");
// Do other work with full size photo saved in mLocationForPhotos
...
}
}
</pre>
<p>For more information about how to use this intent to capture a photo, including
how to create an appropriate {@link android.net.Uri} for the output location, read
<a href="{@docRoot}training/camera/photobasics.html">Taking Photos Simply</a> or
<a href="{@docRoot}training/camera/videobasics.html">Taking Videos Simply</a>.</p>
<p><b>Example intent filter:</b></p>
<pre>
<activity ...>
<intent-filter>
<action android:name="android.media.action.IMAGE_CAPTURE" />
<category android:name="android.intent.category.DEFAULT" />
</intent-filter>
</activity>
</pre>
<p>When handling this intent, your activity should check for the {@link
android.provider.MediaStore#EXTRA_OUTPUT} extra in the incoming {@link android.content.Intent},
then save the captured image or video at the location specified by that extra and call {@link
android.app.Activity#setResult(int,Intent) setResult()} with an
{@link android.content.Intent} that includes a compressed thumbnail
in an extra named <code>"data"</code>.</p>
<h3 id="CameraStill">Start a camera app in still image mode</h3>
<!-- Google Now box -->
<div class="now-box">
<div class="now-img-cont">
<a href="#Now">
<img src="{@docRoot}guide/components/images/voice-icon.png" class="now-img"
width="30" height="30" alt=""/>
</a>
</div>
<p class="now-title">Google Now</p>
<ul>
<li>"take a picture"</li>
</ul>
</div>
<p>To open a camera app in still image mode, use the {@link
android.provider.MediaStore#INTENT_ACTION_STILL_IMAGE_CAMERA} action.</p>
<dl>
<dt><b>Action</b></dt>
<dd>{@link android.provider.MediaStore#INTENT_ACTION_STILL_IMAGE_CAMERA}</dd>
<dt><b>Data URI Scheme</b></dt>
<dd>None</dd>
<dt><b>MIME Type</b></dt>
<dd>None</dd>
<dt><b>Extras</b></dt>
<dd>None</dd>
</dl>
<p><b>Example intent:</b></p>
<pre>
public void capturePhoto() {
Intent intent = new Intent(MediaStore.INTENT_ACTION_STILL_IMAGE_CAMERA);
if (intent.resolveActivity(getPackageManager()) != null) {
startActivityForResult(intent);
}
}
</pre>
<p><b>Example intent filter:</b></p>
<pre>
<activity ...>
<intent-filter>
<action android:name="android.media.action.STILL_IMAGE_CAMERA" />
<category android:name="android.intent.category.DEFAULT" />
</intent-filter>
</activity>
</pre>
<h3 id="CameraVideo">Start a camera app in video mode</h3>
<!-- Google Now box -->
<div class="now-box">
<div class="now-img-cont">
<a href="#Now">
<img src="{@docRoot}guide/components/images/voice-icon.png" class="now-img"
width="30" height="30" alt=""/>
</a>
</div>
<p class="now-title">Google Now</p>
<ul>
<li>"record a video"</li>
</ul>
</div>
<p>To open a camera app in video mode, use the {@link
android.provider.MediaStore#INTENT_ACTION_VIDEO_CAMERA} action.</p>
<dl>
<dt><b>Action</b></dt>
<dd>{@link android.provider.MediaStore#INTENT_ACTION_VIDEO_CAMERA}</dd>
<dt><b>Data URI Scheme</b></dt>
<dd>None</dd>
<dt><b>MIME Type</b></dt>
<dd>None</dd>
<dt><b>Extras</b></dt>
<dd>None</dd>
</dl>
<p><b>Example intent:</b></p>
<pre>
public void capturePhoto() {
Intent intent = new Intent(MediaStore.INTENT_ACTION_VIDEO_CAMERA);
if (intent.resolveActivity(getPackageManager()) != null) {
startActivityForResult(intent);
}
}
</pre>
<p><b>Example intent filter:</b></p>
<pre>
<activity ...>
<intent-filter>
<action android:name="android.media.action.VIDEO_CAMERA" />
<category android:name="android.intent.category.DEFAULT" />
</intent-filter>
</activity>
</pre>
<h2 id="Contacts">Contacts/People App</h2>
<h3 id="PickContact">Select a contact</h3>
<p>To have the user select a contact and provide your app access to all the contact information,
use the {@link android.content.Intent#ACTION_PICK} action and specify the MIME type to
{@link android.provider.ContactsContract.Contacts#CONTENT_TYPE
Contacts.CONTENT_TYPE}.</p>
<p>The result {@link android.content.Intent} delivered to your {@link
android.app.Activity#onActivityResult onActivityResult()} callback contains the
<code>content:</code> URI pointing to the selected contact. The response grants
your app temporary permissions to read that contact using the <a
href="{@docRoot}guide/topics/providers/contacts-provider.html">Contacts Provider</a> API even if
your app does not include the {@link android.Manifest.permission#READ_CONTACTS} permission.</p>
<p class="note"><strong>Tip:</strong> If you need access to only a specific piece of contact
information, such as a phone number or email address, instead see the next section about how to
<a href="#PickContactData">select specific contact data</a>.</p>
<dl>
<dt><b>Action</b></dt>
<dd>{@link android.content.Intent#ACTION_PICK}</dd>
<dt><b>Data URI Scheme</b></dt>
<dd>None</dd>
<dt><b>MIME Type</b></dt>
<dd>{@link android.provider.ContactsContract.Contacts#CONTENT_TYPE
Contacts.CONTENT_TYPE}
</dd>
</dl>
<p><b>Example intent:</b></p>
<pre>
static final int REQUEST_SELECT_CONTACT = 1;
public void selectContact() {
Intent intent = new Intent(Intent.ACTION_PICK);
intent.setType(ContactsContract.Contacts.CONTENT_TYPE);
if (intent.resolveActivity(getPackageManager()) != null) {
startActivityForResult(intent, REQUEST_SELECT_CONTACT);
}
}
@Override
protected void onActivityResult(int requestCode, int resultCode, Intent data) {
if (requestCode == REQUEST_SELECT_CONTACT && resultCode == RESULT_OK) {
Uri contactUri = data.getData();
// Do something with the selected contact at contactUri
...
}
}
</pre>
<p>For information about how to retrieve contact details once you have the contact URI,
read <a href="{@docRoot}training/contacts-provider/retrieve-details.html">Retrieving Details
for a Contact</a>. Remember, when you retrieve the contact URI with the above intent, you
<strong>do not</strong> need the {@link android.Manifest.permission#READ_CONTACTS} permission
to read details for that contact.</p>
<h3 id="PickContactDat">Select specific contact data</h3>
<p>To have the user select a specific piece of information from a contact, such as
a phone number, email address, or other data type, use the
{@link android.content.Intent#ACTION_PICK} action and specify the MIME type to one
of the content types listed below, such as
{@link android.provider.ContactsContract.CommonDataKinds.Phone#CONTENT_TYPE
CommonDataKinds.Phone.CONTENT_TYPE} to get the contact's phone number.</p>
<p>If you need to retrieve only one type of data from a contact, this technique with a
{@code CONTENT_TYPE} from the
{@link android.provider.ContactsContract.CommonDataKinds} classes is more efficient than
using the {@link android.provider.ContactsContract.Contacts#CONTENT_TYPE
Contacts.CONTENT_TYPE} (as shown in the previous section) because the result provides you direct
access to the desired data without requiring you to perform a more complex query to <a
href="{@docRoot}guide/topics/providers/contacts-provider.html">Contacts Provider</a>.</p>
<p>The result {@link android.content.Intent} delivered to your {@link
android.app.Activity#onActivityResult onActivityResult()} callback contains the
<code>content:</code> URI pointing to the selected contact data. The response grants
your app temporary permissions to read that contact data even if your app does
not include the {@link android.Manifest.permission#READ_CONTACTS} permission.</p>
<dl>
<dt><b>Action</b></dt>
<dd>{@link android.content.Intent#ACTION_PICK}</dd>
<dt><b>Data URI Scheme</b></dt>
<dd>None</dd>
<dt><b>MIME Type</b></dt>
<dd>
<dl>
<dt>{@link android.provider.ContactsContract.CommonDataKinds.Phone#CONTENT_TYPE
CommonDataKinds.Phone.CONTENT_TYPE}</dt>
<dd>Pick from contacts with a phone number.</dd>
<dt>{@link android.provider.ContactsContract.CommonDataKinds.Email#CONTENT_TYPE
CommonDataKinds.Email.CONTENT_TYPE}</dt>
<dd>Pick from contacts with an email address.</dd>
<dt>{@link android.provider.ContactsContract.CommonDataKinds.StructuredPostal#CONTENT_TYPE
CommonDataKinds.StructuredPostal.CONTENT_TYPE}</dt>
<dd>Pick from contacts with a postal address.</dd>
</dl>
<p>Or one of many other {@code CONTENT_TYPE} values
under {@link android.provider.ContactsContract}.</p>
</dd>
</dl>
<p><b>Example intent:</b></p>
<pre>
static final int REQUEST_SELECT_PHONE_NUMBER = 1;
public void selectContact() {
// Start an activity for the user to pick a phone number from contacts
Intent intent = new Intent(Intent.ACTION_PICK);
intent.setType(CommonDataKinds.Phone.CONTENT_TYPE);
if (intent.resolveActivity(getPackageManager()) != null) {
startActivityForResult(intent, REQUEST_SELECT_PHONE_NUMBER);
}
}
@Override
protected void onActivityResult(int requestCode, int resultCode, Intent data) {
if (requestCode == REQUEST_SELECT_PHONE_NUMBER && resultCode == RESULT_OK) {
// Get the URI and query the content provider for the phone number
Uri contactUri = data.getData();
String[] projection = new String[]{CommonDataKinds.Phone.NUMBER};
Cursor cursor = getContentResolver().query(contactUri, projection,
null, null, null);
// If the cursor returned is valid, get the phone number
if (cursor != null && cursor.moveToFirst()) {
int numberIndex = cursor.getColumnIndex(CommonDataKinds.Phone.NUMBER);
String number = cursor.getString(numberIndex);
// Do something with the phone number
...
}
}
}
</pre>
<h3 id="ViewContact">View a contact</h3>
<p>To display the details for a known contact, use the {@link android.content.Intent#ACTION_VIEW}
action and specify the contact with a {@code content:} URI as the intent data.</p>
<p>There are primarily two ways to initially retrieve the contact's URI:</p>
<ul>
<li>Use the contact URI returned by the {@link android.content.Intent#ACTION_PICK},
shown in the previous section (this approach does not require any app permissions).</li>
<li>Access the list of all contacts directly, as described in <a
href="{@docRoot}training/contacts-provider/retrieve-names.html">Retrieving a List of
Contacts</a> (this approach requires the {@link android.Manifest.permission#READ_CONTACTS}
permission).</li>
</ul>
<dl>
<dt><b>Action</b></dt>
<dd>{@link android.content.Intent#ACTION_VIEW}</dd>
<dt><b>Data URI Scheme</b></dt>
<dd>{@code content:<URI>}</dd>
<dt><b>MIME Type</b></dt>
<dd>None. The type is inferred from contact URI.
</dd>
</dl>
<p><b>Example intent:</b></p>
<pre>
public void viewContact(Uri contactUri) {
Intent intent = new Intent(Intent.ACTION_VIEW, contactUri);
if (intent.resolveActivity(getPackageManager()) != null) {
startActivity(intent);
}
}
</pre>
<h3 id="EditContact">Edit an existing contact</h3>
<p>To edit a known contact, use the {@link android.content.Intent#ACTION_EDIT}
action, specify the contact with a {@code content:} URI
as the intent data, and include any known contact information in extras specified by
constants in {@link android.provider.ContactsContract.Intents.Insert}.</p>
<p>There are primarily two ways to initially retrieve the contact URI:</p>
<ul>
<li>Use the contact URI returned by the {@link android.content.Intent#ACTION_PICK},
shown in the previous section (this approach does not require any app permissions).</li>
<li>Access the list of all contacts directly, as described in <a
href="{@docRoot}training/contacts-provider/retrieve-names.html">Retrieving a List of
Contacts</a> (this approach requires the {@link android.Manifest.permission#READ_CONTACTS}
permission).</li>
</ul>
<dl>
<dt><b>Action</b></dt>
<dd>{@link android.content.Intent#ACTION_EDIT}</dd>
<dt><b>Data URI Scheme</b></dt>
<dd>{@code content:<URI>}</dd>
<dt><b>MIME Type</b></dt>
<dd>The type is inferred from contact URI.
</dd>
<dt><b>Extras</b></dt>
<dd>One or more of the extras defined in {@link android.provider.ContactsContract.Intents.Insert}
so you can populate fields of the contact details.
</dd>
</dl>
<p><b>Example intent:</b></p>
<pre>
public void editContact(Uri contactUri, String email) {
Intent intent = new Intent(Intent.ACTION_EDIT);
intent.setData(contactUri);
intent.putExtra(Intents.Insert.EMAIL, email);
if (intent.resolveActivity(getPackageManager()) != null) {
startActivity(intent);
}
}
</pre>
<p>For more information about how to edit a contact, read <a
href="{@docRoot}training/contacts-provider/modify-data.html">Modifying
Contacts Using Intents</a>.</p>
<h3 id="InsertContact">Insert a contact</h3>
<p>To insert a new contact, use the {@link android.content.Intent#ACTION_INSERT} action,
specify {@link android.provider.ContactsContract.Contacts#CONTENT_TYPE Contacts.CONTENT_TYPE} as
the MIME type, and include any known contact information in extras specified by
constants in {@link android.provider.ContactsContract.Intents.Insert}.
<dl>
<dt><b>Action</b></dt>
<dd>{@link android.content.Intent#ACTION_INSERT}</dd>
<dt><b>Data URI Scheme</b></dt>
<dd>None</dd>
<dt><b>MIME Type</b></dt>
<dd>{@link android.provider.ContactsContract.Contacts#CONTENT_TYPE Contacts.CONTENT_TYPE}</dd>
<dt><b>Extras</b></dt>
<dd>One or more of the extras defined in {@link android.provider.ContactsContract.Intents.Insert}.
</dd>
</dl>
<p><b>Example intent:</b></p>
<pre>
public void insertContact(String name, String email) {
Intent intent = new Intent(Intent.ACTION_INSERT);
intent.setType(Contacts.CONTENT_TYPE);
intent.putExtra(Intents.Insert.NAME, name);
intent.putExtra(Intents.Insert.EMAIL, email);
if (intent.resolveActivity(getPackageManager()) != null) {
startActivity(intent);
}
}
</pre>
<p>For more information about how to insert a contact, read <a
href="{@docRoot}training/contacts-provider/modify-data.html">Modifying
Contacts Using Intents</a>.</p>
<h2 id="Email">Email</h2>
<h3 id="ComposeEmail">Compose an email with optional attachments</h3>
<p>To compose an email, use one of the below actions based on whether you'll include attachments,
and include email details such as the recipient and subject using the extra keys listed below.</p>
<dl>
<dt><b>Action</b></dt>
<dd>{@link android.content.Intent#ACTION_SENDTO} (for no attachment) or<br>
{@link android.content.Intent#ACTION_SEND} (for one attachment) or<br>
{@link android.content.Intent#ACTION_SEND_MULTIPLE} (for multiple attachments)</dd>
<dt><b>Data URI Scheme</b></dt>
<dd>None</dd>
<dt><b>MIME Type</b></dt>
<dd>
<dl>
<dt><code>"text/plain"</code>
<dt><code>"*/*"</code>
</dl>
</dd>
<dt><b>Extras</b></dt>
<dd>
<dl>
<dt>{@link android.content.Intent#EXTRA_EMAIL Intent.EXTRA_EMAIL}</dt>
<dd>A string array of all "To" recipient email addresses.</dd>
<dt>{@link android.content.Intent#EXTRA_CC Intent.EXTRA_CC}</dt>
<dd>A string array of all "CC" recipient email addresses.</dd>
<dt>{@link android.content.Intent#EXTRA_BCC Intent.EXTRA_BCC}</dt>
<dd>A string array of all "BCC" recipient email addresses.</dd>
<dt>{@link android.content.Intent#EXTRA_SUBJECT Intent.EXTRA_SUBJECT}</dt>
<dd>A string with the email subject.</dd>
<dt>{@link android.content.Intent#EXTRA_TEXT Intent.EXTRA_TEXT}</dt>
<dd>A string with the body of the email.</dd>
<dt>{@link android.content.Intent#EXTRA_STREAM Intent.EXTRA_STREAM}</dt>
<dd>A {@link android.net.Uri} pointing to the attachment. If using the
{@link android.content.Intent#ACTION_SEND_MULTIPLE} action, this should instead
be an {@link java.util.ArrayList} containing multiple {@link android.net.Uri} objects.</dd>
</dl>
</dd>
</dl>
<p><b>Example intent:</b></p>
<pre>
public void composeEmail(String[] addresses, String subject, Uri attachment) {
Intent intent = new Intent(Intent.ACTION_SEND);
intent.setType("*/*");
intent.putExtra(Intent.EXTRA_EMAIL, addresses);
intent.putExtra(Intent.EXTRA_SUBJECT, subject);
intent.putExtra(Intent.EXTRA_STREAM, attachment);
if (intent.resolveActivity(getPackageManager()) != null) {
startActivity(intent);
}
}
</pre>
<p>If you want to ensure that your intent is handled only by an email app (and not other
text messaging or social apps), then use the {@link android.content.Intent#ACTION_SENDTO} action
and include the {@code "mailto:"} data scheme. For example:</p>
<pre>
public void composeEmail(String[] addresses, String subject) {
Intent intent = new Intent(Intent.ACTION_SENDTO);
intent.setData(Uri.parse("mailto:")); // only email apps should handle this
intent.putExtra(Intent.EXTRA_EMAIL, addresses);
intent.putExtra(Intent.EXTRA_SUBJECT, subject);
if (intent.resolveActivity(getPackageManager()) != null) {
startActivity(intent);
}
}
</pre>
<p><b>Example intent filter:</b></p>
<pre>
<activity ...>
<intent-filter>
<action android:name="android.intent.action.SEND" />
<data android:type="*/*" />
<category android:name="android.intent.category.DEFAULT" />
</intent-filter>
<intent-filter>
<action android:name="android.intent.action.SENDTO" />
<data android:scheme="mailto" />
<category android:name="android.intent.category.DEFAULT" />
</intent-filter>
</activity>
</pre>
<h2 id="Storage">File Storage</h2>
<h3 id="GetFile">Retrieve a specific type of file</h3>
<p>To request that the user select a file such as a document or photo and return a reference to
your app, use the {@link android.content.Intent#ACTION_GET_CONTENT} action and specify your desired
MIME type. The file reference returned to your app is transient to your activity's current
lifecycle, so if you want to access it later you must import a copy that you can read later.
This intent also allows the user to create a new file in the process (for
example, instead of selecting an existing photo, the user can capture a new photo with the camera).
</p>
<p>The result intent delivered to your {@link android.app.Activity#onActivityResult
onActivityResult()} method includes data with a URI pointing to the file.
The URI could be anything, such as an {@code http:} URI, {@code file:} URI, or {@code content:}
URI. However, if you'd like to restrict selectable files to only those that are accessible
from a content provider (a {@code content:} URI) and that are available as a file stream with {@link
android.content.ContentResolver#openFileDescriptor openFileDescriptor()}, you should add
the {@link android.content.Intent#CATEGORY_OPENABLE} category to your intent.</p>
<p>On Android 4.3 (API level 18) and higher,
you can also allow the user to select multiple files by adding
{@link android.content.Intent#EXTRA_ALLOW_MULTIPLE} to the intent, set to {@code true}.
You can then access each of the selected files in a {@link android.content.ClipData}
object returned by {@link android.content.Intent#getClipData()}.</p>
<dl>
<dt><b>Action</b></dt>
<dd>{@link android.content.Intent#ACTION_GET_CONTENT}</dd>
<dt><b>Data URI Scheme</b></dt>
<dd>None</dd>
<dt><b>MIME Type</b></dt>
<dd>The MIME type corresponding to the file type the user should select.
</dd>
<dt><b>Extras</b></dt>
<dd>
<dl>
<dt>{@link android.content.Intent#EXTRA_ALLOW_MULTIPLE}
<dd>A boolean declaring whether the user can select more than one file at a time.
</dd>
<dt>{@link android.content.Intent#EXTRA_LOCAL_ONLY}
<dd>A boolean that declares whether the returned file must be available directly from
the device, rather than requiring a download from a remote service.
</dd>
</dl>
</dd>
<dt><b>Category</b> (optional)</dt>
<dd>
<dl>
<dt>{@link android.content.Intent#CATEGORY_OPENABLE}</dt>
<dd>To return only "openable" files that can be represented as a file stream
with {@link android.content.ContentResolver#openFileDescriptor openFileDescriptor()}.</dd>
</dl>
</dd>
</dl>
<p><b>Example intent to get a photo:</b></p>
<pre>
static final int REQUEST_IMAGE_GET = 1;
public void selectImage() {
Intent intent = new Intent(Intent.ACTION_GET_CONTENT);
intent.setType("image/*");
if (intent.resolveActivity(getPackageManager()) != null) {
startActivityForResult(intent, REQUEST_IMAGE_GET);
}
}
@Override
protected void onActivityResult(int requestCode, int resultCode, Intent data) {
if (requestCode == REQUEST_IMAGE_GET && resultCode == RESULT_OK) {
Bitmap thumbnail = data.getParcelable("data");
Uri fullPhotoUri = data.getData();
// Do work with photo saved at fullPhotoUri
...
}
}
</pre>
<p><b>Example intent filter to return a photo:</b></p>
<pre>
<activity ...>
<intent-filter>
<action android:name="android.intent.action.GET_CONTENT" />
<data android:type="image/*" />
<category android:name="android.intent.category.DEFAULT" />
<!-- The OPENABLE category declares that the returned file is accessible
from a content provider that supports {@link android.provider.OpenableColumns}
and {@link android.content.ContentResolver#openFileDescriptor ContentResolver.openFileDescriptor()} -->
<category android:name="android.intent.category.OPENABLE" />
</intent-filter>
</activity>
</pre>
<h3 id="OpenFile">Open a specific type of file</h3>
<p>Instead of retrieving a copy of a file that you must import to your app
(by using the {@link android.content.Intent#ACTION_GET_CONTENT} action), when running on Android
4.4 or higher, you can instead request to <em>open</em> a file that's managed by another app by
using the {@link android.content.Intent#ACTION_OPEN_DOCUMENT} action and specifying a MIME type.
To also allow the user to instead create a new document that your app can write to, use the {@link
android.content.Intent#ACTION_CREATE_DOCUMENT} action instead. For example, instead of
selecting from existing PDF documents, the {@link android.content.Intent#ACTION_CREATE_DOCUMENT}
intent allows users to select where they'd like to create a new document (within another app
that manages the document's storage)—your app then receives the URI location of where it
can write the new document.</p>
<p>Whereas the intent delivered to your {@link android.app.Activity#onActivityResult
onActivityResult()} method from the {@link android.content.Intent#ACTION_GET_CONTENT} action may
return a URI of any type, the result intent from {@link android.content.Intent#ACTION_OPEN_DOCUMENT}
and {@link android.content.Intent#ACTION_CREATE_DOCUMENT} always specify the chosen file as a {@code
content:} URI that's backed by a {@link android.provider.DocumentsProvider}. You can open the
file with {@link android.content.ContentResolver#openFileDescriptor openFileDescriptor()} and
query its details using columns from {@link android.provider.DocumentsContract.Document}.</p>
<p>The returned URI grants your app long-term read access to the file (also possibly
with write access). So the {@link android.content.Intent#ACTION_OPEN_DOCUMENT} action is
particularly useful (instead of using {@link android.content.Intent#ACTION_GET_CONTENT})
when you want to read an existing file without making a copy into your app,
or when you want to open and edit a file in place.</p>
<p>You can also allow the user to select multiple files by adding
{@link android.content.Intent#EXTRA_ALLOW_MULTIPLE} to the intent, set to {@code true}.
If the user selects just one item, then you can retrieve the item from {@link
android.content.Intent#getData()}. If the user selects more than one item, then {@link
android.content.Intent#getData()} returns null and you must instead
retrieve each item from a {@link android.content.ClipData}
object that is returned by {@link android.content.Intent#getClipData()}.</p>
<p class="note"><strong>Note:</strong> Your intent <strong>must</strong> specify a MIME type and
<strong>must</strong> declare the {@link android.content.Intent#CATEGORY_OPENABLE} category. If
appropriate, you can specify more than one MIME type by adding an array of MIME types with the
{@link android.content.Intent#EXTRA_MIME_TYPES} extra—if you do so, you must set the
primary MIME type in {@link android.content.Intent#setType setType()} to {@code "*/*"}.</p>
<dl>
<dt><b>Action</b></dt>
<dd>{@link android.content.Intent#ACTION_OPEN_DOCUMENT} or<br/>
{@link android.content.Intent#ACTION_CREATE_DOCUMENT}</dd>
<dt><b>Data URI Scheme</b></dt>
<dd>None</dd>
<dt><b>MIME Type</b></dt>
<dd>The MIME type corresponding to the file type the user should select.
</dd>
<dt><b>Extras</b></dt>
<dd>
<dl>
<dt>{@link android.content.Intent#EXTRA_MIME_TYPES}
<dd>An array of MIME types corresponding to the types of files your app is
requesting. When you use this extra, you must set the primary MIME type in
{@link android.content.Intent#setType setType()} to {@code "*/*"}.</dd>
<dt>{@link android.content.Intent#EXTRA_ALLOW_MULTIPLE}
<dd>A boolean that declares whether the user can select more than one file at a time.
</dd>
<dt>{@link android.content.Intent#EXTRA_TITLE}
<dd>For use with {@link android.content.Intent#ACTION_CREATE_DOCUMENT} to specify
an initial file name.
</dd>
<dt>{@link android.content.Intent#EXTRA_LOCAL_ONLY}
<dd>A boolean that declares whether the returned file must be available directly from
the device, rather than requiring a download from a remote service.
</dd>
</dl>
</dd>
<dt><b>Category</b></dt>
<dd>
<dl>
<dt>{@link android.content.Intent#CATEGORY_OPENABLE}</dt>
<dd>To return only "openable" files that can be represented as a file stream
with {@link android.content.ContentResolver#openFileDescriptor openFileDescriptor()}.</dd>
</dl>
</dd>
</dl>
<p><b>Example intent to get a photo:</b></p>
<pre>
static final int REQUEST_IMAGE_OPEN = 1;
public void selectImage() {
Intent intent = new Intent(Intent.ACTION_OPEN_DOCUMENT);
intent.setType("image/*");
intent.addCategory(Intent.CATEGORY_OPENABLE);
// Only the system receives the ACTION_OPEN_DOCUMENT, so no need to test.
startActivityForResult(intent, REQUEST_IMAGE_OPEN);
}
@Override
protected void onActivityResult(int requestCode, int resultCode, Intent data) {
if (requestCode == REQUEST_IMAGE_OPEN && resultCode == RESULT_OK) {
Uri fullPhotoUri = data.getData();
// Do work with full size photo saved at fullPhotoUri
...
}
}
</pre>
<p>Third party apps cannot actually respond to an intent with the
{@link android.content.Intent#ACTION_OPEN_DOCUMENT} action. Instead, the system receives this
intent and displays all the files available from various apps in a unified user interface.</p>
<p>To provide your app's files in this UI and allow other apps to open them, you must implement
a {@link android.provider.DocumentsProvider} and include an intent filter for
{@link android.provider.DocumentsContract#PROVIDER_INTERFACE}
({@code "android.content.action.DOCUMENTS_PROVIDER"}). For example:
<pre>
<provider ...
android:grantUriPermissions="true"
android:exported="true"
android:permission="android.permission.MANAGE_DOCUMENTS">
<intent-filter>
<action android:name="android.content.action.DOCUMENTS_PROVIDER" />
</intent-filter>
</provider>
</pre>
<p>For more information about how to make the files managed by your app openable from other apps,
read the <a href="{@docRoot}guide/topics/providers/document-provider.html">Storage Access
Framework</a> guide.</p>
<h2 id="Local">Local Actions</h2>
<h3 id="CallCar">Call a car</h3>
<!-- Google Now box -->
<div class="now-box">
<div class="now-img-cont">
<a href="#Now">
<img src="{@docRoot}guide/components/images/voice-icon.png" class="now-img"
width="30" height="30" alt=""/>
</a>
</div>
<p class="now-title">Google Now</p>
<ul>
<li>"get me a taxi"</li>
<li>"call me a car"</li>
</ul>
<p style="font-size:13px;margin-bottom:0px;margin-top:10px">(Android Wear only)</p>
</div>
<p>To call a taxi, use the
<a href="{@docRoot}reference/com/google/android/gms/actions/ReserveIntents.html#ACTION_RESERVE_TAXI_RESERVATION"><code>ACTION_RESERVE_TAXI_RESERVATION</code></a>
action.</p>
<p class="note"><strong>Note:</strong> Apps must ask for confirmation from the user
before completing the action.</p>
<dl>
<dt><b>Action</b></dt>
<dd><a href="{@docRoot}reference/com/google/android/gms/actions/ReserveIntents.html#ACTION_RESERVE_TAXI_RESERVATION"><code>ACTION_RESERVE_TAXI_RESERVATION</code></a></dd>
<dt><b>Data URI</b></dt>
<dd>None</dd>
<dt><b>MIME Type</b></dt>
<dd>None</dd>
<dt><b>Extras</b></dt>
<dd>None</dd>
</dl>
<p><b>Example intent:</b></p>
<pre>
public void callCar() {
Intent intent = new Intent(ReserveIntents.ACTION_RESERVE_TAXI_RESERVATION);
if (intent.resolveActivity(getPackageManager()) != null) {
startActivity(intent);
}
}
</pre>
<p><b>Example intent filter:</b></p>
<pre>
<activity ...>
<intent-filter>
<action android:name="com.google.android.gms.actions.RESERVE_TAXI_RESERVATION" />
<category android:name="android.intent.category.DEFAULT" />
</intent-filter>
</activity>
</pre>
<h2 id="Maps">Maps</h2>
<h3 id="ViewMap">Show a location on a map</h3>
<p>To open a map, use the {@link android.content.Intent#ACTION_VIEW} action and specify
the location information in the intent data with one of the schemes defined below.</p>
<dl>
<dt><b>Action</b></dt>
<dd>{@link android.content.Intent#ACTION_VIEW}</dd>
<dt><b>Data URI Scheme</b></dt>
<dd>
<dl>
<dt><code>geo:<em>latitude</em>,<em>longitude</em></code></dt>
<dd>Show the map at the given longitude and latitude.
<p>Example: <code>"geo:47.6,-122.3"</code>
</dd>
<dt><code>geo:<em>latitude</em>,<em>longitude</em>?z=<em>zoom</em></code></dt>
<dd>Show the map at the given longitude and latitude at a certain zoom level. A zoom level of
1 shows the whole Earth, centered at the given <em>lat</em>,<em>lng</em>. The highest
(closest) zoom level is 23.
<p>Example: <code>"geo:47.6,-122.3?z=11"</code>
</dd>
<dt><code>geo:0,0?q=lat,lng(label)</code></dt>
<dd>Show the map at the given longitude and latitude with a string label.
<p>Example: <code>"geo:0,0?q=34.99,-106.61(Treasure)"</code>
</dd>
<dt><code>geo:0,0?q=my+street+address</code></dt>
<dd>Show the location for "my street address" (may be a specific address or location query).
<p>Example: <code>"geo:0,0?q=1600+Amphitheatre+Parkway%2C+CA"</code></p>
<p class="note"><strong>Note:</strong> All strings passed in the {@code geo} URI must
be encoded. For example, the string {@code 1st & Pike, Seattle} should become
{@code 1st%20%26%20Pike%2C%20Seattle}. Spaces in the string can be encoded with
{@code %20} or replaced with the plus sign ({@code +}).</p>
</dd>
</dl>
</dd>
<dt><b>MIME Type</b></dt>
<dd>None</dd>
</dl>
<p><b>Example intent:</b></p>
<pre>
public void showMap(Uri geoLocation) {
Intent intent = new Intent(Intent.ACTION_VIEW);
intent.setData(geoLocation);
if (intent.resolveActivity(getPackageManager()) != null) {
startActivity(intent);
}
}
</pre>
<p><b>Example intent filter:</b></p>
<pre>
<activity ...>
<intent-filter>
<action android:name="android.intent.action.VIEW" />
<data android:scheme="geo" />
<category android:name="android.intent.category.DEFAULT" />
</intent-filter>
</activity>
</pre>
<h2 id="Music">Music or Video</h2>
<h3 id="PlayMedia">Play a media file</h3>
<p>To play a music file, use the {@link android.content.Intent#ACTION_VIEW} action and
specify the URI location of the file in the intent data.</p>
<dl>
<dt><b>Action</b></dt>
<dd>{@link android.content.Intent#ACTION_VIEW}</dd>
<dt><b>Data URI Scheme</b></dt>
<dd>
<dl>
<dt><code>file:<em><URI></em></code>
<dt><code>content:<em><URI></em></code>
<dt><code>http:<em><URL></em></code>
</dl>
</dd>
<dt><b>MIME Type</b></dt>
<dd>
<dl>
<dt><code>"audio/*"</code>
<dt><code>"application/ogg"</code>
<dt><code>"application/x-ogg"</code>
<dt><code>"application/itunes"</code>
<dt>Or any other that your app may require.
</dl>
</dd>
</dl>
<p><b>Example intent:</b></p>
<pre>
public void playMedia(Uri file) {
Intent intent = new Intent(Intent.ACTION_VIEW);
intent.setData(file);
if (intent.resolveActivity(getPackageManager()) != null) {
startActivity(intent);
}
}
</pre>
<p><b>Example intent filter:</b></p>
<pre>
<activity ...>
<intent-filter>
<action android:name="android.intent.action.VIEW" />
<data android:type="audio/*" />
<data android:type="application/ogg" />
<category android:name="android.intent.category.DEFAULT" />
</intent-filter>
</activity>
</pre>
<h3 id="PlaySearch">Play music based on a search query</h3>
<!-- Google Now box -->
<div class="now-box">
<div class="now-img-cont">
<a href="#Now">
<img src="{@docRoot}guide/components/images/voice-icon.png" class="now-img"
width="30" height="30" alt=""/>
</a>
</div>
<p class="now-title">Google Now</p>
<ul>
<li>"play michael jackson billie jean"</li>
</ul>
</div>
<p>To play music based on a search query, use the
{@link android.provider.MediaStore#INTENT_ACTION_MEDIA_PLAY_FROM_SEARCH} intent. An app may fire
this intent in response to the user's voice command to play music. The receiving app for this
intent performs a search within its inventory to match existing content to the given query and
starts playing that content.</p>
<p>This intent should include the {@link android.provider.MediaStore#EXTRA_MEDIA_FOCUS} string
extra, which specifies the inteded search mode. For example, the search mode can specify whether
the search is for an artist name or song name.</p>
<dl>
<dt><b>Action</b></dt>
<dd>{@link android.provider.MediaStore#INTENT_ACTION_MEDIA_PLAY_FROM_SEARCH}</dd>
<dt><b>Data URI Scheme</b></dt>
<dd>None</dd>
<dt><b>MIME Type</b></dt>
<dd>None</dd>
<dt><b>Extras</b></dt>
<dd>
<dl>
<dt>{@link android.provider.MediaStore#EXTRA_MEDIA_FOCUS MediaStore.EXTRA_MEDIA_FOCUS} (required)</dt>
<dd>
<p>Indicates the search mode (whether the user is looking for a particular artist, album, song,
or playlist). Most search modes take additional extras. For example, if the user
is interested in listening to a particular song, the intent might have three additional extras:
the song title, the artist, and the album. This intent supports the following search modes for
each value of {@link android.provider.MediaStore#EXTRA_MEDIA_FOCUS}:</p>
<dl>
<dt><p><em>Any</em> - <code>"vnd.android.cursor.item/*"</p></code></dt>
<dd>
<p>Play any music. The receiving app should play some music based on a smart choice, such
as the last playlist the user listened to.</p>
<p>Additional extras:</p>
<ul>
<li>{@link android.app.SearchManager#QUERY} (required) - An empty string. This extra is always
provided for backward compatibility: existing apps that do not know about search modes can
process this intent as an unstructured search.</li>
</ul>
</dd>
<dt><p><em>Unstructured</em> - <code>"vnd.android.cursor.item/*"</code></p></dt>
<dd>
<p>Play a particular song, album or genre from an unstructured search query. Apps may generate
an intent with this search mode when they can't identify the type of content the user wants to
listen to. Apps should use more specific search modes when possible.</p>
<p>Additional extras:</p>
<ul>
<li>{@link android.app.SearchManager#QUERY} (required) - A string that contains any combination
of: the artist, the album, the song name, or the genre.</li>
</ul>
</dd>
<dt><p><em>Genre</em> -
{@link android.provider.MediaStore.Audio.Genres#ENTRY_CONTENT_TYPE Audio.Genres.ENTRY_CONTENT_TYPE}</p></dt>
<dd>
<p>Play music of a particular genre.</p>
<p>Additional extras:</p>
<ul>
<li><code>"android.intent.extra.genre"</code> (required) - The genre.</li>
<li>{@link android.app.SearchManager#QUERY} (required) - The genre. This extra is always provided
for backward compatibility: existing apps that do not know about search modes can process
this intent as an unstructured search.</li>
</ul>
</dd>
<dt><p><em>Artist</em> -
{@link android.provider.MediaStore.Audio.Artists#ENTRY_CONTENT_TYPE Audio.Artists.ENTRY_CONTENT_TYPE}</p></dt>
<dd>
<p>Play music from a particular artist.</p>
<p>Additional extras:</p>
<ul>
<li>{@link android.provider.MediaStore#EXTRA_MEDIA_ARTIST} (required) - The artist.</li>
<li><code>"android.intent.extra.genre"</code> - The genre.</li>
<li>{@link android.app.SearchManager#QUERY} (required) - A string that contains any combination of
the artist or the genre. This extra is always provided for backward compatibility:
existing apps that do not know about search modes can process this intent as an unstructured
search.</li>
</ul>
</dd>
<dt><p><em>Album</em> -
{@link android.provider.MediaStore.Audio.Albums#ENTRY_CONTENT_TYPE Audio.Albums.ENTRY_CONTENT_TYPE}</p></dt>
<dd>
<p>Play music from a particular album.</p>
<p>Additional extras:</p>
<ul>
<li>{@link android.provider.MediaStore#EXTRA_MEDIA_ALBUM} (required) - The album.</li>
<li>{@link android.provider.MediaStore#EXTRA_MEDIA_ARTIST} - The artist.</li>
<li><code>"android.intent.extra.genre"</code> - The genre.</li>
<li>{@link android.app.SearchManager#QUERY} (required) - A string that contains any combination of
the album or the artist. This extra is always provided for backward
compatibility: existing apps that do not know about search modes can process this intent as an
unstructured search.</li>
</ul>
</dd>
<dt><p><em>Song</em> - <code>"vnd.android.cursor.item/audio"</code></p></dt>
<dd>
<p>Play a particular song.</p>
<p>Additional extras:</p>
<ul>
<li>{@link android.provider.MediaStore#EXTRA_MEDIA_ALBUM} - The album.</li>
<li>{@link android.provider.MediaStore#EXTRA_MEDIA_ARTIST} - The artist.</li>
<li><code>"android.intent.extra.genre"</code> - The genre.</li>
<li>{@link android.provider.MediaStore#EXTRA_MEDIA_TITLE} (required) - The song name.</li>
<li>{@link android.app.SearchManager#QUERY} (required) - A string that contains any combination of:
the album, the artist, the genre, or the title. This extra is always provided for
backward compatibility: existing apps that do not know about search modes can process this
intent as an unstructured search.</li>
</ul>
</dd>
<dt><p><em>Playlist</em> - {@link android.provider.MediaStore.Audio.Playlists#ENTRY_CONTENT_TYPE Audio.Playlists.ENTRY_CONTENT_TYPE}</p></dt>
<dd>
<p>Play a particular playlist or a playlist that matches some criteria specified
by additional extras.</p>
<p>Additional extras:</p>
<ul>
<li>{@link android.provider.MediaStore#EXTRA_MEDIA_ALBUM} - The album.</li>
<li>{@link android.provider.MediaStore#EXTRA_MEDIA_ARTIST} - The artist.</li>
<li><code>"android.intent.extra.genre"</code> - The genre.</li>
<li><code>"android.intent.extra.playlist"</code> - The playlist.</li>
<li>{@link android.provider.MediaStore#EXTRA_MEDIA_TITLE} - The song name that the playlist is
based on.</li>
<li>{@link android.app.SearchManager#QUERY} (required) - A string that contains any combination
of: the album, the artist, the genre, the playlist, or the title. This extra is always
provided for backward compatibility: existing apps that do not know about search modes can
process this intent as an unstructured search.</li>
</ul>
</dd>
</dl>
</dd>
</dl>
</dd>
</dl>
<p><b>Example intent:</b></p>
<p>If the user wants to listen to music from a particular artist, a search app may generate the
following intent:</p>
<pre>
public void playSearchArtist(String artist) {
Intent intent = new Intent(MediaStore.INTENT_ACTION_MEDIA_PLAY_FROM_SEARCH);
intent.putExtra(MediaStore.EXTRA_MEDIA_FOCUS,
MediaStore.Audio.Artists.ENTRY_CONTENT_TYPE);
intent.putExtra(MediaStore.EXTRA_MEDIA_ARTIST, artist);
intent.putExtra(SearchManager.QUERY, artist);
if (intent.resolveActivity(getPackageManager()) != null) {
startActivity(intent);
}
}
</pre>
<p><b>Example intent filter:</b></p>
<pre>
<activity ...>
<intent-filter>
<action android:name="android.media.action.MEDIA_PLAY_FROM_SEARCH" />
<category android:name="android.intent.category.DEFAULT" />
</intent-filter>
</activity>
</pre>
<p>When handling this intent, your activity should check the value of the
{@link android.provider.MediaStore#EXTRA_MEDIA_FOCUS} extra in the incoming
{@link android.content.Intent} to determine the search mode. Once your activity has identified
the search mode, it should read the values of the additional extras for that particular search mode.
With this information your app can then perform the search within its inventory to play the
content that matches the search query. For example:</p>
<pre>
protected void onCreate(Bundle savedInstanceState) {
...
Intent intent = this.getIntent();
if (intent.getAction().compareTo(MediaStore.INTENT_ACTION_MEDIA_PLAY_FROM_SEARCH) == 0) {
String mediaFocus = intent.getStringExtra(MediaStore.EXTRA_MEDIA_FOCUS);
String query = intent.getStringExtra(SearchManager.QUERY);
// Some of these extras may not be available depending on the search mode
String album = intent.getStringExtra(MediaStore.EXTRA_MEDIA_ALBUM);
String artist = intent.getStringExtra(MediaStore.EXTRA_MEDIA_ARTIST);
String genre = intent.getStringExtra("android.intent.extra.genre");
String playlist = intent.getStringExtra("android.intent.extra.playlist");
String title = intent.getStringExtra(MediaStore.EXTRA_MEDIA_TITLE);
// Determine the search mode and use the corresponding extras
if (mediaFocus == null) {
// 'Unstructured' search mode (backward compatible)
playUnstructuredSearch(query);
} else if (mediaFocus.compareTo("vnd.android.cursor.item/*") == 0) {
if (query.isEmpty()) {
// 'Any' search mode
playResumeLastPlaylist();
} else {
// 'Unstructured' search mode
playUnstructuredSearch(query);
}
} else if (mediaFocus.compareTo(MediaStore.Audio.Genres.ENTRY_CONTENT_TYPE) == 0) {
// 'Genre' search mode
playGenre(genre);
} else if (mediaFocus.compareTo(MediaStore.Audio.Artists.ENTRY_CONTENT_TYPE) == 0) {
// 'Artist' search mode
playArtist(artist, genre);
} else if (mediaFocus.compareTo(MediaStore.Audio.Albums.ENTRY_CONTENT_TYPE) == 0) {
// 'Album' search mode
playAlbum(album, artist);
} else if (mediaFocus.compareTo("vnd.android.cursor.item/audio") == 0) {
// 'Song' search mode
playSong(album, artist, genre, title);
} else if (mediaFocus.compareTo(MediaStore.Audio.Playlists.ENTRY_CONTENT_TYPE) == 0) {
// 'Playlist' search mode
playPlaylist(album, artist, genre, playlist, title);
}
}
}
</pre>
<h2 id="NewNote">New Note</h2>
<h3 id="CreateNote">Create a note</h3>
<p>To create a new note, use the
<a href="https://developers.google.com/android/reference/com/google/android/gms/actions/NoteIntents#ACTION_CREATE_NOTE">
{@code ACTION_CREATE_NOTE}</a> action and specify note details such as the subject and text using extras defined below.</p>
<p class="note"><strong>Note:</strong> Apps must ask for confirmation from the user
before completing the action.</p>
<dl>
<dt><b>Action</b></dt>
<dd><a href="https://developers.google.com/android/reference/com/google/android/gms/actions/NoteIntents#ACTION_CREATE_NOTE">
{@code ACTION_CREATE_NOTE}</a>
</dd>
<dt><b>Data URI Scheme</b></dt>
<dd>None</dd>
<dt><b>MIME Type</b></dt>
<dd><a href="https://developer.android.com/reference/org/apache/http/protocol/HTTP.html#PLAIN_TEXT_TYPE">
{@code PLAIN_TEXT_TYPE}</a></dd>
<dd>"*/*"</dd>
<dt><b>Extras</b></dt>
<dd>
<dl>
<dt><a href="https://developers.google.com/android/reference/com/google/android/gms/actions/NoteIntents#EXTRA_NAME">
{@code EXTRA_NAME}</a>
<dd>A string indicating the title or subject of the note.</dd>
<dt><a href="https://developers.google.com/android/reference/com/google/android/gms/actions/NoteIntents#EXTRA_TEXT">
{@code EXTRA_TEXT}</a>
<dd>A string indicating the text of the note.</dd>
</dl>
</dd>
<p><b>Example intent:</b></p>
<pre>
public void createNote(String subject, String text) {
Intent intent = new Intent(NoteIntents.ACTION_CREATE_NOTE)
.putExtra(NoteIntents.EXTRA_NAME, subject)
.putExtra(NoteIntents.EXTRA_TEXT, text);
if (intent.resolveActivity(getPackageManager()) != null) {
startActivity(intent);
}
}</pre>
<p><b>Example intent filter:</b></p>
<pre>
<activity ...>
<intent-filter>
<action android:name="com.google.android.gms.actions.CREATE_NOTE" />
<category android:name="android.intent.category.DEFAULT" />
<data android:mimeType=”*/*”>
</intent-filter>
</activity>
</pre>
<h2 id="Phone">Phone</h2>
<h3 id="DialPhone">Initiate a phone call</h3>
<p>To open the phone app and dial a phone number, use the {@link
android.content.Intent#ACTION_DIAL} action and specify a phone number using
the URI scheme defined below. When the phone app opens, it displays the phone number
but the user must press the <em>Call</em> button to begin the phone call.</p>
<!-- Google Now box -->
<div class="now-box">
<div class="now-img-cont">
<a href="#Now">
<img src="{@docRoot}guide/components/images/voice-icon.png" class="now-img"
width="30" height="30" alt=""/>
</a>
</div>
<p class="now-title">Google Now</p>
<ul>
<li>"call 555-5555"</li>
<li>"call bob"</li>
<li>"call voicemail"</li>
</ul>
</div>
<p>To place a phone call directly, use the {@link android.content.Intent#ACTION_CALL} action
and specify a phone number using the URI scheme defined below. When the phone app opens, it
begins the phone call; the user does not need to press the <em>Call</em> button.</p>
<p>The {@link android.content.Intent#ACTION_CALL} action requires that you add the
<code>CALL_PHONE</code> permission to your manifest file:</p>
<pre style="margin-top:45px">
<uses-permission android:name="android.permission.CALL_PHONE" />
</pre>
<dl>
<dt><b>Action</b></dt>
<dd>
<ul>
<li>{@link android.content.Intent#ACTION_DIAL} - Opens the dialer or phone app.</li>
<li>{@link android.content.Intent#ACTION_CALL} - Places a phone call (requires the
<code>CALL_PHONE</code> permission)</li>
</ul>
</dd>
<dt><b>Data URI Scheme</b></dt>
<dd>
<ul>
<li>{@code tel:<phone-number>}</li>
<li>{@code voicemail:<phone-number>}</li>
</ul>
</dd>
<dt><b>MIME Type</b></dt>
<dd>None</dd>
</dl>
<p>Valid telephone numbers are those defined
in <a href="http://tools.ietf.org/html/rfc3966">the IETF RFC 3966</a>.
Valid examples include the following:</p>
<ul>
<li><code>tel:2125551212</code> </li>
<li><code>tel:(212) 555 1212</code></li>
</ul>
<p>The Phone's dialer is good at normalizing schemes, such as
telephone numbers. So the scheme described isn't strictly required in the
{@link android.net.Uri#parse(String) Uri.parse()} method.
However, if you have not tried a scheme or are unsure whether it
can be handled, use the {@link android.net.Uri#fromParts Uri.fromParts()}
method instead.</p>
<p><b>Example intent:</b></p>
<pre>
public void dialPhoneNumber(String phoneNumber) {
Intent intent = new Intent(Intent.ACTION_DIAL);
intent.setData(Uri.parse("tel:" + phoneNumber));
if (intent.resolveActivity(getPackageManager()) != null) {
startActivity(intent);
}
}
</pre>
<h2 id="Search">Search</h2>
<h3 id="SearchOnApp">Search using a specific app</h3>
<!-- Google Now box -->
<div class="now-box">
<div class="now-img-cont">
<a href="#Now">
<img src="{@docRoot}guide/components/images/voice-icon.png" class="now-img"
width="30" height="30"/></a>
</div>
<p class="now-title">Google Now</p>
<ul>
<li>"search for cat videos on myvideoapp"</li>
</ul>
</div>
<!-- Video box -->
<a class="notice-developers-video"
href="https://www.youtube.com/watch?v=PS1FbB5qWEI">
<div>
<h3>Video</h3>
<p>Voice search in your app</p>
</div>
</a>
<p>To support search within the context of your app, declare an intent filter in your app with
the <code>SEARCH_ACTION</code> action, as shown in the example intent filter below.</p>
<dl>
<dt><b>Action</b></dt>
<dd>
<dl>
<dt><code>"com.google.android.gms.actions.SEARCH_ACTION"</code></dt>
<dd>Support search queries from Google Now.</dd>
</dl>
</dd>
<dt><b>Extras</b></dt>
<dd>
<dl>
<dt><code>{@link android.app.SearchManager#QUERY}</code></dt>
<dd>A string that contains the search query.</dd>
<dl>
</dd>
</dl>
<p><b>Example intent filter:</b></p>
<pre>
<activity android:name=".SearchActivity">
<intent-filter>
<action android:name="com.google.android.gms.actions.SEARCH_ACTION"/>
<category android:name="android.intent.category.DEFAULT"/>
</intent-filter>
</activity>
</pre>
<h3 id="SearchWeb">Perform a web search</h3>
<p>To initiate a web search, use the {@link android.content.Intent#ACTION_WEB_SEARCH} action
and specify the search string in the
{@link android.app.SearchManager#QUERY SearchManager.QUERY} extra.</p>
<dl>
<dt><b>Action</b></dt>
<dd>{@link android.content.Intent#ACTION_WEB_SEARCH}</dd>
<dt><b>Data URI Scheme</b></dt>
<dd>None</dd>
<dt><b>MIME Type</b></dt>
<dd>None</dd>
<dt><b>Extras</b></dt>
<dd>
<dl>
<dt>{@link android.app.SearchManager#QUERY SearchManager.QUERY}</dt>
<dd>The search string.</dd>
</dl>
</dd>
</dl>
<p><b>Example intent:</b></p>
<pre>
public void searchWeb(String query) {
Intent intent = new Intent(Intent.ACTION_SEARCH);
intent.putExtra(SearchManager.QUERY, query);
if (intent.resolveActivity(getPackageManager()) != null) {
startActivity(intent);
}
}
</pre>
<h2 id="Settings">Settings</h2>
<h3 id="OpenSettings">Open a specific section of Settings</h3>
<p>To open a screen in the system settings when your app requires the user to change something,
use one of the following intent actions to open the settings screen respective to the action name.
</p>
<dl>
<dt><b>Action</b></dt>
<dd>
{@link android.provider.Settings#ACTION_SETTINGS}<br/>
{@link android.provider.Settings#ACTION_WIRELESS_SETTINGS}<br/>
{@link android.provider.Settings#ACTION_AIRPLANE_MODE_SETTINGS}<br/>
{@link android.provider.Settings#ACTION_WIFI_SETTINGS}<br/>
{@link android.provider.Settings#ACTION_APN_SETTINGS}<br/>
{@link android.provider.Settings#ACTION_BLUETOOTH_SETTINGS}<br/>
{@link android.provider.Settings#ACTION_DATE_SETTINGS}<br/>
{@link android.provider.Settings#ACTION_LOCALE_SETTINGS}<br/>
{@link android.provider.Settings#ACTION_INPUT_METHOD_SETTINGS}<br/>
{@link android.provider.Settings#ACTION_DISPLAY_SETTINGS}<br/>
{@link android.provider.Settings#ACTION_SECURITY_SETTINGS}<br/>
{@link android.provider.Settings#ACTION_LOCATION_SOURCE_SETTINGS}<br/>
{@link android.provider.Settings#ACTION_INTERNAL_STORAGE_SETTINGS}<br/>
{@link android.provider.Settings#ACTION_MEMORY_CARD_SETTINGS}<br/>
<p>See the {@link android.provider.Settings} documentation for additional settings screens
that are available.</p>
</dd>
<dt><b>Data URI Scheme</b></dt>
<dd>None</dd>
<dt><b>MIME Type</b></dt>
<dd>None</dd>
</dl>
<p><b>Example intent:</b></p>
<pre>
public void openWifiSettings() {
Intent intent = new Intent(Intent.ACTION_WIFI_SETTINGS);
if (intent.resolveActivity(getPackageManager()) != null) {
startActivity(intent);
}
}
</pre>
<h2 id="Messaging">Text Messaging</h2>
<h3 id="SendMessage">Compose an SMS/MMS message with attachment</h3>
<p>To initiate an SMS or MMS text message, use one of the intent actions below and specify message
details such as the phone number, subject, and message body using the extra keys listed below.</p>
<dl>
<dt><b>Action</b></dt>
<dd>{@link android.content.Intent#ACTION_SENDTO} or<br>
{@link android.content.Intent#ACTION_SEND} or<br>
{@link android.content.Intent#ACTION_SEND_MULTIPLE}</dd>
<dt><b>Data URI Scheme</b></dt>
<dd>
<dl>
<dt><code>sms:<em><phone_number></em></code>
<dt><code>smsto:<em><phone_number></em></code>
<dt><code>mms:<em><phone_number></em></code>
<dt><code>mmsto:<em><phone_number></em></code>
</dl>
<p>Each of these schemes are handled the same.
</dd>
<dt><b>MIME Type</b></dt>
<dd>
<dl>
<dt><code>"text/plain"</code>
<dt><code>"image/*"</code>
<dt><code>"video/*"</code>
</dl>
</dd>
<dt><b>Extras</b></dt>
<dd>
<dl>
<dt><code>"subject"</code></dt>
<dd>A string for the message subject (usually for MMS only).</dd>
<dt><code>"sms_body"</code></dt>
<dd>A string for the text message.</dd>
<dt>{@link android.content.Intent#EXTRA_STREAM}</dt>
<dd>A {@link android.net.Uri} pointing to the
image or video to attach. If using the {@link android.content.Intent#ACTION_SEND_MULTIPLE} action,
this extra should be an {@link java.util.ArrayList} of {@link
android.net.Uri}s pointing to the images/videos to attach.</dd>
<dl>
</dd>
</dl>
<p><b>Example intent:</b></p>
<pre>
public void composeMmsMessage(String message, Uri attachment) {
Intent intent = new Intent(Intent.ACTION_SENDTO);
intent.setType(HTTP.PLAIN_TEXT_TYPE);
intent.putExtra("sms_body", message);
intent.putExtra(Intent.EXTRA_STREAM, attachment);
if (intent.resolveActivity(getPackageManager()) != null) {
startActivity(intent);
}
}
</pre>
<p>If you want to ensure that your intent is handled only by a text messaging app (and not other
email or social apps), then use the {@link android.content.Intent#ACTION_SENDTO} action
and include the {@code "smsto:"} data scheme. For example:</p>
<pre>
public void composeMmsMessage(String message, Uri attachment) {
Intent intent = new Intent(Intent.ACTION_SEND);
intent.setData(Uri.parse("smsto:")); // This ensures only SMS apps respond
intent.putExtra("sms_body", message);
intent.putExtra(Intent.EXTRA_STREAM, attachment);
if (intent.resolveActivity(getPackageManager()) != null) {
startActivity(intent);
}
}
</pre>
<p><b>Example intent filter:</b></p>
<pre>
<activity ...>
<intent-filter>
<action android:name="android.intent.action.SEND" />
<data android:type="text/plain" />
<data android:type="image/*" />
<category android:name="android.intent.category.DEFAULT" />
</intent-filter>
</activity>
</pre>
<p class="note"><strong>Note:</strong> If you're developing an SMS/MMS messaging app, you must
implement intent filters for several additional actions in order to be available as the
<em>default SMS app</em> on Android 4.4 and higher. For more information, see the documentation
at {@link android.provider.Telephony}.</p>
<h2 id="Browser">Web Browser</h2>
<h3 id="ViewUrl">Load a web URL</h3>
<!-- Google Now box -->
<div class="now-box">
<div class="now-img-cont">
<a href="#Now">
<img src="{@docRoot}guide/components/images/voice-icon.png" class="now-img"
width="30" height="30" alt=""/>
</a>
</div>
<p class="now-title">Google Now</p>
<ul>
<li>"open example.com"</li>
</ul>
</div>
<p>To open a web page, use the {@link android.content.Intent#ACTION_VIEW} action
and specify the web URL in the intent data.</p>
<dl>
<dt><b>Action</b></dt>
<dd>{@link android.content.Intent#ACTION_VIEW}<dd>
<dt><b>Data URI Scheme</b></dt>
<dd><code>http:<em><URL></em></code><br/>
<code>https:<em><URL></em></code></dd>
<dt><b>MIME Type</b></dt>
<dd>
<dl>
<dt><code>"text/plain"</code>
<dt><code>"text/html"</code>
<dt><code>"application/xhtml+xml"</code>
<dt><code>"application/vnd.wap.xhtml+xml"</code>
</dl>
</dd>
</dl>
<p><b>Example intent:</b></p>
<pre>
public void openWebPage(String url) {
Uri webpage = Uri.parse(url);
Intent intent = new Intent(Intent.ACTION_VIEW, webpage);
if (intent.resolveActivity(getPackageManager()) != null) {
startActivity(intent);
}
}
</pre>
<p><b>Example intent filter:</b></p>
<pre>
<activity ...>
<intent-filter>
<action android:name="android.intent.action.VIEW" />
<!-- Include the host attribute if you want your app to respond
only to URLs with your app's domain. -->
<data android:scheme="http" android:host="www.example.com" />
<category android:name="android.intent.category.DEFAULT" />
<!-- The BROWSABLE category is required to get links from web pages. -->
<category android:name="android.intent.category.BROWSABLE" />
</intent-filter>
</activity>
</pre>
<p class="note"><strong>Tip:</strong> If your Android app provides functionality similar to
your web site, include an intent filter for URLs that point to your web site. Then,
if users have your app installed, links from emails or other web pages pointing to your web site
open your Android app instead of your web page.</p>
<h2 id="AdbIntents">Verify Intents with the Android Debug Bridge</h2>
<p>To verify that your app responds to the intents that you want to support, you can use the
<a href="{@docRoot}tools/help/adb.html"><code>adb</code></a> tool to fire specific intents:</p>
<ol>
<li>Set up an Android device for <a href="{@docRoot}tools/device.html#setting-up">development</a>,
or use a <a href="{@docRoot}tools/devices/emulator.html#avds">virtual device</a>.</li>
<li>Install a version of your app that handles the intents you want to support.</li>
<li>Fire an intent using <code>adb</code>:
<pre class="no-pretty-print">
adb shell am start -a <ACTION> -t <MIME_TYPE> -d <DATA> \
-e <EXTRA_NAME> <EXTRA_VALUE> -n <ACTIVITY>
</pre>
<p>For example:</p>
<pre class="no-pretty-print">
adb shell am start -a android.intent.action.DIAL \
-d tel:555-5555 -n org.example.MyApp/.MyActivity
</pre>
<li>If you defined the required intent filters, your app should handle the intent.</li>
</ol>
<p>For more information, see
<a href="{@docRoot}tools/help/shell.html#am">ADB Shell Commands</a>.</p>
<h2 id="Now">Intents Fired by Google Now</h2>
<p><a href="http://www.google.com/landing/now/">Google Now</a> recognizes many voice commands
and fires intents for them. As such, users may launch your app with a Google Now voice command
if your app declares the corresponding intent filter. For example, if your app can
<a href="#CreateAlarm">set an alarm</a> and you add the corresponding intent filter to your
manifest file, Google Now lets users choose your app when they request to set an alarm, as
shown in figure 1.</p>
<img src="{@docRoot}guide/components/images/google-action.png"
srcset="{@docRoot}guide/components/images/google-action_2x.png 2x"
width="700" height="241" alt=""/>
<p class="img-caption"><strong>Figure 1.</strong> Google Now lets users choose from installed
apps that support a given action.</p>
<p>Google Now recognizes voice commands for the actions listed in table 1. For more information
about declaring each intent filter, click on the action description.</p>
<p class="table-caption"><strong>Table 1.</strong> Voice commands recognized by Google Now
(Google Search app v3.6).</p>
<table>
<tr>
<th>Category</th>
<th>Details and Examples</th>
<th>Action Name</th>
</tr>
<tr>
<td rowspan="2" style="vertical-align:middle">Alarm</td>
<td>
<p><a href="#CreateAlarm">Set alarm</a></p>
<ul class="now-list">
<li>"set an alarm for 7 am"</li>
</ul>
</td>
<td>{@link android.provider.AlarmClock#ACTION_SET_ALARM AlarmClock.ACTION_SET_ALARM}</td>
</tr>
<tr>
<td>
<p><a href="#CreateTimer">Set timer</a></p>
<ul class="now-list">
<li>"set a timer for 5 minutes"</li>
</ul>
</td>
<td>{@link android.provider.AlarmClock#ACTION_SET_TIMER AlarmClock.ACTION_SET_TIMER}</td>
</tr>
<tr>
<td style="vertical-align:middle">Communication</td>
<td>
<p><a href="#DialPhone">Call a number</a></p>
<ul class="now-list">
<li>"call 555-5555"</li>
<li>"call bob"</li>
<li>"call voicemail"</li>
</ul>
</td>
<td>{@link android.content.Intent#ACTION_CALL Intent.ACTION_CALL}</td>
</tr>
<tr>
<td style="vertical-align:middle">Local</td>
<td>
<p><a href="#CallCar">Book a car</a></p>
<ul class="now-list">
<li>"call me a car"</li>
<li>"book me a taxi"</li>
</ul>
</td>
<td><a href="{@docRoot}reference/com/google/android/gms/actions/ReserveIntents.html#ACTION_RESERVE_TAXI_RESERVATION">
<code>ReserveIntents<br/>.ACTION_RESERVE_TAXI_RESERVATION</code></a></td>
</tr>
<tr>
<td rowspan="3" style="vertical-align:middle">Media</td>
<td>
<p><a href="#PlaySearch">Play music from search</a></p>
<ul class="now-list">
<li>"play michael jackson billie jean"</li>
</ul>
</td>
<td>{@link android.provider.MediaStore#INTENT_ACTION_MEDIA_PLAY_FROM_SEARCH MediaStore<br/>.INTENT_ACTION_MEDIA_PLAY_FROM_SEARCH}</td>
</tr>
<tr>
<td>
<p><a href="#CameraStill">Take a picture</a></p>
<ul class="now-list">
<li>"take a picture"</li>
</ul>
</td>
<td>{@link android.provider.MediaStore#INTENT_ACTION_STILL_IMAGE_CAMERA MediaStore<br/>.INTENT_ACTION_STILL_IMAGE_CAMERA}</td>
</tr>
<tr>
<td>
<p><a href="#CameraVideo">Record a video</a></p>
<ul class="now-list">
<li>"record a video"</li>
</ul>
</td>
<td>{@link android.provider.MediaStore#INTENT_ACTION_VIDEO_CAMERA MediaStore<br/>.INTENT_ACTION_VIDEO_CAMERA}</td>
</tr>
<tr>
<td style="vertical-align:middle">Search</td>
<td>
<p><a href="#SearchOnApp">Search using a specific app</a></p>
<ul class="now-list">
<li>"search for cat videos <br/>on myvideoapp"</li>
</ul>
</td>
<td><code>"com.google.android.gms.actions<br/>.SEARCH_ACTION"</code></td>
</tr>
<tr>
<td style="vertical-align:middle">Web browser</td>
<td>
<p><a href="#ViewUrl">Open URL</a></p>
<ul class="now-list">
<li>"open example.com"</li>
</ul>
</td>
<td>{@link android.content.Intent#ACTION_VIEW Intent.ACTION_VIEW}</td>
</tr>
</table>