Intent ทั่วไป

val REQUEST_IMAGE_CAPTURE = 1

private fun dispatchTakePictureIntent() {
    val takePictureIntent = Intent(MediaStore.ACTION_IMAGE_CAPTURE)
    try {
        startActivityForResult(takePictureIntent, REQUEST_IMAGE_CAPTURE)
    } catch (e: ActivityNotFoundException) {
        // Display error state to the user.
    }
}

static final int REQUEST_IMAGE_CAPTURE = 1;

private void dispatchTakePictureIntent() {
    Intent takePictureIntent = new Intent(MediaStore.ACTION_IMAGE_CAPTURE);
    try {
        startActivityForResult(takePictureIntent, REQUEST_IMAGE_CAPTURE);
    } catch (ActivityNotFoundException e) {
        // Display error state to the user.
    }
}
</section></div>

ดูข้อมูลเพิ่มเติมเกี่ยวกับวิธีใช้ Intent นี้เพื่อจับภาพ รวมถึงวิธีสร้าง Uri ที่เหมาะสมสําหรับตําแหน่งเอาต์พุตได้ที่หัวข้อถ่ายภาพหรือถ่ายวิดีโอ

ตัวอย่างตัวกรอง Intent:

<activity ...>
    <intent-filter>
        <action android:name="android.media.action.IMAGE_CAPTURE" />
        <category android:name="android.intent.category.DEFAULT" />
    </intent-filter>
</activity>

เมื่อจัดการกับ Intent นี้ ให้กิจกรรมตรวจสอบรายการเพิ่มเติม EXTRA_OUTPUT ใน Intent ที่เข้ามา จากนั้นบันทึกรูปภาพหรือวิดีโอที่จับภาพไว้ที่ตำแหน่งที่ระบุโดยรายการเพิ่มเติมนั้น และเรียก setResult() ด้วย Intent ที่มีภาพขนาดย่อที่บีบอัดแล้วในรายการเพิ่มเติมชื่อ "data"

เริ่มแอปกล้องถ่ายรูปในโหมดภาพนิ่ง

การสั่งงานด้วยเสียงของ Google

• "ถ่ายรูป"

หากต้องการเปิดแอปกล้องในโหมดภาพนิ่ง ให้ใช้การดำเนินการ INTENT_ACTION_STILL_IMAGE_CAMERA

การดำเนินการ

INTENT_ACTION_STILL_IMAGE_CAMERA

รูปแบบ URI ของข้อมูล

ไม่มี

ประเภท MIME

ไม่มี

พิเศษ

ไม่มี

ตัวอย่าง Intent:

private fun dispatchTakePictureIntent() {
    val takePictureIntent = Intent(MediaStore.ACTION_IMAGE_CAPTURE)
    try {
        startActivityForResult(takePictureIntent, REQUEST_IMAGE_CAPTURE)
    } catch (e: ActivityNotFoundException) {
        // Display error state to the user.
    }
}

public void capturePhoto(String targetFilename) {
    Intent intent = new Intent(MediaStore.ACTION_IMAGE_CAPTURE);
    intent.putExtra(MediaStore.EXTRA_OUTPUT,
            Uri.withAppendedPath(locationForPhotos, targetFilename));
    if (intent.resolveActivity(getPackageManager()) != null) {
        startActivityForResult(intent, REQUEST_IMAGE_CAPTURE);
    }
}

ตัวอย่างตัวกรอง Intent:

<activity ...>
    <intent-filter>
        <action android:name="android.media.action.STILL_IMAGE_CAMERA" />
        <category android:name="android.intent.category.DEFAULT" />
    </intent-filter>
</activity>

เริ่มแอปกล้องในโหมดวิดีโอ

การสั่งงานด้วยเสียงของ Google

• "บันทึกวิดีโอ"

หากต้องการเปิดแอปกล้องถ่ายรูปในโหมดวิดีโอ ให้ใช้การดำเนินการ INTENT_ACTION_VIDEO_CAMERA

การดำเนินการ

INTENT_ACTION_VIDEO_CAMERA

รูปแบบ URI ของข้อมูล

ไม่มี

ประเภท MIME

ไม่มี

พิเศษ

ไม่มี

ตัวอย่าง Intent:

fun capturePhoto() {
    val intent = Intent(MediaStore.INTENT_ACTION_VIDEO_CAMERA)
    if (intent.resolveActivity(packageManager) != null) {
        startActivityForResult(intent, REQUEST_IMAGE_CAPTURE)
    }
}

public void capturePhoto() {
    Intent intent = new Intent(MediaStore.INTENT_ACTION_VIDEO_CAMERA);
    if (intent.resolveActivity(getPackageManager()) != null) {
        startActivityForResult(intent, REQUEST_IMAGE_CAPTURE);
    }
}

ตัวอย่างตัวกรอง Intent:

<activity ...>
    <intent-filter>
        <action android:name="android.media.action.VIDEO_CAMERA" />
        <category android:name="android.intent.category.DEFAULT" />
    </intent-filter>
</activity>

แอปรายชื่อติดต่อ/ผู้คน

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

เลือกรายชื่อติดต่อ

หากต้องการให้ผู้ใช้เลือกรายชื่อติดต่อและอนุญาตให้แอปเข้าถึงข้อมูลติดต่อทั้งหมด ให้ใช้การดำเนินการ ACTION_PICK และระบุประเภท MIME เป็น Contacts.CONTENT_TYPE

ผลลัพธ์ Intent ที่ส่งไปยังการเรียกกลับ onActivityResult() จะมี content: URI ที่ชี้ไปยังรายชื่อติดต่อที่เลือก การตอบกลับจะมอบสิทธิ์ชั่วคราวแก่แอปในการอ่านรายชื่อติดต่อนั้นโดยใช้ Contacts Provider API แม้ว่าแอปจะไม่มีสิทธิ์ READ_CONTACTS ก็ตาม

เคล็ดลับ: หากต้องการเข้าถึงเฉพาะข้อมูลติดต่อบางอย่าง เช่น หมายเลขโทรศัพท์หรืออีเมล โปรดดูส่วนถัดไปเกี่ยวกับวิธีเลือกข้อมูลติดต่อที่เฉพาะเจาะจง

การดำเนินการ

ACTION_PICK

รูปแบบ URI ของข้อมูล

ไม่มี

ประเภท MIME

Contacts.CONTENT_TYPE

ตัวอย่าง Intent:

const val REQUEST_SELECT_CONTACT = 1

fun selectContact() {
    val intent = Intent(Intent.ACTION_PICK).apply {
        type = ContactsContract.Contacts.CONTENT_TYPE
    }
    if (intent.resolveActivity(packageManager) != null) {
        startActivityForResult(intent, REQUEST_SELECT_CONTACT)
    }
}

override fun onActivityResult(requestCode: Int, resultCode: Int, data: Intent) {
    if (requestCode == REQUEST_SELECT_CONTACT && resultCode == RESULT_OK) {
        val contactUri: Uri = data.data
        // Do something with the selected contact at contactUri.
        //...
    }
}

static final int REQUEST_SELECT_CONTACT = 1;

public void selectContact() {
    Intent intent = new Intent(Intent.ACTION_PICK);
    intent.setType(ContactsContract.Contacts.CONTENT_TYPE);
    if (intent.resolveActivity(getPackageManager()) != null) {
        startActivityForResult(intent, REQUEST_SELECT_CONTACT);
    }
}

@Override
protected void onActivityResult(int requestCode, int resultCode, Intent data) {
    if (requestCode == REQUEST_SELECT_CONTACT && resultCode == RESULT_OK) {
        Uri contactUri = data.getData();
        // Do something with the selected contact at contactUri.
        ...
    }
}

ดูข้อมูลเกี่ยวกับวิธีดึงข้อมูลติดต่อเมื่อคุณมี URI ของรายชื่อติดต่อได้ที่หัวข้อดึงข้อมูลสำหรับรายชื่อติดต่อ

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

เลือกข้อมูลติดต่อที่เฉพาะเจาะจง

หากต้องการให้ผู้ใช้เลือกข้อมูลที่ต้องการจากรายชื่อติดต่อ เช่น หมายเลขโทรศัพท์ อีเมล หรือข้อมูลประเภทอื่นๆ ให้ใช้การดำเนินการ ACTION_PICK และระบุประเภท MIME เป็นประเภทเนื้อหาต่อไปนี้ เช่น CommonDataKinds.Phone.CONTENT_TYPE เพื่อรับหมายเลขโทรศัพท์ของรายชื่อติดต่อ

