ส่งข้อมูลไปยังแอปอื่นๆ

Android มี 2 วิธีให้ผู้ใช้แชร์ข้อมูลระหว่างแอป ดังนี้

• Android Sharesheet ได้รับการออกแบบมาเพื่อส่งเนื้อหาออกนอกแอปของคุณหรือส่งไปยังผู้ใช้รายอื่นโดยตรง เช่น การแชร์ URL กับเพื่อน
• Android Intent Resolver เหมาะที่สุดสำหรับการส่งข้อมูลไปยัง ขั้นตอนถัดไปของงานที่กำหนดไว้อย่างชัดเจน เช่น การเปิด PDF จากแอปของคุณและให้ผู้ใช้ เลือกโปรแกรมดูที่ต้องการ

เหตุผลที่ควรใช้ Android Sharesheet

ใช้ Android Sharesheet เพื่อสร้างความสอดคล้องให้ผู้ใช้ใน แอปต่างๆ อย่าแสดงรายการเป้าหมายการแชร์ของแอปเองหรือสร้าง Sharesheet เวอร์ชันของคุณเอง

Android Sharesheet ช่วยให้ผู้ใช้แชร์ข้อมูลกับบุคคลที่เหมาะสม พร้อมคำแนะนำแอปที่เกี่ยวข้องได้ด้วยการแตะเพียงครั้งเดียว Sharesheet สามารถแนะนำเป้าหมายที่โซลูชันที่กำหนดเองใช้ไม่ได้และใช้การจัดอันดับที่สอดคล้องกัน เนื่องจาก Sharesheet สามารถพิจารณาข้อมูลเกี่ยวกับกิจกรรมในแอปและกิจกรรมของผู้ใช้ที่ระบบเท่านั้นเข้าถึงได้

นอกจากนี้ Android Sharesheet ยังมีฟีเจอร์ที่มีประโยชน์มากมายสำหรับนักพัฒนาแอป เช่น คุณสามารถทำสิ่งต่อไปนี้ได้

• ดูว่าผู้ใช้แชร์เมื่อใดและแชร์ไปที่ใด
• เพิ่มเป้าหมายที่กำหนดเองและเป้าหมายแอป
• แสดงตัวอย่างเนื้อหา Rich Text ตั้งแต่ Android 10 (ระดับ API 29) เป็นต้นไป
• ยกเว้นเป้าหมายที่ตรงกับชื่อคอมโพเนนต์ที่เฉพาะเจาะจง

ใช้ Android Sharesheet

สร้าง Intent และตั้งค่าการทำงานเป็น Intent.ACTION_SEND สำหรับการแชร์ทุกประเภท หากต้องการแสดง Android Sharesheet ให้เรียก Intent.createChooser(), แล้วส่งออบเจ็กต์ Intent ของคุณ ระบบจะแสดง Intent เวอร์ชันที่แสดง Android Sharesheet เสมอ

ส่งเนื้อหาข้อความ

การใช้งาน Android Sharesheet ที่ตรงไปตรงมาและพบได้บ่อยที่สุดคือการส่งเนื้อหาข้อความจากกิจกรรมหนึ่งไปยังอีกกิจกรรมหนึ่ง ตัวอย่างเช่น เบราว์เซอร์ส่วนใหญ่สามารถแชร์ URL ของหน้าที่แสดงอยู่ในปัจจุบันเป็นข้อความกับแอปอื่นได้ ซึ่งมีประโยชน์สำหรับการแชร์บทความหรือเว็บไซต์กับเพื่อนๆ ผ่านอีเมลหรือโซเชียลเน็ตเวิร์ก ใน Jetpack Compose ให้เรียกข้อมูลบริบทปัจจุบันโดยใช้ LocalContext.current แล้วเรียก context.startActivity() ตัวอย่างวิธีทำมีดังนี้

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

    val shareIntent = Intent.createChooser(sendIntent, null)
    context.startActivity(shareIntent)
}
SharesheetSnippets.kt

คุณสามารถเพิ่มข้อมูลเพิ่มเติม เช่น ผู้รับอีเมล (EXTRA_EMAIL, EXTRA_CC, EXTRA_BCC) หรือเรื่องอีเมล (EXTRA_SUBJECT) ได้โดยไม่บังคับ

