onResume — mga batayan, pakikipag-ugnayan sa gumagamit sa Android

Mga batayan ng onResume method sa Android

onResume — ikatlong pamamaraan ng lifecycle ng Activity, tinatawag pagkatapos ng onStart, na nagpapahiwatig ng kahandaan ng screen para sa buong interaksyon sa gumagamit. Sa sandaling ito ang Activity ay nasa tuktok ng stack ng mga gawain (back stack), idinidirekta ng system ang lahat ng input event dito, at ang application ay maaaring magsimula ng anumang operasyon na nangangailangan ng aktibong partisipasyon ng gumagamit: mga video call, laro, pag-record ng audio, pagguhit sa Canvas.

Ang onResume ay bahagi ng foreground lifetime — ang panahon sa pagitan ng onResume at onPause. Ito ang pinaka-aktibong panahon ng trabaho ng Activity, kung saan ang application ay kumokonsumo ng maximum na resources: ang processor para sa pagproseso ng mga pagpindot, GPU para sa pag-render ng mga animation, camera at mikropono para sa video capture. Ang pag-unawa sa antas na ito ng lifecycle ay kritikal para sa pag-optimize ng konsumo ng enerhiya — ang mga resources na binuksan sa onResume ay dapat na agad na isara sa onPause.

Ayon sa datos ng Google I/O 2025, ang average na oras na ginugugol ng Activity sa onResume state bawat session ay 2–5 minuto para sa mga balita app at 15–30 minuto para sa mga laro at messenger. Ang natitirang oras ang Activity ay nasa onPause, onStop, o onDestroy states. Ibig sabihin, ang pag-optimize ng onResume code ay nagbibigay ng pinakamalaking pakinabang sa performance at buhay ng baterya.

onResume sa Activity

Sa Activity, ang onResume method ay tinatawag tuwing ang screen ay nakatatanggap ng input focus — sa unang paglunsad, sa pagbabalik mula sa ibang Activity, sa pagsasara ng dialog window, sa pag-unlock ng device. Ito ay isang mainit na pamamaraan na maaaring tawagin nang maraming beses sa isang session, at ang implementasyon nito ay dapat na gaan hangga't maaari.

class CameraActivity : AppCompatActivity() {
    private var cameraProvider: ProcessCameraProvider? = null
    private var preview: Preview? = null

    override fun onResume() {
        super.onResume()
        val cameraProviderFuture = ProcessCameraProvider.getInstance(this)
        cameraProviderFuture.addListener({
            cameraProvider = cameraProviderFuture.get()
            val cameraSelector = CameraSelector.DEFAULT_BACK_CAMERA
            preview = Preview.Builder().build().also {
                it.setSurfaceProvider(binding?.viewFinder?.surfaceProvider)
            }
            try {
                cameraProvider?.unbindAll()
                cameraProvider?.bindToLifecycle(
                    this, cameraSelector, preview
                )
            } catch (e: Exception) {
                Log.e("Camera", "Nabigo na i-bind ang camera", e)
            }
        }, ContextCompact.getMainExecutor(this))
    }

    override fun onPause() {
        super.onPause()
        cameraProvider?.unbindAll()
        preview = null
    }
}

Ang halimbawa gamit ang CameraX ay nagpapakita ng klasikong paggamit ng onResume/onPause: ang camera ay isang eksklusibong resource na maaari lamang gamitin ng isang application sa isang pagkakataon. Ang pagtali ng camera sa lifecycle sa pamamagitan ng bindToLifecycle ay awtomatikong nagsasara ng camera sa onPause, ngunit ang tahasang tawag na unbindAll ay ginagarantiyahan ang agarang pagpapalaya. Ito ay lalong mahalaga sa paglipat sa pagitan ng mga Activity: ang camera ay dapat palayain bago subukan ng ibang Activity na buksan ito.

onResume sa Fragment

Ang onResume sa Fragment ay tinatawag pagkatapos na ang Activity na naglalaman nito ay nakatanggap ng onResume. Gayunpaman, dahil sa mga katangian ng FragmentManager at ViewPager, ang sandali ng pagtawag ng onResume para sa Fragment ay maaaring maantala kumpara sa Activity. Halimbawa, ang Fragment sa ViewPager na may offscreenPageLimit = 1 ay tumatanggap ng onResume lamang kapag ito ay naging kasalukuyang pahina, hindi sa pagsisimula ng Activity.

class VideoPlayerFragment : Fragment() {
    private var exoPlayer: ExoPlayer? = null

    override fun onViewCreated(view: View, savedInstanceState: Bundle?) {
        super.onViewCreated(view, savedInstanceState)
        exoPlayer = ExoPlayer.Builder(requireContext()).build()
        binding?.playerView?.player = exoPlayer
    }

    override fun onResume() {
        super.onResume()
        exoPlayer?.play()
        if (userVisibleHint) {
            startBiometricAuth()
        }
    }

    override fun onPause() {
        exoPlayer?.pause()
        stopBiometricAuth()
        super.onPause()
    }
}