หมายเหตุ: ในหลายกรณี แอปของคุณต้องมีสิทธิ์ READ_CONTACTS เพื่อดูข้อมูลที่เฉพาะเจาะจงเกี่ยวกับรายชื่อติดต่อหนึ่งๆ

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

ผลลัพธ์ Intent ที่ส่งไปยังการเรียกกลับ onActivityResult() จะมี content: URI ที่ชี้ไปยังข้อมูลติดต่อที่เลือก การตอบกลับจะมอบสิทธิ์ชั่วคราวแก่แอปในการอ่านข้อมูลติดต่อนั้น แม้ว่าแอปจะไม่มีสิทธิ์ READ_CONTACTS ก็ตาม

การดำเนินการ

ACTION_PICK

รูปแบบ URI ของข้อมูล

ไม่มี

ประเภท MIME

CommonDataKinds.Phone.CONTENT_TYPE

เลือกจากรายชื่อติดต่อที่มีหมายเลขโทรศัพท์

CommonDataKinds.Email.CONTENT_TYPE

เลือกจากรายชื่อติดต่อที่มีอีเมล

CommonDataKinds.StructuredPostal.CONTENT_TYPE

เลือกจากผู้ติดต่อที่มีที่อยู่ไปรษณีย์

หรือค่า CONTENT_TYPE อื่นๆ ใดค่าหนึ่งภายใต้ ContactsContract

ตัวอย่าง Intent:

const val REQUEST_SELECT_PHONE_NUMBER = 1

fun selectContact() {
    // Start an activity for the user to pick a phone number from contacts.
    val intent = Intent(Intent.ACTION_PICK).apply {
        type = CommonDataKinds.Phone.CONTENT_TYPE
    }
    if (intent.resolveActivity(packageManager) != null) {
        startActivityForResult(intent, REQUEST_SELECT_PHONE_NUMBER)
    }
}

override fun onActivityResult(requestCode: Int, resultCode: Int, data: Intent) {
    if (requestCode == REQUEST_SELECT_PHONE_NUMBER && resultCode == Activity.RESULT_OK) {
        // Get the URI and query the content provider for the phone number.
        val contactUri: Uri = data.data
        val projection: Array<String> = arrayOf(CommonDataKinds.Phone.NUMBER)
        contentResolver.query(contactUri, projection, null, null, null).use { cursor ->
            // If the cursor returned is valid, get the phone number.
            if (cursor.moveToFirst()) {
                val numberIndex = cursor.getColumnIndex(CommonDataKinds.Phone.NUMBER)
                val number = cursor.getString(numberIndex)
                // Do something with the phone number.
                ...
            }
        }
    }
}

static final int REQUEST_SELECT_PHONE_NUMBER = 1;

public void selectContact() {
    // Start an activity for the user to pick a phone number from contacts.
    Intent intent = new Intent(Intent.ACTION_PICK);
    intent.setType(CommonDataKinds.Phone.CONTENT_TYPE);
    if (intent.resolveActivity(getPackageManager()) != null) {
        startActivityForResult(intent, REQUEST_SELECT_PHONE_NUMBER);
    }
}

@Override
protected void onActivityResult(int requestCode, int resultCode, Intent data) {
    if (requestCode == REQUEST_SELECT_PHONE_NUMBER && resultCode == RESULT_OK) {
        // Get the URI and query the content provider for the phone number.
        Uri contactUri = data.getData();
        String[] projection = new String[]{CommonDataKinds.Phone.NUMBER};
        Cursor cursor = getContentResolver().query(contactUri, projection,
                null, null, null);
        // If the cursor returned is valid, get the phone number.
        if (cursor != null && cursor.moveToFirst()) {
            int numberIndex = cursor.getColumnIndex(CommonDataKinds.Phone.NUMBER);
            String number = cursor.getString(numberIndex);
            // Do something with the phone number.
            //...
        }
    }
}

ดูรายชื่อติดต่อ

หากต้องการแสดงรายละเอียดสำหรับผู้ติดต่อที่รู้จัก ให้ใช้การดําเนินการ ACTION_VIEW และระบุผู้ติดต่อด้วย URI content: เป็นข้อมูล Intent

การดึงข้อมูล URI ของผู้ติดต่อในตอนแรกทำได้ 2 วิธีหลักๆ ดังนี้

• ใช้ URI ติดต่อที่แสดงผลจากการดำเนินการ ACTION_PICK ที่แสดงในส่วนก่อนหน้า แนวทางนี้ไม่จําเป็นต้องใช้สิทธิ์ของแอป
• เข้าถึงรายชื่อติดต่อทั้งหมดโดยตรง ตามที่อธิบายไว้ในดึงข้อมูลรายชื่อติดต่อ แนวทางนี้ต้องใช้สิทธิ์ READ_CONTACTS

การดำเนินการ

ACTION_VIEW

รูปแบบ URI ของข้อมูล

content:<URI>

ประเภท MIME

ไม่มี ระบบจะอนุมานประเภทจาก URI ของข้อมูลติดต่อ

ตัวอย่าง Intent:

fun viewContact(contactUri: Uri) {
    val intent = Intent(Intent.ACTION_VIEW, contactUri)
    if (intent.resolveActivity(packageManager) != null) {
        startActivity(intent)
    }
}

public void viewContact(Uri contactUri) {
    Intent intent = new Intent(Intent.ACTION_VIEW, contactUri);
    if (intent.resolveActivity(getPackageManager()) != null) {
        startActivity(intent);
    }
}

แก้ไขผู้ติดต่อที่มีอยู่

หากต้องการแก้ไขรายชื่อติดต่อที่รู้จัก ให้ใช้การดําเนินการ ACTION_EDIT ระบุรายชื่อติดต่อด้วย URI content: เป็นข้อมูล Intent และใส่ข้อมูลติดต่อที่รู้จักไว้ในข้อมูลเพิ่มเติมที่ระบุโดยค่าคงที่ใน ContactsContract.Intents.Insert

การดึงข้อมูล URI ติดต่อในขั้นต้นทำได้ 2 วิธีหลักๆ ดังนี้

• ใช้ URI ติดต่อที่แสดงผลจากการดำเนินการ ACTION_PICK ที่แสดงในส่วนก่อนหน้า แนวทางนี้ไม่จําเป็นต้องใช้สิทธิ์ของแอป
• เข้าถึงรายชื่อติดต่อทั้งหมดโดยตรง ตามที่อธิบายไว้ในดึงข้อมูลรายชื่อติดต่อ แนวทางนี้ต้องใช้สิทธิ์ READ_CONTACTS

การดำเนินการ

ACTION_EDIT

รูปแบบ URI ของข้อมูล

content:<URI>

ประเภท MIME

ระบบจะอนุมานประเภทจาก URI ของรายชื่อติดต่อ

พิเศษ

ข้อมูลเพิ่มเติมอย่างน้อย 1 รายการที่กําหนดไว้ใน ContactsContract.Intents.Insert เพื่อให้คุณป้อนข้อมูลในช่องของรายละเอียดการติดต่อได้

ตัวอย่าง Intent:

fun editContact(contactUri: Uri, email: String) {
    val intent = Intent(Intent.ACTION_EDIT).apply {
        data = contactUri
        putExtra(ContactsContract.Intents.Insert.EMAIL, email)
    }
    if (intent.resolveActivity(packageManager) != null) {
        startActivity(intent)
    }
}

public void editContact(Uri contactUri, String email) {
    Intent intent = new Intent(Intent.ACTION_EDIT);
    intent.setData(contactUri);
    intent.putExtra(Intents.Insert.EMAIL, email);
    if (intent.resolveActivity(getPackageManager()) != null) {
        startActivity(intent);
    }
}

ดูข้อมูลเพิ่มเติมเกี่ยวกับวิธีแก้ไขรายชื่อติดต่อได้ที่แก้ไขรายชื่อติดต่อโดยใช้ Intent

แทรกรายชื่อติดต่อ

หากต้องการแทรกรายชื่อติดต่อใหม่ ให้ใช้การดำเนินการ ACTION_INSERT โดยระบุ Contacts.CONTENT_TYPE เป็นประเภท MIME และใส่ข้อมูลติดต่อที่ทราบไว้ในส่วนเพิ่มเติมที่ระบุโดยค่าคงที่ใน ContactsContract.Intents.Insert

การดำเนินการ

ACTION_INSERT

รูปแบบ URI ของข้อมูล

ไม่มี

ประเภท MIME

Contacts.CONTENT_TYPE

พิเศษ

ฟีเจอร์เสริมที่ระบุไว้ใน ContactsContract.Intents.Insert อย่างน้อย 1 รายการ

ตัวอย่าง Intent:

