一般的なインテント

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

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 タイプ

なし

おまけ

なし

例のインテント:

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

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 タイプ

なし

おまけ

なし

例のインテント:

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

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

例のインテント:

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

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 値のいずれか。

例のインテント:

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

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 から推測されます。

例のインテント:

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

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 つ以上のエクストラ。連絡先情報のフィールドに入力できます。

例のインテント:

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

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 つ以上指定します。

例のインテント:

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

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

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

メール

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

添付ファイル（任意）を含むメールを作成する

メールを作成するには、添付ファイルを含めるかどうかに応じて次のいずれかのアクションを使用し、リストされている追加キーを使用して、受信者や件名などのメールの詳細を指定します。

操作

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

データ URI スキーム

なし

MIME タイプ

"text/plain"

"*/*"

おまけ

Intent.EXTRA_EMAIL

すべての「To」受信者のメールアドレスの文字列配列。

Intent.EXTRA_CC

すべての「CC」受信者のメールアドレスの文字列配列。

Intent.EXTRA_BCC

すべての「BCC」受信者のメールアドレスの文字列配列。

Intent.EXTRA_SUBJECT

メールの件名を含む文字列。

Intent.EXTRA_TEXT

メールの本文を含む文字列。

Intent.EXTRA_STREAM

添付ファイルを指す Uri。ACTION_SEND_MULTIPLE アクションを使用する場合は、複数の Uri オブジェクトを含む ArrayList になります。

例のインテント:

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

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:" データ スキームを含めます。

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

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() メソッドに配信される結果の Intent には、ファイルを指す 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() でファイル ストリームとして表すことができる「開くことができる」ファイルのみを返します。

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

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

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() でファイル ストリームとして表すことができる「開くことができる」ファイルのみを返します。

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

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

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 タイプ

なし

おまけ

なし

例のインテント:

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

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

「私の住所」の場所を表示します。これは、特定の住所または場所のクエリにすることができます。

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

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

MIME タイプ

なし

例のインテント:

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

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"

または、アプリで必要なその他の権限。

例のインテント:

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

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（必須）

検索モード（ユーザーが特定のアーティスト、アルバム、曲、プレイリストを検索しているかどうか）を示します。ほとんどの検索モードでは、追加の extras が必要です。たとえば、ユーザーが特定の曲を聴きたい場合、インテントには曲のタイトル、アーティスト、アルバムの 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（必須）: アルバム、アーティスト、ジャンル、プレイリスト、タイトルの組み合わせを含む文字列。この余分な部分は、下位互換性を確保するために常に提供されます。検索モードを認識していない既存のアプリは、このインテントを非構造化検索として処理できます。

例のインテント:

ユーザーが特定のアーティストの音楽を聴きたい場合、検索アプリは次のインテントを生成します。

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

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 エクストラの値を確認し、検索モードを決定します。アクティビティが検索モードを特定したら、その特定の検索モードの追加エクストラの値を読み取ります。この情報に基づいて、アプリは広告枠内で検索を実行し、検索語句に一致するコンテンツを再生できます。次の例はこのメソッドを示しています。

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

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 に電話して」
• 「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 音声操作

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

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

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

操作

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

• 「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 ツールを使用して、次の手順で特定のインテントをトリガーします。

1. 開発用に Android デバイスをセットアップするか、仮想デバイスを使用します。
2. サポートするインテントを処理するバージョンのアプリをインストールします。
3. 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
   

4. 必要なインテント フィルタを定義した場合は、インテントを処理します。

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