หมายเหตุ: แอปอีเมลบางแอป เช่น Gmail คาดหวัง String[] สำหรับข้อมูลเพิ่มเติม เช่น EXTRA_EMAIL และ EXTRA_CC ให้ใช้ putExtra(String, String[]) เพื่อเพิ่มข้อมูลเหล่านี้ลงใน Intent

ส่งเนื้อหาไบนารี

แชร์ข้อมูลไบนารีโดยใช้การทำงาน ACTION_SEND ตั้งค่าประเภท MIME ที่เหมาะสมและวาง URI ของข้อมูลในข้อมูลเพิ่มเติม EXTRA_STREAM ดังที่แสดงในตัวอย่างต่อไปนี้ โดยทั่วไปจะใช้เพื่อแชร์รูปภาพ แต่ก็ใช้เพื่อแชร์เนื้อหาไบนารีประเภทอื่นๆ ได้ด้วย

fun shareBinaryContent(context: Context) {
    val shareIntent: Intent = Intent().apply {
        action = ACTION_SEND
        // Example: content://com.google.android.apps.photos.contentprovider/...
        val imageUri: Uri =
            Uri.parse("content://com.google.android.apps.photos.contentprovider/0/1/mediakey/1")
        putExtra(Intent.EXTRA_STREAM, imageUri)
        type = "image/jpeg"
    }
    context.startActivity(Intent.createChooser(shareIntent, null))
}
SharesheetSnippets.kt

แอปพลิเคชันที่รับต้องมีสิทธิ์เข้าถึงข้อมูลที่ Uri ชี้ไป เราขอแนะนำให้ทำดังนี้ 2 วิธี

• จัดเก็บข้อมูลใน ContentProvider ของคุณเอง โดยตรวจสอบว่าแอปอื่นๆ มีสิทธิ์ที่ถูกต้องในการเข้าถึงผู้ให้บริการของคุณ กลไกที่แนะนำสำหรับการให้สิทธิ์เข้าถึงคือการใช้ สิทธิ์ต่อ URIซึ่งเป็นสิทธิ์ชั่วคราวและให้สิทธิ์เข้าถึงแอปพลิเคชันที่รับเท่านั้น หากต้องการสร้าง ContentProvider เช่นนี้ ให้ใช้คลาสตัวช่วย FileProvider
• ใช้ MediaStore ของระบบ MediaStore เหมาะสำหรับประเภท MIME ของวิดีโอ เสียง และรูปภาพเป็นหลัก อย่างไรก็ตาม ตั้งแต่ Android 3.0 (API ระดับ 11) เป็นต้นไป ก็สามารถจัดเก็บประเภทที่ไม่ใช่สื่อได้ด้วย ดูข้อมูลเพิ่มเติมได้ที่ MediaStore.Files คุณสามารถแทรกไฟล์ลงใน MediaStore โดยใช้ scanFile() หลังจากนั้นระบบจะส่ง Uri ในรูปแบบ content:// ที่เหมาะสำหรับการแชร์ไปยังการเรียกกลับ onScanCompleted() ที่ระบุ โปรดทราบว่าเมื่อเพิ่มลงใน MediaStore ของระบบแล้ว แอปใดก็ตามในอุปกรณ์จะเข้าถึงเนื้อหาได้

ใช้ประเภท MIME ที่ถูกต้อง

ระบุประเภท MIME ที่เฉพาะเจาะจงที่สุดสำหรับข้อมูลที่คุณกำลังส่ง เช่น ใช้ text/plain เมื่อแชร์ข้อความธรรมดา ต่อไปนี้คือประเภท MIME ทั่วไปบางประเภทเมื่อส่งข้อมูลใน Android

หากต้องการกำหนดประเภท MIME แบบไดนามิกในรันไทม์แทนการฮาร์ดโค้ด ให้ใช้วิธีการต่อไปนี้

• สำหรับ URI content:// (เช่น URI ที่ FileProvider หรือ MediaStore ให้มา) ให้เรียก ContentResolver.getType()
• สำหรับนามสกุลไฟล์ ให้เรียก MimeTypeMap.getSingleton().getMimeTypeFromExtension().
• หากคุณใช้ Storage Access Framework คุณยังสามารถค้นหา DocumentFile.getType() ได้ด้วย