fun insertContact(name: String, email: String) {
    val intent = Intent(Intent.ACTION_INSERT).apply {
        type = ContactsContract.Contacts.CONTENT_TYPE
        putExtra(ContactsContract.Intents.Insert.NAME, name)
        putExtra(ContactsContract.Intents.Insert.EMAIL, email)
    }
    if (intent.resolveActivity(packageManager) != null) {
        startActivity(intent)
    }
}

public void insertContact(String name, String email) {
    Intent intent = new Intent(Intent.ACTION_INSERT);
    intent.setType(Contacts.CONTENT_TYPE);
    intent.putExtra(Intents.Insert.NAME, name);
    intent.putExtra(Intents.Insert.EMAIL, email);
    if (intent.resolveActivity(getPackageManager()) != null) {
        startActivity(intent);
    }
}

ดูข้อมูลเพิ่มเติมเกี่ยวกับวิธีแทรกรายชื่อติดต่อได้ที่หัวข้อแก้ไขรายชื่อติดต่อโดยใช้ Intent

อีเมล

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

เขียนอีเมลพร้อมไฟล์แนบ (ไม่บังคับ)

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

การดำเนินการ

ACTION_SENDTO (สำหรับไม่มีไฟล์แนบ) หรือ
ACTION_SEND (สำหรับไฟล์แนบ 1 รายการ) หรือ
ACTION_SEND_MULTIPLE (สำหรับไฟล์แนบหลายรายการ)

รูปแบบ URI ของข้อมูล

ไม่มี

ประเภท MIME

"text/plain"

"*/*"

พิเศษ

Intent.EXTRA_EMAIL

อาร์เรย์สตริงของอีเมลผู้รับ "ถึง" ทั้งหมด

Intent.EXTRA_CC

อาร์เรย์สตริงของอีเมลผู้รับ "สำเนา" ทั้งหมด

Intent.EXTRA_BCC

อาร์เรย์สตริงของอีเมลผู้รับ "สำเนาลับ" ทั้งหมด

Intent.EXTRA_SUBJECT

สตริงที่มีเรื่องอีเมล

Intent.EXTRA_TEXT

สตริงที่มีเนื้อหาของอีเมล

Intent.EXTRA_STREAM

Uri ที่ชี้ไปที่ไฟล์แนบ หากใช้การดําเนินการ ACTION_SEND_MULTIPLE แทน รายการนี้จะเป็น ArrayList ที่มีออบเจ็กต์ Uri หลายรายการ

ตัวอย่าง Intent:

fun composeEmail(addresses: Array<String>, subject: String, attachment: Uri) {
    val intent = Intent(Intent.ACTION_SEND).apply {
        type = "*/*"
        putExtra(Intent.EXTRA_EMAIL, addresses)
        putExtra(Intent.EXTRA_SUBJECT, subject)
        putExtra(Intent.EXTRA_STREAM, attachment)
    }
    if (intent.resolveActivity(packageManager) != null) {
        startActivity(intent)
    }
}

public void composeEmail(String[] addresses, String subject, Uri attachment) {
    Intent intent = new Intent(Intent.ACTION_SEND);
    intent.setType("*/*");
    intent.putExtra(Intent.EXTRA_EMAIL, addresses);
    intent.putExtra(Intent.EXTRA_SUBJECT, subject);
    intent.putExtra(Intent.EXTRA_STREAM, attachment);
    if (intent.resolveActivity(getPackageManager()) != null) {
        startActivity(intent);
    }
}

หากต้องการให้แอปอีเมลเท่านั้นจัดการ Intent ของคุณ ไม่ใช่แอปรับส่งข้อความหรือแอปโซเชียล ให้ใช้การดำเนินการ ACTION_SENDTO และใส่รูปแบบข้อมูล "mailto:" ตามที่แสดงในตัวอย่างต่อไปนี้

fun composeEmail(addresses: Array<String>, subject: String) {
    val intent = Intent(Intent.ACTION_SENDTO).apply {
        data = Uri.parse("mailto:") // Only email apps handle this.
        putExtra(Intent.EXTRA_EMAIL, addresses)
        putExtra(Intent.EXTRA_SUBJECT, subject)
    }
    if (intent.resolveActivity(packageManager) != null) {
        startActivity(intent)
    }
}

public void composeEmail(String[] addresses, String subject) {
    Intent intent = new Intent(Intent.ACTION_SENDTO);
    intent.setData(Uri.parse("mailto:")); // Only email apps handle this.
    intent.putExtra(Intent.EXTRA_EMAIL, addresses);
    intent.putExtra(Intent.EXTRA_SUBJECT, subject);
    if (intent.resolveActivity(getPackageManager()) != null) {
        startActivity(intent);
    }
}

ตัวอย่างตัวกรอง Intent:

<activity ...>
    <intent-filter>
        <action android:name="android.intent.action.SEND" />
        <data android:type="*/*" />
        <category android:name="android.intent.category.DEFAULT" />
    </intent-filter>
    <intent-filter>
        <action android:name="android.intent.action.SENDTO" />
        <data android:scheme="mailto" />
        <category android:name="android.intent.category.DEFAULT" />
    </intent-filter>
</activity>

พื้นที่จัดเก็บไฟล์

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

เรียกข้อมูลไฟล์บางประเภท

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

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

Intent ผลลัพธ์ที่ส่งไปยังเมธอด onActivityResult() จะมีข้อมูลที่มี URI ที่ชี้ไปยังไฟล์ URI อาจเป็นอะไรก็ได้ เช่น http: URI, file: URI หรือ content: URI อย่างไรก็ตาม หากต้องการจำกัดไฟล์ที่เลือกได้เฉพาะไฟล์ที่เข้าถึงได้จากผู้ให้บริการเนื้อหา (content: URI) และไฟล์ที่พร้อมใช้งานเป็นสตรีมไฟล์ด้วย openFileDescriptor() ให้เพิ่มหมวดหมู่ CATEGORY_OPENABLE ลงใน Intent

ใน Android 4.3 (API ระดับ 18) ขึ้นไป คุณยังอนุญาตให้ผู้ใช้เลือกไฟล์หลายรายการได้โดยเพิ่ม EXTRA_ALLOW_MULTIPLE ลงใน Intent โดยตั้งค่าเป็น true จากนั้นคุณจะเข้าถึงไฟล์ที่เลือกแต่ละรายการในClipData ออบเจ็กต์ที่ getClipData() แสดงผลได้

การดำเนินการ

ACTION_GET_CONTENT

รูปแบบ URI ของข้อมูล

ไม่มี

ประเภท MIME

ประเภท MIME ที่สอดคล้องกับประเภทไฟล์ที่ผู้ใช้ต้องเลือก

พิเศษ

EXTRA_ALLOW_MULTIPLE

บูลีนที่จะประกาศว่าผู้ใช้เลือกไฟล์ได้มากกว่า 1 ไฟล์พร้อมกันหรือไม่

EXTRA_LOCAL_ONLY

บูลีนที่ประกาศว่าไฟล์ที่แสดงผลต้องพร้อมใช้งานจากอุปกรณ์โดยตรงหรือไม่ แทนที่จะต้องดาวน์โหลดจากบริการระยะไกล

หมวดหมู่ (ไม่บังคับ)

CATEGORY_OPENABLE

หากต้องการแสดงเฉพาะไฟล์ที่ "เปิดได้" ซึ่งแสดงเป็นสตรีมไฟล์ได้ ให้ใช้ openFileDescriptor()

ตัวอย่างความตั้งใจที่จะถ่ายภาพ

const val REQUEST_IMAGE_GET = 1

fun selectImage() {
    val intent = Intent(Intent.ACTION_GET_CONTENT).apply {
        type = "image/*"
    }
    if (intent.resolveActivity(packageManager) != null) {
        startActivityForResult(intent, REQUEST_IMAGE_GET)
    }
}

override fun onActivityResult(requestCode: Int, resultCode: Int, data: Intent) {
    if (requestCode == REQUEST_IMAGE_GET && resultCode == Activity.RESULT_OK) {
        val thumbnail: Bitmap = data.getParcelableExtra("data")
        val fullPhotoUri: Uri = data.data
        // Do work with photo saved at fullPhotoUri.
        ...
    }
}

static final int REQUEST_IMAGE_GET = 1;

public void selectImage() {
    Intent intent = new Intent(Intent.ACTION_GET_CONTENT);
    intent.setType("image/*");
    if (intent.resolveActivity(getPackageManager()) != null) {
        startActivityForResult(intent, REQUEST_IMAGE_GET);
    }
}

