2023/9/1

【Kotlin/Android Studio】registerForActivityResultの使い方！launcherとは？

この記事からわかること

Android Studio/KotlinのregisterForActivityResultの使い方
別のActivityを起動させるには？
Activityの結果を取得する方法
StartActivityForResultの挙動
ActivityResultContractの設定値
RequestPermission/RequestMultiplePermissionsを使用したパーミッションダイアログの結果取得

index

[open]

registerForActivityResult
ActivityResultContract型
ActivityResultCallback
別のActivityからデータを受け取る
RequestPermission：パーミッションダイアログを表示する
RequestMultiplePermissions：複数のパーミッションダイアログを表示する

＼アプリをリリースしました／

友達や家族の誕生日をメモ！通知も届く-みんなの誕生日-

posted withアプリーチ

公式リファレンス：アクティビティの結果を取得する

環境

Android Studio：Flamingo
Kotlin：1.8.20

registerForActivityResult

定義
abstract @NonNull ActivityResultLauncher<I> <I, O> registerForActivityResult(
    @NonNull ActivityResultContract<I, O> contract,
    @NonNull ActivityResultCallback<O> callback
)

registerForActivityResultは別のアクティビティを起動し結果を取得することができるメソッドです。引数としてActivityResultContract型を受け取りActivityResultLauncher型を返します。

使用例
private val launcher = registerForActivityResult(ActivityResultContracts.StartActivityForResult()) { result ->
  // 結果に対する処理
}

※ランチャーとは機能を保持し、あとは簡単な操作のみで起動させるだけの機能のことです。

ActivityResultContract型

公式リファレンス：ActivityResultContract

ActivityResultContractには色々定義されており、渡すものによって機能が異なります。

StartActivityForResult

Activityを起動して結果を取得する

RequestPermission

単体のパーミッション許可ダイアログを表示して結果を取得する

RequestMultiplePermissions

複数個のパーミッション許可ダイアログを表示して結果を取得する

ActivityResultCallback

registerForActivityResultの2つ目の引数ActivityResultCallback(コールバック)で実際の結果を受け取ることが可能になっています。

別のActivityからデータを受け取る

今回はよくあるSecondActivityから入力されたデータをMainActivityで表示させてみます。

MainActivity側でregisterForActivityResultメソッドを呼び出します。1つ目の引数にはActivityResultContracts.StartActivityForResultを渡します。Activityから返ってくる値はコールバックで受け取れるので変数resultに格納し、resultCodeプロパティから識別コードを、dataプロパティからIntentを参照することができます。

MainActivity.ky
class MainActivity : AppCompatActivity() {

    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        setContentView(R.layout.activity_main)
        val button: Button = findViewById(R.id.done_button)

        button.setOnClickListener {
            // SecondActivityに送信する用のデータを準備する
            val intent = Intent(applicationContext, SecondActivity::class.java)
            // SecondActivityを起動
            launcher.launch(intent)
        }
    }

    // SecondActivityを起動する機能と結果を処理する機能をもったランチャー(ActivityResultLauncher型)
    private val launcher =
    registerForActivityResult(ActivityResultContracts.StartActivityForResult()) { result ->
        // Resultコードをチェック
        if (result.resultCode == Activity.RESULT_OK) {
            // インテントを取得
            val intent = result.data
            // 中身を取り出す
            val name = intent?.getStringExtra("name")
            // 表示
            Toast.makeText(this, name, Toast.LENGTH_SHORT)
                .show()
        }
    }
}

Intentの使い方は以下の記事を参考にしてください。

SecondActivity側はsetResultメソッドを使用して結果として返すデータを設定します。1つ目の引数にはActivity.RESULT_OKやActivity.RESULT_CANCELEDなどの識別コードを渡し、2つ目にはIntentを渡します。

定義
public final void setResult(int resultCode, Intent data) {
    throw new RuntimeException("Stub!");
}

最後にActivityを終了するfinishメソッドを呼び出して完了です。

SecondActivity.kt
class SecondActivity : AppCompatActivity() {

    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        setContentView(R.layout.activity_second)

        val name: EditText = findViewById(R.id.name_edit)
        val backBtn:Button = findViewById(R.id.back_button)
        backBtn.setOnClickListener {
            // インテントに値をセット
            intent.putExtra("name", name.text.toString())
            // 結果として返すデータをセット
            setResult(Activity.RESULT_OK, intent)
            // アクティビティを終了
            finish()
        }
    }
}

これで以下のような機能を実装することができました。

RequestPermission：パーミッションダイアログを表示する

registerForActivityResultの引数にRequestPermissionを渡すことで簡単にパーミッション許可申請ダイアログを表示することができます。ダイアログを出す際は忘れずにマニフェストファイルの追加をしといてください。

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

実装は以下のとおりです。

class MainActivity : AppCompatActivity() {
    
    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        setContentView(R.layout.activity_main)

        // 許可ダイアログを表示
        launcher.launch(Manifest.permission.CAMERA)
    }

    private val launcher =
        registerForActivityResult(ActivityResultContracts.RequestPermission()) { result ->
            // ダイアログの結果で処理を分岐
            if (result) {
                Toast.makeText(this, "許可されました", Toast.LENGTH_SHORT)
                    .show()
            } else {
                Toast.makeText(this, "否認されました", Toast.LENGTH_SHORT)
                    .show()
            }
        }
}

RequestMultiplePermissions：複数のパーミッションダイアログを表示する

複数のパーミッションダイアログを表示するにはRequestMultiplePermissionsを指定します。

class MainActivity : AppCompatActivity() {

    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        setContentView(R.layout.activity_main)

        launcher.launch(
            arrayOf(
                Manifest.permission.CAMERA,
                Manifest.permission.ACCESS_COARSE_LOCATION
            )
        )
    }

    private val launcher =
        registerForActivityResult(ActivityResultContracts.RequestMultiplePermissions()) {
            it
            val camera = it[Manifest.permission.CAMERA] ?: false
            val location = it[Manifest.permission.ACCESS_COARSE_LOCATION] ?: false

            if (camera && location) {
                Toast.makeText(this, "許可されました", Toast.LENGTH_SHORT)
                    .show()
            } else {
                Toast.makeText(this, "否認されました", Toast.LENGTH_SHORT)
                    .show()
            }
        }
}