Ang pagsusuri ng userVisibleHint sa Fragment.onResume ay mahalaga para sa ViewPager: ang Fragment ay maaaring makatanggap ng onResume ngunit nakatago ng katabing pahina (halimbawa, sa animated na transition). Sa ganitong mga kaso, ang pagsisimula ng video o biometry sa onResume nang walang pagsusuri ng visibility ay magdudulot ng hindi inaasahang pag-uugali. Simula sa Fragment 1.5.0, inirerekomenda ang paggamit ng FragmentTransaction.setMaxLifecycle() para sa tumpak na kontrol ng lifecycle ng mga fragment sa ViewPager2.

onResume vs onStart: kailan gagamitin ang ano

Ang mga developer ay madalas na nalilito sa onStart at onResume, inilalagay ang code sa maling pamamaraan. Pangunahing patakaran: onStart — para sa mga resources na gumagana sa visibility; onResume — para sa mga resources na nangangailangan ng input focus. Tingnan natin ang mga partikular na sitwasyon at ang tamang pagpili ng pamamaraan.

Praktikal na patakaran: kung ang operasyon ay dapat maputol kapag lumitaw ang dialog window — gamitin ang onResume/onPause. Kung ang operasyon ay maaaring magpatuloy sa bahagyang pagtakip ng screen — gamitin ang onStart/onStop. Halimbawa, ang video player ay dapat mag-pause ng video kapag binuksan ang dialog (onPause), habang ang geolokasyon ay maaaring magpatuloy sa pag-update (nananatili sa onStart).

Pamamahala ng eksklusibong resources

Ang eksklusibong resources ay mga component ng device na maaari lamang gamitin ng isang application sa isang partikular na oras. Camera, mikropono, video output (MediaProjection), NFC adapter sa read mode, USB device sa accessory mode — lahat ng resources na ito ay dapat buksan sa onResume at palayain sa onPause.

Paggamit ng MediaRecorder

Ang MediaRecorder ay ginagamit para sa pag-record ng audio at video. Ang paghingi ng pahintulot at paghahanda ng MediaRecorder ay ginagawa sa onCreate, at ang pagsisimula ng pag-record ay sa onResume. Kung ang gumagamit ay lumipat sa ibang application, ang onPause ay nagpapahinto ng pag-record, at ang onResume ay nagpapatuloy nito. Ito ay karaniwang pag-uugali para sa mga dictaphone at video recording application.

private var mediaRecorder: MediaRecorder? = null
private var isRecording = false

override fun onResume() {
    super.onResume()
    if (isRecording) {
        mediaRecorder?.resume()
    }
}

override fun onPause() {
    if (isRecording) {
        mediaRecorder?.pause()
    }
    super.onPause()
}

BiometricPrompt at onResume

Ang biometric authentication (BiometricPrompt) ay dapat tawagin lamang kapag ang Activity ay nasa onResume. Kung tatawagin ito sa onCreate o onStart, ang dialog ng biometry ay maaaring lumitaw bago matapos ng Activity ang initialization, na magdudulot ng hindi tamang pagproseso ng resulta. Ang pagtawag sa onResume ay ginagarantiyahan na ang biometry window ay ipapakita sa tamang konteksto.

Mga pattern at rekomendasyon

Tingnan natin ang tatlong napatunayang pattern ng pagtatrabaho sa onResume na inilalapat sa mga komersyal na proyekto: pag-reset ng timer ng kawalan ng aktibidad, pag-update ng nakikitang datos, at integrasyon sa Jetpack Navigation.

Pag-reset ng timer ng kawalan ng aktibidad

Sa mga application na may kumpidensyal na datos (banking, medical card) ang onResume ay ginagamit para i-reset ang timer ng awtomatikong pag-logout. Kung ang gumagamit ay aktibong nakikipag-ugnayan sa application, ang onResume ay tinatawag sa bawat paglipat sa pagitan ng mga screen at ang timer ay nire-reset. Kung ang gumagamit ay nag-minimize ng application, ang onPause ay humihinto sa timer, at ang onResume sa pagbabalik ay maaaring i-reset ito o humingi ng re-authentication.

Pag-update ng datos sa pagbabalik

Ang listahan na dapat magpakita ng kasalukuyang datos sa bawat pagbabalik sa screen ay ina-update sa onResume. Halimbawa, kung ang gumagamit ay gumawa ng bagong tala sa ibang Activity at bumalik, ang onResume ay nagre-reload ng listahan mula sa lokal na database o mula sa ViewModel cache. Ito ay tinitiyak ang consistency ng datos nang walang manu-manong pagtawag ng notifyDataSetChanged.

override fun onResume() {
    super.onResume()
    // Ang ActivityResultLauncher ay nagbalik ng resulta — ina-update ang listahan
    viewModel.refreshList()
    // Pag-reset ng timer ng kawalan ng aktibidad
    inactivityTimer.reset()
}

Jetpack Navigation at onResume

Sa Jetpack Navigation ang onResume ng fragment ay tinatawag sa bawat pagbabalik dito sa pamamagitan ng back navigation. Ang property na ito ay ginagamit para i-reset ang estado ng UI: itago ang keyboard, linisin ang mga patlang ng paghahanap, i-update ang pamagat ng toolbar. Ang OnBackPressedCallback kasama ng onResume ay nagbibigay ng buong kontrol sa nabigasyon nang walang pagdodoble ng code.