他のアプリにシンプルなデータを送信する

Android では、インテントとそれに関連する追加機能を使用することにより、ユーザーがアプリで情報をすばやく簡単に共有できるようになっています。

Android では、ユーザーがアプリ間でデータを共有するのに、2 つの方法があります。

  • Android Sharesheet は主に、コンテンツをアプリ外に送信したり、コンテンツを直接別のユーザーに送信したりするために設計されています。たとえば、友人との URL の共有などです。
  • Android インテント リゾルバは、明確に定義されたタスクの次の段階にデータを渡すのに最適です。たとえば、アプリから PDF を開き、ユーザーにビューアを選択させるなどです。

インテントを作成するときに、インテントに実行させるアクションを指定します。Android は、アクション ACTION_SEND を使用して、あるアクティビティから別のアクティビティにデータを送信します。このとき、プロセス境界を越えることもできます。データとそのタイプを指定する必要があります。システムにより、データを受信できる互換性のあるアクティビティが自動的に識別され、ユーザーに表示されます。インテント リゾルバの場合、インテントを処理できるアクティビティが 1 つだけであれば、そのアクティビティがすぐに開始されます。

Android Sharesheet を使用する理由

Android Sharesheet を使用して、ユーザーに対するアプリ間での一貫性を持たせることを強くおすすめします。アプリ独自の共有ターゲットのリストを表示したり、独自の Sharesheet バリエーションを作成したりしないでください。

Android Sharesheet を使用すると、ユーザーは適切な人と情報を共有できます。このとき、関連するアプリが推奨され、すべて 1 回のタップで行うことができます。Sharesheet は、カスタム ソリューションでは利用できないターゲットを、一貫したランキングでおすすめします。これは、Sharesheet が、システムでのみ利用可能な、アプリとユーザーのアクティビティに関する情報を考慮できるためです。

また、Android Sharesheet には、デベロッパーにとって便利な機能が多数あります。たとえば、次の操作を行います。

Android Sharesheet を使用する

すべてのタイプの共有について、インテントを作成し、そのアクションを Intent.ACTION_SEND に設定します。Android Sharesheet を表示するには、Intent.createChooser() を呼び出し、その際に作成した Intent オブジェクトを渡します。常に Android Sharesheet を表示するバージョンのインテントが返されます。

テキスト コンテンツを送信する

最も簡単で一般的な Android Sharesheet の使用方法は、あるアクティビティから別のアクティビティにテキスト コンテンツを送信することです。たとえば、ほとんどのブラウザは、現在表示されているページの URL をテキストとして別のアプリと共有できます。これは、メールやソーシャル ネットワークで友人と記事やウェブサイトを共有するのに便利です。以下はその方法の例です。

Kotlin

val sendIntent: Intent = Intent().apply {
    action = Intent.ACTION_SEND
    putExtra(Intent.EXTRA_TEXT, "This is my text to send.")
    type = "text/plain"
}

val shareIntent = Intent.createChooser(sendIntent, null)
startActivity(shareIntent)

Java

Intent sendIntent = new Intent();
sendIntent.setAction(Intent.ACTION_SEND);
sendIntent.putExtra(Intent.EXTRA_TEXT, "This is my text to send.");
sendIntent.setType("text/plain");

Intent shareIntent = Intent.createChooser(sendIntent, null);
startActivity(shareIntent);

必要に応じて、メールの宛先（EXTRA_EMAIL、EXTRA_CC、EXTRA_BCC）や件名（EXTRA_SUBJECT）などの情報を、補足情報として追加できます。

注: Gmail などの一部のメールアプリは、EXTRA_EMAIL や EXTRA_CC のような補足情報に String[] を想定しています。putExtra(String, String[]) を使用して、これらの値をインテントに追加します。

バイナリ コンテンツを送信する

ACTION_SEND アクションを使用してバイナリデータを共有します。次の例に示すように、適切な MIME タイプを設定し、補足情報 EXTRA_STREAM にデータへの URI を入れます。これは通常、画像の共有に使用されますが、任意のバイナリ コンテンツの共有にも使用できます。

Kotlin

