このページは Cloud Translation API によって翻訳されました。

一般的なインテント

インテントを使用すると、実行するアクション（「地図を表示する」、「写真を撮る」など）を Intent オブジェクトに記述することによって、別のアプリのアクティビティを開始できます。このタイプのインテントでは、開始するアプリのコンポーネントは指定されません。アクションとアクションの実行に使用するデータのみが指定されるため、暗黙的インテントと呼ばれます。

startActivity() または startActivityForResult() を呼び出して暗黙的インテントを渡すと、システムはインテントを扱うことができるアプリを判断するためにインテントの解決を行い、対応する Activity を起動します。インテントを処理できるアプリが複数ある場合、ユーザーが使用するアプリを選択できるダイアログが表示されます。

このページでは、インテントを扱うことができるアプリのタイプ別に、一般的なアクションを実行できる暗黙的インテントについて説明します。各セクションには、アプリがそのアクションを実行できることを通知するインテントフィルタの作成方法も記載されています。

注意: デバイスに暗黙的インテントを受け取ることができるアプリがない場合、startActivity() を呼び出すとアプリがクラッシュします。まず、インテントを受け取るアプリの存在を確認するために、Intent オブジェクトの resolveActivity() を呼び出します。結果が null 以外の場合は、インテントを処理できるアプリが少なくとも 1 つあることを意味し、startActivity() を安全に呼び出すことができます。結果が null の場合は、そのインテントは使用せず、可能であればそのインテントを呼び出す機能を無効にします。

インテントやインテントフィルタの作成方法を十分理解していない場合は、まずインテントとインテントフィルタをお読みください。

このページに記載されているインテントを開発用のホストから発行する方法については、Android Debug Bridge でインテントを検証するをご覧ください。

Google Voice Actions

Google Voice Actions は、音声コマンドへの応答として、このページに記載されているインテントの一部を呼び出します。詳しくは、システム音声操作のスタートガイドをご覧ください。

目覚まし時計

以下は、アラームアプリの一般的なアクションです。各アクションを実行するアプリの機能をアドバタイズするインテントフィルタを作成するために必要な情報も記載しています。

アラームを作成

Google Voice Actions

「アラームを午前 7 時に設定して」

新しいアラームを作成するには、ACTION_SET_ALARM アクションを使用し、次のエクストラを使用して時間やメッセージなどのアラームの詳細を指定します。

注: Android 2.3（API レベル 9）以前では、時間、分、メッセージのエクストラ値のみが利用できます。その他のエクストラは、プラットフォームの新しいバージョンで利用できます。

操作

ACTION_SET_ALARM

データ URI

なし

MIME タイプ

なし

おまけ

EXTRA_HOUR: アラームの時間です。
EXTRA_MINUTES: アラームの分です。
EXTRA_MESSAGE: アラームを識別するカスタムメッセージです。
EXTRA_DAYS: アラームを実行する曜日を格納した ArrayList です。曜日は、MONDAY など Calendar クラスの整数で指定する必要があります。
1 回限りのアラームの場合は、このエクストラ値は設定しないでください。
EXTRA_RINGTONE: アラームで使用する着信音の content: URI を指定します。着信音を使用しない場合は、VALUE_RINGTONE_SILENT を指定します。
デフォルトの着信音を使用する場合は、このエクストラ値は設定しないでください。
EXTRA_VIBRATE: アラームでバイブレーションを使用するかどうかを示すブール値です。
EXTRA_SKIP_UI: アラームを設定する際にアプリが UI をスキップする必要があるかどうかを示すブール値です。true の場合、アプリは確認画面の UI をすべてスキップして指定されたアラームを設定する必要があります。

例のインテント:

Kotlin

fun createAlarm(message: String, hour: Int, minutes: Int) {
    val intent = Intent(AlarmClock.ACTION_SET_ALARM).apply {
        putExtra(AlarmClock.EXTRA_MESSAGE, message)
        putExtra(AlarmClock.EXTRA_HOUR, hour)
        putExtra(AlarmClock.EXTRA_MINUTES, minutes)
    }
    if (intent.resolveActivity(packageManager) != null) {
        startActivity(intent)
    }
}

Java

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);
    }
}

注:

ACTION_SET_ALARM インテントを呼び出すには、アプリに SET_ALARM 権限が必要です。

<uses-permission android:name="com.android.alarm.permission.SET_ALARM" />

インテントフィルタの例:

<activity ...>
    <intent-filter>
        <action android:name="android.intent.action.SET_ALARM" />
        <category android:name="android.intent.category.DEFAULT" />
    </intent-filter>
</activity>

タイマーを作成する

Google Voice Actions

「タイマーを 5 分に設定して」

カウントダウンタイマーを作成するには、ACTION_SET_TIMER アクションを使用し、次のエクストラを使用して時間などのタイマーの詳細を指定します。

注: このインテントは、Android 4.4（API レベル 19）以降で使用できます。

操作

ACTION_SET_TIMER

データ URI

なし

MIME タイプ

なし

おまけ

EXTRA_LENGTH: 秒単位のタイマーの長さです。
EXTRA_MESSAGE: タイマーを識別するカスタムメッセージです。
EXTRA_SKIP_UI: タイマーを設定する際にアプリが UI をスキップする必要があるかどうかを示すブール値です。 true の場合、アプリは確認画面の UI をすべてスキップして指定されたタイマーを開始します。

例のインテント:

Kotlin

fun startTimer(message: String, seconds: Int) {
    val intent = Intent(AlarmClock.ACTION_SET_TIMER).apply {
        putExtra(AlarmClock.EXTRA_MESSAGE, message)
        putExtra(AlarmClock.EXTRA_LENGTH, seconds)
        putExtra(AlarmClock.EXTRA_SKIP_UI, true)
    }
    if (intent.resolveActivity(packageManager) != null) {
        startActivity(intent)
    }
}

Java

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);
    }
}

注:

ACTION_SET_TIMER インテントを呼び出すには、アプリに SET_ALARM 権限が必要です。

<uses-permission android:name="com.android.alarm.permission.SET_ALARM" />

インテントフィルタの例:

<activity ...>
    <intent-filter>
        <action android:name="android.intent.action.SET_TIMER" />
        <category android:name="android.intent.category.DEFAULT" />
    </intent-filter>
</activity>

アラームをすべて表示

アラームの一覧を表示するには、ACTION_SHOW_ALARMS アクションを使用します。

このインテントを呼び出すアプリは多くありませんが（このインテントを使用するのは主にシステムアプリです）、アラームクロックとして動作するアプリは必ずこのインテントフィルタを実装し、応答として現在のアラームの一覧を表示する必要があります。

注: このインテントは、Android 4.4（API レベル 19）以降で使用できます。

操作: ACTION_SHOW_ALARMS
データ URI: なし
MIME タイプ: なし

インテントフィルタの例:

<activity ...>
    <intent-filter>
        <action android:name="android.intent.action.SHOW_ALARMS" />
        <category android:name="android.intent.category.DEFAULT" />
    </intent-filter>
</activity>

カレンダー

イベントの追加は、カレンダーアプリの一般的な操作です。次のセクションの情報を使用して、このアクションを実行するアプリの機能をアドバタイズするインテントフィルタを作成します。

カレンダーに予定を追加する

ユーザーのカレンダーに新しいイベントを追加するには、ACTION_INSERT アクションを使用して Events.CONTENT_URI でデータ URI を指定します。その後、次のエクストラ値を使用してイベントの詳細を指定します。

操作

ACTION_INSERT

データ URI

Events.CONTENT_URI

MIME タイプ

"vnd.android.cursor.dir/event"

おまけ