@Override
protected void onActivityResult(int requestCode, int resultCode, Intent data) {
    if (requestCode == REQUEST_IMAGE_GET && resultCode == RESULT_OK) {
        Bitmap thumbnail = data.getParcelable("data");
        Uri fullPhotoUri = data.getData();
        // Do work with photo saved at fullPhotoUri.
        ...
    }
}

ตัวอย่างตัวกรอง Intent เพื่อแสดงรูปภาพ

<activity ...>
    <intent-filter>
        <action android:name="android.intent.action.GET_CONTENT" />
        <data android:type="image/*" />
        <category android:name="android.intent.category.DEFAULT" />
        <!-- The OPENABLE category declares that the returned file is accessible
             from a content provider that supports OpenableColumns
             and ContentResolver.openFileDescriptor(). -->
        <category android:name="android.intent.category.OPENABLE" />
    </intent-filter>
</activity>

เปิดไฟล์บางประเภท

เมื่อใช้การดำเนินการ ACTION_GET_CONTENT บน Android 4.4 ขึ้นไป คุณสามารถขอเปิดไฟล์ที่แอปอื่นจัดการได้แทนการดึงข้อมูลสำเนาไฟล์ที่คุณต้องนำเข้าไปยังแอป โดยใช้การดำเนินการ ACTION_OPEN_DOCUMENT และระบุประเภท MIME หากต้องการให้ผู้ใช้สร้างเอกสารใหม่ที่แอปของคุณเขียนได้ ให้ใช้การดำเนินการ ACTION_CREATE_DOCUMENT แทน

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

แม้ว่า Intent ที่ส่งไปยังonActivityResult()วิธีจากการดำเนินการ ACTION_GET_CONTENT อาจแสดงผลเป็น URI ประเภทใดก็ได้ แต่ Intent ของผลลัพธ์จาก ACTION_OPEN_DOCUMENT และ ACTION_CREATE_DOCUMENT จะระบุไฟล์ที่เลือกเป็น URI content: ที่รองรับ DocumentsProvider เสมอ คุณสามารถเปิดไฟล์ด้วย openFileDescriptor() และค้นหารายละเอียดโดยใช้คอลัมน์จาก DocumentsContract.Document

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

นอกจากนี้ คุณยังอนุญาตให้ผู้ใช้เลือกไฟล์หลายรายการได้โดยเพิ่ม EXTRA_ALLOW_MULTIPLE ลงใน Intent ซึ่งตั้งค่าเป็น true หากผู้ใช้เลือกเพียงรายการเดียว คุณจะดึงข้อมูลรายการนั้นได้จาก getData() หากผู้ใช้เลือกมากกว่า 1 รายการ getData() จะแสดงผลเป็น Null และคุณต้องดึงข้อมูลแต่ละรายการจากออบเจ็กต์ ClipData ที่ getClipData() แสดงผลแทน

หมายเหตุ: Intent ต้องระบุประเภท MIME และต้องประกาศหมวดหมู่ CATEGORY_OPENABLE หากเหมาะสม คุณสามารถระบุประเภท MIME ได้มากกว่า 1 ประเภทโดยเพิ่มอาร์เรย์ประเภท MIME ที่มี EXTRA_MIME_TYPES เพิ่มเติม หากต้องการทำเช่นนั้น คุณต้องตั้งค่าประเภท MIME หลักใน setType() เป็น "*/*"

การดำเนินการ

ACTION_OPEN_DOCUMENT หรือ
ACTION_CREATE_DOCUMENT

รูปแบบ URI ของข้อมูล

ไม่มี

ประเภท MIME

ประเภท MIME ที่สอดคล้องกับประเภทไฟล์ที่ผู้ใช้ต้องเลือก

พิเศษ

EXTRA_MIME_TYPES

อาร์เรย์ประเภท MIME ที่สอดคล้องกับประเภทไฟล์ที่แอปของคุณขอ เมื่อใช้ส่วนเสริมนี้ คุณต้องตั้งค่าประเภท MIME หลักใน setType() เป็น "*/*"

EXTRA_ALLOW_MULTIPLE

บูลีนที่จะประกาศว่าผู้ใช้เลือกไฟล์ได้มากกว่า 1 ไฟล์พร้อมกันหรือไม่

EXTRA_TITLE

สําหรับใช้กับ ACTION_CREATE_DOCUMENT เพื่อระบุชื่อไฟล์เริ่มต้น

EXTRA_LOCAL_ONLY

บูลีนที่ประกาศว่าไฟล์ที่แสดงผลต้องพร้อมใช้งานจากอุปกรณ์โดยตรงหรือไม่ แทนที่จะต้องดาวน์โหลดจากบริการระยะไกล

หมวดหมู่

CATEGORY_OPENABLE

หากต้องการแสดงเฉพาะไฟล์ที่ "เปิดได้" ซึ่งแสดงเป็นสตรีมไฟล์ได้ ให้ใช้ openFileDescriptor()

ตัวอย่างความตั้งใจที่จะถ่ายภาพ

const val REQUEST_IMAGE_OPEN = 1

fun selectImage2() {
    val intent = Intent(Intent.ACTION_OPEN_DOCUMENT).apply {
        type = "image/*"
        addCategory(Intent.CATEGORY_OPENABLE)
    }
    // Only the system receives the ACTION_OPEN_DOCUMENT, so no need to test.
    startActivityForResult(intent, REQUEST_IMAGE_OPEN)
}

override fun onActivityResult(requestCode: Int, resultCode: Int, data: Intent) {
    if (requestCode == REQUEST_IMAGE_OPEN && resultCode == Activity.RESULT_OK) {
        val fullPhotoUri: Uri = data.data
        // Do work with full size photo saved at fullPhotoUri.
        ...
    }
}

static final int REQUEST_IMAGE_OPEN = 1;

public void selectImage() {
    Intent intent = new Intent(Intent.ACTION_OPEN_DOCUMENT);
    intent.setType("image/*");
    intent.addCategory(Intent.CATEGORY_OPENABLE);
    // Only the system receives the ACTION_OPEN_DOCUMENT, so no need to test.
    startActivityForResult(intent, REQUEST_IMAGE_OPEN);
}

@Override
protected void onActivityResult(int requestCode, int resultCode, Intent data) {
    if (requestCode == REQUEST_IMAGE_OPEN && resultCode == RESULT_OK) {
        Uri fullPhotoUri = data.getData();
        // Do work with full size photo saved at fullPhotoUri.
        ...
    }
}

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

หากต้องการแสดงไฟล์ของแอปใน UI นี้และอนุญาตให้แอปอื่นๆ เปิดไฟล์เหล่านั้น คุณต้องติดตั้งใช้งาน DocumentsProvider และใส่ตัวกรอง Intent สำหรับ PROVIDER_INTERFACE ("android.content.action.DOCUMENTS_PROVIDER") ดังที่แสดงในตัวอย่างต่อไปนี้

<provider ...
    android:grantUriPermissions="true"
    android:exported="true"
    android:permission="android.permission.MANAGE_DOCUMENTS">
    <intent-filter>
        <action android:name="android.content.action.DOCUMENTS_PROVIDER" />
    </intent-filter>
</provider>

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

การกระทำเกี่ยวกับสถานที่

การเรียกรถเป็นการกระทำเกี่ยวกับสถานที่ที่พบบ่อย สร้างตัวกรอง Intent เพื่อโฆษณาความสามารถของแอปในการดําเนินการนี้โดยใช้ข้อมูลในส่วนต่อไปนี้

โทรเรียกรถ

การสั่งงานด้วยเสียงของ Google

• "เรียกแท็กซี่ให้ฉันหน่อย"
• "เรียกรถให้ฉัน"

(Wear OS เท่านั้น)

หากต้องการเรียกแท็กซี่ ให้ใช้การดำเนินการ ACTION_RESERVE_TAXI_RESERVATION

หมายเหตุ: แอปต้องขอการยืนยันจากผู้ใช้ก่อนดำเนินการนี้ให้เสร็จสมบูรณ์

การดำเนินการ

ACTION_RESERVE_TAXI_RESERVATION

Data URI

ไม่มี

ประเภท MIME

ไม่มี

พิเศษ

ไม่มี

ตัวอย่าง Intent:

fun callCar() {
    val intent = Intent(ReserveIntents.ACTION_RESERVE_TAXI_RESERVATION)
    if (intent.resolveActivity(packageManager) != null) {
        startActivity(intent)
    }
}

public void callCar() {
    Intent intent = new Intent(ReserveIntents.ACTION_RESERVE_TAXI_RESERVATION);
    if (intent.resolveActivity(getPackageManager()) != null) {
        startActivity(intent);
    }
}

ตัวอย่างตัวกรอง Intent:

