別のアクティビティを開始する場合、アプリ内のアクティビティか別のアプリのアクティビティかに関係なく、一方向の操作である必要はありません。アクティビティを開始して、結果を受け取ることもできます。たとえば、アプリからカメラアプリを起動し、結果として撮影した写真を受け取ることができます。または、ユーザーが連絡先アプリを起動して連絡先を選択し、結果として連絡先の詳細を受け取るようにすることもできます。
基盤となる startActivityForResult()
API と onActivityResult()
API は、あらゆる API レベルの Activity
クラスで使用できますが、AndroidX Activity
クラスと Fragment
クラスで導入された Activity Result API を使用することを強くおすすめします。
Activity Result API には、結果を登録するためのコンポーネントが用意されています。 結果を生成するアクティビティを起動し、結果が生成されたら システムによってディスパッチされます。
アクティビティの結果に対してコールバックを登録する
アクティビティを開始して結果を取得する場合、メモリ不足が原因でプロセスやアクティビティが破棄される可能性があります(カメラの使用など、メモリを大量に消費する処理の場合は、ほぼ確実に破棄されます)。
そのため、Activity Result API では、他のアクティビティを開始するコードの場所から結果のコールバックを切り離しています。プロセスやアクティビティが再作成されたときに結果のコールバックを使用できる必要があるため、他のアクティビティを開始するロジックがユーザー入力やその他のビジネス ロジックに基づいてのみ実行される場合でも、アクティビティが作成されるたびにコールバックを無条件で登録する必要があります。
ComponentActivity
または Fragment
の Activity Result API には、結果のコールバックを登録するための registerForActivityResult()
が用意されています。registerForActivityResult()
は ActivityResultContract
と ActivityResultCallback
を受け取って、他のアクティビティを開始するために使用する ActivityResultLauncher
を返します。
ActivityResultContract
では、結果の生成に必要な入力タイプと結果の出力タイプを定義します。API には、写真の撮影や権限のリクエストなどの基本的なインテント アクション用のデフォルトのコントラクトが用意されています。カスタム コントラクトを作成することもできます。
ActivityResultCallback
は、ActivityResultContract
で定義した出力タイプのオブジェクトを受け取る onActivityResult()
メソッドを含むシングル メソッド インターフェースです。
Kotlin
val getContent = registerForActivityResult(GetContent()) { uri: Uri? -> // Handle the returned Uri }
Java
// GetContent creates an ActivityResultLauncher<String> to let you pass // in the mime type you want to let the user select ActivityResultLauncher<String> mGetContent = registerForActivityResult(new GetContent(), new ActivityResultCallback<Uri>() { @Override public void onActivityResult(Uri uri) { // Handle the returned Uri } });
アクティビティの結果を複数回呼び出す際に、それぞれ別々のコントラクトを使用するか、個別のコールバックが必要な場合、registerForActivityResult()
を複数回呼び出して、複数の ActivityResultLauncher
インスタンスを登録できます。配信中の結果が適切なコールバックに提供されるようにするには、フラグメントまたはアクティビティが作成されるたびに registerForActivityResult()
を同じ順序で呼び出す必要があります。
registerForActivityResult()
は、フラグメントまたはアクティビティが作成される前に安全に呼び出すことができ、返される ActivityResultLauncher
インスタンスのメンバー変数を宣言する際に直接使用できます。
結果に対してアクティビティを起動する
registerForActivityResult()
はコールバックの登録は行いますが、他のアクティビティは起動せず、結果に対するリクエストも開始しません。これらは、返された ActivityResultLauncher
インスタンスが行います。
入力が存在する場合、ランチャーは ActivityResultContract
のタイプと一致する入力を受け取ります。launch()
を呼び出すと、結果の生成プロセスが開始されます。ユーザーがその後のアクティビティを完了して復帰すると、次の例に示すように、ActivityResultCallback
の onActivityResult()
が実行されます。
Kotlin
val getContent = registerForActivityResult(GetContent()) { uri: Uri? -> // Handle the returned Uri } override fun onCreate(savedInstanceState: Bundle?) { // ... val selectButton = findViewById<Button>(R.id.select_button) selectButton.setOnClickListener { // Pass in the mime type you want to let the user select // as the input getContent.launch("image/*") } }
Java
ActivityResultLauncher<String> mGetContent = registerForActivityResult(new GetContent(), new ActivityResultCallback<Uri>() { @Override public void onActivityResult(Uri uri) { // Handle the returned Uri } }); @Override public void onCreate(@Nullable Bundle savedInstanceState) { // ... Button selectButton = findViewById(R.id.select_button); selectButton.setOnClickListener(new OnClickListener() { @Override public void onClick(View view) { // Pass in the mime type you want to let the user select // as the input mGetContent.launch("image/*"); } }); }
launch()
のオーバーロードされたバージョンを使用すると、入力に加えて ActivityOptionsCompat
も渡すことができます。
アクティビティの結果を別のクラスで受け取る
ComponentActivity
クラスと Fragment
クラスに実装されている ActivityResultCaller
インターフェースで registerForActivityResult()
API を使用できますが、ActivityResultCaller
を実装していない別のクラスで ActivityResultRegistry
を直接使用してアクティビティの結果を受け取ることもできます。
たとえば、コントラクトの登録とランチャーの起動を処理する LifecycleObserver
を実装できます。
Kotlin
class MyLifecycleObserver(private val registry : ActivityResultRegistry) : DefaultLifecycleObserver { lateinit var getContent : ActivityResultLauncher<String> override fun onCreate(owner: LifecycleOwner) { getContent = registry.register("key", owner, GetContent()) { uri -> // Handle the returned Uri } } fun selectImage() { getContent.launch("image/*") } } class MyFragment : Fragment() { lateinit var observer : MyLifecycleObserver override fun onCreate(savedInstanceState: Bundle?) { // ... observer = MyLifecycleObserver(requireActivity().activityResultRegistry) lifecycle.addObserver(observer) } override fun onViewCreated(view: View, savedInstanceState: Bundle?) { val selectButton = view.findViewById<Button>(R.id.select_button) selectButton.setOnClickListener { // Open the activity to select an image observer.selectImage() } } }
Java
class MyLifecycleObserver implements DefaultLifecycleObserver { private final ActivityResultRegistry mRegistry; private ActivityResultLauncher<String> mGetContent; MyLifecycleObserver(@NonNull ActivityResultRegistry registry) { mRegistry = registry; } public void onCreate(@NonNull LifecycleOwner owner) { // ... mGetContent = mRegistry.register(“key”, owner, new GetContent(), new ActivityResultCallback<Uri>() { @Override public void onActivityResult(Uri uri) { // Handle the returned Uri } }); } public void selectImage() { // Open the activity to select an image mGetContent.launch("image/*"); } } class MyFragment extends Fragment { private MyLifecycleObserver mObserver; @Override void onCreate(Bundle savedInstanceState) { // ... mObserver = new MyLifecycleObserver(requireActivity().getActivityResultRegistry()); getLifecycle().addObserver(mObserver); } @Override void onViewCreated(@NonNull View view, @Nullable Bundle savedInstanceState) { Button selectButton = findViewById(R.id.select_button); selectButton.setOnClickListener(new OnClickListener() { @Override public void onClick(View view) { mObserver.selectImage(); } }); } }
ActivityResultRegistry
API を使用する場合は、LifecycleOwner
を受け取る API を使用することを強くおすすめします。LifecycleOwner
は、Lifecycle
が破棄されると、登録済みのランチャーを自動的に削除します。ただし、LifecycleOwner
を使用できない場合は、代わりに各 ActivityResultLauncher
クラスを使用して unregister()
を手動で呼び出すことができます。
テスト
registerForActivityResult()
はデフォルトで、アクティビティから提供される ActivityResultRegistry
を自動的に使用します。また、独自の ActivityResultRegistry
インスタンスを渡すことができるオーバーロードを提供します。このインスタンスを使用すると、別のアクティビティを実際に起動せずにアクティビティの結果の呼び出しをテストできます。
アプリのフラグメントをテストする際にテスト用の ActivityResultRegistry
を提供するには、FragmentFactory
を使用してフラグメントのコンストラクタに ActivityResultRegistry
を渡します。
たとえば、TakePicturePreview
コントラクトを使用して画像のサムネイルを取得するフラグメントは、次のように記述できます。
Kotlin
class MyFragment( private val registry: ActivityResultRegistry ) : Fragment() { val thumbnailLiveData = MutableLiveData<Bitmap?> val takePicture = registerForActivityResult(TakePicturePreview(), registry) { bitmap: Bitmap? -> thumbnailLiveData.setValue(bitmap) } // ... }
Java
public class MyFragment extends Fragment { private final ActivityResultRegistry mRegistry; private final MutableLiveData<Bitmap> mThumbnailLiveData = new MutableLiveData(); private final ActivityResultLauncher<Void> mTakePicture = registerForActivityResult(new TakePicturePreview(), mRegistry, new ActivityResultCallback<Bitmap>() { @Override public void onActivityResult(Bitmap thumbnail) { mThumbnailLiveData.setValue(thumbnail); } }); public MyFragment(@NonNull ActivityResultRegistry registry) { super(); mRegistry = registry; } @VisibleForTesting @NonNull ActivityResultLauncher<Void> getTakePicture() { return mTakePicture; } @VisibleForTesting @NonNull LiveData<Bitmap> getThumbnailLiveData() { return mThumbnailLiveData; } // ... }
テスト固有の ActivityResultRegistry
を作成する場合は、onLaunch()
メソッドを実装する必要があります。startActivityForResult()
を呼び出す代わりに、テストの実装で dispatchResult()
を直接呼び出して、テストで使用する正確な結果を提供することもできます。
val testRegistry = object : ActivityResultRegistry() {
override fun <I, O> onLaunch(
requestCode: Int,
contract: ActivityResultContract<I, O>,
input: I,
options: ActivityOptionsCompat?
) {
dispatchResult(requestCode, expectedResult)
}
}
完全なテストでは、期待される結果が作成され、ActivityResultRegistry
テストが作成されてフラグメントに渡され、直接、または Espresso などの他のテスト API を使用してランチャーがトリガーされ、結果が検証されます。
@Test
fun activityResultTest {
// Create an expected result Bitmap
val expectedResult = Bitmap.createBitmap(1, 1, Bitmap.Config.RGBA_F16)
// Create the test ActivityResultRegistry
val testRegistry = object : ActivityResultRegistry() {
override fun <I, O> onLaunch(
requestCode: Int,
contract: ActivityResultContract<I, O>,
input: I,
options: ActivityOptionsCompat?
) {
dispatchResult(requestCode, expectedResult)
}
}
// Use the launchFragmentInContainer method that takes a
// lambda to construct the Fragment with the testRegistry
with(launchFragmentInContainer { MyFragment(testRegistry) }) {
onFragment { fragment ->
// Trigger the ActivityResultLauncher
fragment.takePicture()
// Verify the result is set
assertThat(fragment.thumbnailLiveData.value)
.isSameInstanceAs(expectedResult)
}
}
}
カスタム コントラクトを作成する
ActivityResultContracts
に含まれている事前ビルド済みのいくつかの ActivityResultContract
クラスを使用できますが、厳密にタイプセーフな API を必要に応じて提供する独自のコントラクトを作成することもできます。
各 ActivityResultContract
には、定義された入力クラスと出力クラスが必要です。入力が不要な場合は、入力タイプとして Void
を使用します(Kotlin では Void?
または Unit
を使用します)。
各コントラクトでは、createIntent()
メソッドを実装する必要があります。このメソッドでは、Context
と入力を受け取って、startActivityForResult()
で使用する Intent
を作成します。
各コントラクトでは parseResult()
も実装する必要があります。このメソッドでは、指定された resultCode
(Activity.RESULT_OK
、Activity.RESULT_CANCELED
、Intent
など)からの出力が生成されます。
createIntent()
を呼び出したり、他のアクティビティを開始したり、parseResult()
を使用して結果を作成したりせずに、指定された入力に対する結果を特定できる場合は、必要に応じてコントラクトに getSynchronousResult()
を実装できます。
次の例は、ActivityResultContract
の作成方法を示しています。
Kotlin
class PickRingtone : ActivityResultContract<Int, Uri?>() { override fun createIntent(context: Context, ringtoneType: Int) = Intent(RingtoneManager.ACTION_RINGTONE_PICKER).apply { putExtra(RingtoneManager.EXTRA_RINGTONE_TYPE, ringtoneType) } override fun parseResult(resultCode: Int, result: Intent?) : Uri? { if (resultCode != Activity.RESULT_OK) { return null } return result?.getParcelableExtra(RingtoneManager.EXTRA_RINGTONE_PICKED_URI) } }
Java
public class PickRingtone extends ActivityResultContract<Integer, Uri> { @NonNull @Override public Intent createIntent(@NonNull Context context, @NonNull Integer ringtoneType) { Intent intent = new Intent(Intent.ACTION_GET_CONTENT); intent.putExtra(RingtoneManager.EXTRA_RINGTONE_TYPE, ringtoneType.intValue()); return intent; } @Override public Uri parseResult(int resultCode, @Nullable Intent result) { if (resultCode != Activity.RESULT_OK || result == null) { return null; } return result.getParcelableExtra(RingtoneManager.EXTRA_RINGTONE_PICKED_URI); } }
カスタム コントラクトが不要な場合は、StartActivityForResult
コントラクトを使用できます。このコントラクトは、任意の Intent
を入力として受け取って ActivityResult
を返す汎用コントラクトです。このコントラクトを使用すると、次の例に示すように、コールバックの一部として resultCode
と Intent
を抽出できます。
Kotlin
val startForResult = registerForActivityResult(StartActivityForResult()) { result: ActivityResult -> if (result.resultCode == Activity.RESULT_OK) { val intent = result.data // Handle the Intent } } override fun onCreate(savedInstanceState: Bundle) { // ... val startButton = findViewById(R.id.start_button) startButton.setOnClickListener { // Use the Kotlin extension in activity-ktx // passing it the Intent you want to start startForResult.launch(Intent(this, ResultProducingActivity::class.java)) } }
Java
ActivityResultLauncher<Intent> mStartForResult = registerForActivityResult(new StartActivityForResult(), new ActivityResultCallback<ActivityResult>() { @Override public void onActivityResult(ActivityResult result) { if (result.getResultCode() == Activity.RESULT_OK) { Intent intent = result.getData(); // Handle the Intent } } }); @Override public void onCreate(@Nullable savedInstanceState: Bundle) { // ... Button startButton = findViewById(R.id.start_button); startButton.setOnClickListener(new OnClickListener() { @Override public void onClick(View view) { // The launcher with the Intent you want to start mStartForResult.launch(new Intent(this, ResultProducingActivity.class)); } }); }