EXTRA_EVENT_ALL_DAY: 終日のイベントかどうかを示すブール値です。
EXTRA_EVENT_BEGIN_TIME: イベントの開始時刻（エポックからのミリ秒単位）。
EXTRA_EVENT_END_TIME: イベントの終了時刻（エポックからのミリ秒単位）。
TITLE: イベントのタイトル。
DESCRIPTION: イベントの説明。
EVENT_LOCATION: イベントの場所。
EXTRA_EMAIL: 参加者のメールアドレスのコンマ区切りリストです。

CalendarContract.EventsColumns クラスで定義されている定数を使用すると、イベントの詳細をさらに細かく指定できます。

例のインテント:

Kotlin

fun addEvent(title: String, location: String, begin: Long, end: Long) {
    val intent = Intent(Intent.ACTION_INSERT).apply {
        data = 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(packageManager) != null) {
        startActivity(intent)
    }
}

Java

public void addEvent(String title, String location, long begin, long 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);
    }
}

インテントフィルタの例:

<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>

カメラ

以下に、カメラアプリの一般的なアクションを示します。各アクションを実行するアプリの機能をアドバタイズするためのインテントフィルタを作成するために必要な情報も示します。

写真やビデオを撮影して返却する

カメラアプリを開いて撮影した写真やビデオを受け取るには、ACTION_IMAGE_CAPTURE または ACTION_VIDEO_CAPTURE アクションを使用します。また、エクストラ値 EXTRA_OUTPUT で写真やビデオを保存する場所の URI を指定する必要があります。

操作

ACTION_IMAGE_CAPTURE または
ACTION_VIDEO_CAPTURE

データ URI スキーム

なし

MIME タイプ

なし

おまけ

EXTRA_OUTPUT: カメラアプリが写真やビデオのファイルを保存する場所を示す URI（Uri オブジェクト）です。

カメラアプリが正常にフォーカスをアクティビティに戻す（アプリが onActivityResult() コールバックを受け取る）と、値 EXTRA_OUTPUT で指定した URI から写真やビデオにアクセスできるようになります。

注: ACTION_IMAGE_CAPTURE を使用して写真を撮影すると、カメラが写真の縮小コピー（サムネイル）も一緒に返す場合があります。これは、結果の Intent の "data" という追加フィールドに Bitmap として保存されています。

例のインテント:

Kotlin

const val REQUEST_IMAGE_CAPTURE = 1
val locationForPhotos: Uri = ...

fun capturePhoto(targetFilename: String) {
    val intent = Intent(MediaStore.ACTION_IMAGE_CAPTURE).apply {
        putExtra(MediaStore.EXTRA_OUTPUT, Uri.withAppendedPath(locationForPhotos, targetFilename))
    }
    if (intent.resolveActivity(packageManager) != null) {
        startActivityForResult(intent, REQUEST_IMAGE_CAPTURE)
    }
}

override fun onActivityResult(requestCode: Int, resultCode: Int, data: Intent) {
    if (requestCode == REQUEST_IMAGE_CAPTURE && resultCode == Activity.RESULT_OK) {
        val thumbnail: Bitmap = data.getParcelableExtra("data")
        // Do other work with full size photo saved in locationForPhotos.
        ...
    }
}

Java

static final int REQUEST_IMAGE_CAPTURE = 1;
static final Uri locationForPhotos;

public void capturePhoto(String targetFilename) {
    Intent intent = new Intent(MediaStore.ACTION_IMAGE_CAPTURE);
    intent.putExtra(MediaStore.EXTRA_OUTPUT,
            Uri.withAppendedPath(locationForPhotos, 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.getParcelableExtra("data");
        // Do other work with full size photo saved in locationForPhotos.
        ...
    }
}

Android 12（API レベル 31）以降でこれを行うには、次のインテントの例をご覧ください。

例のインテント:

Kotlin

val REQUEST_IMAGE_CAPTURE = 1

private fun dispatchTakePictureIntent() {
    val takePictureIntent = Intent(MediaStore.ACTION_IMAGE_CAPTURE)
    try {
        startActivityForResult(takePictureIntent, REQUEST_IMAGE_CAPTURE)
    } catch (e: ActivityNotFoundException) {
        // Display error state to the user.
    }
}

Java

static final int REQUEST_IMAGE_CAPTURE = 1;

private void dispatchTakePictureIntent() {
    Intent takePictureIntent = new Intent(MediaStore.ACTION_IMAGE_CAPTURE);
    try {
        startActivityForResult(takePictureIntent, REQUEST_IMAGE_CAPTURE);
    } catch (ActivityNotFoundException e) {
        // Display error state to the user.
    }
}
</section></div>

出力場所に適切な Uri を作成する方法など、このインテントを使って写真を撮影する方法の詳細については、写真を撮影するまたは動画を撮影するをご覧ください。

インテントフィルタの例:

<activity ...>
    <intent-filter>
        <action android:name="android.media.action.IMAGE_CAPTURE" />
        <category android:name="android.intent.category.DEFAULT" />
    </intent-filter>
</activity>

このインテントを処理するアクティビティを作成する場合は、受け取った Intent の EXTRA_OUTPUT エクストラ値を確認し、撮影した画像やビデオをエクストラ値で指定された場所に保存し、追加フィールド "data" に圧縮されたサムネイルを含む Intent を指定して setResult() を呼び出します。

静止画モードでカメラアプリを起動する

Google Voice Actions

「写真を撮って」

静止画モードでカメラアプリを起動するには、INTENT_ACTION_STILL_IMAGE_CAMERA アクションを使用します。

操作: INTENT_ACTION_STILL_IMAGE_CAMERA
データ URI スキーム: なし
MIME タイプ: なし
おまけ: なし

例のインテント:

Kotlin

private fun dispatchTakePictureIntent() {
    val takePictureIntent = Intent(MediaStore.ACTION_IMAGE_CAPTURE)
    try {
        startActivityForResult(takePictureIntent, REQUEST_IMAGE_CAPTURE)
    } catch (e: ActivityNotFoundException) {
        // Display error state to the user.
    }
}

Java

public void capturePhoto(String targetFilename) {
    Intent intent = new Intent(MediaStore.ACTION_IMAGE_CAPTURE);
    intent.putExtra(MediaStore.EXTRA_OUTPUT,
            Uri.withAppendedPath(locationForPhotos, targetFilename));
    if (intent.resolveActivity(getPackageManager()) != null) {
        startActivityForResult(intent, REQUEST_IMAGE_CAPTURE);
    }
}

インテントフィルタの例:

<activity ...>
    <intent-filter>
        <action android:name="android.media.action.STILL_IMAGE_CAMERA" />
        <category android:name="android.intent.category.DEFAULT" />
    </intent-filter>
</activity>

ビデオモードでカメラアプリを起動する

Google Voice Actions

「動画を撮って」

ビデオモードでカメラアプリを起動するには、INTENT_ACTION_VIDEO_CAMERA アクションを使用します。

操作: INTENT_ACTION_VIDEO_CAMERA
データ URI スキーム: なし
MIME タイプ: なし
おまけ: なし

例のインテント:

Kotlin

fun capturePhoto() {
    val intent = Intent(MediaStore.INTENT_ACTION_VIDEO_CAMERA)
    if (intent.resolveActivity(packageManager) != null) {
        startActivityForResult(intent, REQUEST_IMAGE_CAPTURE)
    }
}

Java

public void capturePhoto() {
    Intent intent = new Intent(MediaStore.INTENT_ACTION_VIDEO_CAMERA);
    if (intent.resolveActivity(getPackageManager()) != null) {
        startActivityForResult(intent, REQUEST_IMAGE_CAPTURE);
    }
}

インテントフィルタの例:

<activity ...>
    <intent-filter>
        <action android:name="android.media.action.VIDEO_CAMERA" />
        <category android:name="android.intent.category.DEFAULT" />
    </intent-filter>
</activity>

連絡先/連絡帳アプリ

以下は、連絡先管理アプリの一般的なアクションです。各アクションを実行するアプリの機能をアドバタイズするインテントフィルタを作成するために必要な情報も示します。

連絡先の選択

ユーザーが連絡先を選択し、アプリが連絡先情報にアクセスできるようにするには、ACTION_PICK アクションを使用して MIME タイプに Contacts.CONTENT_TYPE を指定します。

onActivityResult() コールバックに渡される結果 Intent には、選択した連絡先を指す content: URI が含まれています。アプリに READ_CONTACTS 権限がなくても、Contacts Provider API を使用して連絡先を読み取る一時的な権限が付与されます。

ヒント: 電話番号やメールアドレスなど、連絡先情報の一部のみにアクセスする場合は、次のセクションの特定の連絡先データを選択する方法をご覧ください。

操作: ACTION_PICK
データ URI スキーム: なし
MIME タイプ: Contacts.CONTENT_TYPE

例のインテント:

Kotlin

const val REQUEST_SELECT_CONTACT = 1

fun selectContact() {
    val intent = Intent(Intent.ACTION_PICK).apply {
        type = ContactsContract.Contacts.CONTENT_TYPE
    }
    if (intent.resolveActivity(packageManager) != null) {
        startActivityForResult(intent, REQUEST_SELECT_CONTACT)
    }
}

override fun onActivityResult(requestCode: Int, resultCode: Int, data: Intent) {
    if (requestCode == REQUEST_SELECT_CONTACT && resultCode == RESULT_OK) {
        val contactUri: Uri = data.data
        // Do something with the selected contact at contactUri.
        //...
    }
}

Java

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.
        ...
    }
}