<activity ...>
    <intent-filter>
        <action android:name="com.google.android.gms.actions.RESERVE_TAXI_RESERVATION" />
        <category android:name="android.intent.category.DEFAULT" />
    </intent-filter>
</activity>

แผนที่

การแสดงตำแหน่งบนแผนที่เป็นการดำเนินการทั่วไปของแอปแผนที่ สร้างตัวกรอง Intent เพื่อโฆษณาความสามารถของแอปในการดําเนินการนี้โดยใช้ข้อมูลในส่วนต่อไปนี้

แสดงตำแหน่งบนแผนที่

หากต้องการเปิดแผนที่ ให้ใช้การดำเนินการ ACTION_VIEW และระบุข้อมูลตำแหน่งในข้อมูล Intent ด้วยรูปแบบใดรูปแบบหนึ่งต่อไปนี้

การดำเนินการ

ACTION_VIEW

รูปแบบ URI ของข้อมูล

geo:latitude,longitude

แสดงแผนที่ที่ลองจิจูดและละติจูดที่ระบุ

ตัวอย่าง: "geo:47.6,-122.3"

geo:latitude,longitude?z=zoom

แสดงแผนที่ที่ลองจิจูดและละติจูดที่ระบุในระดับการซูมหนึ่งๆ ระดับการซูม 1 จะแสดงทั้งโลกโดยศูนย์กลางอยู่ที่ lat,lng ที่ระบุ ระดับการซูมสูงสุด (ใกล้ที่สุด) คือ 23

ตัวอย่าง: "geo:47.6,-122.3?z=11"

geo:0,0?q=lat,lng(label)

แสดงแผนที่ที่ลองจิจูดและละติจูดที่ระบุพร้อมป้ายกำกับสตริง

ตัวอย่าง: "geo:0,0?q=34.99,-106.61(Treasure)"

geo:0,0?q=my+street+address

แสดงตำแหน่งสำหรับ "ที่อยู่ของฉัน" ซึ่งอาจเป็นที่อยู่หรือคำค้นหาตำแหน่งที่เฉพาะเจาะจง

ตัวอย่าง: "geo:0,0?q=1600+Amphitheatre+Parkway%2C+CA"

หมายเหตุ: สตริงทั้งหมดที่ส่งใน URI geo ต้องมีการเข้ารหัส เช่น สตริง 1st & Pike, Seattle จะกลายเป็น 1st%20%26%20Pike%2C%20Seattle ระบบจะเข้ารหัสการเว้นวรรคในสตริงด้วย %20 หรือแทนที่ด้วยเครื่องหมายบวก (+)

ประเภท MIME

ไม่มี

ตัวอย่าง Intent:

fun showMap(geoLocation: Uri) {
    val intent = Intent(Intent.ACTION_VIEW).apply {
        data = geoLocation
    }
    if (intent.resolveActivity(packageManager) != null) {
        startActivity(intent)
    }
}

public void showMap(Uri geoLocation) {
    Intent intent = new Intent(Intent.ACTION_VIEW);
    intent.setData(geoLocation);
    if (intent.resolveActivity(getPackageManager()) != null) {
        startActivity(intent);
    }
}

ตัวอย่างตัวกรอง Intent:

<activity ...>
    <intent-filter>
        <action android:name="android.intent.action.VIEW" />
        <data android:scheme="geo" />
        <category android:name="android.intent.category.DEFAULT" />
    </intent-filter>
</activity>

เพลงหรือวิดีโอ

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

เล่นไฟล์สื่อ

หากต้องการเล่นไฟล์เพลง ให้ใช้การดำเนินการ ACTION_VIEW และระบุตำแหน่ง URI ของไฟล์ในข้อมูล Intent

การดำเนินการ

ACTION_VIEW

รูปแบบ URI ของข้อมูล

file:<URI>

content:<URI>

http:<URL>

ประเภท MIME

"audio/*"

"application/ogg"

"application/x-ogg"

"application/itunes"

หรืออื่นๆ ที่แอปของคุณกำหนด

ตัวอย่าง Intent:

fun playMedia(file: Uri) {
    val intent = Intent(Intent.ACTION_VIEW).apply {
        data = file
    }
    if (intent.resolveActivity(packageManager) != null) {
        startActivity(intent)
    }
}

public void playMedia(Uri file) {
    Intent intent = new Intent(Intent.ACTION_VIEW);
    intent.setData(file);
    if (intent.resolveActivity(getPackageManager()) != null) {
        startActivity(intent);
    }
}

ตัวอย่างตัวกรอง Intent:

<activity ...>
    <intent-filter>
        <action android:name="android.intent.action.VIEW" />
        <data android:type="audio/*" />
        <data android:type="application/ogg" />
        <category android:name="android.intent.category.DEFAULT" />
    </intent-filter>
</activity>

เปิดเพลงตามคำค้นหา

การสั่งงานด้วยเสียงของ Google

• "play michael jackson billie jean"

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

ใน Intent นี้ ให้ใส่สตริง EXTRA_MEDIA_FOCUSextra ซึ่งระบุโหมดการค้นหาที่ต้องการ ตัวอย่างเช่น โหมดการค้นหาสามารถระบุได้ว่าเป็นการค้นหาชื่อศิลปินหรือชื่อเพลง

การดำเนินการ

INTENT_ACTION_MEDIA_PLAY_FROM_SEARCH

รูปแบบ URI ของข้อมูล

ไม่มี

ประเภท MIME

ไม่มี

พิเศษ

MediaStore.EXTRA_MEDIA_FOCUS (ต้องระบุ)

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

Any - "vnd.android.cursor.item/*"

เปิดเพลง แอปที่รับจะเล่นเพลงบางส่วนตามตัวเลือกอัจฉริยะ เช่น เพลย์ลิสต์ล่าสุดที่ผู้ใช้ฟัง

ฟีเจอร์เพิ่มเติม

• QUERY (ต้องระบุ): สตริงว่าง เรามีตัวเลือกเพิ่มเติมนี้ไว้เสมอเพื่อให้ใช้กับเวอร์ชันก่อนหน้าได้ แอปที่มีอยู่ซึ่งไม่ทราบเกี่ยวกับโหมดการค้นหาจะประมวลผลความตั้งใจนี้เป็นการค้นหาที่ไม่มีโครงสร้างได้

ไม่เป็นโครงสร้าง - "vnd.android.cursor.item/*"

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

ฟีเจอร์เพิ่มเติม

• QUERY (ต้องระบุ): สตริงที่มีชุดค่าผสมของศิลปิน อัลบั้ม ชื่อเพลง หรือแนวเพลง

ประเภท - Audio.Genres.ENTRY_CONTENT_TYPE

เปิดเพลงแนวใดแนวหนึ่ง

ฟีเจอร์เพิ่มเติม

• "android.intent.extra.genre" (ต้องระบุ) - ประเภท
• QUERY (ต้องระบุ): ประเภท เรามีข้อมูลนี้ให้เสมอเพื่อให้ใช้กับเวอร์ชันก่อนหน้าได้ แอปที่มีอยู่ซึ่งไม่ทราบเกี่ยวกับโหมดการค้นหาจะประมวลผลความตั้งใจนี้เป็นการค้นหาที่ไม่มีโครงสร้างได้

ศิลปิน - Audio.Artists.ENTRY_CONTENT_TYPE

เปิดเพลงจากศิลปินที่เฉพาะเจาะจง

ฟีเจอร์เพิ่มเติม

• EXTRA_MEDIA_ARTIST (ต้องระบุ): ศิลปิน
• "android.intent.extra.genre": ประเภท
• QUERY (ต้องระบุ): สตริงที่มีชุดค่าผสมของศิลปินหรือแนวเพลง เรามีตัวเลือกเพิ่มเติมนี้ไว้เพื่อให้ใช้กับเวอร์ชันก่อนหน้าได้เสมอ แอปที่มีอยู่ซึ่งไม่ทราบเกี่ยวกับโหมดการค้นหาจะประมวลผลความตั้งใจนี้เป็นการค้นหาที่ไม่มีโครงสร้างได้

อัลบั้ม - Audio.Albums.ENTRY_CONTENT_TYPE

เปิดเพลงจากอัลบั้มที่เฉพาะเจาะจง

ฟีเจอร์เพิ่มเติม

• EXTRA_MEDIA_ALBUM (ต้องระบุ): อัลบั้ม
• EXTRA_MEDIA_ARTIST: ศิลปิน
• "android.intent.extra.genre": ประเภท
• QUERY (ต้องระบุ): สตริงที่มีชุดค่าผสมของอัลบั้มหรือศิลปิน เรามีบริการเสริมนี้ไว้เพื่อให้ใช้กับเวอร์ชันก่อนหน้าได้เสมอ แอปที่มีอยู่ซึ่งไม่ทราบเกี่ยวกับโหมดการค้นหาจะประมวลผลความตั้งใจนี้เป็นการค้นหาที่ไม่มีโครงสร้างได้