val shareIntent: Intent = Intent().apply {
    action = Intent.ACTION_SEND
    // Example: content://com.google.android.apps.photos.contentprovider/...
    putExtra(Intent.EXTRA_STREAM, uriToImage)
    type = "image/jpeg"
}
startActivity(Intent.createChooser(shareIntent, null))

Java

Intent shareIntent = new Intent();
shareIntent.setAction(Intent.ACTION_SEND);
// Example: content://com.google.android.apps.photos.contentprovider/...
shareIntent.putExtra(Intent.EXTRA_STREAM, uriToImage);
shareIntent.setType("image/jpeg");
startActivity(Intent.createChooser(shareIntent, null));

受信アプリケーションには、Uri が指すデータへのアクセス権が必要です。これにはおすすめの方法が 2 つあります。

  • 自分の ContentProvider にデータを保存し、他のアプリがこのプロバイダにアクセスするための正しい権限を持つようにする。アクセス権を与えるためのおすすめの方法は、受信アプリケーションへのアクセス権だけを付与する一時的な URI ごとのパーミッションを使用することです。FileProvider ヘルパークラスを使用すると、このような ContentProvider を簡単に作成できます。
  • システム MediaStore を使用します。MediaStore は主に動画、音声、画像の MIME タイプ用です。ただし、Android 3.0（API レベル 11）以降では、メディア以外のタイプも保存できるようになりました。詳細については、MediaStore.Files をご覧ください。ファイルは、scanFile() を使用して MediaStore に挿入できます。その後、共有に適した content:// スタイルの Uri が、指定された onScanCompleted() コールバックに渡されます。システム MediaStore に追加されると、そのコンテンツはデバイス上のすべてのアプリからアクセスできるようになることに注意してください。

正しい MIME タイプを使用する

送信するデータに使用できる最も限定的な MIME タイプを指定します。たとえば、書式なしテキストを共有する場合は text/plain を使用します。Android 内でシンプルなデータを送信する際の一般的な MIME タイプを以下に示します。

受信者が登録する 送信者からの送信
text/*
  • text/plain
  • text/rtf
  • text/html
  • text/json
`image/*`
  • image/jpg
  • image/png
  • image/gif
video/*
  • video/mp4
  • video/3gp
サポートされているファイル拡張子 application/pdf

MIME タイプの詳細については、MIME メディアタイプの IANA 公式レジストリをご覧ください。

Android Sharesheet は、指定された MIME タイプに応じてコンテンツのプレビューを表示する場合があります。一部のプレビュー機能は、特定のタイプでのみ使用できます。

複数のコンテンツを共有する

複数のコンテンツを共有するには、ACTION_SEND_MULTIPLE アクションをそのコンテンツを指す URI のリストとともに使用します。MIME タイプは、共有しようとしているコンテンツの組み合わせによって異なります。たとえば、3 つの JPEG 画像を共有する場合は、タイプ "image/jpg" を使用します。画像タイプが混在している場合は、"image/*" を使用して、任意のタイプの画像を処理するアクティビティを照合します。タイプを混在させて共有することは可能ですが、受信者にとって何が送られるのか不明確になるため、行わないことを強くおすすめします。複数のタイプを送信する必要がある場合は、"*/*" を使用します。データの解析と処理は、受信アプリケーションで行います。次の例をご覧ください。

Kotlin

val imageUris: ArrayList<Uri> = arrayListOf(
        // Add your image URIs here
        imageUri1,
        imageUri2
)

val shareIntent = Intent().apply {
    action = Intent.ACTION_SEND_MULTIPLE
    putParcelableArrayListExtra(Intent.EXTRA_STREAM, imageUris)
    type = "image/*"
}
startActivity(Intent.createChooser(shareIntent, null))

Java

ArrayList<Uri> imageUris = new ArrayList<Uri>();
imageUris.add(imageUri1); // Add your image URIs here
imageUris.add(imageUri2);

Intent shareIntent = new Intent();
shareIntent.setAction(Intent.ACTION_SEND_MULTIPLE);
shareIntent.putParcelableArrayListExtra(Intent.EXTRA_STREAM, imageUris);
shareIntent.setType("image/*");
startActivity(Intent.createChooser(shareIntent, null));

指定された Uri オブジェクトが、受信アプリケーションがアクセスできるデータを指していることを確認してください。

テキスト プレビューにリッチ コンテンツを追加する

