本頁面由 Cloud Translation API 翻譯而成。

傳送簡單資料給其他應用程式

Android 會使用意圖及相關聯的額外功能，讓使用者快速分享資訊，並輕鬆使用喜愛的應用程式

Android 提供兩種在應用程式之間分享資料的方式：

Android 分享頁面主要用於將內容傳送至應用程式以外的使用者，以及/或是直接傳送給其他使用者。例如，與好友分享網址。
Android 意圖解析器最適合將資料傳遞至明確定義工作階段。例如從應用程式開啟 PDF，並讓使用者挑選偏好的觀眾

建構意圖時，您會指定意圖要執行的動作。Android 採用「ACTION_SEND」動作在活動之間傳送資料甚至可以跨越處理程序邊界您必須指定以及資料類型系統會自動找出相容的活動以便接收資料並向使用者顯示在意圖解析器的情況下，如果只有一個活動可以處理意圖，該活動會立即啟動。

為什麼要使用 Android Sharesheet

我們強烈建議您使用 Android Sharesheet，以維持使用者的一致性應用程式。請勿顯示應用程式本身的分享目標清單，或自行建立分享列變化版本。

Android 分享頁面可讓使用者輕鬆與適當對象分享資訊，並提供相關應用程式建議。Sharesheet 可以建議自訂解決方案無法使用的目標，並使用一致的排名。這是因為 Sharesheet 可將應用程式和使用者活動的相關資訊納入考量提供給系統使用

Android 分享列表也提供許多實用的開發人員功能。舉例來說：：

瞭解使用者完成分享的時間和分享對象
新增自訂 ChooserTarget 和應用程式目標
自 Android 10 (API 級別 29) 起，提供 RTF 格式預覽功能
排除符合特定元件名稱的目標

使用 Android Sharesheet

針對所有類型的分享，請建立意圖並將其動作設為 Intent.ACTION_SEND。如要顯示 Android Sharesheet，請呼叫 Intent.createChooser(), 並傳送 Intent 物件給該函式。它會傳回意圖的版本，該版本一律會顯示 Android 分享列。

傳送文字內容

Android Sharesheet 是最簡單也最直觀的方法，就是從以下位置傳送文字內容：在不同活動之間進行負載平衡舉例來說，大多數瀏覽器都能將目前顯示的網頁網址以文字形式與其他應用程式分享。這項功能可讓您透過電子郵件或社群網站，與朋友分享文章或網站。範例如下：

KotlinJava

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)

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 類型，並在額外資料中放置資料的 URI EXTRA_STREAM，如如以下範例所示常用於共用圖片，但也可用於分享任何類型的二進位內容。

KotlinJava

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

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 所指向資料的權限。建議您採用下列兩種做法：

將資料儲存在自己的ContentProvider中，確保其他應用程式具備適當權限，才能存取你的供應商。提供存取權的首選機制是使用個別 URI 權限，這類權限是暫時性的，且只會授予接收應用程式的存取權。如要建立這類 ContentProvider，最簡單的方法是使用 FileProvider 輔助類別。
使用系統 MediaStore。MediaStore 主要用於影片、音訊和圖片 MIME 類型。不過，從 Android 3.0 (API 級別 11) 開始，它也可以儲存非媒體類型。若需更多資訊，請參閲 MediaStore.Files。您可以使用以下程式碼將檔案插入 MediaStore scanFile(), 之後 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 官方的 MIME 媒體類型註冊資料庫。

視提供的 MIME 類型而定，Android 分享列可能會顯示內容預覽畫面。部分預覽功能僅適用於特定類型。

如要分享多個內容，請使用 ACTION_SEND_MULTIPLE 動作，並搭配指向內容的 URI 清單。MIME 類型會因分享的內容組合而異。舉例來說，如要分享三張 JPEG 圖片，請使用輸入 "image/jpg"。如果是混合圖片類型，請使用 "image/*" 比對處理任何圖片類型的活動。雖然可以分享混合類型的內容，但我們強烈不建議這麼做，因為接收者可能不清楚要傳送的內容。如果需要傳送多種類型，請使用 "*/*"。接收應用程式會負責剖析及處理您的資料。範例如下：