เพลง - "vnd.android.cursor.item/audio"

เล่นเพลงที่ต้องการ

ฟีเจอร์เพิ่มเติม

• EXTRA_MEDIA_ALBUM: อัลบั้ม
• EXTRA_MEDIA_ARTIST: ศิลปิน
• "android.intent.extra.genre": ประเภท
• EXTRA_MEDIA_TITLE (ต้องระบุ): ชื่อเพลง
• QUERY (ต้องระบุ): สตริงที่มีชุดค่าผสมของอัลบั้ม ศิลปิน ประเภท หรือชื่อ เรามีตัวเลือกเพิ่มเติมนี้ไว้เสมอเพื่อให้ใช้กับเวอร์ชันก่อนหน้าได้ แอปที่มีอยู่ซึ่งไม่ทราบเกี่ยวกับโหมดการค้นหาจะประมวลผลความตั้งใจนี้เป็นการค้นหาที่ไม่มีโครงสร้างได้

เพลย์ลิสต์ - Audio.Playlists.ENTRY_CONTENT_TYPE

เปิดเพลย์ลิสต์ที่เฉพาะเจาะจงหรือเพลย์ลิสต์ที่ตรงกับเกณฑ์บางอย่างที่ระบุโดยฟีเจอร์เพิ่มเติม

ฟีเจอร์เพิ่มเติม

• EXTRA_MEDIA_ALBUM: อัลบั้ม
• EXTRA_MEDIA_ARTIST: ศิลปิน
• "android.intent.extra.genre": ประเภท
• "android.intent.extra.playlist": เพลย์ลิสต์
• EXTRA_MEDIA_TITLE: ชื่อเพลงที่ใช้สร้างเพลย์ลิสต์
• QUERY (ต้องระบุ): สตริงที่มีชุดค่าผสมของอัลบั้ม ศิลปิน แนวเพลง เพลย์ลิสต์ หรือชื่อ เรามีตัวเลือกเพิ่มเติมนี้ไว้เสมอเพื่อให้ใช้กับเวอร์ชันก่อนหน้าได้ แอปที่มีอยู่ซึ่งไม่ทราบเกี่ยวกับโหมดการค้นหาจะประมวลผลความตั้งใจนี้เป็นการค้นหาที่ไม่มีโครงสร้างได้

ตัวอย่าง Intent:

หากผู้ใช้ต้องการฟังเพลงจากศิลปินที่เฉพาะเจาะจง แอปค้นหาอาจสร้าง Intent ต่อไปนี้

fun playSearchArtist(artist: String) {
    val intent = Intent(MediaStore.INTENT_ACTION_MEDIA_PLAY_FROM_SEARCH).apply {
        putExtra(MediaStore.EXTRA_MEDIA_FOCUS, MediaStore.Audio.Artists.ENTRY_CONTENT_TYPE)
        putExtra(MediaStore.EXTRA_MEDIA_ARTIST, artist)
        putExtra(SearchManager.QUERY, artist)
    }
    if (intent.resolveActivity(packageManager) != null) {
        startActivity(intent)
    }
}

public void playSearchArtist(String artist) {
    Intent intent = new Intent(MediaStore.INTENT_ACTION_MEDIA_PLAY_FROM_SEARCH);
    intent.putExtra(MediaStore.EXTRA_MEDIA_FOCUS,
                    MediaStore.Audio.Artists.ENTRY_CONTENT_TYPE);
    intent.putExtra(MediaStore.EXTRA_MEDIA_ARTIST, artist);
    intent.putExtra(SearchManager.QUERY, artist);
    if (intent.resolveActivity(getPackageManager()) != null) {
        startActivity(intent);
    }
}

ตัวอย่างตัวกรอง Intent:

<activity ...>
    <intent-filter>
        <action android:name="android.media.action.MEDIA_PLAY_FROM_SEARCH" />
        <category android:name="android.intent.category.DEFAULT" />
    </intent-filter>
</activity>

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

override fun onCreate(savedInstanceState: Bundle?) {
    ...
    if (intent.action.compareTo(MediaStore.INTENT_ACTION_MEDIA_PLAY_FROM_SEARCH) == 0) {

        val mediaFocus: String? = intent.getStringExtra(MediaStore.EXTRA_MEDIA_FOCUS)
        val query: String? = intent.getStringExtra(SearchManager.QUERY)

        // Some of these extras might not be available depending on the search mode.
        val album: String? = intent.getStringExtra(MediaStore.EXTRA_MEDIA_ALBUM)
        val artist: String? = intent.getStringExtra(MediaStore.EXTRA_MEDIA_ARTIST)
        val genre: String? = intent.getStringExtra("android.intent.extra.genre")
        val playlist: String? = intent.getStringExtra("android.intent.extra.playlist")
        val title: String? = intent.getStringExtra(MediaStore.EXTRA_MEDIA_TITLE)

        // Determine the search mode and use the corresponding extras.
        when {
            mediaFocus == null -> {
                // 'Unstructured' search mode (backward compatible)
                playUnstructuredSearch(query)
            }
            mediaFocus.compareTo("vnd.android.cursor.item/*") == 0 -> {
                if (query?.isNotEmpty() == true) {
                    // 'Unstructured' search mode.
                    playUnstructuredSearch(query)
                } else {
                    // 'Any' search mode.
                    playResumeLastPlaylist()
                }
            }
            mediaFocus.compareTo(MediaStore.Audio.Genres.ENTRY_CONTENT_TYPE) == 0 -> {
                // 'Genre' search mode.
                playGenre(genre)
            }
            mediaFocus.compareTo(MediaStore.Audio.Artists.ENTRY_CONTENT_TYPE) == 0 -> {
                // 'Artist' search mode.
                playArtist(artist, genre)
            }
            mediaFocus.compareTo(MediaStore.Audio.Albums.ENTRY_CONTENT_TYPE) == 0 -> {
                // 'Album' search mode.
                playAlbum(album, artist)
            }
            mediaFocus.compareTo("vnd.android.cursor.item/audio") == 0 -> {
                // 'Song' search mode.
                playSong(album, artist, genre, title)
            }
            mediaFocus.compareTo(MediaStore.Audio.Playlists.ENTRY_CONTENT_TYPE) == 0 -> {
                // 'Playlist' search mode.
                playPlaylist(album, artist, genre, playlist, title)
            }
        }
    }
}

protected void onCreate(Bundle savedInstanceState) {
    //...
    Intent intent = this.getIntent();
    if (intent.getAction().compareTo(MediaStore.INTENT_ACTION_MEDIA_PLAY_FROM_SEARCH) == 0) {

        String mediaFocus = intent.getStringExtra(MediaStore.EXTRA_MEDIA_FOCUS);
        String query = intent.getStringExtra(SearchManager.QUERY);

        // Some of these extras might not be available depending on the search mode.
        String album = intent.getStringExtra(MediaStore.EXTRA_MEDIA_ALBUM);
        String artist = intent.getStringExtra(MediaStore.EXTRA_MEDIA_ARTIST);
        String genre = intent.getStringExtra("android.intent.extra.genre");
        String playlist = intent.getStringExtra("android.intent.extra.playlist");
        String title = intent.getStringExtra(MediaStore.EXTRA_MEDIA_TITLE);

        // Determine the search mode and use the corresponding extras.
        if (mediaFocus == null) {
            // 'Unstructured' search mode (backward compatible).
            playUnstructuredSearch(query);

        } else if (mediaFocus.compareTo("vnd.android.cursor.item/*") == 0) {
            if (query.isEmpty()) {
                // 'Any' search mode.
                playResumeLastPlaylist();
            } else {
                // 'Unstructured' search mode.
                playUnstructuredSearch(query);
            }

        } else if (mediaFocus.compareTo(MediaStore.Audio.Genres.ENTRY_CONTENT_TYPE) == 0) {
            // 'Genre' search mode.
            playGenre(genre);

        } else if (mediaFocus.compareTo(MediaStore.Audio.Artists.ENTRY_CONTENT_TYPE) == 0) {
            // 'Artist' search mode.
            playArtist(artist, genre);

        } else if (mediaFocus.compareTo(MediaStore.Audio.Albums.ENTRY_CONTENT_TYPE) == 0) {
            // 'Album' search mode.
            playAlbum(album, artist);

        } else if (mediaFocus.compareTo("vnd.android.cursor.item/audio") == 0) {
            // 'Song' search mode.
            playSong(album, artist, genre, title);

        } else if (mediaFocus.compareTo(MediaStore.Audio.Playlists.ENTRY_CONTENT_TYPE) == 0) {
            // 'Playlist' search mode.
            playPlaylist(album, artist, genre, playlist, title);
        }
    }
}