Android 10（API レベル 29）以降では、共有テキストのプレビューが Android Sharesheet に表示されます。場合によっては、共有されているテキストが理解しにくいことがあります。https://www.google.com/search?ei=2rRVXcLkJajM0PEPoLy7oA4 のような複雑な URL を共有する場合を考えてください。リッチなプレビューがあれば、何を共有するのかがわかり、ユーザーは安心します。

テキストをプレビューする場合は、タイトルまたはサムネイル画像、あるいはその両方を設定できます。Intent.createChooser() を呼び出す前に Intent.EXTRA_TITLE に説明を追加し、ClipData を使用して関連するサムネイルを追加します。

注: 画像コンテンツ URI は、FileProvider（通常は構成された <cache-path>）から提供されます。詳細については、ファイルを共有するをご覧ください。必ず、サムネイルとして使用する画像を読み取るための適切な権限を Sharesheet に付与してください。詳細については、Intent.FLAG_GRANT_READ_URI_PERMISSION をご覧ください。

次の例をご覧ください。

Kotlin

 val share = Intent.createChooser(Intent().apply {
      action = Intent.ACTION_SEND
      putExtra(Intent.EXTRA_TEXT, "https://developer.android.com/training/sharing/")

      // (Optional) Here you're setting the title of the content
      putExtra(Intent.EXTRA_TITLE, "Introducing content previews")

      // (Optional) Here you're passing a content URI to an image to be displayed
      data = contentUri
      flags = Intent.FLAG_GRANT_READ_URI_PERMISSION
  }, null)
  startActivity(share)

Java

Intent sendIntent = new Intent(Intent.ACTION_SEND);
sendIntent.putExtra(Intent.EXTRA_TEXT, "https://developer.android.com/training/sharing/");

// (Optional) Here you're setting the title of the content
sendIntent.putExtra(Intent.EXTRA_TITLE, "Introducing content previews");

// (Optional) Here you're passing a content URI to an image to be displayed
sendIntent.setData(contentUri);
sendIntent.setFlags(Intent.FLAG_GRANT_READ_URI_PERMISSION);

// Show the Sharesheet
startActivity(Intent.createChooser(sendIntent, null));

プレビューは次のようになります。

共有シートにカスタム アクションを追加する

Android Sharesheet でのカスタム アクションのスクリーンショット。

Android 14（API レベル 34）以降では、アプリは Android 共有シートにカスタム アクションを追加できます。カスタム アクションは、Android 共有シートの上部に小さなアクション アイコンとして表示されます。アプリは、アイコンがクリックされたときに呼び出されるアクションとして任意の Intent を指定できます。

Android 共有シートにカスタム アクションを追加するには、まず ChooserAction.Builder を使用して ChooserAction を作成します。アイコンがクリックされたときに呼び出されるアクションとして PendingIntent を指定できます。すべてのカスタム アクションを含む配列を作成し、共有 Intent の EXTRA_CHOOSER_CUSTOM_ACTIONS として指定します。

Kotlin

val sendIntent = Intent(Intent.ACTION_SEND)
    .setType("text/plain")
    .putExtra(Intent.EXTRA_TEXT, text)
val shareIntent = Intent.createChooser(sendIntent, null)
val customActions = arrayOf(
    ChooserAction.Builder(
        Icon.createWithResource(context, R.drawable.ic_custom_action),
        "Custom",
        PendingIntent.getBroadcast(
            context,
            1,
            Intent(Intent.ACTION_VIEW),
            PendingIntent.FLAG_IMMUTABLE or PendingIntent.FLAG_CANCEL_CURRENT
        )
    ).build()
)
shareIntent.putExtra(Intent.EXTRA_CHOOSER_CUSTOM_ACTIONS, customActions)
context.startActivity(shareIntent)

Java

Intent sendIntent = new Intent(Intent.ACTION_SEND)
        .setType("text.plain")
        .putExtra(Intent.EXTRA_TEXT, text);