KotlinJava

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

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 物件會指向接收應用程式可存取的資料。

在文字預覽中加入 RTF 格式內容

自 Android 10 (API 級別 29) 起，Android 分享頁面會顯示要分享的文字預覽畫面。在某些情況下，分享的文字可能難以理解。建議您與其他人分享複雜的網址，例如 https://www.google.com/search?ei=2rRVXcLkJajM0PEPoLy7oA4。內容更豐富預覽功能可以讓使用者安心知道自己分享的內容。

如果您正在預覽文字，您可以設定標題和/或縮圖圖片。在呼叫 Intent.createChooser() 之前，請先在 Intent.EXTRA_TITLE 中新增說明，然後使用 ClipData 新增相關縮圖。

注意：圖片內容 URI 是由 FileProvider 提供，通常是來自已設定的 <cache-path>。詳情請參閱「共用檔案」。請務必為 Sharesheet 具備適當的權限，可以讀取任何你想做為縮圖的圖片。詳情請參閱 Intent.FLAG_GRANT_READ_URI_PERMISSION。

範例如下：

KotlinJava

 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)

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

以下是預覽畫面：

在 Sharesheet 中新增自訂動作

Android Sharesheet 中的自訂動作螢幕截圖。

在 Android 14 (API 級別 34) 以上版本中，應用程式可將自訂動作新增至 Android Sharesheet。自訂動作會顯示為 Android 分享列頂端的小型動作圖示，應用程式可以指定任何 Intent，做為點選圖示時叫用的動作。

如要在 Android Sharesheet 中新增自訂動作，請先建立一個 ChooserAction 同時 ChooserAction.Builder。您可以指定 PendingIntent，做為點選圖示時叫用的動作。建立包含所有自訂動作的陣列，並將其指定為分享 Intent 的 EXTRA_CHOOSER_CUSTOM_ACTIONS。

KotlinJava

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)

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 分享頁面可讓您指定最多兩個 ChooserTarget 物件，這些物件會在從 ChooserTargetServices 載入的分享捷徑和選擇器目標前顯示。你也可以指定最多兩個意圖指向列出的活動的意圖並在應用程式建議之前：

在呼叫 Intent.createChooser() 後，將 Intent.EXTRA_CHOOSER_TARGETS 和 Intent.EXTRA_INITIAL_INTENTS 新增至分享意圖：

KotlinJava

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

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 新增至意圖：

KotlinJava

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

  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，並在 Intent.createChooser() 中提供其 IntentSender：

KotlinJava

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)

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：

KotlinJava

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

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

在 Sharesheet 中新增自訂動作

在 Android 14 (API 級別 34) 以上版本中，應用程式可將自訂動作新增至 Android Sharesheet。建立 ChooserAction 同時 ChooserAction.Builder。您可以指定 PendingIntent 做為點選圖示時所叫用的動作。創作包含所有自訂動作的陣列，並將其指定為 EXTRA_CHOOSER_CUSTOM_ACTIONS 股份清單 Intent

KotlinJava

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)

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 意圖解析器，請建立意圖並新增額外項目，就像呼叫 Android Sharesheet 一樣。但「不要」呼叫 Intent.createChooser()。

如已安裝多個符合篩選條件的應用程式 ACTION_SEND 與 MIME 類型，系統會顯示名為「意圖解析器」的消歧對話方塊讓使用者選擇要共用的目標。單一應用程式就會執行

以下範例說明如何使用 Android 意圖解析器傳送文字：

KotlinJava

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

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

瞭解詳情

如要進一步瞭解如何傳送資料，請參閱「意圖和意圖篩選器」。

接收其他應用程式傳送的簡單資料

傳送簡單資料給其他應用程式

為什麼要使用 Android Sharesheet

使用 Android Sharesheet

傳送文字內容

傳送二進位內容

使用正確的 MIME 類型

分享多項內容

在文字預覽中加入 RTF 格式內容

在 Sharesheet 中新增自訂動作

新增自訂目標

依元件排除特定目標

取得共用資訊

在 Sharesheet 中新增自訂動作

使用 Android 意圖解析器

瞭解詳情