Google は AI 技術を使用して、コンテンツをご希望の言語に翻訳しています。AI 翻訳には誤りが含まれる場合があります。

一般的なインテント

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

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

このページでは、一般的なアクションを実行するために使用できる暗黙的インテントを、インテントを処理するアプリの種類別に紹介します。また、各セクションでは、インテントフィルタを作成して、アプリがアクションを実行できることを通知する方法についても説明します。

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

インテントやインテントフィルタの作成方法に詳しくない場合は、まずインテントとインテントフィルタをご覧ください。

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

Google 音声操作

Google 音声操作は、音声コマンドに応じて、このページに記載されているインテントの一部を呼び出します。詳細については、システム音声操作を使ってみるをご覧ください。

目覚まし時計

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

アラームを作成する

Google 音声操作

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

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

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

操作

ACTION_SET_ALARM

データ URI

なし

MIME タイプ

なし

エクストラ

EXTRA_HOUR: アラームの時刻。
EXTRA_MINUTES: アラームの分。
EXTRA_MESSAGE: アラームを識別するためのカスタムメッセージ。
EXTRA_DAYS: このアラームを繰り返す各曜日を含む ArrayList。各曜日は、Calendar クラスの整数（MONDAY など）で宣言する必要があります。
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 音声操作

「タイマーを 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 音声操作

「写真を撮って」

静止画モードでカメラアプリを開くには、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 音声操作

「動画を録画して」

動画モードでカメラアプリを開くには、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 権限が含まれていなくても、連絡先プロバイダ 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 など、何でもかまいません。ただし、選択可能なファイルを、コンテンツプロバイダ（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>

特定の種類のファイルを開く

ACTION_GET_CONTENT アクションを使用してアプリにインポートする必要があるファイルのコピーを取得する代わりに、Android 4.4 以降で実行する場合は、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 音声操作

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

（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 では、指定された lat、lng を中心に地球全体が表示されます。最大（最も近い）ズームレベルは 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 音声操作

「マイケルジャクソンのビリージーンを再生して」

検索クエリに基づいて音楽を再生するには、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 の値ごとに次の検索モードをサポートしています。

Any - "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 で指定された条件に一致するプレイリストを再生します。

その他の追加料金:

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 音声操作

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

直接電話をかけるには、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 音声操作

「myvideoapp で猫の動画を検索して」

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

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

操作

"com.google.android.gms.actions.SEARCH_ACTION": Google 音声操作からの検索クエリをサポートします。

エクストラ

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 音声操作

「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 音声操作

目覚まし時計

アラームを作成する

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

一般的なインテント

ファイルストレージ

ローカルアクション

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

テキストメッセージ