หากแอปของคุณสามารถดำเนินการที่อาจเป็นประโยชน์ต่อแอปอื่น ให้เตรียมแอปให้พร้อมตอบสนองต่อคำขอดำเนินการโดยระบุตัวกรอง 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() ไม่เช่นนั้น ระบบจะไม่สนใจผลลัพธ์ดังกล่าว