連絡先の URI を受け取った後に連絡先の詳細を取得する方法については、連絡先の詳細を取得するをご覧ください。

このインテントを使用して連絡先の URI を取得する場合、通常、その連絡先の基本的な詳細（表示名や連絡先がスター付きかどうかなど）を読み取る READ_CONTACTS 権限は必要ありません。ただし、特定の連絡先に関するより具体的なデータ（電話番号やメールアドレスなど）を読み取る場合は、READ_CONTACTS 権限が必要です。

特定の連絡先データを選択する

ユーザーが連絡先から特定の情報（電話番号、メールアドレス、その他のデータ型など）を選択できるようにするには、ACTION_PICK アクションを使用して、MIME タイプを次のいずれかのコンテンツタイプに指定します。たとえば、連絡先の電話番号を取得するには CommonDataKinds.Phone.CONTENT_TYPE を指定します。

注: 多くの場合、特定の連絡先に関する特定の情報を表示するには、アプリに READ_CONTACTS 権限が必要です。

連絡先から 1 種類のデータのみを取得する必要がある場合は、前のセクションで説明した Contacts.CONTENT_TYPE を使用するよりも、ContactsContract.CommonDataKinds クラスの CONTENT_TYPE を使用する方が効率的です。これにより、連絡先プロバイダに対してより複雑なクエリを実行することなく、目的のデータに直接アクセスできます。

onActivityResult() コールバックに渡される結果 Intent には、選択した連絡先データを指す content: URI が含まれています。アプリに READ_CONTACTS 権限がなくても、連絡先データを参照する一時的な権限が付与されます。

操作

ACTION_PICK

データ URI スキーム

なし

MIME タイプ

CommonDataKinds.Phone.CONTENT_TYPE: 連絡先から電話番号を取得します。
CommonDataKinds.Email.CONTENT_TYPE: 連絡先からメールアドレスを取得します。
CommonDataKinds.StructuredPostal.CONTENT_TYPE: 連絡先から住所を取得します。

または、ContactsContract で定義されているさまざまな CONTENT_TYPE 値のいずれかを使用します。

例のインテント:

Kotlin

const val REQUEST_SELECT_PHONE_NUMBER = 1

fun selectContact() {
    // Start an activity for the user to pick a phone number from contacts.
    val intent = Intent(Intent.ACTION_PICK).apply {
        type = CommonDataKinds.Phone.CONTENT_TYPE
    }
    if (intent.resolveActivity(packageManager) != null) {
        startActivityForResult(intent, REQUEST_SELECT_PHONE_NUMBER)
    }
}

override fun onActivityResult(requestCode: Int, resultCode: Int, data: Intent) {
    if (requestCode == REQUEST_SELECT_PHONE_NUMBER && resultCode == Activity.RESULT_OK) {
        // Get the URI and query the content provider for the phone number.
        val contactUri: Uri = data.data
        val projection: Array<String> = arrayOf(CommonDataKinds.Phone.NUMBER)
        contentResolver.query(contactUri, projection, null, null, null).use { cursor ->
            // If the cursor returned is valid, get the phone number.
            if (cursor.moveToFirst()) {
                val numberIndex = cursor.getColumnIndex(CommonDataKinds.Phone.NUMBER)
                val number = cursor.getString(numberIndex)
                // Do something with the phone number.
                ...
            }
        }
    }
}

Java

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.
            //...
        }
    }
}

連絡先を表示する

既知の連絡先の詳細を表示するには、ACTION_VIEW アクションを使用し、インテントのデータに content: URI で連絡先を指定します。

まず連絡先の URI を取得する必要がありますが、これには主に 2 つの方法があります。

前のセクションで説明した ACTION_PICK アクションによって返される連絡先 URI を使用します。この方法では、アプリの権限は必要ありません。
連絡先のリストを取得するで説明されている方法を利用して連絡先のリストに直接アクセスします。この方法では、READ_CONTACTS 権限が必要です。

操作: ACTION_VIEW
データ URI スキーム: content:<URI>
MIME タイプ: なし。タイプは連絡先 URI から推測します。

例のインテント:

Kotlin

fun viewContact(contactUri: Uri) {
    val intent = Intent(Intent.ACTION_VIEW, contactUri)
    if (intent.resolveActivity(packageManager) != null) {
        startActivity(intent)
    }
}

Java

public void viewContact(Uri contactUri) {
    Intent intent = new Intent(Intent.ACTION_VIEW, contactUri);
    if (intent.resolveActivity(getPackageManager()) != null) {
        startActivity(intent);
    }
}

既存の連絡先を編集する

既知の連絡先を編集するには、ACTION_EDIT アクションを使用し、インテントのデータに content: URI で連絡先を指定します。さらに、ContactsContract.Intents.Insert 内の定数をエクストラ値に設定し、連絡先詳細情報を指定します。

まず連絡先の URI を取得する必要がありますが、これには主に 2 つの方法があります。

前のセクションで説明した ACTION_PICK アクションによって返される連絡先 URI を使用します。この方法では、アプリの権限は必要ありません。
連絡先のリストを取得するで説明されている方法を利用して連絡先のリストに直接アクセスします。この方法では、READ_CONTACTS 権限が必要です。

操作: ACTION_EDIT
データ URI スキーム: content:<URI>
MIME タイプ: タイプは連絡先 URI から推測されます。
おまけ: ContactsContract.Intents.Insert で定義されているエクストラ値を用いて、連絡先詳細に設定するフィールドを 1 つまたは複数指定します。

例のインテント:

Kotlin

fun editContact(contactUri: Uri, email: String) {
    val intent = Intent(Intent.ACTION_EDIT).apply {
        data = contactUri
        putExtra(ContactsContract.Intents.Insert.EMAIL, email)
    }
    if (intent.resolveActivity(packageManager) != null) {
        startActivity(intent)
    }
}

Java

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);
    }
}

連絡先を編集する方法の詳細については、インテントを使用して連絡先を変更するをご覧ください。

連絡先を挿入する

新しい連絡先を挿入するには、ACTION_INSERT アクションを使用し、MIME タイプに Contacts.CONTENT_TYPE を指定します。さらに、ContactsContract.Intents.Insert 内の定数をエクストラ値に設定し、連絡先詳細情報を指定します。