Intent shareIntent = Intent.createChooser(sendIntent, null);
ChooserAction[] actions = new ChooserAction[]{
        new ChooserAction.Builder(
                Icon.createWithResource(context, R.drawable.ic_custom_action),
                "Custom",
                PendingIntent.getBroadcast(
                        context,
                        1,
                        new Intent(Intent.ACTION_VIEW),
                        PendingIntent.FLAG_IMMUTABLE | PendingIntent.FLAG_CANCEL_CURRENT
                )
        ).build()
};
shareIntent.putExtra(Intent.EXTRA_CHOOSER_CUSTOM_ACTIONS, actions);
context.startActivity(shareIntent);

カスタム ターゲットを追加する

Android Sharesheet では、ChooserTargetServices から読み込んだ共有ショートカットと ChooserTarget の前に表示する、最大 2 つの ChooserTarget オブジェクトを指定できます。また、アプリの候補の前に一覧表示されるアクティビティを指すインテントを 2 つまで指定することもできます。

Intent.createChooser() を呼び出した後で、Intent.EXTRA_CHOOSER_TARGETS と Intent.EXTRA_INITIAL_INTENTS をインテントに追加します。

Kotlin

val share = Intent.createChooser(myShareIntent, null).apply {
    putExtra(Intent.EXTRA_CHOOSER_TARGETS, myChooserTargetArray)
    putExtra(Intent.EXTRA_INITIAL_INTENTS, myInitialIntentArray)
}

Java

Intent shareIntent = Intent.createChooser(sendIntent, null);
share.putExtra(Intent.EXTRA_CHOOSER_TARGETS, myChooserTargetArray);
share.putExtra(Intent.EXTRA_INITIAL_INTENTS, myInitialIntentArray);

この機能の使用には注意が必要です。カスタムの Intent と ChooserTarget を追加するたびに、システムが提案する候補の数が少なくなります。通常、カスタム ターゲットを追加することはおすすめしません。Intent.EXTRA_INITIAL_INTENTS を追加する一般的で適切な例は、共有コンテンツに対してユーザーが実行できる追加のアクションを提供する場合です。たとえば、ユーザーが画像を共有し、Intent.EXTRA_INITIAL_INTENTS を使用してリンクを送信できるようにします。Intent.EXTRA_CHOOSER_TARGETS を追加する一般的で適切な例は、アプリが提供する関連する人やデバイスを提示する場合です。

特定コンポーネントのターゲットの除外

特定のターゲットを除外するには、Intent.EXTRA_EXCLUDE_COMPONENTS を指定します。制御可能なターゲットを削除する場合にのみ使用してください。一般的なユースケースは、ユーザーのインテントがアプリの外部で共有される可能性が高いため、ユーザーがアプリ内から共有するときに、アプリの共有ターゲットを非表示にする場合です。

Intent.createChooser() を呼び出した後で、インテントに Intent.EXTRA_EXCLUDE_COMPONENTS を追加します。

Kotlin

  val share = Intent.createChooser(Intent(), null).apply {
    // Only use for components you have control over
    val excludedComponentNames = arrayOf(ComponentName("com.example.android", "ExampleClass"))
    putExtra(Intent.EXTRA_EXCLUDE_COMPONENTS, excludedComponentNames)
  }

Java

  Intent shareIntent = Intent.createChooser(new Intent(), null);
  // Only use for components you have control over
  ComponentName[] excludedComponentNames = {
          new ComponentName("com.example.android", "ExampleClass")
  };
  shareIntent.putExtra(Intent.EXTRA_EXCLUDE_COMPONENTS, excludedComponentNames);

共有に関する情報を取得する

ユーザーが共有しようとするタイミングと、どのターゲットを選択したのかがわかると便利です。Android Sharesheet では、ユーザーが選択したターゲットの ComponentName を IntentSender を使用して提供することで、この情報を取得できます。

まず、BroadcastReceiver の PendingIntent を作成して、その IntentSender を Intent.createChooser() に渡します。

Kotlin

var share = Intent(Intent.ACTION_SEND)
// ...
val pi = PendingIntent.getBroadcast(
    myContext, requestCode,
    Intent(myContext, MyBroadcastReceiver::class.java),
    PendingIntent.FLAG_MUTABLE or PendingIntent.FLAG_UPDATE_CURRENT
)
share = Intent.createChooser(share, null, pi.intentSender)

Java

Intent share = new Intent(ACTION_SEND);
...
PendingIntent pi = PendingIntent.getBroadcast(myContext, requestCode,
        new Intent(myContext, MyBroadcastReceiver.class),
        PendingIntent.FLAG_MUTABLE | PendingIntent.FLAG_UPDATE_CURRENT);
