onActivityResult的现状
- 回调方法各种嵌套、耦合严重、难以维护
- 处理结果都耦合在onActivityResult回调中
- 定义许多额外的常量来处理返回结果
Activity Results API
- Activity Results API 是 Google官方推荐的Activity、Fragment获取返回结果的方式。
一、Activity Results API 中两个重要的组件：
ActivityResultContract和ActivityResultLauncher。
- ActivityResultContract: 协议，它定义了如何传递数据和如何处理返回的数据。ActivityResultContract是一个抽象类，你需要继承它来创建自己的协议，每个 ActivityResultContract 都需要定义输入和输出类，如果您不需要任何输入，可使用 Void作为输入类型。
- ActivityResultLauncher: 启动器，调用ActivityResultLauncher的launch方法来启动页面跳转，作用相当于原来的startActivity()
二、如何使用
- 首先再build.gradle中添加依赖
implementation 'androidx.activity:activity:1.2.0-beta01'
implementation 'androidx.fragment:fragment:1.3.0-beta01'
- 在Activity中新建内部类，继承ActivityResultContract
class ResultContract extends ActivityResultContract<String, String> {
@NonNull
@Override
public Intent createIntent(@NonNull Context context, String input) {
Intent intent = new Intent(ResultActivity.this, ResultBackOneActivity.class);
intent.putExtra("text_string", input);
return intent;
}
@Override
public String parseResult(int resultCode, @Nullable Intent intent) {
return intent.getStringExtra("one_back");
}
}
- 然后初始化ActivityResultLauncher，在回调方法中可以获取到带回来的值 result
ActivityResultLauncher launcher = registerForActivityResult(new ResultContract(), new ActivityResultCallback<String>() {
@Override
public void onActivityResult(String result) {
Toast.makeText(ResultActivity.this, result, Toast.LENGTH_SHORT).show();
}
});
- 然后在跳转方法中使用launcher进行页面见传值，使用.launcher()方法启动
tv_intent_one.setOnClickListener(new View.OnClickListener() {
@Override
public void onClick(View v) {
launcher.launch("这里是第一个跳转");
}
});
- 在目标页面中，处理还是一样的，返回数据时也是之前的操作
TextView tv_intent_one = findViewById(R.id.tv_intent_one);
tv_intent_one.setText(getIntent().getStringExtra("text_string"));
tv_intent_one.setOnClickListener(new View.OnClickListener() {
@Override
public void onClick(View v) {
setResult(RESULT_OK, new Intent().putExtra("one_back", "这里是第一个跳转的返回"));
finish();
}
});
三、使用预定的Contract
为了使用方便，Google预定义了许多类型
- StartActivityForResult: 通用的Contract,不做任何转换，Intent作为输入，ActivityResult作为输出，这也是最常用的一个协定。
- RequestMultiplePermissions：用于请求一组权限
- RequestPermission:用于请求单个权限
- TakePicturePreview:调用MediaStore.ACTION_IMAGE_CAPTURE拍照，返回值为Bitmap图片
- TakePicture:调用MediaStore.ACTION_IMAGE_CAPTURE拍照，并将图片保存到给定的Uri地址，返回true表示保存成功。
- TakeVideo: 调用MediaStore.ACTION_VIDEO_CAPTURE 拍摄视频，保存到给定的Uri地址，返回一张缩略图。
- PickContact:从通讯录APP获取联系人
- GetContent:提示用选择一条内容，返回一个通过ContentResolver#openInputStream(Uri)访问原生数据的- Uri地址（content://形式） 。默认情况下，它增加了Intent#CATEGORY_OPENABLE, 返回可以表示流的内容。
- CreateDocument:提示用户选择一个文档，返回一个(file:/http:/content:)开头的Uri。
- OpenMultipleDocuments: 提示用户选择文档（可以选择多个），分别返回它们的Uri，以List的形式。
- OpenDocumentTree: 提示用户选择一个目录，并返回用户选择的作为一个Uri返回，应用程序可以完全管理返回目录中的文档。
四、如何使用预定的Contract
- StartActivityForResult的使用，注意返回值定义为ActivityResult。在目标页面的处理同上
ActivityResultLauncher mylauncher = registerForActivityResult(new ActivityResultContracts.StartActivityForResult(), new ActivityResultCallback<ActivityResult>() {
@Override
public void onActivityResult(ActivityResult result) {
Toast.makeText(ResultActivity.this, result.getData().getStringExtra("two_back")+"-----", Toast.LENGTH_SHORT).show();
}
});
// 跳转方法
Intent intent = new Intent(ResultActivity.this, ResultBackTwoActivity.class);
intent.putExtra("text_string","这里是第二个跳转");
mylauncher.launch(intent);
- 单个权限请求（RequestPermission）和多个权限请求（RequestMultiplePermissions）的使用
// 初始化单个权限请求
ActivityResultLauncher requestpermiss = registerForActivityResult(new ActivityResultContracts.RequestPermission(), new ActivityResultCallback<Boolean>() {
@Override
public void onActivityResult(Boolean result) {
Toast.makeText(ResultActivity.this, "获取权限"+result, Toast.LENGTH_SHORT).show();
}
});
// 初始化多个权限请求
ActivityResultLauncher requestpermissgroup = registerForActivityResult(new ActivityResultContracts.RequestMultiplePermissions(), new ActivityResultCallback<Map<String, Boolean>>() {
@Override
public void onActivityResult(Map<String, Boolean> result) {
Set entries = result.entrySet( );
if(entries != null) {
Iterator iterator = entries.iterator( );
while(iterator.hasNext( )) {
Map.Entry entry = (Map.Entry) iterator.next( );
Object key = entry.getKey( );
Object value = entry.getValue();
Toast.makeText(ResultActivity.this, key+"权限获取"+value, Toast.LENGTH_SHORT).show();
}
}
}
});
// 单个权限请求实现
requestpermiss.launch(Manifest.permission.BLUETOOTH);
// 多个权限请求实现
String[] permissgroup = new String[]{
Manifest.permission.BLUETOOTH,
Manifest.permission.NFC,
Manifest.permission.ACCESS_FINE_LOCATION,
Manifest.permission.CAMERA};
requestpermissgroup.launch(permissgroup);