操作: ACTION_INSERT
データ URI スキーム: なし
MIME タイプ: Contacts.CONTENT_TYPE
おまけ: ContactsContract.Intents.Insert で定義されているエクストラを 1 つ以上指定します。

例のインテント:

Kotlin

fun insertContact(name: String, email: String) {
    val intent = Intent(Intent.ACTION_INSERT).apply {
        type = ContactsContract.Contacts.CONTENT_TYPE
        putExtra(ContactsContract.Intents.Insert.NAME, name)
        putExtra(ContactsContract.Intents.Insert.EMAIL, email)
    }
    if (intent.resolveActivity(packageManager) != null) {
        startActivity(intent)
    }
}

Java

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);
    }
}

連絡先を挿入する方法の詳細については、インテントを使用して連絡先を変更するをご覧ください。

メール

メールアプリでは、添付ファイルを含めたメールを作成する操作が一般的です。次のセクションの情報を使用して、このアクションを実行するアプリの機能をアドバタイズするインテントフィルタを作成します。

メールまたは添付ファイル付きのメールを作成する

メールを作成するには、添付ファイルの有無に応じて次のいずれかのアクションを利用します。さらに、下記のエクストラ値のキーを使用して受信者や件名などのメールの詳細を指定します。

操作

ACTION_SENDTO（添付ファイルがない場合）または
ACTION_SEND（1 つの添付ファイルの場合）または
ACTION_SEND_MULTIPLE（複数の添付ファイルの場合）

データ URI スキーム

なし

MIME タイプ

"text/plain"
"*/*"

おまけ

Intent.EXTRA_EMAIL: 「宛先」としてメールを送信するアドレスを格納した文字列配列です。
Intent.EXTRA_CC: 「CC」としてメールを送信するアドレスを格納した文字列配列です。
Intent.EXTRA_BCC: 「BCC」としてメールを送信するアドレスを格納した文字列配列です。
Intent.EXTRA_SUBJECT: メールの件名となる文字列です。
Intent.EXTRA_TEXT: メールの本文となる文字列です。
Intent.EXTRA_STREAM: 添付ファイルを指す Uri。 ACTION_SEND_MULTIPLE アクションを使用する場合は、複数の Uri オブジェクトを含む ArrayList になります。

例のインテント:

Kotlin

fun composeEmail(addresses: Array<String>, subject: String, attachment: Uri) {
    val intent = Intent(Intent.ACTION_SEND).apply {
        type = "*/*"
        putExtra(Intent.EXTRA_EMAIL, addresses)
        putExtra(Intent.EXTRA_SUBJECT, subject)
        putExtra(Intent.EXTRA_STREAM, attachment)
    }
    if (intent.resolveActivity(packageManager) != null) {
        startActivity(intent)
    }
}

Java

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);
    }
}

テキストメッセージングアプリやソーシャルアプリではなく、メールアプリでのみインテントを処理するようにするには、次の例に示すように、ACTION_SENDTO アクションを使用して "mailto:" データスキームを含めます。

Kotlin

fun composeEmail(addresses: Array<String>, subject: String) {
    val intent = Intent(Intent.ACTION_SENDTO).apply {
        data = Uri.parse("mailto:") // Only email apps handle this.
        putExtra(Intent.EXTRA_EMAIL, addresses)
        putExtra(Intent.EXTRA_SUBJECT, subject)
    }
    if (intent.resolveActivity(packageManager) != null) {
        startActivity(intent)
    }
}

Java

public void composeEmail(String[] addresses, String subject) {
    Intent intent = new Intent(Intent.ACTION_SENDTO);
    intent.setData(Uri.parse("mailto:")); // Only email apps handle this.
    intent.putExtra(Intent.EXTRA_EMAIL, addresses);
    intent.putExtra(Intent.EXTRA_SUBJECT, subject);
    if (intent.resolveActivity(getPackageManager()) != null) {
        startActivity(intent);
    }
}

インテントフィルタの例:

<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>

ファイルストレージ

ファイルストレージアプリの一般的なアクションは次のとおりです。各アクションを実行するアプリの機能をアドバタイズするインテントフィルタを作成するために必要な情報も記載しています。

特定のタイプのファイルを取得する

ユーザーがドキュメントや写真などのファイルを選択した後、アプリでそのファイルへの参照を受け取るには、ACTION_GET_CONTENT アクションを使用して目的の MIME タイプを指定します。アプリに返されるファイル参照は、アクティビティの現在のライフサイクルに対して一時的なものです。後でアクセスするには、後で読み取れるコピーをインポートする必要があります。

このインテントでは、ユーザーがそのプロセスで新しいファイルを作成することもできます。たとえば、既存の写真を撮影する代わりに、カメラで新しい写真を撮影できます。

onActivityResult() メソッドで受け取る結果のインテントには、ユーザーが選択したファイルを指す URI データが含まれています。URI には、http: URI、file: URI、content: URI など、任意の URI を指定できます。ただし、選択できるファイルをあるコンテンツプロバイダ（content: URI）がアクセスできるファイルや openFileDescriptor() によるファイルストリームとして利用できるファイルに限定したい場合は、インテントに CATEGORY_OPENABLE カテゴリを追加します。

Android 4.3（API レベル 18）以降では、インテントに EXTRA_ALLOW_MULTIPLE を追加して true に設定することで、ユーザーが複数のファイルを選択できるようにすることもできます。getClipData() によって返される ClipData オブジェクトから、選択した各ファイルにアクセスできます。

操作

ACTION_GET_CONTENT

データ URI スキーム

なし

MIME タイプ

ユーザーが選択するファイルタイプに対応する MIME タイプ。

おまけ

EXTRA_ALLOW_MULTIPLE: ユーザーが一度に複数のファイルを選択できるかどうかを示すブール値です。
EXTRA_LOCAL_ONLY: リモートサービスからダウンロードすることなくデバイス上で直接アクセスできるファイルを返すべきかどうかを示すブール値です。

カテゴリ（省略可）

CATEGORY_OPENABLE: openFileDescriptor() によるファイルストリームとして利用可能な「開くことができる」ファイルのみを返します。

写真を取得するインテントの例:

Kotlin

const val REQUEST_IMAGE_GET = 1

fun selectImage() {
    val intent = Intent(Intent.ACTION_GET_CONTENT).apply {
        type = "image/*"
    }
    if (intent.resolveActivity(packageManager) != null) {
        startActivityForResult(intent, REQUEST_IMAGE_GET)
    }
}

override fun onActivityResult(requestCode: Int, resultCode: Int, data: Intent) {
    if (requestCode == REQUEST_IMAGE_GET && resultCode == Activity.RESULT_OK) {
        val thumbnail: Bitmap = data.getParcelableExtra("data")
        val fullPhotoUri: Uri = data.data
        // Do work with photo saved at fullPhotoUri.
        ...
    }
}

Java

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.
        ...
    }
}

写真を返すインテントフィルタの例:

<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 OpenableColumns
             and ContentResolver.openFileDescriptor(). -->
        <category android:name="android.intent.category.OPENABLE" />
    </intent-filter>
</activity>

特定のタイプのファイルを開く

Android 4.4 以降で実行する場合、ACTION_GET_CONTENT アクションを使用してアプリにインポートする必要があるファイルのコピーを取得する代わりに、ACTION_OPEN_DOCUMENT アクションを使用して MIME タイプを指定し、別のアプリによって管理されているファイルを開くことをリクエストできます。アプリが書き込みできる新しいドキュメントをユーザーが作成できるようにするには、代わりに ACTION_CREATE_DOCUMENT アクションを使用します。

たとえば、ACTION_CREATE_DOCUMENT インテントを使用すると、ユーザーは既存の PDF ドキュメントを選択する代わりに、新しいドキュメントを作成する場所（ドキュメントのストレージを管理する別のアプリ内など）を選択できます。書き込み可能な新しいドキュメントの場所を示す URI がアプリに返されます。

