ให้แอปอื่นๆ เริ่มกิจกรรมของคุณ

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

ตัวอย่างเช่น หากคุณสร้างแอปโซเชียลที่สามารถแชร์ข้อความหรือรูปภาพกับเพื่อนของผู้ใช้ ให้รองรับ Intent ACTION_SEND จากนั้นเมื่อผู้ใช้เริ่มการดำเนินการ "แชร์" จากแอปอื่น แอปของคุณจะปรากฏเป็นตัวเลือกในกล่องโต้ตอบตัวเลือก (หรือที่เรียกว่ากล่องโต้ตอบการแก้ความกำกวม) ดังที่แสดงในรูปที่ 1

รูปที่ 1 กล่องโต้ตอบตัวเลือก

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

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

เพิ่มตัวกรอง Intent

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

ระบบอาจส่ง Intent ที่ระบุไปยังกิจกรรมหนึ่งๆ หากกิจกรรมนั้นมีตัวกรอง Intent ที่ตรงตามเกณฑ์ต่อไปนี้ของออบเจ็กต์ Intent

การทำงาน
สตริงที่ตั้งชื่อการดำเนินการที่จะทำ โดยปกติแล้วจะเป็นค่าใดค่าหนึ่งที่แพลตฟอร์มกำหนด เช่น ACTION_SEND หรือ ACTION_VIEW

ระบุข้อมูลนี้ในตัวกรอง Intent ด้วยองค์ประกอบ <action> ค่าที่คุณระบุในองค์ประกอบนี้ต้องเป็นชื่อสตริงแบบเต็มสำหรับการดำเนินการ แทนที่จะเป็นค่าคงที่ API ดังที่แสดงในตัวอย่างในหน้านี้

ข้อมูล
คำอธิบายข้อมูลที่เชื่อมโยงกับ Intent

ระบุข้อมูลนี้ในตัวกรอง Intent ด้วยองค์ประกอบ <data> คุณสามารถใช้แอตทริบิวต์อย่างน้อย 1 รายการในองค์ประกอบนี้เพื่อระบุประเภท MIME, คำนำหน้า URI, สคีม URI หรือการรวมกันของสิ่งเหล่านี้และอื่นๆ ที่ระบุประเภทข้อมูลที่ยอมรับ

หมายเหตุ: หากไม่จำเป็นต้องประกาศข้อมูลที่เฉพาะเจาะจงเกี่ยวกับข้อมูลUri เช่น เมื่อกิจกรรมของคุณจัดการข้อมูล "เพิ่มเติม" ประเภทอื่นๆ แทน URI ให้ระบุเฉพาะแอตทริบิวต์ android:mimeType เพื่อประกาศประเภทข้อมูลที่กิจกรรมของคุณจัดการ เช่น text/plain หรือ image/jpeg

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

ระบุข้อมูลนี้ในตัวกรอง Intent ด้วยองค์ประกอบ <category>

ในตัวกรอง Intent คุณสามารถประกาศเกณฑ์ที่กิจกรรมยอมรับได้โดยประกาศเกณฑ์แต่ละรายการด้วยองค์ประกอบ XML ที่เกี่ยวข้องซึ่งฝังอยู่ในองค์ประกอบ <intent-filter>

ตัวอย่างเช่น ต่อไปนี้เป็นกิจกรรมที่มีตัวกรอง Intent ซึ่งจัดการ Intent ACTION_SEND เมื่อประเภทข้อมูลเป็นข้อความหรือรูปภาพ

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

เคล็ดลับ: หากต้องการให้ไอคอนในกล่องโต้ตอบของเครื่องมือเลือกแตกต่างจากไอคอนเริ่มต้นของกิจกรรม ให้เพิ่ม android:icon ในองค์ประกอบ <intent-filter>

Intent ขาเข้าแต่ละรายการจะระบุการดำเนินการเพียง 1 รายการและประเภทข้อมูลเพียง 1 ประเภท แต่คุณสามารถประกาศอินสแตนซ์หลายรายการขององค์ประกอบ <action>, <category> และ <data> ใน <intent-filter> แต่ละรายการได้

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

ตัวอย่างเช่น สมมติว่ากิจกรรมของคุณจัดการทั้งข้อความและรูปภาพสำหรับทั้ง Intent ACTION_SEND และ ACTION_SENDTO ในกรณีนี้ คุณต้องกำหนดตัวกรอง Intent 2 รายการแยกกันสำหรับการดำเนินการ 2 รายการ เนื่องจาก Intent ACTION_SENDTO ต้องใช้ข้อมูล Uri เพื่อระบุที่อยู่ของผู้รับโดยใช้สคีม URI send หรือ sendto ดังที่แสดงในตัวอย่างต่อไปนี้

