Google ใช้เทคโนโลยี AI เพื่อแปลเนื้อหาเป็นภาษาที่คุณต้องการ การแปลโดย AI อาจมีข้อผิดพลาด

รับข้อมูลอย่างง่ายจากแอปอื่นๆ

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

ในแอปที่ใช้ Compose Navigation การรับข้อมูลที่แอปอื่นส่งมาเป็นกระบวนการ 2 ขั้นตอน ดังนี้

ประกาศ <intent-filter> ในไฟล์ Manifest: คุณยังคงต้องเพิ่มตัวกรอง Intent ลงใน Activity ในไฟล์ AndroidManifest.xml ซึ่งจะบอกระบบปฏิบัติการ Android ว่าแอปพลิเคชันของคุณสามารถรับการดำเนินการที่เฉพาะเจาะจง (เช่น ACTION_SEND) และประเภท MIME (เช่น text/plain) ได้
กำหนด navDeepLink ในกราฟ Compose Navigation: แทนที่จะดักจับและแยกวิเคราะห์ Intent ด้วยตนเองภายในเมธอด onCreate หรือ onNewIntent ของ Activity ให้ใช้การรองรับลิงก์ในรายละเอียดของ Compose Navigation แนบ navDeepLink ที่ตรงกับการดำเนินการและประเภท MIME กับปลายทางที่สร้างได้โดยตรงซึ่งควรแสดงเนื้อหา NavController จะดักจับ Intent และนำผู้ใช้ไปยังหน้าจอนั้นโดยอัตโนมัติ

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

ประเภท MIME ที่รองรับ