ACTION_GET_CONTENT アクションから onActivityResult() メソッドに送信されるインテントは任意のタイプの URI を返しますが、ACTION_OPEN_DOCUMENT と ACTION_CREATE_DOCUMENT の結果のインテントでは、選択したファイルは常に DocumentsProvider がサポートする content: URI になります。openFileDescriptor() でファイルを開き、DocumentsContract.Document のカラムを使用して詳細情報をクエリできます。

URI が返されるのと同時に、ファイルへの長期的な読み取りアクセス権限がアプリに付与されます（書き込みアクセス権限も付与される場合があります）。ACTION_OPEN_DOCUMENT アクションは、アプリ内にコピーを作成せずに既存のファイルを読み取りたい場合や、ファイルをその場で開いて編集したい場合に特に便利です。

インテントに EXTRA_ALLOW_MULTIPLE を追加して true に設定すると、ユーザーが複数のファイルを選択できるようにすることもできます。ユーザーが 1 つの項目のみを選択した場合は、getData() から項目を取得できます。ユーザーが複数の項目を選択した場合、getData() は null を返します。この場合は、getClipData() が返す ClipData オブジェクトから各項目を取得する必要があります。

注: インテントでは、MIME タイプの指定と CATEGORY_OPENABLE カテゴリの宣言が必須です。必要に応じて、EXTRA_MIME_TYPES エクストラ値に MIME タイプの配列を追加して複数の MIME タイプを指定することもできます。この場合は、setType() のプライマリ MIME タイプを "*/*" に設定する必要があります。

操作

ACTION_OPEN_DOCUMENT または
ACTION_CREATE_DOCUMENT

データ URI スキーム

なし

MIME タイプ

ユーザーが選択するファイルタイプに対応する MIME タイプ。

おまけ

EXTRA_MIME_TYPES: アプリがリクエストするファイルタイプに対応する MIME タイプの配列。このエクストラを使用する場合は、setType() のプライマリ MIME タイプを "*/*" に設定する必要があります。
EXTRA_ALLOW_MULTIPLE: ユーザーが一度に複数のファイルを選択できるかどうかを示すブール値です。
EXTRA_TITLE: ACTION_CREATE_DOCUMENT で使用して、初期ファイル名を指定します。
EXTRA_LOCAL_ONLY: リモートサービスからダウンロードすることなくデバイス上で直接アクセスできるファイルを返すべきかどうかを示すブール値です。

カテゴリ

CATEGORY_OPENABLE: openFileDescriptor() によるファイルストリームとして利用可能な「開くことができる」ファイルのみを返します。

写真を取得するインテントの例:

Kotlin

const val REQUEST_IMAGE_OPEN = 1

fun selectImage2() {
    val intent = Intent(Intent.ACTION_OPEN_DOCUMENT).apply {
        type = "image/*"
        addCategory(Intent.CATEGORY_OPENABLE)
    }
    // Only the system receives the ACTION_OPEN_DOCUMENT, so no need to test.
    startActivityForResult(intent, REQUEST_IMAGE_OPEN)
}

override fun onActivityResult(requestCode: Int, resultCode: Int, data: Intent) {
    if (requestCode == REQUEST_IMAGE_OPEN && resultCode == Activity.RESULT_OK) {
        val fullPhotoUri: Uri = data.data
        // Do work with full size photo saved at fullPhotoUri.
        ...
    }
}

Java

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.
        ...
    }
}

サードパーティ製アプリは、ACTION_OPEN_DOCUMENT アクションのインテントに応答できません。システムがこのインテントを受信し、統一されたインターフェースで各アプリの全ファイルを表示しています。

アプリ内のファイルをこの UI に表示して別のアプリから開けるようにするには、次の例に示すように、DocumentsProvider を実装して PROVIDER_INTERFACE（"android.content.action.DOCUMENTS_PROVIDER"）用のインテントフィルタを含める必要があります。

<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>

アプリが管理するファイルを別のアプリから開けるようにする方法の詳細については、ストレージアクセスフレームワークを使用してファイルを開くをご覧ください。

ローカルアクション

車を呼ぶことは、一般的なローカルアクションです。次のセクションの情報を使用して、このアクションを実行するアプリの機能をアドバタイズするインテントフィルタを作成します。

タクシーを呼ぶ

Google Voice Actions

「タクシーを呼んで」
「タクシーを呼んで」

（Wear OS のみ）

タクシーを呼ぶには、ACTION_RESERVE_TAXI_RESERVATION アクションを使用します。

注: アプリがこのアクションを完了するには、ユーザーの確認が必要です。

操作: ACTION_RESERVE_TAXI_RESERVATION
データ URI: なし
MIME タイプ: なし
おまけ: なし

例のインテント:

Kotlin

fun callCar() {
    val intent = Intent(ReserveIntents.ACTION_RESERVE_TAXI_RESERVATION)
    if (intent.resolveActivity(packageManager) != null) {
        startActivity(intent)
    }
}

Java

public void callCar() {
    Intent intent = new Intent(ReserveIntents.ACTION_RESERVE_TAXI_RESERVATION);
    if (intent.resolveActivity(getPackageManager()) != null) {
        startActivity(intent);
    }
}

インテントフィルタの例:

<activity ...>
    <intent-filter>
        <action android:name="com.google.android.gms.actions.RESERVE_TAXI_RESERVATION" />
        <category android:name="android.intent.category.DEFAULT" />
    </intent-filter>
</activity>

マップ

地図上の場所を表示することは、地図アプリの一般的なアクションです。次のセクションの情報を使用して、このアクションを実行するアプリの機能をアドバタイズするインテントフィルタを作成します。

地図上の場所を表示する

地図を開くには、ACTION_VIEW アクションを使用して、次のいずれかのスキームでインテントデータに位置情報を指定します。

操作

ACTION_VIEW

データ URI スキーム

geo:latitude,longitude

指定された経度と緯度の地図を表示します。

例: "geo:47.6,-122.3"

geo:latitude,longitude?z=zoom

指定された経度と緯度の地図をあるズームレベルで表示します。ズームレベル 1 では、地球全体が、指定した緯度と経度を中心にして表示されます。最大（もっとも拡大率の高い）ズームレベルは 23 です。

例: "geo:47.6,-122.3?z=11"

geo:0,0?q=lat,lng(label)

指定された経度と緯度の地図を文字列ラベル付きで表示します。

例: "geo:0,0?q=34.99,-106.61(Treasure)"

geo:0,0?q=my+street+address

「my street address」（特定の住所や位置クエリ）の場所を表示します。

例: "geo:0,0?q=1600+Amphitheatre+Parkway%2C+CA"

注: geo URI で渡す文字列はすべてエンコードする必要があります。たとえば、文字列 1st & Pike, Seattle は 1st%20%26%20Pike%2C%20Seattle になります。文字列内のスペースは %20 でエンコードされるか、プラス記号（+）に置き換えられます。

MIME タイプ

なし

例のインテント:

Kotlin

fun showMap(geoLocation: Uri) {
    val intent = Intent(Intent.ACTION_VIEW).apply {
        data = geoLocation
    }
    if (intent.resolveActivity(packageManager) != null) {
        startActivity(intent)
    }
}

Java

public void showMap(Uri geoLocation) {
    Intent intent = new Intent(Intent.ACTION_VIEW);
    intent.setData(geoLocation);
    if (intent.resolveActivity(getPackageManager()) != null) {
        startActivity(intent);
    }
}

インテントフィルタの例:

<activity ...>
    <intent-filter>
        <action android:name="android.intent.action.VIEW" />
        <data android:scheme="geo" />
        <category android:name="android.intent.category.DEFAULT" />
    </intent-filter>
</activity>

音楽または動画

以下は、音楽アプリと動画アプリの一般的なアクションです。各アクションを実行するアプリの機能を宣伝するインテントフィルタを作成するために必要な情報も記載しています。