<activity android:name="ShareActivity">
    <!-- Filter for sending text; accepts SENDTO action with sms URI schemes -->
    <intent-filter>
        <action android:name="android.intent.action.SENDTO"/>
        <category android:name="android.intent.category.DEFAULT"/>
        <data android:scheme="sms" />
        <data android:scheme="smsto" />
    </intent-filter>
    <!-- Filter for sending text or images; accepts SEND action and text or image data -->
    <intent-filter>
        <action android:name="android.intent.action.SEND"/>
        <category android:name="android.intent.category.DEFAULT"/>
        <data android:mimeType="image/*"/>
        <data android:mimeType="text/plain"/>
    </intent-filter>
</activity>

หมายเหตุ: หากต้องการรับ Intent โดยนัย คุณต้องรวมหมวดหมู่ CATEGORY_DEFAULT ไว้ในตัวกรอง Intent เมธอด startActivity() และ startActivityForResult() จะถือว่า Intent ทั้งหมดเป็นเหมือนกับว่าได้ประกาศหมวดหมู่ CATEGORY_DEFAULT ไว้ หากคุณไม่ได้ประกาศไว้ในตัวกรอง Intent จะไม่มี Intent โดยนัยที่แก้ไขกิจกรรมของคุณ

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

จัดการ Intent ในกิจกรรม

หากต้องการตัดสินใจว่าจะดำเนินการใดในกิจกรรม ให้อ่าน Intent ที่ใช้เพื่อเริ่มกิจกรรม

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

ดังที่แสดงในตัวอย่างต่อไปนี้

Kotlin

override fun onCreate(savedInstanceState: Bundle?) {
    super.onCreate(savedInstanceState)

    setContentView(R.layout.main)

    val data: Uri? = intent?.data

    // Figure out what to do based on the intent type
    if (intent?.type?.startsWith("image/") == true) {
        // Handle intents with image data
    } else if (intent?.type == "text/plain") {
        // Handle intents with text
    }
}

Java

@Override
protected void onCreate(Bundle savedInstanceState) {
    super.onCreate(savedInstanceState);

    setContentView(R.layout.main);

    // Get the intent that started this activity
    Intent intent = getIntent();
    Uri data = intent.getData();

    // Figure out what to do based on the intent type
    if (intent.getType().indexOf("image/") != -1) {
        // Handle intents with image data
    } else if (intent.getType().equals("text/plain")) {
        // Handle intents with text
    }
}

แสดงผลลัพธ์

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

Kotlin

// Create intent to deliver some kind of result data
Intent("com.example.RESULT_ACTION", Uri.parse("content://result_uri")).also { result ->
    setResult(Activity.RESULT_OK, result)
}
finish()

Java

// Create intent to deliver some kind of result data
Intent result = new Intent("com.example.RESULT_ACTION", Uri.parse("content://result_uri"));
setResult(Activity.RESULT_OK, result);
finish();

คุณต้องระบุรหัสผลลัพธ์พร้อมกับผลลัพธ์เสมอ โดยทั่วไปจะเป็น RESULT_OK หรือ RESULT_CANCELED จากนั้นคุณจะระบุข้อมูลเพิ่มเติมด้วย Intent ได้ตามความจำเป็น

หมายเหตุ: ระบบจะตั้งค่าผลลัพธ์เป็น RESULT_CANCELED โดยค่าเริ่มต้น ดังนั้น หากผู้ใช้แตะปุ่มย้อนกลับก่อนที่จะดำเนินการเสร็จสิ้นและก่อนที่คุณจะตั้งค่าผลลัพธ์ กิจกรรมเดิมจะได้รับผลลัพธ์ "ยกเลิก"

หากต้องการเพียงแค่แสดงผลจำนวนเต็มที่ระบุตัวเลือกผลลัพธ์อย่างใดอย่างหนึ่ง คุณสามารถตั้งค่ารหัสผลลัพธ์เป็นค่าใดก็ได้ที่มากกว่า 0 หากคุณใช้รหัสผลลัพธ์เพื่อส่งจำนวนเต็มและไม่จำเป็นต้องรวม Intent คุณสามารถเรียกใช้ setResult() และส่งเฉพาะรหัสผลลัพธ์ได้ ดังนี้

Kotlin

setResult(RESULT_COLOR_RED)
finish()

Java

setResult(RESULT_COLOR_RED);
finish();

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

หมายเหตุ: คุณไม่จำเป็นต้องตรวจสอบว่ากิจกรรมเริ่มต้นด้วย startActivity() หรือ startActivityForResult() หรือไม่ เพียงเรียกใช้ setResult() หาก Intent ที่เริ่มกิจกรรม อาจคาดหวังผลลัพธ์ หากกิจกรรมต้นทางเรียกใช้ startActivityForResult() ระบบจะส่ง ผลลัพธ์ที่คุณระบุไปยัง setResult() ไม่เช่นนั้น ระบบจะไม่สนใจผลลัพธ์ดังกล่าว