share = Intent.createChooser(share, null, pi.getIntentSender());

MyBroadcastReceiver でコールバックを受信して、Intent.EXTRA_CHOSEN_COMPONENT を確認します。

Kotlin

override fun onReceive(context: Context, intent: Intent) {
  ...
  val clickedComponent : ComponentName = intent.getParcelableExtra(EXTRA_CHOSEN_COMPONENT);
}

Java

@Override public void onReceive(Context context, Intent intent) {
  ...
  ComponentName clickedComponent = intent.getParcelableExtra(EXTRA_CHOSEN_COMPONENT);
}

Sharesheet にカスタム アクションを追加する

Android 14（API レベル 34）以降では、アプリは Android Sharesheet にカスタム アクションを追加できます。ChooserAction.Builder で ChooserAction を作成します。アイコンがクリックされたときに呼び出されるアクションとして PendingIntent を指定できます。すべてのカスタム アクションを含む配列を作成し、共有 Intent の EXTRA_CHOOSER_CUSTOM_ACTIONS として指定します。

Kotlin

val sendIntent = Intent(Intent.ACTION_SEND)
    .setType("text/plain")
    .putExtra(Intent.EXTRA_TEXT, text)
val shareIntent = Intent.createChooser(sendIntent, null)
val customActions = arrayOf(
    ChooserAction.Builder(
        Icon.createWithResource(context, R.drawable.ic_custom_action),
        "Custom",
        PendingIntent.getBroadcast(
            context,
            1,
            Intent(Intent.ACTION_VIEW),
            PendingIntent.FLAG_IMMUTABLE or PendingIntent.FLAG_CANCEL_CURRENT
        )
    ).build()
)
shareIntent.putExtra(Intent.EXTRA_CHOOSER_CUSTOM_ACTIONS, customActions)
context.startActivity(shareIntent)

Java

Intent sendIntent = new Intent(Intent.ACTION_SEND)
        .setType("text.plain")
        .putExtra(Intent.EXTRA_TEXT, text);
Intent shareIntent = Intent.createChooser(sendIntent, null);
ChooserAction[] actions = new ChooserAction[]{
        new ChooserAction.Builder(
                Icon.createWithResource(context, R.drawable.ic_custom_action),
                "Custom",
                PendingIntent.getBroadcast(
                        context,
                        1,
                        new Intent(Intent.ACTION_VIEW),
                        PendingIntent.FLAG_IMMUTABLE | PendingIntent.FLAG_CANCEL_CURRENT
                )
        ).build()
};
shareIntent.putExtra(Intent.EXTRA_CHOOSER_CUSTOM_ACTIONS, actions);
context.startActivity(shareIntent);

Android インテント リゾルバの使用

ACTION_SEND インテント リゾルバのスクリーンショット

Android インテント リゾルバが最もよく使われるのは、明確に定義されたタスクフローの一部として別のアプリにデータを渡す場合です。

Android インテント リゾルバを使用するには、Android Sharesheet を呼び出す場合と同様に、インテントを作成し、エクストラを追加します。ただし、Intent.createChooser() は呼び出さないでください。

ACTION_SEND と MIME タイプに一致するフィルタを持つアプリが複数インストールされている場合は、「インテント リゾルバ」と呼ばれる確認ダイアログが表示され、ユーザーは共有先のターゲットを選択できます。一致するアプリケーションが 1 つであれば、そのアプリケーションが実行されます。

Android インテント リゾルバを使用してテキストを送信する例を以下に示します。

Kotlin

val sendIntent: Intent = Intent().apply {
    action = Intent.ACTION_SEND
    putExtra(Intent.EXTRA_TEXT, "This is my text to send.")
    type = "text/plain"
}
startActivity(sendIntent)

Java

Intent sendIntent = new Intent();
sendIntent.setAction(Intent.ACTION_SEND);
sendIntent.putExtra(Intent.EXTRA_TEXT, "This is my text to send.");
sendIntent.setType("text/plain");
startActivity(sendIntent);

詳細

データの送信の詳細については、インテントとインテント フィルタをご覧ください。

次へ
他のアプリからの単純なデータの受信