メディアファイルを再生する

音楽ファイルを再生するには、ACTION_VIEW アクションを使用して、インテントデータにファイルの場所の URI を指定します。

操作

ACTION_VIEW

データ URI スキーム

file:<URI>
content:<URI>
http:<URL>

MIME タイプ

"audio/*"
"application/ogg"
"application/x-ogg"
"application/itunes"
その他、アプリが要求するものであれば何でも構いません。

例のインテント:

Kotlin

fun playMedia(file: Uri) {
    val intent = Intent(Intent.ACTION_VIEW).apply {
        data = file
    }
    if (intent.resolveActivity(packageManager) != null) {
        startActivity(intent)
    }
}

Java

public void playMedia(Uri file) {
    Intent intent = new Intent(Intent.ACTION_VIEW);
    intent.setData(file);
    if (intent.resolveActivity(getPackageManager()) != null) {
        startActivity(intent);
    }
}

インテントフィルタの例:

<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>

検索クエリから音楽を再生する

Google Voice Actions

「play michael jackson billie jean」

検索クエリに基づいて音楽を再生するには、INTENT_ACTION_MEDIA_PLAY_FROM_SEARCH インテントを使用します。アプリは、音楽を再生するユーザーの音声コマンドへの応答としてこのインテントを呼び出すことができます。このインテントを受信したアプリは、指定されたクエリに該当する既存のコンテンツを検索し、再生を開始します。

このインテントには、検索モードを指定する EXTRA_MEDIA_FOCUS 文字列エクストラを含めます。たとえば、検索モードでは、アーティスト名で検索するか、曲名で検索するかを指定できます。

操作

INTENT_ACTION_MEDIA_PLAY_FROM_SEARCH

データ URI スキーム

なし

MIME タイプ

なし

おまけ

MediaStore.EXTRA_MEDIA_FOCUS（必須）

検索モード（ユーザーが特定のアーティスト、アルバム、曲、プレイリストを検索しているかどうか）を指定します。ほとんどの検索モードでは、追加のエクストラ値が必要になります。たとえば、ユーザーが特定の曲を聴きたい場合、曲名、アーティスト、アルバムという 3 つのエクストラ値がインテントに指定される可能性があります。このインテントは、EXTRA_MEDIA_FOCUS の値ごとに次の検索モードをサポートしています。

すべて - "vnd.android.cursor.item/*"

任意の音楽を再生します。インテントを受け取るアプリは、適切な方法（ユーザーが直近に聴いたプレイリストなど）で音楽を選択して再生します。

追加のエクストラ値

QUERY（必須）: 空の文字列。このエクストラ値は下方互換性を提供するためのものです。検索モードを判別できない既存のアプリは、このインテントを非構造化検索として処理する場合があります。

非構造化 - "vnd.android.cursor.item/*"

非構造化検索クエリから、特定の曲、アルバム、ジャンルのいずれかを再生します。ユーザーが聴きたいコンテンツのタイプをアプリで特定できない場合は、この検索モードでインテントを生成できます。可能な場合は、具体的な検索モードを使用します。

追加のエクストラ値

QUERY（必須）: アーティスト、アルバム、曲名、ジャンルを自由に組み合わせた文字列です。

ジャンル - Audio.Genres.ENTRY_CONTENT_TYPE

特定のジャンルの音楽を再生します。

追加のエクストラ値

"android.intent.extra.genre"（必須）: ジャンルです。
QUERY（必須）: ジャンル。このエクストラ値は下方互換性を提供するためのものです。検索モードを判別できない既存のアプリは、このインテントを非構造化検索として処理する場合があります。

アーティスト - Audio.Artists.ENTRY_CONTENT_TYPE

特定のアーティストの音楽を再生します。

追加のエクストラ値

EXTRA_MEDIA_ARTIST（必須）: アーティスト。
"android.intent.extra.genre": ジャンル。
QUERY（必須）: アーティストとジャンルを自由に組み合わせた文字列です。このエクストラ値は下位互換性を提供するためのものです。検索モードを判別できない既存のアプリは、このインテントを非構造化検索として処理する場合があります。

アルバム - Audio.Albums.ENTRY_CONTENT_TYPE

特定のアルバムの音楽を再生します。

追加のエクストラ値

EXTRA_MEDIA_ALBUM（必須）: アルバム。
EXTRA_MEDIA_ARTIST: アーティスト。
"android.intent.extra.genre": ジャンル。
QUERY（必須）: アルバムとアーティストを自由に組み合わせた文字列です。このエクストラは下位互換性を確保するために常に提供されます。検索モードを判別できない既存のアプリは、このインテントを非構造化検索として処理する場合があります。

曲 - "vnd.android.cursor.item/audio"

特定の曲を再生します。

追加のエクストラ値

EXTRA_MEDIA_ALBUM: アルバム。
EXTRA_MEDIA_ARTIST: アーティスト。
"android.intent.extra.genre": ジャンル。
EXTRA_MEDIA_TITLE（必須）: 曲名。
QUERY（必須）: アルバム、アーティスト、ジャンル、曲名を自由に組み合わせた文字列です。このエクストラは下位互換性を確保するために常に提供されます。検索モードを判別できない既存のアプリは、このインテントを非構造化検索として処理する場合があります。

再生リスト - Audio.Playlists.ENTRY_CONTENT_TYPE

特定のプレイリストまたは追加エクストラ値で指定された条件に一致するプレイリストを再生します。

追加のエクストラ値

EXTRA_MEDIA_ALBUM: アルバム。
EXTRA_MEDIA_ARTIST: アーティスト。
"android.intent.extra.genre": ジャンル。
"android.intent.extra.playlist": 再生リスト。
EXTRA_MEDIA_TITLE: プレイリストのベースとなる曲名。
QUERY（必須）: アルバム、アーティスト、ジャンル、プレイリスト、曲名を自由に組み合わせた文字列です。このエクストラ値は下方互換性を提供するためのものです。検索モードを判別できない既存のアプリは、このインテントを非構造化検索として処理する場合があります。

例のインテント:

ユーザーが特定のアーティストの音楽を聴きたい場合、検索を行うアプリは次のようなインテントを生成することができます。

Kotlin

fun playSearchArtist(artist: String) {
    val intent = Intent(MediaStore.INTENT_ACTION_MEDIA_PLAY_FROM_SEARCH).apply {
        putExtra(MediaStore.EXTRA_MEDIA_FOCUS, MediaStore.Audio.Artists.ENTRY_CONTENT_TYPE)
        putExtra(MediaStore.EXTRA_MEDIA_ARTIST, artist)
        putExtra(SearchManager.QUERY, artist)
    }
    if (intent.resolveActivity(packageManager) != null) {
        startActivity(intent)
    }
}

Java

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);
    }
}

インテントフィルタの例:

<activity ...>
    <intent-filter>
        <action android:name="android.media.action.MEDIA_PLAY_FROM_SEARCH" />
        <category android:name="android.intent.category.DEFAULT" />
    </intent-filter>
</activity>

アクティビティでこのインテントを処理する場合は、受信した Intent の EXTRA_MEDIA_FOCUS エクストラの値を確認して検索モードを決定します。アクティビティで検索モードを判定した後に、その検索モード用の追加エクストラ値を読み込みます。アプリはこの情報を使用してコンテンツを検索し、検索クエリに一致するコンテンツを再生します。次の例はこのメソッドを示しています。

Kotlin

