ActivityResultLauncher
是 Android 开发中的一个 API,用于启动 Activity 并处理其返回的结果。这个 API 是在 Android 10(API 级别 29)开始被推荐使用,以替代过时的 startActivityForResult
方法。
ActivityResultLauncher
提供了一种简单而有效的方式来处理 Activity 的结果。开发者可以使用它来在应用程序中启动 Activity,并在 Activity 完成后接收和处理返回的结果。
在使用 ActivityResultLauncher
时,通常需要在 onCreate
或 onAttach
方法下进行初始化。此外,Android 还提供了一些标准的 ActivityResultContract
,这些契约定义了启动 Activity 和处理结果的规范方式。
请注意,ActivityResultLauncher
是在 Android API 级别 23(Android 6.0, Marshmallow)引入的,但直到 API 级别 29(Android 10)才被广泛推荐使用。在之前的版本中,开发者可能仍需要使用 startActivityForResult
方法来处理 Activity 的结果。
ActivityResultLauncher 应用举例
ActivityResultLauncher
在 Android 开发中用于启动 Activity 并处理其返回的结果。以下是一个使用 ActivityResultLauncher
的基本示例,假设我们要启动一个相机 Activity 并获取拍摄的照片:
首先,在项目的 build.gradle
文件中添加依赖项,以使用 ActivityResultLauncher
和相关的 KTX 扩展:
implementation 'androidx.activity:activity-ktx:1.5.1' // 使用时请检查最新版本 |
然后,在需要使用 ActivityResultLauncher
的 Activity 中定义它:
import androidx.activity.result.ActivityResult | |
import androidx.activity.result.ActivityResultCallback | |
import androidx.activity.result.ActivityResultLauncher | |
import androidx.activity.result.contract.ActivityResultContracts | |
import androidx.appcompat.app.AppCompatActivity | |
import android.content.Intent | |
import android.net.Uri | |
import android.os.Bundle | |
import android.provider.MediaStore | |
class MainActivity : AppCompatActivity() { | |
private lateinit var takePictureLauncher: ActivityResultLauncher<Intent> | |
override fun onCreate(savedInstanceState: Bundle?) { | |
super.onCreate(savedInstanceState) | |
setContentView(R.layout.activity_main) | |
// 初始化 ActivityResultLauncher | |
takePictureLauncher = registerForActivityResult( | |
ActivityResultContracts.TakePicture(), | |
ActivityResultCallback { result: Boolean -> | |
if (result) { | |
// 照片拍摄成功,可以在这里处理照片(如保存到文件、显示预览等) | |
// 注意:照片的实际文件路径需要根据相机的配置和设备的不同来确定 | |
} else { | |
// 照片拍摄失败或取消 | |
} | |
} | |
) | |
// 假设有一个按钮用于触发拍照 | |
// button_take_picture.setOnClickListener { ... } | |
} | |
// 当需要启动相机时 | |
fun startCamera() { | |
val intent = Intent(MediaStore.ACTION_IMAGE_CAPTURE) | |
if (intent.resolveActivity(packageManager) != null) { | |
// 启动相机 Activity | |
takePictureLauncher.launch(intent) | |
} | |
} | |
} |
在这个例子中,我们使用了 ActivityResultContracts.TakePicture()
作为一个预定义的 ActivityResultContract
,它简化了处理相机 Activity 结果的逻辑。当用户拍摄照片后,ActivityResultLauncher
会调用我们提供的 ActivityResultCallback
,我们可以在回调中处理照片(如保存到文件、显示预览等)。
请注意,上述代码中的 startCamera()
方法是一个假设的方法,用于演示如何触发拍照操作。在实际应用中,你可能需要将其与一个按钮或其他 UI 组件的点击事件绑定。