โน้ตใหม่

การสร้างโน้ตเป็นการดำเนินการทั่วไปของแอปจดบันทึก สร้างตัวกรอง Intent เพื่อโฆษณาความสามารถของแอปในการดําเนินการนี้โดยใช้ข้อมูลในส่วนต่อไปนี้

สร้างโน้ต

หากต้องการสร้างโน้ตใหม่ ให้ใช้การดำเนินการ ACTION_CREATE_NOTE แล้วระบุรายละเอียดของโน้ต เช่น เรื่องและข้อความ โดยใช้ส่วนเสริมต่อไปนี้

หมายเหตุ: แอปต้องขอการยืนยันจากผู้ใช้ก่อนดำเนินการนี้ให้เสร็จสมบูรณ์

การดำเนินการ

ACTION_CREATE_NOTE

รูปแบบ URI ของข้อมูล

ไม่มี

ประเภท MIME

PLAIN_TEXT_TYPE

"*/*"

พิเศษ

EXTRA_NAME

สตริงที่ระบุชื่อหรือเรื่องของเทมเพลต

EXTRA_TEXT

สตริงที่ระบุข้อความของโน้ต

ตัวอย่าง Intent:

Kotlin

fun createNote(subject: String, text: String) {
    val intent = Intent(NoteIntents.ACTION_CREATE_NOTE).apply {
        putExtra(NoteIntents.EXTRA_NAME, subject)
        putExtra(NoteIntents.EXTRA_TEXT, text)
    }
    if (intent.resolveActivity(packageManager) != null) {
        startActivity(intent)
    }
}

Java

public void createNote(String subject, String text) {
    Intent intent = new Intent(NoteIntents.ACTION_CREATE_NOTE)
            .putExtra(NoteIntents.EXTRA_NAME, subject)
            .putExtra(NoteIntents.EXTRA_TEXT, text);
    if (intent.resolveActivity(getPackageManager()) != null) {
        startActivity(intent);
    }
}

ตัวอย่างตัวกรอง Intent:

<activity ...>
    <intent-filter>
        <action android:name="com.google.android.gms.actions.CREATE_NOTE" />
        <category android:name="android.intent.category.DEFAULT" />
        <data android:mimeType="*/*" />
    </intent-filter>
</activity>

โทรศัพท์

การเริ่มโทรเป็นการดำเนินการทั่วไปสำหรับแอปโทรศัพท์ สร้างตัวกรอง Intent เพื่อโฆษณาความสามารถของแอปในการดําเนินการนี้โดยใช้ข้อมูลในส่วนต่อไปนี้

เริ่มโทรออก

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

การสั่งงานด้วยเสียงของ Google

• "โทรหา 555-5555"
• "call bob"
• "โทรหาข้อความเสียง"

หากต้องการโทรออกโดยตรง ให้ใช้การดําเนินการ ACTION_CALL และระบุหมายเลขโทรศัพท์โดยใช้รูปแบบ URI ต่อไปนี้ เมื่อแอปโทรศัพท์เปิดขึ้น ระบบจะเริ่มการโทร ผู้ใช้ไม่จําเป็นต้องแตะปุ่มโทร

การดำเนินการ ACTION_CALL กำหนดให้คุณเพิ่มสิทธิ์ CALL_PHONE ลงในไฟล์ Manifest

<uses-permission android:name="android.permission.CALL_PHONE" />

การดำเนินการ

• ACTION_DIAL - เปิดแอปโทรศัพท์หรือแป้นโทรศัพท์
• ACTION_CALL - โทรออก (ต้องมีสิทธิ์ CALL_PHONE)

รูปแบบ URI ของข้อมูล

• tel:<phone-number>
• voicemail:<phone-number>

ประเภท MIME

ไม่มี

หมายเลขโทรศัพท์ที่ถูกต้องคือหมายเลขที่ระบุไว้ใน IETF RFC 3966 ตัวอย่างที่ถูกต้องมีดังนี้

• tel:2125551212
• tel:(212) 555 1212

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

ตัวอย่าง Intent:

Kotlin

fun dialPhoneNumber(phoneNumber: String) {
    val intent = Intent(Intent.ACTION_DIAL).apply {
        data = Uri.parse("tel:$phoneNumber")
    }
    if (intent.resolveActivity(packageManager) != null) {
        startActivity(intent)
    }
}

Java

public void dialPhoneNumber(String phoneNumber) {
    Intent intent = new Intent(Intent.ACTION_DIAL);
    intent.setData(Uri.parse("tel:" + phoneNumber));
    if (intent.resolveActivity(getPackageManager()) != null) {
        startActivity(intent);
    }
}

ค้นหา

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

ค้นหาโดยใช้แอปที่เฉพาะเจาะจง

การสั่งงานด้วยเสียงของ Google

• "ค้นหาวิดีโอแมวบน myvideoapp"

หากต้องการรองรับการค้นหาภายในบริบทของแอป ให้ประกาศตัวกรอง Intent ในแอปด้วยการดำเนินการ SEARCH_ACTION ดังที่แสดงในตัวอย่างตัวกรอง Intent ต่อไปนี้

หมายเหตุ: เราไม่แนะนำให้ใช้ SEARCH_ACTION สำหรับการค้นหาแอป แต่ให้ใช้การดําเนินการ GET_THING เพื่อใช้ประโยชน์จากการสนับสนุนการค้นหาในแอปในตัวของ Google Assistant ดูข้อมูลเพิ่มเติมได้ที่เอกสารประกอบการดำเนินการของแอปใน Google Assistant

การดำเนินการ

"com.google.android.gms.actions.SEARCH_ACTION"

รองรับคำค้นหาจาก Google Voice Actions

พิเศษ

QUERY

สตริงที่มีคำค้นหา

ตัวอย่างตัวกรอง Intent:

<activity android:name=".SearchActivity">
    <intent-filter>
        <action android:name="com.google.android.gms.actions.SEARCH_ACTION"/>
        <category android:name="android.intent.category.DEFAULT"/>
    </intent-filter>
</activity>

ทำการค้นหาในเว็บ

หากต้องการเริ่มการค้นหาบนเว็บ ให้ใช้การดำเนินการ ACTION_WEB_SEARCH และระบุสตริงการค้นหาในข้อมูลเพิ่มเติม SearchManager.QUERY

การดำเนินการ

ACTION_WEB_SEARCH

รูปแบบ URI ของข้อมูล

ไม่มี

ประเภท MIME

ไม่มี

พิเศษ

SearchManager.QUERY

สตริงการค้นหา

ตัวอย่าง Intent:

Kotlin

fun searchWeb(query: String) {
    val intent = Intent(Intent.ACTION_WEB_SEARCH).apply {
        putExtra(SearchManager.QUERY, query)
    }
    if (intent.resolveActivity(packageManager) != null) {
        startActivity(intent)
    }
}

Java

public void searchWeb(String query) {
    Intent intent = new Intent(Intent.ACTION_WEB_SEARCH);
    intent.putExtra(SearchManager.QUERY, query);
    if (intent.resolveActivity(getPackageManager()) != null) {
        startActivity(intent);
    }
}

การตั้งค่า

หากต้องการเปิดหน้าจอในแอปการตั้งค่าของระบบเมื่อแอปกำหนดให้ผู้ใช้ทำการเปลี่ยนแปลงบางอย่าง ให้ใช้การดำเนินการตาม Intent อย่างใดอย่างหนึ่งต่อไปนี้

การดำเนินการ

ACTION_SETTINGS
ACTION_WIRELESS_SETTINGS
ACTION_AIRPLANE_MODE_SETTINGS
ACTION_WIFI_SETTINGS
ACTION_APN_SETTINGS
ACTION_BLUETOOTH_SETTINGS
ACTION_DATE_SETTINGS
ACTION_LOCALE_SETTINGS
ACTION_INPUT_METHOD_SETTINGS
ACTION_DISPLAY_SETTINGS
ACTION_SECURITY_SETTINGS
ACTION_LOCATION_SOURCE_SETTINGS
ACTION_INTERNAL_STORAGE_SETTINGS
ACTION_MEMORY_CARD_SETTINGS

ดูหน้าจอการตั้งค่าเพิ่มเติมที่ใช้ได้ได้ที่Settingsเอกสารประกอบ

รูปแบบ URI ของข้อมูล

ไม่มี

ประเภท MIME

ไม่มี