override fun onCreate(savedInstanceState: Bundle?) {
    ...
    if (intent.action.compareTo(MediaStore.INTENT_ACTION_MEDIA_PLAY_FROM_SEARCH) == 0) {

        val mediaFocus: String? = intent.getStringExtra(MediaStore.EXTRA_MEDIA_FOCUS)
        val query: String? = intent.getStringExtra(SearchManager.QUERY)

        // Some of these extras might not be available depending on the search mode.
        val album: String? = intent.getStringExtra(MediaStore.EXTRA_MEDIA_ALBUM)
        val artist: String? = intent.getStringExtra(MediaStore.EXTRA_MEDIA_ARTIST)
        val genre: String? = intent.getStringExtra("android.intent.extra.genre")
        val playlist: String? = intent.getStringExtra("android.intent.extra.playlist")
        val title: String? = intent.getStringExtra(MediaStore.EXTRA_MEDIA_TITLE)

        // Determine the search mode and use the corresponding extras.
        when {
            mediaFocus == null -> {
                // 'Unstructured' search mode (backward compatible)
                playUnstructuredSearch(query)
            }
            mediaFocus.compareTo("vnd.android.cursor.item/*") == 0 -> {
                if (query?.isNotEmpty() == true) {
                    // 'Unstructured' search mode.
                    playUnstructuredSearch(query)
                } else {
                    // 'Any' search mode.
                    playResumeLastPlaylist()
                }
            }
            mediaFocus.compareTo(MediaStore.Audio.Genres.ENTRY_CONTENT_TYPE) == 0 -> {
                // 'Genre' search mode.
                playGenre(genre)
            }
            mediaFocus.compareTo(MediaStore.Audio.Artists.ENTRY_CONTENT_TYPE) == 0 -> {
                // 'Artist' search mode.
                playArtist(artist, genre)
            }
            mediaFocus.compareTo(MediaStore.Audio.Albums.ENTRY_CONTENT_TYPE) == 0 -> {
                // 'Album' search mode.
                playAlbum(album, artist)
            }
            mediaFocus.compareTo("vnd.android.cursor.item/audio") == 0 -> {
                // 'Song' search mode.
                playSong(album, artist, genre, title)
            }
            mediaFocus.compareTo(MediaStore.Audio.Playlists.ENTRY_CONTENT_TYPE) == 0 -> {
                // 'Playlist' search mode.
                playPlaylist(album, artist, genre, playlist, title)
            }
        }
    }
}

Java

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 might 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);
        }
    }
}

新しいメモ

メモの作成は、メモ作成アプリの一般的なアクションです。次のセクションの情報を使用して、このアクションを実行するアプリの機能をアドバタイズするインテントフィルタを作成します。

メモを作成する

新しいノートを作成するには、 ACTION_CREATE_NOTE アクションを使用し、件名やテキストなどのノートの詳細を以下のエクストラで指定します。

注: アプリがこのアクションを完了するには、ユーザーの確認が必要です。

操作

ACTION_CREATE_NOTE

データ URI スキーム

なし

MIME タイプ

PLAIN_TEXT_TYPE

"*/*"

おまけ

EXTRA_NAME: ノートのタイトルまたは件名を示す文字列です。
EXTRA_TEXT: ノートのテキストを示す文字列です。

例のインテント:

Kotlin

fun createNote(subject: String, text: String) {
    val intent = Intent(NoteIntents.ACTION_CREATE_NOTE).apply {
        putExtra(NoteIntents.EXTRA_NAME, subject)
        putExtra(NoteIntents.EXTRA_TEXT, text)
    }
    if (intent.resolveActivity(packageManager) != null) {
        startActivity(intent)
    }
}

Java

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);
    }
}

インテントフィルタの例:

<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>

電話

通話の開始は、スマートフォンアプリの一般的なアクションです。次のセクションの情報を使用して、このアクションを実行するアプリの機能をアドバタイズするインテントフィルタを作成します。

電話をかける

電話アプリを開いて電話番号をダイヤルするには、ACTION_DIAL アクションを使用して、次の URI スキームで電話番号を指定します。電話アプリが開くと電話番号が表示されます。ユーザーは通話ボタンをタップして通話を始める必要があります。

Google Voice Actions

「555-5555 に電話して」
「bob に電話して」
「ボイスメールに電話」

直接電話をかけるには、ACTION_CALL アクションを使用して、次の URI スキームで電話番号を指定します。電話アプリが開くと、通話が開始されます。ユーザーは [通話] ボタンをタップする必要はありません。

ACTION_CALL アクションを使用する場合は、CALL_PHONE 権限をマニフェストファイルに追加する必要があります。

<uses-permission android:name="android.permission.CALL_PHONE" />

操作

ACTION_DIAL - ダイヤラーまたは電話アプリを開きます。
ACTION_CALL - 電話をかけます（CALL_PHONE 権限が必要です）

データ URI スキーム

tel:<phone-number>
voicemail:<phone-number>

MIME タイプ

なし

有効な電話番号は、IETF RFC 3966 で定義されている番号です。有効な例:

tel:2125551212
tel:(212) 555 1212

電話アプリのダイヤラーは、電話番号などのスキームを正規化することができます。そのため、Uri.parse() メソッドには、厳密に記載されたスキームが要求されるわけではありません。ただし、スキームを試したことがない、または処理できるかどうか不明な場合は、代わりに Uri.fromParts() メソッドを使用します。

例のインテント:

Kotlin

fun dialPhoneNumber(phoneNumber: String) {
    val intent = Intent(Intent.ACTION_DIAL).apply {
        data = Uri.parse("tel:$phoneNumber")
    }
    if (intent.resolveActivity(packageManager) != null) {
        startActivity(intent)
    }
}

Java

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);
    }
}

検索

以下に、検索アプリの一般的なアクションを示します。各アクションを実行するアプリの機能を宣伝するインテントフィルタを作成するために必要な情報も記載しています。

特定のアプリを使用して検索する

Google Voice Actions

「search for cat videos on myvideoapp」

アプリ内部の検索をサポートするには、次のインテントフィルタの例に示すように、アプリで SEARCH_ACTION アクションのインテントフィルタを宣言します。

注: アプリ検索に SEARCH_ACTION を使用することはおすすめしません。代わりに、GET_THING アクションを実装して、Google アシスタントのアプリ内検索の組み込みサポートを活用します。詳しくは、Google アシスタントのアプリ操作のドキュメントをご覧ください。

操作

"com.google.android.gms.actions.SEARCH_ACTION": Google Voice Actions の検索クエリをサポートします。

おまけ

QUERY: 検索クエリを含む文字列。

インテントフィルタの例:

<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>

ウェブ検索を行う

ウェブ検索を開始するには、ACTION_WEB_SEARCH アクションを使用して、SearchManager.QUERY エクストラ値で検索文字列を指定します。

操作

ACTION_WEB_SEARCH

データ URI スキーム

なし

MIME タイプ

なし

おまけ

SearchManager.QUERY: 検索文字列。

例のインテント:

Kotlin

fun searchWeb(query: String) {
    val intent = Intent(Intent.ACTION_WEB_SEARCH).apply {
        putExtra(SearchManager.QUERY, query)
    }
    if (intent.resolveActivity(packageManager) != null) {
        startActivity(intent)
    }
}

Java

public void searchWeb(String query) {
    Intent intent = new Intent(Intent.ACTION_WEB_SEARCH);
    intent.putExtra(SearchManager.QUERY, query);
    if (intent.resolveActivity(getPackageManager()) != null) {
        startActivity(intent);
    }
}

設定

ユーザーに何らかの設定を変えてもらうためにシステム設定アプリの画面を開くには、次のインテントアクションのいずれかを使用します。

操作: ACTION_SETTINGS
ACTION_WIRELESS_SETTINGS
ACTION_AIRPLANE_MODE_SETTINGS
ACTION_WIFI_SETTINGS
ACTION_APN_SETTINGS
ACTION_BLUETOOTH_SETTINGS
ACTION_DATE_SETTINGS
ACTION_LOCALE_SETTINGS
ACTION_INPUT_METHOD_SETTINGS
ACTION_DISPLAY_SETTINGS
ACTION_SECURITY_SETTINGS
ACTION_LOCATION_SOURCE_SETTINGS
ACTION_INTERNAL_STORAGE_SETTINGS
ACTION_MEMORY_CARD_SETTINGS