หากกำหนดประเภท MIME ที่เฉพาะเจาะจงไม่ได้ ให้ใช้ application/octet-stream สำหรับข้อมูลไบนารีทั่วไป หรือ */* เป็นทางเลือกสุดท้าย

ดูข้อมูลเพิ่มเติมเกี่ยวกับประเภท MIME ได้ที่ รีจิสทรีอย่างเป็นทางการของประเภทสื่อ MIME ของ IANA

Android Sharesheet อาจแสดงตัวอย่างเนื้อหา ทั้งนี้ขึ้นอยู่กับประเภท MIME ที่ระบุ ฟีเจอร์เวอร์ชันตัวอย่างบางรายการ ใช้ได้กับบางประเภทเท่านั้น

แชร์เนื้อหาหลายรายการ

หากต้องการแชร์เนื้อหาหลายรายการ ให้ใช้การทำงาน ACTION_SEND_MULTIPLE ร่วมกับรายการ URI ที่ชี้ไปยังเนื้อหา ประเภท MIME จะแตกต่างกันไปตามเนื้อหาที่คุณแชร์ เช่น หากคุณแชร์รูปภาพ JPEG 3 รูป ให้ใช้ประเภท "image/jpg" หากแชร์รูปภาพหลายประเภท ให้ใช้ "image/*" เพื่อจับคู่กิจกรรมที่จัดการรูปภาพทุกประเภท แม้ว่าจะแชร์เนื้อหาหลายประเภทได้ แต่เราไม่แนะนำให้ทำเช่นนี้ เนื่องจากผู้รับจะไม่ทราบว่าคุณต้องการส่งเนื้อหาประเภทใด หากจำเป็นต้องส่งเนื้อหาหลายประเภท ให้ใช้ "*/*" แอปพลิเคชันที่รับมีหน้าที่แยกวิเคราะห์และประมวลผลข้อมูลของคุณ ตัวอย่าง