ตัวอย่าง Intent:

Kotlin

fun openWifiSettings() {
    val intent = Intent(Settings.ACTION_WIFI_SETTINGS)
    if (intent.resolveActivity(packageManager) != null) {
        startActivity(intent)
    }
}

Java

public void openWifiSettings() {
    Intent intent = new Intent(Settings.ACTION_WIFI_SETTINGS);
    if (intent.resolveActivity(getPackageManager()) != null) {
        startActivity(intent);
    }
}

การรับส่งข้อความ

การเขียนข้อความ SMS/MMS ที่มีไฟล์แนบเป็นการดำเนินการทั่วไปสำหรับแอปรับส่งข้อความ สร้างตัวกรอง Intent เพื่อโฆษณาความสามารถของแอปในการดําเนินการนี้โดยใช้ข้อมูลในส่วนต่อไปนี้

เขียนข้อความ SMS/MMS พร้อมไฟล์แนบ

หากต้องการเริ่มส่ง SMS หรือ MMS ให้ใช้การดำเนินการตาม Intent อย่างใดอย่างหนึ่งต่อไปนี้และระบุรายละเอียดข้อความ เช่น หมายเลขโทรศัพท์ เรื่อง และเนื้อหาข้อความ โดยใช้คีย์เพิ่มเติมต่อไปนี้

การดำเนินการ

ACTION_SENDTO หรือ
ACTION_SEND หรือ
ACTION_SEND_MULTIPLE

รูปแบบ URI ของข้อมูล

sms:<phone_number>

smsto:<phone_number>

mms:<phone_number>

mmsto:<phone_number>

รูปแบบเหล่านี้ทั้งหมดจะได้รับการจัดการในลักษณะเดียวกัน

ประเภท MIME

"text/plain"

"image/*"

"video/*"

พิเศษ

"subject"

สตริงสำหรับหัวเรื่องข้อความ (ปกติจะใช้กับ MMS เท่านั้น)

"sms_body"

สตริงสำหรับ SMS

EXTRA_STREAM

Uri ที่ชี้ไปยังรูปภาพหรือวิดีโอที่จะแนบ หากใช้การดำเนินการ ACTION_SEND_MULTIPLE ข้อมูลเพิ่มเติมนี้จะเป็น ArrayList ของออบเจ็กต์ Uri ที่ชี้ไปยังรูปภาพหรือวิดีโอที่จะแนบ

ตัวอย่าง Intent:

Kotlin

fun composeMmsMessage(message: String, attachment: Uri) {
    val intent = Intent(Intent.ACTION_SENDTO).apply {
        type = HTTP.PLAIN_TEXT_TYPE
        putExtra("sms_body", message)
        putExtra(Intent.EXTRA_STREAM, attachment)
    }
    if (intent.resolveActivity(packageManager) != null) {
        startActivity(intent)
    }
}

Java

public void composeMmsMessage(String message, Uri attachment) {
    Intent intent = new Intent(Intent.ACTION_SENDTO);
    intent.setType(HTTP.PLAIN_TEXT_TYPE);
    intent.putExtra("sms_body", message);
    intent.putExtra(Intent.EXTRA_STREAM, attachment);
    if (intent.resolveActivity(getPackageManager()) != null) {
        startActivity(intent);
    }
}

หากต้องการตรวจสอบว่า Intent ได้รับการจัดการโดยแอปรับส่งข้อความเท่านั้น ไม่ใช่อีเมลหรือแอปโซเชียลอื่นๆ ให้ใช้ACTION_SENDTOการดำเนินการ และใส่รูปแบบข้อมูล "smsto:" ตามที่แสดงในตัวอย่างต่อไปนี้

Kotlin

fun composeMmsMessage(message: String, attachment: Uri) {
    val intent = Intent(Intent.ACTION_SEND).apply {
        data = Uri.parse("smsto:")  // Only SMS apps respond to this.
        putExtra("sms_body", message)
        putExtra(Intent.EXTRA_STREAM, attachment)
    }
    if (intent.resolveActivity(packageManager) != null) {
        startActivity(intent)
    }
}

Java

public void composeMmsMessage(String message, Uri attachment) {
    Intent intent = new Intent(Intent.ACTION_SEND);
    intent.setData(Uri.parse("smsto:"));  // Only SMS apps respond to this.
    intent.putExtra("sms_body", message);
    intent.putExtra(Intent.EXTRA_STREAM, attachment);
    if (intent.resolveActivity(getPackageManager()) != null) {
        startActivity(intent);
    }
}

ตัวอย่างตัวกรอง Intent:

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

หมายเหตุ: หากกำลังพัฒนาแอปรับส่งข้อความ SMS/MMS คุณต้องติดตั้งใช้งานตัวกรอง Intent สำหรับการดําเนินการเพิ่มเติมหลายรายการเพื่อให้แอปเป็นแอป SMS เริ่มต้นใน Android 4.4 ขึ้นไป ดูข้อมูลเพิ่มเติมได้ที่เอกสารประกอบที่ Telephony

เว็บเบราว์เซอร์

การโหลด URL ของเว็บเป็นการดำเนินการทั่วไปสำหรับแอปเว็บเบราว์เซอร์ สร้างตัวกรอง Intent เพื่อโฆษณาความสามารถของแอปในการดําเนินการนี้โดยใช้ข้อมูลในส่วนต่อไปนี้

โหลด URL ของเว็บ

การสั่งงานด้วยเสียงของ Google

• "open example.com"

หากต้องการเปิดหน้าเว็บ ให้ใช้การดำเนินการ ACTION_VIEW และระบุ URL ของเว็บในข้อมูล Intent

การดำเนินการ

ACTION_VIEW

รูปแบบ URI ของข้อมูล

http:<URL>
https:<URL>

ประเภท MIME

"text/plain"

"text/html"

"application/xhtml+xml"

"application/vnd.wap.xhtml+xml"

ตัวอย่าง Intent:

Kotlin

fun openWebPage(url: String) {
    val webpage: Uri = Uri.parse(url)
    val intent = Intent(Intent.ACTION_VIEW, webpage)
    if (intent.resolveActivity(packageManager) != null) {
        startActivity(intent)
    }
}

Java

public void openWebPage(String url) {
    Uri webpage = Uri.parse(url);
    Intent intent = new Intent(Intent.ACTION_VIEW, webpage);
    if (intent.resolveActivity(getPackageManager()) != null) {
        startActivity(intent);
    }
}

ตัวอย่างตัวกรอง Intent:

<activity ...>
    <intent-filter>
        <action android:name="android.intent.action.VIEW" />
        <!-- Include the host attribute if you want your app to respond
             only to URLs with your app's domain. -->
        <data android:scheme="http" android:host="www.example.com" />
        <category android:name="android.intent.category.DEFAULT" />
        <!-- The BROWSABLE category is required to get links from web pages. -->
        <category android:name="android.intent.category.BROWSABLE" />
    </intent-filter>
</activity>

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

ตั้งแต่ Android 12 (API ระดับ 31) เป็นต้นไป อินเทนต์ของเว็บทั่วไปจะแก้ไขเป็นกิจกรรมในแอปก็ต่อเมื่อแอปได้รับอนุมัติสำหรับโดเมนที่เฉพาะเจาะจงซึ่งอยู่ในอินเทนต์ของเว็บนั้น หากแอปไม่ได้รับอนุมัติสำหรับโดเมนนั้น เว็บ Intent จะแก้ไขแอปเบราว์เซอร์เริ่มต้นของผู้ใช้แทน

ยืนยัน Intent ด้วย Android Debug Bridge

หากต้องการยืนยันว่าแอปตอบสนองต่อ Intent ที่ต้องการรองรับ ให้ใช้เครื่องมือ adb เพื่อเรียก Intent ที่เฉพาะเจาะจงโดยทําดังนี้

1. ตั้งค่าอุปกรณ์ Android สําหรับการพัฒนาหรือใช้อุปกรณ์เสมือน
2. ติดตั้งแอปเวอร์ชันที่จัดการ Intent ที่ต้องการรองรับ
3. เรียกใช้ Intent โดยใช้ adb

   adb shell am start -a <ACTION> -t <MIME_TYPE> -d <DATA> \
     -e <EXTRA_NAME> <EXTRA_VALUE> -n <ACTIVITY>
   

   เช่น

   adb shell am start -a android.intent.action.DIAL \
     -d tel:555-5555 -n org.example.MyApp/.MyActivity
   

4. หากคุณกําหนดตัวกรอง Intent ที่จําเป็น ให้จัดการ Intent

ดูข้อมูลเพิ่มเติมได้ที่ออกคำสั่งเชลล์