利用可能なその他の設定画面については、Settings のドキュメントをご覧ください。
データ URI スキーム: なし
MIME タイプ: なし

例のインテント:

Kotlin

fun openWifiSettings() {
    val intent = Intent(Settings.ACTION_WIFI_SETTINGS)
    if (intent.resolveActivity(packageManager) != null) {
        startActivity(intent)
    }
}

Java

public void openWifiSettings() {
    Intent intent = new Intent(Settings.ACTION_WIFI_SETTINGS);
    if (intent.resolveActivity(getPackageManager()) != null) {
        startActivity(intent);
    }
}

テキストメッセージ

添付ファイル付きの SMS/MMS メッセージを作成することは、テキストメッセージアプリの一般的なアクションです。次のセクションの情報を使用して、このアクションを実行するアプリの機能をアドバタイズするインテントフィルタを作成します。

添付ファイル付きの SMS/MMS メッセージを作成する

SMS または MMS でテキストメッセージを作成するには、次のインテントアクションのいずれかを使用し、電話番号、件名、メッセージ本文などの詳細情報を次のエクストラキーで指定します。

操作

ACTION_SENDTO または
ACTION_SEND または
ACTION_SEND_MULTIPLE

データ URI スキーム

sms:<phone_number>
smsto:<phone_number>
mms:<phone_number>
mmsto:<phone_number>

これらのスキームはすべて同じように処理されます。

MIME タイプ

"text/plain"
"image/*"
"video/*"

おまけ

"subject": メッセージの件名を示す文字列です（通常は MMS にのみ使用します）。
"sms_body": テキストメッセージの文字列。
EXTRA_STREAM: 添付する画像または動画を指す Uri。ACTION_SEND_MULTIPLE アクションを使用する場合、このエクストラは、添付する画像または動画を指す Uri オブジェクトの ArrayList です。

例のインテント:

Kotlin

fun composeMmsMessage(message: String, attachment: Uri) {
    val intent = Intent(Intent.ACTION_SENDTO).apply {
        type = HTTP.PLAIN_TEXT_TYPE
        putExtra("sms_body", message)
        putExtra(Intent.EXTRA_STREAM, attachment)
    }
    if (intent.resolveActivity(packageManager) != null) {
        startActivity(intent)
    }
}

Java

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);
    }
}

他のメールアプリやソーシャルアプリではなく、テキストメッセージングアプリでのみインテントを処理するようにしたい場合は、次の例に示すように、ACTION_SENDTO アクションを使用して "smsto:" データスキームを含めます。

Kotlin

fun composeMmsMessage(message: String, attachment: Uri) {
    val intent = Intent(Intent.ACTION_SEND).apply {
        data = Uri.parse("smsto:")  // Only SMS apps respond to this.
        putExtra("sms_body", message)
        putExtra(Intent.EXTRA_STREAM, attachment)
    }
    if (intent.resolveActivity(packageManager) != null) {
        startActivity(intent)
    }
}

Java

public void composeMmsMessage(String message, Uri attachment) {
    Intent intent = new Intent(Intent.ACTION_SEND);
    intent.setData(Uri.parse("smsto:"));  // Only SMS apps respond to this.
    intent.putExtra("sms_body", message);
    intent.putExtra(Intent.EXTRA_STREAM, attachment);
    if (intent.resolveActivity(getPackageManager()) != null) {
        startActivity(intent);
    }
}

インテントフィルタの例:

<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>

注: SMS/MMS メッセージングアプリを開発していて、Android 4.4 以降でデフォルトの SMS アプリにできるようにする場合は、他にいくつかのアクション用のインテントフィルタを実装する必要があります。詳細については、Telephony のドキュメントをご覧ください。

ウェブブラウザ

ウェブ URL の読み込みは、ウェブブラウザアプリの一般的なアクションです。次のセクションの情報を使用して、このアクションを実行するアプリの機能をアドバタイズするインテントフィルタを作成します。

URL からウェブページを読み込む

Google Voice Actions

「open example.com」

ウェブページを開くには、ACTION_VIEW アクションを使用して、インテントデータでウェブの URL を指定します。

操作

ACTION_VIEW

データ URI スキーム

http:<URL>
https:<URL>

MIME タイプ

"text/plain"
"text/html"
"application/xhtml+xml"
"application/vnd.wap.xhtml+xml"

例のインテント:

Kotlin

fun openWebPage(url: String) {
    val webpage: Uri = Uri.parse(url)
    val intent = Intent(Intent.ACTION_VIEW, webpage)
    if (intent.resolveActivity(packageManager) != null) {
        startActivity(intent)
    }
}

Java

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);
    }
}

インテントフィルタの例:

<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>

ヒント: Android アプリでウェブサイトと同じ機能を提供したい場合は、ウェブサイトの URL をインテントフィルタに指定する必要があります。その場合、ユーザーがアプリをインストールし、メールや他のウェブページにあるウェブサイトへのリンクを開くと、ウェブページではなく Android アプリが開くようになります。詳しくは、Android アプリリンクの処理をご覧ください。

Android 12（API レベル 31）以降、一般的なウェブインテントは、そのウェブインテントに含まれる特定のドメインについてアプリが承認されている場合のみ、アプリのアクティビティに解決されます。アプリがそのドメインに対して承認されていない場合、ウェブインテントは代わりにユーザーのデフォルトのブラウザアプリに解決されます。

Android Debug Bridge でインテントを検証する

サポートしたいインテントにアプリが応答することを検証するには、adb ツールを使用して、次の手順で特定のインテントを呼び出します。

開発用の Android デバイスをセットアップするか、仮想デバイスを使用します。
サポートしたいインテントを処理するようにしたバージョンのアプリをインストールします。

adb を使用してインテントを呼び出します。

adb shell am start -a <ACTION> -t <MIME_TYPE> -d <DATA> \
  -e <EXTRA_NAME> <EXTRA_VALUE> -n <ACTIVITY>

例:

adb shell am start -a android.intent.action.DIAL \
  -d tel:555-5555 -n org.example.MyApp/.MyActivity

必要なインテントフィルタを定義したら、インテントを処理します。

詳細については、シェルコマンドを発行するをご覧ください。

一般的なインテント

Google Voice Actions

目覚まし時計

アラームを作成

Kotlin

Java

タイマーを作成する

Kotlin

Java

アラームをすべて表示

カレンダー

カレンダーに予定を追加する

Kotlin

Java

カメラ

写真やビデオを撮影して返却する

Kotlin

Java

Kotlin

Java

静止画モードでカメラアプリを起動する

Kotlin

Java

ビデオモードでカメラアプリを起動する

Kotlin

Java

連絡先/連絡帳アプリ

連絡先の選択

Kotlin

Java

特定の連絡先データを選択する

Kotlin

Java

連絡先を表示する

Kotlin

Java

既存の連絡先を編集する

Kotlin

Java

連絡先を挿入する

Kotlin

Java

メール

メールまたは添付ファイル付きのメールを作成する

Kotlin

Java

Kotlin

Java

ファイル ストレージ

特定のタイプのファイルを取得する

Kotlin

Java

特定のタイプのファイルを開く

Kotlin

Java

ローカル アクション

タクシーを呼ぶ

Kotlin

Java

マップ

地図上の場所を表示する

Kotlin

Java

音楽または動画

メディア ファイルを再生する

Kotlin

Java

検索クエリから音楽を再生する

Kotlin

Java

Kotlin

Java

新しいメモ

メモを作成する

Kotlin

Java

電話

電話をかける

Kotlin

Java

ファイルストレージ

ローカルアクション

メディアファイルを再生する

テキストメッセージ