Một ý định cho phép bạn bắt đầu một hoạt động trong một ứng dụng khác bằng cách mô tả một
hành động bạn muốn thực hiện, chẳng hạn như "xem bản đồ" hoặc "lấy một
ảnh" trong đối tượng Intent
. Loại ý định này
được gọi là ý định ngầm ẩn vì không chỉ định ứng dụng
thành phần để bắt đầu, mà thay vào đó chỉ định một hành động và cung cấp
một số dữ liệu để thực hiện hành động.
Khi bạn gọi startActivity()
hoặc startActivityForResult()
rồi truyền vào đó ý định ngầm ẩn, hệ thống sẽ
giải quyết
ý định đến một ứng dụng có thể xử lý ý định và bắt đầu
Activity
tương ứng. Nếu có nhiều ứng dụng
có thể xử lý ý định, hệ thống sẽ hiển thị cho người dùng một hộp thoại để
chọn ứng dụng sẽ sử dụng.
Trang này mô tả một số ý định ngầm ẩn mà bạn có thể dùng để thực hiện các thao tác phổ biến, được sắp xếp theo loại ứng dụng xử lý ý định. Một cũng sẽ cho bạn biết cách tạo ý định bộ lọc để quảng cáo khả năng thực hiện hành động đó của ứng dụng.
Thận trọng: Nếu trên thiết bị không có ứng dụng nào có thể
nhận ý định ngầm ẩn, ứng dụng sẽ gặp sự cố khi gọi startActivity()
. Để xác minh rằng
đã tồn tại một ứng dụng để nhận ý định, hãy gọi resolveActivity()
trên đối tượng Intent
. Nếu kết quả không rỗng, có ít nhất có
một ứng dụng có thể xử lý ý định và có thể an toàn gọi startActivity()
. Nếu kết quả là
rỗng, không sử dụng ý định và nếu có thể, hãy tắt
gọi ý định.
Nếu bạn chưa hiểu rõ cách tạo ý định hoặc bộ lọc ý định, trước tiên, hãy đọc bài viết Ý định và bộ lọc ý định Bộ lọc.
Để tìm hiểu cách kích hoạt các ý định được liệt kê trên trang này từ quá trình phát triển của bạn máy chủ lưu trữ, hãy xem phần Xác minh ý định bằng Gỡ lỗi Android Cầu nối.
Tác vụ thoại của Google
Google Voice Hành động kích hoạt một số ý định được liệt kê trên trang này để phản hồi lệnh thoại. Để biết thêm thông tin, hãy xem Bắt đầu với Tác vụ thoại của hệ thống.
Đồng hồ báo thức
Sau đây là những thao tác phổ biến cho ứng dụng đồng hồ báo thức, bao gồm cả thông tin bạn cần để tạo bộ lọc ý định nhằm quảng cáo khả năng thực hiện từng hành động của ứng dụng.
Tạo chuông báo
Để tạo chuông báo mới, hãy sử dụng ACTION_SET_ALARM
hành động và chỉ định chi tiết báo thức như thời gian và tin nhắn bằng cách sử dụng các tham số bổ sung sau.
Lưu ý: Bạn chỉ có thể xem thêm thông tin về giờ, phút và tin nhắn trong Android 2.3 (API cấp 9) trở xuống. Các tính năng bổ sung khác có trong phiên bản cao hơn của chủ.
- Hành động
ACTION_SET_ALARM
- URI dữ liệu
- Không có
- Loại MIME
- Không có
- Thông tin khác
-
EXTRA_HOUR
- Giờ báo thức.
EXTRA_MINUTES
- Số phút chuông báo.
EXTRA_MESSAGE
- Một thông báo tuỳ chỉnh để xác định chuông báo.
EXTRA_DAYS
ArrayList
, kể cả vào mỗi ngày trong tuần mà báo thức này xuất hiện lặp lại. Bạn phải khai báo mỗi ngày bằng một số nguyên trongCalendar
chẳng hạn nhưMONDAY
.Đối với chuông báo một lần, đừng chỉ định dữ liệu bổ sung này.
EXTRA_RINGTONE
- URI
content:
chỉ định nhạc chuông để sử dụng cùng với chuông báo, hoặcVALUE_RINGTONE_SILENT
nếu không có nhạc chuông.Để sử dụng nhạc chuông mặc định, không chỉ định phần phụ này.
EXTRA_VIBRATE
- Một giá trị boolean chỉ định liệu chuông báo này có rung hay không.
EXTRA_SKIP_UI
- Giá trị boolean chỉ định liệu ứng dụng phản hồi có phải bỏ qua giao diện người dùng khi đặt chuông báo hay không. Nếu đặt là true, ứng dụng phải bỏ qua mọi giao diện người dùng xác nhận và đặt chuông báo đã chỉ định.
Ví dụ về ý định:
Kotlin
fun createAlarm(message: String, hour: Int, minutes: Int) { val intent = Intent(AlarmClock.ACTION_SET_ALARM).apply { putExtra(AlarmClock.EXTRA_MESSAGE, message) putExtra(AlarmClock.EXTRA_HOUR, hour) putExtra(AlarmClock.EXTRA_MINUTES, minutes) } if (intent.resolveActivity(packageManager) != null) { startActivity(intent) } }
Java
public void createAlarm(String message, int hour, int minutes) { Intent intent = new Intent(AlarmClock.ACTION_SET_ALARM) .putExtra(AlarmClock.EXTRA_MESSAGE, message) .putExtra(AlarmClock.EXTRA_HOUR, hour) .putExtra(AlarmClock.EXTRA_MINUTES, minutes); if (intent.resolveActivity(getPackageManager()) != null) { startActivity(intent); } }
Để gọi ý định ACTION_SET_ALARM
, ứng dụng của bạn phải có
Quyền SET_ALARM
:
<uses-permission android:name="com.android.alarm.permission.SET_ALARM" />
Ví dụ về bộ lọc ý định:
<activity ...> <intent-filter> <action android:name="android.intent.action.SET_ALARM" /> <category android:name="android.intent.category.DEFAULT" /> </intent-filter> </activity>
Tạo bộ tính giờ
Để tạo đồng hồ đếm ngược, hãy dùng thao tác ACTION_SET_TIMER
và chỉ định đồng hồ hẹn giờ
chẳng hạn như thời lượng bằng cách sử dụng các tiện ích bổ sung sau.
Lưu ý: Bạn có thể dùng ý định này trong Android 4.4 (API cấp 19) trở lên.
- Hành động
ACTION_SET_TIMER
- URI dữ liệu
- Không có
- Loại MIME
- Không có
- Thông tin khác
-
EXTRA_LENGTH
- Thời lượng của đồng hồ hẹn giờ tính bằng giây.
EXTRA_MESSAGE
- Một thông báo tuỳ chỉnh để xác định đồng hồ hẹn giờ.
EXTRA_SKIP_UI
- Giá trị boolean chỉ định liệu ứng dụng phản hồi có phải bỏ qua giao diện người dùng khi đặt bộ tính giờ hay không. Nếu đúng, ứng dụng phải bỏ qua mọi giao diện người dùng xác nhận và bắt đầu bộ tính giờ đã chỉ định.
Ví dụ về ý định:
Kotlin
fun startTimer(message: String, seconds: Int) { val intent = Intent(AlarmClock.ACTION_SET_TIMER).apply { putExtra(AlarmClock.EXTRA_MESSAGE, message) putExtra(AlarmClock.EXTRA_LENGTH, seconds) putExtra(AlarmClock.EXTRA_SKIP_UI, true) } if (intent.resolveActivity(packageManager) != null) { startActivity(intent) } }
Java
public void startTimer(String message, int seconds) { Intent intent = new Intent(AlarmClock.ACTION_SET_TIMER) .putExtra(AlarmClock.EXTRA_MESSAGE, message) .putExtra(AlarmClock.EXTRA_LENGTH, seconds) .putExtra(AlarmClock.EXTRA_SKIP_UI, true); if (intent.resolveActivity(getPackageManager()) != null) { startActivity(intent); } }
Để gọi ý định ACTION_SET_TIMER
, ứng dụng của bạn phải có
Quyền SET_ALARM
:
<uses-permission android:name="com.android.alarm.permission.SET_ALARM" />
Ví dụ về bộ lọc ý định:
<activity ...> <intent-filter> <action android:name="android.intent.action.SET_TIMER" /> <category android:name="android.intent.category.DEFAULT" /> </intent-filter> </activity>
Hiển thị tất cả báo thức
Để hiện danh sách chuông báo, hãy dùng ACTION_SHOW_ALARMS
hành động.
Mặc dù không nhiều ứng dụng gọi ra ý định này vì ý định này chủ yếu được các ứng dụng hệ thống sử dụng, bất kỳ ứng dụng nào hoạt động như một đồng hồ báo thức đều có thể triển khai bộ lọc ý định này và phản hồi bằng cách hiện danh sách các chuông báo hiện tại.
Lưu ý: Bạn có thể dùng ý định này trong Android 4.4 (API cấp 19) trở lên.
- Hành động
ACTION_SHOW_ALARMS
- URI dữ liệu
- Không có
- Loại MIME
- Không có
Ví dụ về bộ lọc ý định:
<activity ...> <intent-filter> <action android:name="android.intent.action.SHOW_ALARMS" /> <category android:name="android.intent.category.DEFAULT" /> </intent-filter> </activity>
Lịch
Thêm sự kiện là một thao tác phổ biến đối với ứng dụng lịch. Tạo bộ lọc ý định để quảng cáo khả năng ứng dụng của bạn thực hiện hành động này bằng cách sử dụng ở phần sau.
Thêm sự kiện trên lịch
Để thêm sự kiện mới vào lịch của người dùng, hãy sử dụng
ACTION_INSERT
và chỉ định URI dữ liệu bằng cách sử dụng
Events.CONTENT_URI
Sau đó, bạn có thể chỉ định nhiều thông tin chi tiết về sự kiện bằng cách sử dụng các tiện ích bổ sung sau.
- Hành động
ACTION_INSERT
- URI dữ liệu
Events.CONTENT_URI
- Loại MIME
"vnd.android.cursor.dir/event"
- Thông tin khác
-
EXTRA_EVENT_ALL_DAY
- Một giá trị boolean chỉ định liệu đây có phải là một sự kiện diễn ra cả ngày hay không.
EXTRA_EVENT_BEGIN_TIME
- Thời gian bắt đầu sự kiện (mili giây kể từ thời gian bắt đầu của hệ thống).
EXTRA_EVENT_END_TIME
- Thời gian kết thúc của sự kiện (mili giây kể từ thời gian bắt đầu của hệ thống).
TITLE
- Tiêu đề sự kiện.
DESCRIPTION
- Nội dung mô tả sự kiện.
EVENT_LOCATION
- Địa điểm diễn ra sự kiện.
EXTRA_EMAIL
- Danh sách địa chỉ email được phân tách bằng dấu phẩy, trong đó nêu rõ người được mời.
Có thể chỉ định thêm nhiều thông tin chi tiết về sự kiện bằng cách sử dụng các hằng số được xác định trong Lớp
CalendarContract.EventsColumns
.
Ví dụ về ý định:
Kotlin
fun addEvent(title: String, location: String, begin: Long, end: Long) { val intent = Intent(Intent.ACTION_INSERT).apply { data = Events.CONTENT_URI putExtra(Events.TITLE, title) putExtra(Events.EVENT_LOCATION, location) putExtra(CalendarContract.EXTRA_EVENT_BEGIN_TIME, begin) putExtra(CalendarContract.EXTRA_EVENT_END_TIME, end) } if (intent.resolveActivity(packageManager) != null) { startActivity(intent) } }
Java
public void addEvent(String title, String location, long begin, long end) { Intent intent = new Intent(Intent.ACTION_INSERT) .setData(Events.CONTENT_URI) .putExtra(Events.TITLE, title) .putExtra(Events.EVENT_LOCATION, location) .putExtra(CalendarContract.EXTRA_EVENT_BEGIN_TIME, begin) .putExtra(CalendarContract.EXTRA_EVENT_END_TIME, end); if (intent.resolveActivity(getPackageManager()) != null) { startActivity(intent); } }
Ví dụ về bộ lọc ý định:
<activity ...> <intent-filter> <action android:name="android.intent.action.INSERT" /> <data android:mimeType="vnd.android.cursor.dir/event" /> <category android:name="android.intent.category.DEFAULT" /> </intent-filter> </activity>
Camera
Sau đây là những thao tác phổ biến đối với các ứng dụng camera, bao gồm cả thông tin bạn cần để tạo bộ lọc ý định nhằm quảng cáo khả năng thực hiện từng hành động của ứng dụng.
Chụp ảnh hoặc quay video và trả lại
Để mở một ứng dụng máy ảnh và nhận ảnh hoặc video thu được, hãy sử dụng thao tác ACTION_IMAGE_CAPTURE
hoặc ACTION_VIDEO_CAPTURE
. Ngoài ra, hãy chỉ định vị trí URI nơi bạn muốn
chẳng hạn như camera để lưu ảnh hoặc video trong EXTRA_OUTPUT
khác.
- Hành động
ACTION_IMAGE_CAPTURE
hoặc
ACTION_VIDEO_CAPTURE
- Lược đồ URI dữ liệu
- Không có
- Loại MIME
- Không có
- Thông tin khác
-
EXTRA_OUTPUT
- Vị trí URI nơi ứng dụng máy ảnh lưu ảnh hoặc
tệp video (dưới dạng đối tượng
Uri
).
Khi ứng dụng máy ảnh quay trở lại thành công
tập trung vào hoạt động của bạn — nói cách khác, ứng dụng nhận được lệnh gọi lại onActivityResult()
— bạn
có thể truy cập vào ảnh hoặc video tại URI mà bạn đã chỉ định
bằng giá trị EXTRA_OUTPUT
.
Lưu ý: Khi bạn sử dụng ACTION_IMAGE_CAPTURE
để chụp ảnh, máy ảnh cũng có thể trả về
bản sao hoặc hình thu nhỏ đã thu nhỏ của ảnh trong kết quả Intent
, được lưu dưới dạng Bitmap
trong một trường bổ sung có tên
"data"
.
Ví dụ về ý định:
Kotlin
const val REQUEST_IMAGE_CAPTURE = 1 val locationForPhotos: Uri = ... fun capturePhoto(targetFilename: String) { val intent = Intent(MediaStore.ACTION_IMAGE_CAPTURE).apply { putExtra(MediaStore.EXTRA_OUTPUT, Uri.withAppendedPath(locationForPhotos, targetFilename)) } if (intent.resolveActivity(packageManager) != null) { startActivityForResult(intent, REQUEST_IMAGE_CAPTURE) } } override fun onActivityResult(requestCode: Int, resultCode: Int, data: Intent) { if (requestCode == REQUEST_IMAGE_CAPTURE && resultCode == Activity.RESULT_OK) { val thumbnail: Bitmap = data.getParcelableExtra("data") // Do other work with full size photo saved in locationForPhotos. ... } }
Java
static final int REQUEST_IMAGE_CAPTURE = 1; static final Uri locationForPhotos; 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); } } @Override protected void onActivityResult(int requestCode, int resultCode, Intent data) { if (requestCode == REQUEST_IMAGE_CAPTURE && resultCode == RESULT_OK) { Bitmap thumbnail = data.getParcelableExtra("data"); // Do other work with full size photo saved in locationForPhotos. ... } }
Để thực hiện việc này khi làm việc trên Android 12 (API cấp 31) trở lên, hãy tham khảo ví dụ về ý định sau.
Ví dụ về ý định:
Kotlin
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. } }
Java
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>
Để biết thêm thông tin về cách sử dụng ý định này để chụp ảnh, hãy bao gồm
cách tạo Uri
thích hợp cho vị trí đầu ra, hãy đọc
Chụp ảnh hoặc
Quay video.
Ví dụ về bộ lọc ý định:
<activity ...> <intent-filter> <action android:name="android.media.action.IMAGE_CAPTURE" /> <category android:name="android.intent.category.DEFAULT" /> </intent-filter> </activity>
Khi xử lý ý định này, hãy yêu cầu bạn kiểm tra hoạt động để tìm phần bổ sung EXTRA_OUTPUT
trong Intent
sắp tới, sau đó lưu hình ảnh hoặc video đã chụp vào
vị trí do dữ liệu bổ sung đó chỉ định và gọi setResult()
bằng Intent
có chứa một hình thu nhỏ nén trong phần bổ sung
có tên "data"
.
Khởi động ứng dụng máy ảnh ở chế độ hình ảnh tĩnh
Để mở một ứng dụng máy ảnh ở chế độ hình ảnh tĩnh, hãy dùng thao tác INTENT_ACTION_STILL_IMAGE_CAMERA
.
- Hành động
INTENT_ACTION_STILL_IMAGE_CAMERA
- Lược đồ URI dữ liệu
- Không có
- Loại MIME
- Không có
- Thông tin khác
- Không có
Ví dụ về ý định:
Kotlin
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. } }
Java
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); } }
Ví dụ về bộ lọc ý định:
<activity ...> <intent-filter> <action android:name="android.media.action.STILL_IMAGE_CAMERA" /> <category android:name="android.intent.category.DEFAULT" /> </intent-filter> </activity>
Khởi động ứng dụng máy ảnh ở chế độ video
Để mở một ứng dụng máy ảnh ở chế độ video, hãy dùng thao tác INTENT_ACTION_VIDEO_CAMERA
.
- Hành động
INTENT_ACTION_VIDEO_CAMERA
- Lược đồ URI dữ liệu
- Không có
- Loại MIME
- Không có
- Thông tin khác
- Không có
Ví dụ về ý định:
Kotlin
fun capturePhoto() { val intent = Intent(MediaStore.INTENT_ACTION_VIDEO_CAMERA) if (intent.resolveActivity(packageManager) != null) { startActivityForResult(intent, REQUEST_IMAGE_CAPTURE) } }
Java
public void capturePhoto() { Intent intent = new Intent(MediaStore.INTENT_ACTION_VIDEO_CAMERA); if (intent.resolveActivity(getPackageManager()) != null) { startActivityForResult(intent, REQUEST_IMAGE_CAPTURE); } }
Ví dụ về bộ lọc ý định:
<activity ...> <intent-filter> <action android:name="android.media.action.VIDEO_CAMERA" /> <category android:name="android.intent.category.DEFAULT" /> </intent-filter> </activity>
Ứng dụng Danh bạ/người
Sau đây là những thao tác phổ biến đối với các ứng dụng quản lý danh bạ, bao gồm cả thông tin bạn cần để tạo bộ lọc ý định nhằm quảng cáo khả năng thực hiện từng hành động của ứng dụng.
Chọn địa chỉ liên hệ
Để người dùng chọn một người liên hệ và cấp cho ứng dụng của bạn quyền truy cập vào tất cả thông tin liên hệ,
sử dụng thao tác ACTION_PICK
và chỉ định loại MIME để
Contacts.CONTENT_TYPE
Kết quả Intent
được gửi tới lệnh gọi lại onActivityResult()
của bạn chứa
URI content:
trỏ đến địa chỉ liên hệ đã chọn. Câu trả lời đã cấp
quyền tạm thời cho ứng dụng để đọc thông tin liên hệ đó bằng API Trình cung cấp danh bạ, ngay cả khi
ứng dụng của bạn không có quyền READ_CONTACTS
.
Lưu ý: Nếu bạn chỉ cần quyền truy cập vào một thông tin liên hệ cụ thể thông tin, chẳng hạn như số điện thoại hoặc địa chỉ email, thay vào đó, hãy xem phần tiếp theo về cách chọn dữ liệu liên hệ cụ thể.
- Hành động
ACTION_PICK
- Lược đồ URI dữ liệu
- Không có
- Loại MIME
Contacts.CONTENT_TYPE
Ví dụ về ý định:
Kotlin
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. //... } }
Java
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. ... } }
Để biết thông tin về cách truy xuất thông tin liên hệ sau khi bạn có URI liên hệ, đọc Truy xuất chi tiết của một người liên hệ.
Khi truy xuất URI liên hệ bằng ý định này, bạn thường không
cần
READ_CONTACTS
quyền đọc thông tin cơ bản về người liên hệ đó, chẳng hạn như tên hiển thị và
liệu địa chỉ liên hệ đó có được gắn dấu sao hay không. Tuy nhiên, nếu bạn đang cố gắng
đọc dữ liệu cụ thể hơn về một người liên hệ cụ thể, chẳng hạn như
làm số điện thoại hoặc địa chỉ email của họ, bạn cần có READ_CONTACTS
quyền.
Chọn dữ liệu liên hệ cụ thể
Để yêu cầu người dùng chọn một phần thông tin cụ thể từ một mục liên hệ, chẳng hạn như
số điện thoại, địa chỉ email hoặc loại dữ liệu khác, hãy sử dụng
Thao tác ACTION_PICK
và chỉ định loại MIME là 1
loại nội dung sau, chẳng hạn như
CommonDataKinds.Phone.CONTENT_TYPE
để biết số điện thoại của người liên hệ.
Lưu ý: Trong nhiều trường hợp, ứng dụng của bạn cần có
READ_CONTACTS
quyền xem thông tin cụ thể về một người liên hệ cụ thể.
Nếu bạn chỉ cần truy xuất một loại dữ liệu từ một địa chỉ liên hệ, kỹ thuật này với
CONTENT_TYPE
từ
Lớp ContactsContract.CommonDataKinds
hiệu quả hơn
bằng Contacts.CONTENT_TYPE
, như đã trình bày ở phần trước. Kết quả này cung cấp cho bạn
quyền truy cập vào dữ liệu mong muốn mà không yêu cầu bạn thực hiện một truy vấn phức tạp hơn đối với Nhà cung cấp danh bạ.
Kết quả Intent
được gửi tới lệnh gọi lại onActivityResult()
của bạn chứa
URI content:
trỏ đến dữ liệu liên hệ đã chọn. Câu trả lời đã cấp
ứng dụng của bạn có quyền tạm thời để đọc dữ liệu liên hệ đó ngay cả khi ứng dụng không bao gồm quyền READ_CONTACTS
.
- Hành động
ACTION_PICK
- Lược đồ URI dữ liệu
- Không có
- Loại MIME
-
CommonDataKinds.Phone.CONTENT_TYPE
- Chọn từ các liên hệ có số điện thoại.
CommonDataKinds.Email.CONTENT_TYPE
- Chọn từ các liên hệ có địa chỉ email.
CommonDataKinds.StructuredPostal.CONTENT_TYPE
- Chọn từ người liên hệ có địa chỉ bưu chính.
Hoặc một trong nhiều giá trị
CONTENT_TYPE
khác dướiContactsContract
.
Ví dụ về ý định:
Kotlin
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. ... } } } }
Java
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. //... } } }
Xem người liên hệ
Để hiển thị thông tin chi tiết về một người liên hệ đã biết, hãy sử dụng ACTION_VIEW
và chỉ định địa chỉ liên hệ với URI content:
làm dữ liệu ý định.
Có hai cách chính để truy xuất URI của địa chỉ liên hệ lúc ban đầu:
- Dùng URI liên hệ do thao tác
ACTION_PICK
trả về như được trình bày ở phần trước. Phương pháp này không yêu cầu quyền cho ứng dụng. - Truy cập trực tiếp vào danh sách tất cả người liên hệ, như được mô tả trong Truy xuất danh sách
danh bạ. Phương pháp này yêu cầu
READ_CONTACTS
quyền.
- Hành động
ACTION_VIEW
- Lược đồ URI dữ liệu
content:<URI>
- Loại MIME
- Không có. Loại này được suy ra từ URI liên hệ.
Ví dụ về ý định:
Kotlin
fun viewContact(contactUri: Uri) { val intent = Intent(Intent.ACTION_VIEW, contactUri) if (intent.resolveActivity(packageManager) != null) { startActivity(intent) } }
Java
public void viewContact(Uri contactUri) { Intent intent = new Intent(Intent.ACTION_VIEW, contactUri); if (intent.resolveActivity(getPackageManager()) != null) { startActivity(intent); } }
Chỉnh sửa một mục liên hệ hiện có
Để chỉnh sửa người liên hệ đã biết, hãy sử dụng ACTION_EDIT
hành động, chỉ định địa chỉ liên hệ bằng URI content:
làm dữ liệu ý định và đưa mọi thông tin liên hệ đã biết vào dữ liệu bổ sung được chỉ định bởi
hằng số trong ContactsContract.Intents.Insert
.
Có hai cách chính để truy xuất URI liên hệ lúc ban đầu:
- Dùng URI liên hệ do thao tác
ACTION_PICK
trả về như được trình bày ở phần trước. Phương pháp này không yêu cầu quyền cho ứng dụng. - Truy cập trực tiếp vào danh sách tất cả người liên hệ, như được mô tả trong Truy xuất danh sách
danh bạ. Phương pháp này yêu cầu
READ_CONTACTS
quyền.
- Hành động
ACTION_EDIT
- Lược đồ URI dữ liệu
content:<URI>
- Loại MIME
- Loại được suy ra từ URI liên hệ.
- Thông tin khác
- Một hoặc nhiều dữ liệu bổ sung được xác định trong
ContactsContract.Intents.Insert
để bạn có thể điền sẵn các trường thông tin liên hệ.
Ví dụ về ý định:
Kotlin
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) } }
Java
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); } }
Để biết thêm thông tin về cách chỉnh sửa người liên hệ, hãy đọc Sửa đổi người liên hệ dựa trên ý định.
Chèn một mục liên hệ
Để chèn một người liên hệ mới, hãy sử dụng thao tác ACTION_INSERT
,
chỉ định Contacts.CONTENT_TYPE
làm
loại MIME và đưa mọi thông tin liên hệ đã biết vào phần bổ sung được chỉ định bởi
hằng số trong ContactsContract.Intents.Insert
.
- Hành động
ACTION_INSERT
- Lược đồ URI dữ liệu
- Không có
- Loại MIME
Contacts.CONTENT_TYPE
- Thông tin khác
- Một hoặc nhiều dữ liệu bổ sung được xác định trong
ContactsContract.Intents.Insert
.
Ví dụ về ý định:
Kotlin
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) } }
Java
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); } }
Để biết thêm thông tin về cách chèn một người liên hệ, hãy đọc bài viết Sửa đổi người liên hệ dựa trên ý định.
Việc soạn email có các tệp đính kèm không bắt buộc là một thao tác phổ biến đối với các ứng dụng email. Tạo bộ lọc ý định để quảng cáo khả năng ứng dụng của bạn thực hiện hành động này bằng cách sử dụng ở phần sau.
Soạn email có các tệp đính kèm không bắt buộc
Để soạn email, hãy sử dụng một trong các thao tác sau tuỳ vào việc bạn có đính kèm tệp hay không, và bao gồm thông tin chi tiết về email như người nhận và chủ đề bằng các khoá bổ sung được liệt kê.
- Hành động
ACTION_SENDTO
(khi không có tệp đính kèm) hoặc
ACTION_SEND
(cho một tệp đính kèm) hoặc
ACTION_SEND_MULTIPLE
(đối với nhiều tệp đính kèm)- Lược đồ URI dữ liệu
- Không có
- Loại MIME
-
"text/plain"
"*/*"
- Thông tin khác
-
Intent.EXTRA_EMAIL
- Một mảng chuỗi của tất cả các giá trị "Đến" địa chỉ email của người nhận.
Intent.EXTRA_CC
- Một mảng chuỗi của tất cả các giá trị "CC" địa chỉ email của người nhận.
Intent.EXTRA_BCC
- Một mảng chuỗi của tất cả các giá trị "BCC" địa chỉ email của người nhận.
Intent.EXTRA_SUBJECT
- Một chuỗi có tiêu đề email.
Intent.EXTRA_TEXT
- Một chuỗi có nội dung email.
Intent.EXTRA_STREAM
Uri
trỏ đến tệp đính kèm. Nếu sử dụngACTION_SEND_MULTIPLE
hành động, thay vào đó, đây là mộtArrayList
chứa nhiều đối tượngUri
.
Ví dụ về ý định:
Kotlin
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) } }
Java
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); } }
Nếu bạn muốn đảm bảo rằng ý định của bạn chỉ được xử lý bằng ứng dụng email chứ không phải
nhắn tin văn bản hoặc ứng dụng mạng xã hội, sau đó sử dụng thao tác ACTION_SENDTO
đồng thời thêm giao thức dữ liệu "mailto:"
như trong ví dụ sau:
Kotlin
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) } }
Java
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); } }
Ví dụ về bộ lọc ý định:
<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>
Bộ nhớ tệp
Sau đây là những thao tác phổ biến cho các ứng dụng lưu trữ tệp, bao gồm cả thông tin bạn cần để tạo bộ lọc ý định nhằm quảng cáo khả năng thực hiện từng hành động của ứng dụng.
Truy xuất một loại tệp cụ thể
Để yêu cầu người dùng chọn một tệp như tài liệu hoặc ảnh và trả lại tham chiếu đến
ứng dụng của bạn, hãy sử dụng thao tác ACTION_GET_CONTENT
và chỉ định mong muốn
Loại MIME. Tham chiếu tệp được trả về cho ứng dụng của bạn là tạm thời đối với hoạt động hiện tại của bạn
, vì vậy, nếu muốn truy cập vào tệp này sau, bạn phải nhập một bản sao để đọc sau.
Ý định này cũng cho phép người dùng tạo một tệp mới trong quá trình. Cho ví dụ: thay vì chọn ảnh hiện có, người dùng có thể chụp ảnh mới bằng máy ảnh.
Ý định kết quả được phân phối cho phương thức onActivityResult()
của bạn bao gồm dữ liệu có URI trỏ đến tệp.
URI có thể là bất kỳ nội dung nào, chẳng hạn như URI http:
, URI file:
hoặc content:
URI. Tuy nhiên, nếu bạn muốn giới hạn các tệp có thể chọn chỉ ở những tệp có thể truy cập được
từ một nhà cung cấp nội dung (URI content:
) và có sẵn dưới dạng luồng tệp có
openFileDescriptor()
,
thêm
CATEGORY_OPENABLE
vào ý định của bạn.
Trên Android 4.3 (API cấp 18) trở lên,
bạn cũng có thể cho phép người dùng chọn nhiều tệp bằng cách thêm
EXTRA_ALLOW_MULTIPLE
thành ý định, được đặt thành true
.
Sau đó, bạn có thể truy cập từng tệp đã chọn trong một ClipData
đối tượng được getClipData()
trả về.
- Hành động
ACTION_GET_CONTENT
- Lược đồ URI dữ liệu
- Không có
- Loại MIME
- Loại MIME tương ứng với loại tệp mà người dùng cần chọn.
- Thông tin khác
-
EXTRA_ALLOW_MULTIPLE
- Một giá trị boolean khai báo việc người dùng có thể chọn nhiều tệp cùng một lúc hay không.
EXTRA_LOCAL_ONLY
- Một giá trị boolean khai báo liệu tệp trả về có phải truy cập trực tiếp qua thiết bị thay vì yêu cầu tải xuống từ một dịch vụ từ xa.
- Danh mục (không bắt buộc)
-
CATEGORY_OPENABLE
- Để chỉ trả về trạng thái "có thể mở" các tệp có thể được biểu thị dưới dạng luồng tệp
cùng với
openFileDescriptor()
.
Ví dụ về ý định chụp ảnh:
Kotlin
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. ... } }
Java
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. ... } }
Ví dụ về bộ lọc ý định trả về một ảnh:
<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 supportsOpenableColumns
andContentResolver.openFileDescriptor()
. --> <category android:name="android.intent.category.OPENABLE" /> </intent-filter> </activity>
Mở một loại tệp cụ thể
Thay vì truy xuất bản sao của tệp mà bạn phải nhập vào ứng dụng, bằng cách sử dụng thao tác ACTION_GET_CONTENT
khi chạy trên Android
Phiên bản 4.4 trở lên, bạn có thể yêu cầu mở một tệp được quản lý bởi một ứng dụng khác bằng
bằng cách sử dụng thao tác ACTION_OPEN_DOCUMENT
và chỉ định loại MIME.
Để cho phép người dùng tạo tài liệu mới để ứng dụng của bạn có thể ghi vào, hãy sử dụng thao tác ACTION_CREATE_DOCUMENT
.
Ví dụ: thay vì
chọn trong số các tài liệu PDF hiện có, ACTION_CREATE_DOCUMENT
ý định cho phép người dùng chọn vị trí họ muốn tạo tài liệu mới, chẳng hạn như trong một ứng dụng khác
để quản lý bộ nhớ của tài liệu. Sau đó, ứng dụng của bạn sẽ nhận được vị trí URI của nơi ứng dụng
có thể viết tài liệu mới.
Trong khi ý định đã gửi đến onActivityResult()
của bạn
từ thao tác ACTION_GET_CONTENT
có thể
trả về URI thuộc bất kỳ loại nào, ý định kết quả từ ACTION_OPEN_DOCUMENT
và ACTION_CREATE_DOCUMENT
luôn chỉ định tệp đã chọn làm URI content:
được DocumentsProvider
hỗ trợ. Bạn có thể mở
tệp có openFileDescriptor()
và
truy vấn thông tin chi tiết bằng cách sử dụng các cột trong DocumentsContract.Document
.
URI được trả về cấp cho ứng dụng của bạn quyền đọc tệp trong thời gian dài, cũng có thể là
có quyền ghi. Hành động ACTION_OPEN_DOCUMENT
là
đặc biệt hữu ích khi bạn muốn đọc tệp hiện có mà không cần tạo bản sao trong ứng dụng
hoặc khi bạn muốn mở và chỉnh sửa tệp tại chỗ.
Bạn cũng có thể cho phép người dùng chọn nhiều tệp bằng cách thêm
EXTRA_ALLOW_MULTIPLE
thành ý định, được đặt thành true
.
Nếu người dùng chỉ chọn một mục, thì bạn có thể truy xuất mục đó từ getData()
.
Nếu người dùng chọn nhiều mục, getData()
sẽ trả về giá trị rỗng và bạn phải thay vào đó
truy xuất từng mục từ ClipData
đối tượng được getClipData()
trả về.
Lưu ý: Ý định của bạn phải chỉ định một loại MIME và
phải khai báo danh mục CATEGORY_OPENABLE
. Nếu
thích hợp, bạn có thể chỉ định nhiều hơn một loại MIME bằng cách thêm một mảng các loại MIME với
EXTRA_MIME_TYPES
bổ sung. Nếu làm như vậy, bạn phải đặt
loại MIME chính trong setType()
đến "*/*"
.
- Hành động
ACTION_OPEN_DOCUMENT
hoặc
ACTION_CREATE_DOCUMENT
- Lược đồ URI dữ liệu
- Không có
- Loại MIME
- Loại MIME tương ứng với loại tệp mà người dùng cần chọn.
- Thông tin khác
-
EXTRA_MIME_TYPES
- Một mảng gồm các loại MIME tương ứng với loại tệp mà ứng dụng của bạn đang dùng
đang yêu cầu. Khi sử dụng dữ liệu bổ sung này, bạn phải đặt loại MIME chính trong
setType()
thành"*/*"
. EXTRA_ALLOW_MULTIPLE
- Một giá trị boolean khai báo việc người dùng có thể chọn nhiều tệp cùng một lúc hay không.
EXTRA_TITLE
- Để sử dụng với
ACTION_CREATE_DOCUMENT
để chỉ định tên tệp ban đầu. EXTRA_LOCAL_ONLY
- Một giá trị boolean khai báo liệu tệp trả về có phải truy cập trực tiếp qua thiết bị thay vì yêu cầu tải xuống từ một dịch vụ từ xa.
- Danh mục
-
CATEGORY_OPENABLE
- Để chỉ trả về trạng thái "có thể mở" các tệp có thể được biểu thị dưới dạng luồng tệp
cùng với
openFileDescriptor()
.
Ví dụ về ý định chụp ảnh:
Kotlin
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. ... } }
Java
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. ... } }
Các ứng dụng bên thứ ba không thể phản hồi một ý định bằng
ACTION_OPEN_DOCUMENT
hành động. Thay vào đó, hệ thống sẽ nhận được
ý định và hiển thị tất cả các tệp có sẵn từ nhiều ứng dụng trong một giao diện người dùng hợp nhất.
Để cung cấp các tệp của ứng dụng trong giao diện người dùng này và cho phép các ứng dụng khác mở các tệp đó, bạn phải triển khai
DocumentsProvider
và thêm bộ lọc ý định cho
PROVIDER_INTERFACE
("android.content.action.DOCUMENTS_PROVIDER"
), như trong ví dụ sau:
<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>
Để biết thêm thông tin về cách làm cho tệp do ứng dụng của bạn quản lý có thể mở được qua ứng dụng khác, đọc bài viết Mở tệp bằng khung truy cập bộ nhớ.
Các hành động cục bộ
Gọi xe ô tô là một hành động phổ biến tại địa phương. Tạo bộ lọc ý định để quảng cáo ứng dụng của bạn khả năng thực hiện tác vụ này bằng cách sử dụng thông tin trong phần sau.
Gọi xe
Để gọi taxi, hãy sử dụng
ACTION_RESERVE_TAXI_RESERVATION
hành động.
Lưu ý: Ứng dụng phải yêu cầu người dùng xác nhận trước khi hoàn tất hành động này.
- Hành động
ACTION_RESERVE_TAXI_RESERVATION
- URI dữ liệu
- Không có
- Loại MIME
- Không có
- Thông tin khác
- Không có
Ví dụ về ý định:
Kotlin
fun callCar() { val intent = Intent(ReserveIntents.ACTION_RESERVE_TAXI_RESERVATION) if (intent.resolveActivity(packageManager) != null) { startActivity(intent) } }
Java
public void callCar() { Intent intent = new Intent(ReserveIntents.ACTION_RESERVE_TAXI_RESERVATION); if (intent.resolveActivity(getPackageManager()) != null) { startActivity(intent); } }
Ví dụ về bộ lọc ý định:
<activity ...> <intent-filter> <action android:name="com.google.android.gms.actions.RESERVE_TAXI_RESERVATION" /> <category android:name="android.intent.category.DEFAULT" /> </intent-filter> </activity>
Bản đồ
Hiển thị một vị trí trên bản đồ là một thao tác phổ biến đối với ứng dụng bản đồ. Tạo bộ lọc ý định để quảng cáo khả năng ứng dụng của bạn thực hiện hành động này bằng cách sử dụng ở phần sau.
Hiển thị một vị trí trên bản đồ
Để mở bản đồ, hãy sử dụng thao tác ACTION_VIEW
và chỉ định
thông tin vị trí trong dữ liệu ý định bằng một trong các giao thức sau.
- Hành động
ACTION_VIEW
- Lược đồ URI dữ liệu
-
geo:latitude,longitude
- Hiển thị bản đồ tại kinh độ và vĩ độ cho sẵn.
Ví dụ:
"geo:47.6,-122.3"
geo:latitude,longitude?z=zoom
- Hiển thị bản đồ ở kinh độ và vĩ độ cụ thể ở mức thu phóng nhất định. Mức thu phóng
1 hiển thị toàn bộ Trái đất, có tâm tại vĩ độ,lng đã cho. Cao nhất
Mức thu phóng (gần nhất) là 23.
Ví dụ:
"geo:47.6,-122.3?z=11"
geo:0,0?q=lat,lng(label)
- Hiển thị bản đồ ở kinh độ và vĩ độ cho sẵn bằng nhãn chuỗi.
Ví dụ:
"geo:0,0?q=34.99,-106.61(Treasure)"
geo:0,0?q=my+street+address
- Hiển thị vị trí cho "địa chỉ đường phố của tôi", có thể là một địa chỉ hoặc cụm từ tìm kiếm vị trí cụ thể.
Ví dụ:
"geo:0,0?q=1600+Amphitheatre+Parkway%2C+CA"
Lưu ý: Tất cả chuỗi được truyền trong URI
geo
phải được mã hoá. Ví dụ: chuỗi1st & Pike, Seattle
trở thành1st%20%26%20Pike%2C%20Seattle
Các dấu cách trong chuỗi được mã hoá bằng%20
hoặc được thay thế bằng dấu cộng (+
).
- Loại MIME
- Không có
Ví dụ về ý định:
Kotlin
fun showMap(geoLocation: Uri) { val intent = Intent(Intent.ACTION_VIEW).apply { data = geoLocation } if (intent.resolveActivity(packageManager) != null) { startActivity(intent) } }
Java
public void showMap(Uri geoLocation) { Intent intent = new Intent(Intent.ACTION_VIEW); intent.setData(geoLocation); if (intent.resolveActivity(getPackageManager()) != null) { startActivity(intent); } }
Ví dụ về bộ lọc ý định:
<activity ...> <intent-filter> <action android:name="android.intent.action.VIEW" /> <data android:scheme="geo" /> <category android:name="android.intent.category.DEFAULT" /> </intent-filter> </activity>
Nhạc hoặc video
Sau đây là những thao tác phổ biến đối với ứng dụng nhạc và video, bao gồm cả thông tin bạn cần để tạo bộ lọc ý định nhằm quảng cáo khả năng thực hiện từng hành động của ứng dụng.
Phát tệp nội dung nghe nhìn
Để phát một tệp nhạc, hãy sử dụng thao tác ACTION_VIEW
và
chỉ định vị trí URI của tệp trong dữ liệu ý định.
- Hành động
ACTION_VIEW
- Lược đồ URI dữ liệu
-
file:<URI>
content:<URI>
http:<URL>
- Loại MIME
-
"audio/*"
"application/ogg"
"application/x-ogg"
"application/itunes"
- Hoặc bất kỳ tính năng nào khác mà ứng dụng của bạn yêu cầu.
Ví dụ về ý định:
Kotlin
fun playMedia(file: Uri) { val intent = Intent(Intent.ACTION_VIEW).apply { data = file } if (intent.resolveActivity(packageManager) != null) { startActivity(intent) } }
Java
public void playMedia(Uri file) { Intent intent = new Intent(Intent.ACTION_VIEW); intent.setData(file); if (intent.resolveActivity(getPackageManager()) != null) { startActivity(intent); } }
Ví dụ về bộ lọc ý định:
<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>
Phát nhạc dựa trên một cụm từ tìm kiếm
Để phát nhạc dựa trên một cụm từ tìm kiếm, hãy sử dụng
Ý định INTENT_ACTION_MEDIA_PLAY_FROM_SEARCH
. Ứng dụng có thể kích hoạt
ý định này để phản hồi lệnh thoại của người dùng để phát nhạc. Ứng dụng nhận dữ liệu cho việc này
ý định thực hiện một lượt tìm kiếm trong khoảng không quảng cáo của mình để so khớp nội dung hiện có với cụm từ tìm kiếm nhất định và
bắt đầu phát nội dung đó.
Trong ý định này, hãy thêm chuỗi EXTRA_MEDIA_FOCUS
ký tự bổ sung xác định chế độ tìm kiếm dự định. Ví dụ: chế độ tìm kiếm có thể chỉ định xem
nội dung tìm kiếm là tên nghệ sĩ hoặc tên bài hát.
- Hành động
INTENT_ACTION_MEDIA_PLAY_FROM_SEARCH
- Lược đồ URI dữ liệu
- Không có
- Loại MIME
- Không có
- Thông tin khác
-
MediaStore.EXTRA_MEDIA_FOCUS
(bắt buộc)-
Cho biết chế độ tìm kiếm: liệu người dùng có đang tìm kiếm một nghệ sĩ, đĩa nhạc, bài hát cụ thể hay không hoặc danh sách phát. Hầu hết các chế độ tìm kiếm đều có thêm thông tin bổ sung. Ví dụ: nếu người dùng muốn nghe một bài hát cụ thể, mục đích có thể có thêm ba yếu tố bổ sung: tên bài hát, nghệ sĩ và đĩa nhạc. Ý định này hỗ trợ các chế độ tìm kiếm sau đây cho mỗi giá trị của
EXTRA_MEDIA_FOCUS
:Bất kỳ –
"vnd.android.cursor.item/*"
-
Phát nhạc bất kỳ. Ứng dụng nhận sẽ phát một số bản nhạc dựa trên một lựa chọn thông minh, chẳng hạn như làm danh sách phát gần đây nhất mà người dùng đã nghe.
Thông tin bổ sung:
QUERY
(bắt buộc): một chuỗi trống. Thông tin bổ sung này luôn được cung cấp để tương thích ngược. Những ứng dụng hiện có chưa biết về chế độ tìm kiếm có thể xử lý ý định này dưới dạng một lượt tìm kiếm phi cấu trúc.
Không có cấu trúc –
"vnd.android.cursor.item/*"
-
Phát một bài hát, đĩa nhạc hoặc thể loại cụ thể trong một cụm từ tìm kiếm không có cấu trúc. Các ứng dụng có thể tạo một ý định với chế độ tìm kiếm này khi họ không thể xác định loại nội dung mà người dùng muốn lắng nghe. Sử dụng các chế độ tìm kiếm cụ thể hơn khi có thể.
Thông tin bổ sung:
QUERY
(bắt buộc): một chuỗi chứa bất kỳ kiểu kết hợp nào về nghệ sĩ, đĩa nhạc, tên bài hát hoặc thể loại.
Thể loại –
Audio.Genres.ENTRY_CONTENT_TYPE
-
Phát nhạc thuộc một thể loại cụ thể.
Thông tin bổ sung:
"android.intent.extra.genre"
(bắt buộc) – Thể loại.QUERY
(bắt buộc): thể loại. Thông tin bổ sung này luôn được cung cấp để tương thích ngược. Những ứng dụng hiện có chưa biết về chế độ tìm kiếm có thể xử lý ý định này dưới dạng một lượt tìm kiếm không có cấu trúc.
Nghệ sĩ –
Audio.Artists.ENTRY_CONTENT_TYPE
-
Phát nhạc của một nghệ sĩ cụ thể.
Thông tin bổ sung:
EXTRA_MEDIA_ARTIST
(bắt buộc): nghệ sĩ."android.intent.extra.genre"
: thể loại.QUERY
(bắt buộc): một chuỗi chứa bất kỳ kết hợp nào của nghệ sĩ hoặc thể loại. Thông tin bổ sung này luôn được cung cấp để đảm bảo khả năng tương thích ngược. Các ứng dụng hiện có không biết về chế độ tìm kiếm có thể xử lý ý định này dưới dạng một hành động phi cấu trúc tìm kiếm.
Album -
Audio.Albums.ENTRY_CONTENT_TYPE
-
Phát nhạc trong một đĩa nhạc cụ thể.
Thông tin bổ sung:
EXTRA_MEDIA_ALBUM
(bắt buộc): album.EXTRA_MEDIA_ARTIST
: nghệ sĩ."android.intent.extra.genre"
: thể loại.QUERY
(bắt buộc): một chuỗi chứa bất kỳ kết hợp nào của đĩa nhạc hoặc nghệ sĩ. Phần phụ này luôn được cung cấp để truy cập ngược khả năng tương thích. Các ứng dụng hiện có không biết về chế độ tìm kiếm có thể xử lý ý định này dưới dạng một tìm kiếm không có cấu trúc.
Bài hát –
"vnd.android.cursor.item/audio"
-
Phát một bài hát cụ thể.
Thông tin bổ sung:
EXTRA_MEDIA_ALBUM
: album.EXTRA_MEDIA_ARTIST
: nghệ sĩ."android.intent.extra.genre"
: thể loại.EXTRA_MEDIA_TITLE
(bắt buộc): tên bài hát.QUERY
(bắt buộc): một chuỗi chứa bất kỳ kết hợp nào của đĩa nhạc, nghệ sĩ, thể loại hoặc tiêu đề. Thông tin bổ sung này luôn được cung cấp cho khả năng tương thích ngược. Các ứng dụng hiện có chưa biết về chế độ tìm kiếm có thể xử lý thao tác này ý định tìm kiếm phi cấu trúc.
Danh sách phát -
Audio.Playlists.ENTRY_CONTENT_TYPE
-
Phát một danh sách phát cụ thể hoặc một danh sách phát phù hợp với một số tiêu chí được chỉ định bằng cách bổ sung.
Thông tin bổ sung:
EXTRA_MEDIA_ALBUM
: album.EXTRA_MEDIA_ARTIST
: nghệ sĩ."android.intent.extra.genre"
: thể loại."android.intent.extra.playlist"
: danh sách phát.EXTRA_MEDIA_TITLE
: tên bài hát của danh sách phát dựa trên.QUERY
(bắt buộc): một chuỗi chứa bất kỳ kiểu kết hợp nào về đĩa nhạc, nghệ sĩ, thể loại, danh sách phát hoặc tiêu đề. Thông tin bổ sung này luôn được cung cấp để tương thích ngược. Những ứng dụng hiện có chưa biết về chế độ tìm kiếm có thể xử lý ý định này dưới dạng một lượt tìm kiếm phi cấu trúc.
Ví dụ về ý định:
Nếu người dùng muốn nghe nhạc của một nghệ sĩ cụ thể, ứng dụng tìm kiếm có thể tạo ý định sau:
Kotlin
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) } }
Java
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); } }
Ví dụ về bộ lọc ý định:
<activity ...> <intent-filter> <action android:name="android.media.action.MEDIA_PLAY_FROM_SEARCH" /> <category android:name="android.intent.category.DEFAULT" /> </intent-filter> </activity>
Khi xử lý ý định này trong hoạt động của bạn, hãy kiểm tra giá trị của
Thêm EXTRA_MEDIA_FOCUS
trong thư đến
Intent
để xác định chế độ tìm kiếm. Khi hoạt động của bạn đã xác định được
chế độ tìm kiếm, đọc các giá trị của dữ liệu bổ sung cho chế độ tìm kiếm cụ thể đó.
Với thông tin này, ứng dụng của bạn sau đó có thể thực hiện tìm kiếm trong khoảng không quảng cáo của mình để phát
nội dung khớp với cụm từ tìm kiếm. Lệnh này được minh hoạ trong ví dụ sau:
Kotlin
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) } } } }
Java
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); } } }
Ghi chú mới
Tạo ghi chú là một thao tác phổ biến đối với ứng dụng ghi chú. Tạo bộ lọc ý định để quảng cáo khả năng ứng dụng của bạn thực hiện hành động này bằng cách sử dụng ở phần sau.
Tạo ghi chú
Để tạo ghi chú mới, hãy sử dụng
Thao tác ACTION_CREATE_NOTE
và chỉ định các chi tiết ghi chú, chẳng hạn như chủ đề và văn bản bằng các dữ liệu bổ sung sau đây.
Lưu ý: Ứng dụng phải yêu cầu người dùng xác nhận trước khi hoàn tất thao tác này.
- Hành động
-
ACTION_CREATE_NOTE
- Lược đồ URI dữ liệu
- Không có
- Loại MIME
-
PLAIN_TEXT_TYPE
- "*/*"
- Thông tin khác
-
-
EXTRA_NAME
- Một chuỗi cho biết tiêu đề hoặc chủ đề của ghi chú.
-
EXTRA_TEXT
- Một chuỗi cho biết văn bản của ghi chú.
-
- Hành động
-
ACTION_DIAL
– Mở ứng dụng gọi điện hoặc chương trình gọi điện.ACTION_CALL
- Thực hiện cuộc gọi điện thoại (yêu cầu QuyềnCALL_PHONE
)
- Lược đồ URI dữ liệu
-
tel:<phone-number>
voicemail:<phone-number>
- Loại MIME
- Không có
tel:2125551212
tel:(212) 555 1212
- Hành động
-
"com.google.android.gms.actions.SEARCH_ACTION"
- Hỗ trợ các cụm từ tìm kiếm từ Tác vụ thoại của Google.
- Thông tin khác
-
QUERY
- Một chuỗi chứa cụm từ tìm kiếm.
- Hành động
ACTION_WEB_SEARCH
- Lược đồ URI dữ liệu
- Không có
- Loại MIME
- Không có
- Thông tin khác
-
SearchManager.QUERY
- Chuỗi tìm kiếm.
- Hành động
-
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
Để biết thêm các màn hình cài đặt khác có sẵn, hãy xem tài liệu về
Settings
. - Lược đồ URI dữ liệu
- Không có
- Loại MIME
- Không có
- Hành động
ACTION_SENDTO
hoặc
ACTION_SEND
hoặc
ACTION_SEND_MULTIPLE
- Lược đồ URI dữ liệu
-
sms:<phone_number>
smsto:<phone_number>
mms:<phone_number>
mmsto:<phone_number>
Các giao thức này đều được xử lý theo cách tương tự nhau.
- Loại MIME
-
"text/plain"
"image/*"
"video/*"
- Thông tin khác
-
"subject"
- Một chuỗi cho tiêu đề tin nhắn (thường chỉ dành cho MMS).
"sms_body"
- Một chuỗi cho tin nhắn văn bản.
EXTRA_STREAM
- Một
Uri
trỏ đến hình ảnh hoặc video để đính kèm. Nếu dùng thao tácACTION_SEND_MULTIPLE
, phần phụ này làArrayList
của Các đối tượngUri
trỏ đến hình ảnh hoặc video cần đính kèm.
- Hành động
ACTION_VIEW
- Lược đồ URI dữ liệu
http:<URL>
https:<URL>
- Loại MIME
-
"text/plain"
"text/html"
"application/xhtml+xml"
"application/vnd.wap.xhtml+xml"
- Thiết lập thiết bị Android cho hoạt động phát triển hoặc sử dụng một thiết bị ảo.
- Cài đặt một phiên bản ứng dụng xử lý các ý định bạn muốn hỗ trợ.
- Kích hoạt một ý định bằng
adb
:adb shell am start -a <ACTION> -t <MIME_TYPE> -d <DATA> \ -e <EXTRA_NAME> <EXTRA_VALUE> -n <ACTIVITY>
Ví dụ:
adb shell am start -a android.intent.action.DIAL \ -d tel:555-5555 -n org.example.MyApp/.MyActivity
- Nếu bạn xác định các bộ lọc ý định bắt buộc, hãy xử lý ý định đó.
Ví dụ về ý định:
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); } }
Ví dụ về bộ lọc ý định:
<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>
Điện thoại
Thực hiện cuộc gọi là một thao tác phổ biến đối với các ứng dụng điện thoại. Tạo bộ lọc ý định để quảng cáo khả năng ứng dụng của bạn thực hiện hành động này bằng cách sử dụng ở phần sau.
Bắt đầu một cuộc gọi điện thoại
Để mở ứng dụng điện thoại và gọi đến một số điện thoại, hãy thực hiện thao tác ACTION_DIAL
rồi chỉ định một số điện thoại bằng
giao thức URI sau đây. Khi ứng dụng điện thoại mở ra, ứng dụng sẽ hiển thị số điện thoại.
và người dùng phải nhấn vào nút Gọi để bắt đầu cuộc gọi điện thoại.
Để trực tiếp gọi điện thoại, hãy sử dụng thao tác ACTION_CALL
và chỉ định số điện thoại bằng giao thức URI sau. Khi mở ứng dụng điện thoại,
bắt đầu cuộc gọi điện thoại. Người dùng không cần nhấn vào nút Call (Gọi).
Thao tác ACTION_CALL
yêu cầu bạn thêm thuộc tính
Quyền CALL_PHONE
đối với tệp kê khai của bạn:
<uses-permission android:name="android.permission.CALL_PHONE" />
Số điện thoại hợp lệ là những số được xác định trong RFC 3966 của IETF. Sau đây là một số ví dụ hợp lệ:
Trình quay số của ứng dụng Điện thoại rất hiệu quả trong việc chuẩn hoá các giao thức, chẳng hạn như
số điện thoại. Vì vậy, lược đồ được mô tả không được yêu cầu nghiêm ngặt trong
Uri.parse()
.
Tuy nhiên, nếu bạn chưa thử một lược đồ hoặc không chắc chắn liệu nó
có thể xử lý được, hãy sử dụng Uri.fromParts()
thay thế.
Ví dụ về ý định:
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); } }
Tìm kiếm
Sau đây là những thao tác phổ biến đối với ứng dụng tìm kiếm, bao gồm cả thông tin bạn cần để tạo bộ lọc ý định nhằm quảng cáo khả năng thực hiện từng hành động của ứng dụng.
Tìm kiếm bằng một ứng dụng cụ thể
Để hỗ trợ tính năng tìm kiếm trong ngữ cảnh của ứng dụng, hãy khai báo bộ lọc ý định trong ứng dụng bằng
hành động SEARCH_ACTION
, như minh hoạ trong ví dụ về bộ lọc ý định sau đây.
Lưu ý: Bạn không nên sử dụng SEARCH_ACTION
cho chức năng tìm kiếm ứng dụng.
Thay vào đó, hãy triển khai
GET_THING
hành động để tận dụng tính năng hỗ trợ tích hợp sẵn của Trợ lý Google cho tính năng tìm kiếm trong ứng dụng. Để biết thêm thông tin, hãy xem
Trợ lý Google
Tài liệu về Hành động trong ứng dụng.
Ví dụ về bộ lọc ý định:
<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>
Tìm kiếm trên web
Để bắt đầu tìm kiếm trên web, hãy dùng thao tác ACTION_WEB_SEARCH
và chỉ định chuỗi tìm kiếm trong
Thêm SearchManager.QUERY
.
Ví dụ về ý định:
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); } }
Cài đặt
Cách mở một màn hình trong ứng dụng Cài đặt của hệ thống khi ứng dụng yêu cầu người dùng thay đổi nội dung nào đó: hãy sử dụng một trong các thao tác theo ý định sau:
Ví dụ về ý định:
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); } }
Nhắn tin văn bản
Soạn một tin nhắn SMS/MMS có tệp đính kèm là một thao tác phổ biến đối với các ứng dụng nhắn tin văn bản. Tạo bộ lọc ý định để quảng cáo khả năng ứng dụng của bạn thực hiện hành động này bằng cách sử dụng ở phần sau.
Soạn tin nhắn SMS/MMS có tệp đính kèm
Để bắt đầu tin nhắn văn bản SMS hoặc MMS, hãy sử dụng một trong các thao tác theo ý định sau đây và chỉ định tin nhắn các chi tiết như số điện thoại, chủ đề và nội dung tin nhắn bằng cách sử dụng các phím bổ sung sau đây.
Ví dụ về ý định:
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); } }
Nếu bạn muốn đảm bảo rằng ý định của bạn chỉ được ứng dụng nhắn tin văn bản xử lý, chứ không phải bằng ứng dụng khác
email hoặc ứng dụng mạng xã hội, rồi sử dụng thao tác ACTION_SENDTO
đồng thời thêm giao thức dữ liệu "smsto:"
như trong ví dụ sau:
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); } }
Ví dụ về bộ lọc ý định:
<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>
Lưu ý: Nếu đang phát triển ứng dụng nhắn tin SMS/MMS, bạn phải
triển khai bộ lọc ý định cho một số thao tác bổ sung để có thể sử dụng dưới dạng
ứng dụng SMS mặc định trên Android 4.4 trở lên. Để biết thêm thông tin, hãy xem tài liệu
lúc Telephony
.
Trình duyệt web
Tải URL web là một thao tác phổ biến đối với các ứng dụng trình duyệt web. Tạo bộ lọc ý định để quảng cáo khả năng ứng dụng của bạn thực hiện hành động này bằng cách sử dụng ở phần sau.
Tải một URL web
Để mở một trang web, hãy dùng thao tác ACTION_VIEW
rồi chỉ định URL web trong dữ liệu ý định.
Ví dụ về ý định:
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); } }
Ví dụ về bộ lọc ý định:
<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>
Lưu ý: Nếu ứng dụng Android của bạn cung cấp chức năng tương tự như trang web của bạn, hãy bao gồm bộ lọc ý định cho những URL trỏ đến trang web. Sau đó: nếu người dùng đã cài đặt ứng dụng của bạn, các liên kết từ email hoặc trang web khác trỏ đến trang web của bạn mở ứng dụng Android thay vì trang web của bạn. Tìm hiểu thêm trong Xử lý Đường liên kết trong ứng dụng Android.
Kể từ Android 12 (API cấp 31), một ý định chung trên web sẽ phân giải thành một hoạt động trong ứng dụng của bạn chỉ khi ứng dụng đó được phê duyệt cho miền cụ thể có trong ý định web đó. Nếu ứng dụng của bạn không được phê duyệt cho miền này, thì trang web ý định sẽ phân giải thành ứng dụng trình duyệt mặc định của người dùng.
Xác minh ý định bằng Cầu gỡ lỗi Android
Để xác minh rằng ứng dụng của bạn phản hồi các ý định mà bạn muốn hỗ trợ, bạn có thể sử dụng
Công cụ adb
để kích hoạt các ý định cụ thể bằng cách thực hiện
như sau:
Để biết thêm thông tin, hãy xem Thực hiện lệnh shell.