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

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

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

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

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

Android 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:// ที่เหมาะสำหรับการแชร์ไปยัง Callback 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

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

เพิ่มการดำเนินการที่กำหนดเองลงในชีตการแชร์

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

หากต้องการเพิ่มการดำเนินการที่กำหนดเองใน Android Sharesheet ก่อนอื่นให้สร้าง 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

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

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

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

ต่อไปนี้เป็นตัวอย่างวิธีใช้ 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