fun shareMultiple(context: Context) {
    val imageUris: ArrayList<Uri> = arrayListOf(
        Uri.parse("content://com.google.android.apps.photos.contentprovider/0/1/mediakey/1"),
        Uri.parse("content://com.google.android.apps.photos.contentprovider/0/1/mediakey/2")
    )

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

ตรวจสอบว่าออบเจ็กต์ Uri ที่ระบุชี้ไปยังข้อมูลที่แอปพลิเคชันที่รับเข้าถึงได้

เพิ่มข้อมูลอย่างละเอียดลงในตัวอย่างข้อความ

ตั้งแต่ Android 10 (ระดับ API 29) เป็นต้นไป Android Sharesheet จะแสดงตัวอย่างข้อความที่แชร์ ในบางกรณี ข้อความที่แชร์อาจเข้าใจยาก ลองพิจารณาการแชร์ URL ที่ซับซ้อน เช่น https://www.google.com/search?ei=2rRVXcLkJajM0PEPoLy7oA4 ตัวอย่างที่ละเอียดมากขึ้นจะช่วยให้ผู้ใช้มั่นใจได้ว่าคุณกำลังแชร์อะไร

หากแสดงตัวอย่างข้อความ คุณสามารถตั้งค่าชื่อ รูปภาพขนาดย่อ หรือทั้ง 2 อย่างได้ เพิ่มคำอธิบายลงใน Intent.EXTRA_TITLE ก่อนเรียก Intent.createChooser() และเพิ่มรูปภาพขนาดย่อที่เกี่ยวข้องโดยใช้ ClipData

หมายเหตุ: ระบบจะระบุ URI เนื้อหารูปภาพจาก FileProvider ซึ่งโดยปกติจะมาจาก <cache-path> ที่กำหนดค่าไว้ ดูข้อมูลเพิ่มเติมได้ที่หัวข้อการแชร์ไฟล์ อย่าลืมให้สิทธิ์ที่เหมาะสมแก่ Sharesheet ในการอ่านรูปภาพที่คุณต้องการใช้เป็นรูปภาพขนาดย่อ ดูข้อมูลเพิ่มเติมได้ที่ Intent.FLAG_GRANT_READ_URI_PERMISSION

ตัวอย่าง

fun richContentToTextPreviewShares(context: Context) {
    val share = Intent.createChooser(
        Intent().apply {
            action = 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 =
                Uri.parse("content://com.google.android.apps.photos.contentprovider/0/1/mediakey/A123456789")
            flags = Intent.FLAG_GRANT_READ_URI_PERMISSION
        },
        null
    )
    context.startActivity(share)
}
SharesheetSnippets.kt

ตัวอย่างจะมีลักษณะดังนี้

เพิ่มการทำงานที่กำหนดเองลงใน Sharesheet

ใน Android 14 (ระดับ API 34) ขึ้นไป แอปสามารถเพิ่มการทำงานที่กำหนดเองลงใน Android Sharesheet ได้ การทำงานที่กำหนดเองจะแสดงเป็นไอคอนการทำงานขนาดเล็กที่ด้านบนของ Android Sharesheet และแอปสามารถระบุ Intent ใดก็ได้เป็นการทำงานที่จะเรียกใช้เมื่อมีการคลิกไอคอน

หากต้องการเพิ่มการทำงานที่กำหนดเองใน Android Sharesheet ให้สร้าง a ChooserAction ด้วย ChooserAction.Builder ก่อน คุณสามารถระบุ PendingIntent เป็นการทำงานที่จะเรียกใช้เมื่อมีการคลิกไอคอน สร้างอาร์เรย์ที่มีการทำงานที่กำหนดเองทั้งหมด แล้วระบุอาร์เรย์ดังกล่าวเป็น EXTRA_CHOOSER_CUSTOM_ACTIONS ของ Intent การแชร์

fun sharesheetCustomActions(context: Context, previewText: String) {
    val sendIntent = Intent(ACTION_SEND)
        .setType("text/plain")
        .putExtra(Intent.EXTRA_TEXT, previewText)
    val shareIntent = Intent.createChooser(sendIntent, null)
    val customActions = arrayOf(
        ChooserAction.Builder(
            Icon.createWithResource(context, R.drawable.ic_logo),
            "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)
}
SharesheetSnippets.kt

เพิ่มการกำหนดเป้าหมายเอง

Android Sharesheet ช่วยให้คุณระบุ Intent ของกิจกรรมที่กำหนดเองได้สูงสุด 2 รายการ ซึ่งจะแสดงก่อนคำแนะนำแอปโดยใช้ Intent.EXTRA_INITIAL_INTENTS สำหรับเป้าหมายการแชร์โดยตรง (เช่น การสนทนาหรือรายชื่อติดต่อ) ให้เผยแพร่ทางลัดแบบไดนามิกโดยใช้ ShortcutManagerCompat แทน (ดูหัวข้อ ระบุเป้าหมายการแชร์โดยตรง)

เพิ่ม Intent.EXTRA_INITIAL_INTENTS ลงใน Intent การแชร์ หลังจาก เรียก Intent.createChooser()

val sendIntent = Intent(ACTION_SEND).apply {
    type = "text/plain"
    putExtra(Intent.EXTRA_TEXT, previewText)
}

val customIntent = Intent().apply {
    component = ComponentName(context.packageName, "${context.packageName}.CustomActivity")
}

val shareIntent = Intent.createChooser(sendIntent, null).apply {
    putExtra(
        Intent.EXTRA_INITIAL_INTENTS,
        arrayOf(customIntent)
    )
}
context.startActivity(shareIntent)
SharesheetSnippets.kt

ใช้ฟีเจอร์นี้ด้วยความระมัดระวัง Intent ที่กำหนดเองทุกรายการที่คุณเพิ่มจะลดจำนวนคำแนะนำที่ระบบแสดง โดยทั่วไปแล้ว เราไม่แนะนำให้เพิ่มเป้าหมายที่กำหนดเอง ตัวอย่างที่เหมาะสมและพบได้บ่อยในการเพิ่ม Intent.EXTRA_INITIAL_INTENTS คือการระบุการทำงานเพิ่มเติมที่ผู้ใช้สามารถทำกับเนื้อหาที่แชร์ เช่น ผู้ใช้แชร์รูปภาพและระบบใช้ Intent.EXTRA_INITIAL_INTENTS เพื่อให้ผู้ใช้ส่งลิงก์แทน

ยกเว้นเป้าหมายที่เฉพาะเจาะจงตามคอมโพเนนต์

คุณสามารถยกเว้นเป้าหมายที่เฉพาะเจาะจงได้โดยระบุ Intent.EXTRA_EXCLUDE_COMPONENTS ให้ทำเช่นนี้เพื่อนำเป้าหมายที่คุณควบคุมได้ออกเท่านั้น กรณีการใช้งานที่พบได้บ่อยคือการซ่อนเป้าหมายการแชร์ของแอปเมื่อผู้ใช้แชร์จากภายในแอป เนื่องจากผู้ใช้มีแนวโน้มที่จะแชร์ออกนอกแอป

เพิ่ม Intent.EXTRA_EXCLUDE_COMPONENTS ลงใน Intent หลังจากเรียก Intent.createChooser()

fun excludeSpecificTargets(context: Context) {
    val share = Intent.createChooser(Intent(ACTION_SEND), null).apply {
        // Only use for components you have control over
        val excludedComponentNames =
            arrayOf(ComponentName("com.example.android", "ExampleClass"))
        putExtra(Intent.EXTRA_EXCLUDE_COMPONENTS, excludedComponentNames)
    }
    context.startActivity(share)
}
SharesheetSnippets.kt

รับข้อมูลเกี่ยวกับการแชร์

การทราบว่าผู้ใช้แชร์เมื่อใดและเลือกเป้าหมายใดอาจเป็นประโยชน์ Android Sharesheet ช่วยให้คุณรับข้อมูลนี้ได้โดยระบุ ComponentName ของเป้าหมายที่ผู้ใช้เลือกโดยใช้ IntentSender

ก่อนอื่นให้สร้าง PendingIntent สำหรับ BroadcastReceiver แล้วระบุ IntentSender ใน Intent.createChooser()

fun infoAboutSharing(context: Context, requestCode: Int) {
    var share = Intent(ACTION_SEND)
    // ...
    val pi = PendingIntent.getBroadcast(
        context, requestCode,
        Intent(context, ShareBroadcastReceiver::class.java),
        PendingIntent.FLAG_MUTABLE or PendingIntent.FLAG_UPDATE_CURRENT
    )
    share = Intent.createChooser(share, null, pi.intentSender)
    context.startActivity(share)
}
SharesheetSnippets.kt

รับการเรียกกลับใน MyBroadcastReceiver และดูใน Intent.EXTRA_CHOOSER_RESULT

override fun onReceive(context: Context?, intent: Intent) {
    val TAG = ShareBroadcastReceiver::class.simpleName
    val chooserResult: ChooserResult? = IntentCompat.getParcelableExtra(
        intent,
        Intent.EXTRA_CHOOSER_RESULT,
        ChooserResult::class.java,
    )
    chooserResult?.let {
        Log.i(TAG,
            "Share callback: isShortcut: ${it.isShortcut}, type: ${typeToString(it.type)}, componentName: ${it.selectedComponent}",
        )
    } ?: Log.i(TAG, "chooserResult is null")
}
ShareBroadcastReceiver.kt

ดูข้อมูลเพิ่มเติมได้ที่ตัวอย่างการแชร์แพลตฟอร์ม

ใช้ Android Intent Resolver

Android Intent Resolver เหมาะที่สุดเมื่อส่งข้อมูลไปยังแอปอื่นเป็นส่วนหนึ่งของโฟลว์งานที่กำหนดไว้อย่างชัดเจน

หากต้องการใช้ Android Intent Resolver ให้สร้าง Intent และเพิ่มข้อมูลเพิ่มเติมเหมือนกับที่คุณทำเพื่อเรียก Android Sharesheet แต่ อย่า เรียก Intent.createChooser()

หากมีแอปพลิเคชันที่ติดตั้งไว้หลายแอปที่มีตัวกรองที่ตรงกับ ACTION_SEND และประเภท MIME ระบบจะแสดงกล่องโต้ตอบการแยกความกำกวมที่เรียกว่า Intent Resolver ซึ่งช่วยให้ผู้ใช้เลือกเป้าหมายที่จะแชร์ได้ หากมีแอปพลิเคชันเดียวที่ตรงกัน ระบบจะเรียกใช้แอปพลิเคชันนั้น

ตัวอย่างวิธีใช้ Android Intent Resolver เพื่อส่งข้อความ

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

ดูข้อมูลเพิ่มเติม

ดูข้อมูลเพิ่มเติมเกี่ยวกับการส่งข้อมูลได้ที่ หัวข้อ Intent และตัวกรอง Intent