แอปควรรับประเภท MIME ได้หลากหลายที่สุดเท่าที่จะเป็นไปได้ เช่น แอปรับส่งข้อความที่ออกแบบมาเพื่อส่งข้อความ รูปภาพ และวิดีโอควรจะรองรับการรับ text/*, image/* และ video/* ต่อไปนี้คือประเภท MIME ทั่วไปบางประเภทสำหรับการส่งและรับข้อมูลอย่างง่ายใน Android

ผู้รับลงทะเบียนเพื่อรับ	ผู้ส่งส่ง
`text/*`	`text/plain` `text/rtf` `text/html` `text/json`
`image/*`	`image/jpg` `image/png` `image/gif`
`video/*`	`video/mp4` `video/3gp`
นามสกุลไฟล์ที่รองรับ	`application/pdf`

โปรดดูรีจิสทรีอย่างเป็นทางการของประเภทสื่อ MIME ของ IANA

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

รับข้อมูลด้วยกิจกรรม

การรับข้อมูลด้วยกิจกรรมเกี่ยวข้องกับการอัปเดตไฟล์ Manifest การจัดการเนื้อหาขาเข้า และการตรวจสอบว่าผู้ใช้รู้จักแอปของคุณ

อัปเดตไฟล์ Manifest

ตัวกรอง Intent จะแจ้งให้ระบบทราบว่าคอมโพเนนต์ของแอปยอมรับ Intent ใดบ้าง คุณสร้างตัวกรอง Intent เพื่อรับ Intent ที่มีการดำเนินการนี้ในลักษณะเดียวกับที่คุณสร้าง Intent ด้วยการดำเนินการ ACTION_SEND ใน บทเรียนการส่งข้อมูลอย่างง่ายไปยังแอปอื่นๆ คุณ กำหนดตัวกรอง Intent ในไฟล์ Manifest โดยใช้องค์ประกอบ <intent-filter> ตัวอย่างเช่น หากแอปของคุณจัดการการรับเนื้อหาข้อความ ไฟล์ Manifest ที่มีรูปภาพอย่างน้อย 1 รูปภาพทุกประเภทจะมีลักษณะดังตัวอย่างโค้ดต่อไปนี้

<activity android:name=".ui.MyActivity" >
    <intent-filter>
        <action android:name="android.intent.action.SEND" />
        <category android:name="android.intent.category.DEFAULT" />
        <data android:mimeType="image/*" />
    </intent-filter>
    <intent-filter>
        <action android:name="android.intent.action.SEND" />
        <category android:name="android.intent.category.DEFAULT" />
        <data android:mimeType="text/plain" />
    </intent-filter>
    <intent-filter>
        <action android:name="android.intent.action.SEND_MULTIPLE" />
        <category android:name="android.intent.category.DEFAULT" />
        <data android:mimeType="image/*" />
    </intent-filter>
</activity>

เมื่อแอปอื่นพยายามแชร์สิ่งเหล่านี้โดยการสร้าง an intent และส่งไปยัง startActivity() แอปพลิเคชันของคุณ จะแสดงเป็นตัวเลือกในแผ่นแชร์หรือตัวแก้ปัญหา Intent ของ Android หากผู้ใช้เลือกแอปของคุณ ระบบจะเริ่มกิจกรรมที่เกี่ยวข้อง (.ui.MyActivity ในตัวอย่างก่อนหน้า) จากนั้นคุณต้องจัดการเนื้อหาอย่างเหมาะสมภายในโค้ดและ UI

จัดการเนื้อหาขาเข้า

หากต้องการจัดการเนื้อหาที่ส่งโดย Intent ให้เรียก getIntent() เพื่อรับออบเจ็กต์ Intent เมื่อมีออบเจ็กต์แล้ว คุณจะตรวจสอบเนื้อหาของออบเจ็กต์เพื่อกำหนดสิ่งที่ต้องทำต่อไปได้ หากกิจกรรมนี้เริ่มต้นได้จากส่วนอื่นๆ ของระบบ (เช่น ตัวเรียกใช้งาน) ให้พิจารณาเรื่องนี้เมื่อตรวจสอบ Intent

โปรดตรวจสอบข้อมูลขาเข้าอย่างละเอียด เนื่องจากคุณไม่มีทางรู้ว่าแอปพลิเคชันอื่นจะส่งอะไรมาให้คุณ เช่น อาจมีการตั้งค่าประเภท MIME ที่ไม่ถูกต้อง หรือรูปภาพที่ส่งอาจมีขนาดใหญ่มาก นอกจากนี้ อย่าลืมประมวลผลข้อมูลไบนารีในเธรดแยกต่างหากแทนที่จะประมวลผลในเธรดหลัก ("UI")

@Composable
fun SharesheetHandler() {
    val context = LocalContext.current
    val intent = (context as? Activity)?.intent

    when (intent?.action) {
        ACTION_SEND -> {
            if ("text/plain" == intent.type) {
                handleSendText(intent) // Handle text being sent.
            } else if (intent.type?.startsWith("image/") == true) {
                handleSendImage(intent) // Handle single image being sent
            }
        }

        Intent.ACTION_SEND_MULTIPLE -> {
            if (intent.type?.startsWith("image/") == true) {
                handleSendMultipleImages(intent) // Handle multiple images being sent
            }
        }

        else -> {
            // Handle other intents, such as being started from the home screen
        }
    }
}

fun handleSendText(intent: Intent) {
    intent.getStringExtra(Intent.EXTRA_TEXT)?.let {
        // Update ViewModel state to change state of text being shared
    }
}

fun handleSendImage(intent: Intent) {
    IntentCompat.getParcelableExtra(intent, Intent.EXTRA_STREAM, Uri::class.java).let {
        // Update ViewModel state to change state of image being shared
    }
}

fun handleSendMultipleImages(intent: Intent) {
    IntentCompat.getParcelableArrayListExtra(intent, Intent.EXTRA_STREAM, Uri::class.java).let {
        // Update ViewModel state to change state of image(s) being shared
    }
}SharesheetSnippets.kt

การอัปเดต UI หลังจากได้รับข้อมูลอาจทำได้ง่ายๆ เพียงแค่ป้อนข้อมูลลงใน TextField หรืออาจซับซ้อนมากขึ้น เช่น การใช้ฟิลเตอร์รูปภาพที่น่าสนใจกับรูปภาพ แอปของคุณจะเป็นตัวกำหนดสิ่งที่เกิดขึ้นต่อไป

การแชร์ URL ของภาพหน้าจอ

เมื่อจับภาพหน้าจอ คุณจะแชร์ภาพหน้าจอและ URL ที่เชื่อมโยงได้ ซึ่งจะมอบประสบการณ์การใช้งานที่ดียิ่งขึ้น เมื่อได้รับ URL ให้ตรวจสอบว่าได้รับฟิลด์ EXTRA_TEXT จาก Intent ดังที่แสดงในตัวอย่างต่อไปนี้

IntentCompat.getParcelableExtra(intent, Intent.EXTRA_STREAM, Uri::class.java).let {
    // Handle the EXTRA_TEXT as well
    val extraText = intent.getCharSequenceExtra(Intent.EXTRA_TEXT)
    // Update ViewModel state to change state image being shared and the EXTRA_TEXT
    // if available
}SharesheetSnippets.kt

ตรวจสอบว่าผู้ใช้รู้จักแอปของคุณ

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

ตั้งแต่ Android 10 (ระดับ API 29) เป็นต้นไป Android Sharesheet จะใช้เฉพาะไอคอนที่ตั้งค่าไว้ในไฟล์ Manifest ในแท็ก application Android จะไม่สนใจไอคอนที่ตั้งค่าไว้ในแท็ก intent-filter และ activity