onResume — مبانی، تعامل با کاربر در Android

مبانی روش onResume در Android

onResume — سومین متد چرخه حیات Activity است که پس از onStart فراخوانی می‌شود و آمادگی صفحه برای تعامل کامل با کاربر را نشان می‌دهد. در این لحظه Activity در بالای پشته وظایف (back stack) قرار دارد، سیستم تمام رویدادهای ورودی را به آن هدایت می‌کند و برنامه می‌تواند هر عملیاتی را که نیاز به مشارکت فعال کاربر دارد آغاز کند: تماس‌های ویدیویی، بازی‌ها، ضبط صدا، نقاشی روی Canvas.

onResume بخشی از «عمر در پیش‌زمینه» (foreground lifetime) است — فاصله بین onResume و onPause. این فعال‌ترین دوره کاری Activity است که برنامه حداکثر منابع را مصرف می‌کند: پردازنده برای پردازش لمس‌ها، GPU برای رندر انیمیشن‌ها، دوربین و میکروفون برای ضبط ویدیو. درک این سطح از چرخه حیات برای بهینه‌سازی مصرف انرژی حیاتی است — منابعی که در onResume باز می‌شوند باید بلافاصله در onPause بسته شوند.

طبق داده‌های Google I/O 2025، میانگین زمانی که Activity در یک جلسه در حالت onResume می‌گذراند، ۲–۵ دقیقه برای برنامه‌های خبری و ۱۵–۳۰ دقیقه برای بازی‌ها و پیام‌رسان‌ها است. بقیه زمان Activity در حالت‌های onPause، onStop یا onDestroy قرار دارد. این بدان معناست که بهینه‌سازی دقیقاً کد onResume بیشترین سود را در عملکرد و عمر باتری می‌دهد.

onResume در Activity

در Activity متد onResume هر بار که صفحه فوکوس ورودی دریافت می‌کند فراخوانی می‌شود — در اولین راه‌اندازی، هنگام بازگشت از Activity دیگر، هنگام بسته شدن پنجره دیالوگ، هنگام باز کردن قفل دستگاه. این یک متد داغ است که ممکن است چندین بار در طول یک جلسه فراخوانی شود و پیاده‌سازی آن باید تا حد امکان سبک باشد.

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", "اتصال دوربین انجام نشد", e)
            }
        }, ContextCompact.getMainExecutor(this))
    }

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

مثال با CameraX استفاده کلاسیک از onResume/onPause را نشان می‌دهد: دوربین یک منبع انحصاری است که فقط می‌تواند توسط یک برنامه در یک زمان استفاده شود. اتصال دوربین به چرخه حیات از طریق bindToLifecycle به طور خودکار دوربین را در onPause می‌بندد، اما فراخوانی صریح unbindAll آزادسازی فوری را تضمین می‌کند. این به ویژه هنگام جابجایی بین Activity‌ها مهم است: دوربین باید قبل از اینکه Activity دیگری سعی در باز کردن آن کند آزاد شود.

onResume در Fragment

onResume در Fragment پس از آن‌که Activity حاوی آن onResume دریافت کرد فراخوانی می‌شود. با این حال به دلیل ویژگی‌های FragmentManager و ViewPager، لحظه فراخوانی onResume برای Fragment می‌تواند نسبت به Activity به تأخیر بیفتد. به عنوان مثال، Fragment در ViewPager با offscreenPageLimit = 1 تنها زمانی که صفحه جاری شود onResume دریافت می‌کند، نه هنگام شروع 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()
    }
}

بررسی userVisibleHint در Fragment.onResume برای ViewPager ضروری است: Fragment ممکن است onResume دریافت کند اما توسط صفحه مجاور پنهان شده باشد (مثلاً در انتقال انیمیشنی). در چنین مواردی راه‌اندازی ویدیو یا بیومتریک در onResume بدون بررسی رویت‌پذیری منجر به رفتار غیرمنتظره می‌شود. از Fragment 1.5.0 به بعد، توصیه می‌شود از FragmentTransaction.setMaxLifecycle() برای کنترل دقیق چرخه حیات fragment‌ها در ViewPager2 استفاده کنید.

onResume در مقابل onStart: چه زمانی از کدام استفاده کنیم

توسعه‌دهندگان اغلب onStart و onResume را اشتباه می‌گیرند و کد را در متد نامناسب قرار می‌دهند. قانون اصلی: onStart — برای منابعی که در رویت‌پذیری کار می‌کنند; onResume — برای منابعی که نیاز به فوکوس ورودی دارند. بیایید سناریوهای خاص و انتخاب صحیح متد را بررسی کنیم.

قاعده عملی: اگر عملیات باید با ظاهر شدن پنجره دیالوگ قطع شود — از onResume/onPause استفاده کنید. اگر عملیات می‌تواند با پوشش جزئی صفحه ادامه یابد — از onStart/onStop استفاده کنید. به عنوان مثال، پخش‌کننده ویدیو باید هنگام باز شدن دیالوگ ویدیو را متوقف کند (onPause)، در حالی که موقعیت جغرافیایی می‌تواند به به‌روزرسانی ادامه دهد (در onStart باقی می‌ماند).

مدیریت منابع انحصاری

منابع انحصاری — اجزای دستگاهی هستند که فقط می‌توانند توسط یک برنامه در یک لحظه خاص استفاده شوند. دوربین، میکروفون، خروجی ویدیو (MediaProjection)، آداپتور NFC در حالت خواندن، دستگاه‌های USB در حالت accessory — همه این منابع باید در onResume باز و در onPause آزاد شوند.

کار با MediaRecorder

MediaRecorder برای ضبط صدا و ویدیو استفاده می‌شود. درخواست مجوزها و آماده‌سازی MediaRecorder در onCreate انجام می‌شود و شروع ضبط در onResume. اگر کاربر به برنامه دیگری سوئیچ کند، onPause ضبط را متوقف می‌کند و onResume آن را از سر می‌گیرد. این رفتار استاندارد برای ضبط‌کننده‌های صدا و برنامه‌های ضبط ویدیو است.

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 و onResume

احراز هویت بیومتریک (BiometricPrompt) فقط زمانی باید فراخوانی شود که Activity در onResume است. اگر آن را در onCreate یا onStart فراخوانی کنید، دیالوگ بیومتریک ممکن است قبل از اتمام مقداردهی Activity ظاهر شود که منجر به پردازش نادرست نتیجه می‌شود. فراخوانی در onResume تضمین می‌کند که پنجره بیومتریک در زمینه صحیح نمایش داده شود.

الگوها و توصیه‌ها

سه الگوی تأیید شده کار با onResume را بررسی می‌کنیم که در پروژه‌های تجاری استفاده می‌شوند: بازنشانی تایمر عدم فعالیت، به‌روزرسانی داده‌های قابل مشاهده و یکپارچه‌سازی با Jetpack Navigation.

بازنشانی تایمر عدم فعالیت

در برنامه‌های دارای داده‌های محرمانه (بانکداری، کارت‌های پزشکی) از onResume برای بازنشانی تایمر خروج خودکار استفاده می‌شود. اگر کاربر فعالانه با برنامه تعامل دارد، onResume در هر جابجایی بین صفحات فراخوانی می‌شود و تایمر بازنشانی می‌شود. اگر کاربر برنامه را کوچک کند، onPause تایمر را متوقف می‌کند و onResume هنگام بازگشت یا آن را بازنشانی می‌کند یا احراز هویت مجدد را درخواست می‌کند.

به‌روزرسانی داده‌ها هنگام بازگشت

لیستی که باید در هر بازگشت به صفحه داده‌های به‌روز را نمایش دهد در onResume به‌روزرسانی می‌شود. به عنوان مثال، اگر کاربر یک رکورد جدید در Activity دیگر ایجاد کرده و برگردد، onResume لیست را از پایگاه داده محلی یا از کش ViewModel بارگیری مجدد می‌کند. این امر سازگاری داده‌ها را بدون فراخوانی دستی notifyDataSetChanged تضمین می‌کند.

override fun onResume() {
    super.onResume()
    // ActivityResultLauncher نتیجه را برگرداند — لیست را به‌روزرسانی می‌کنیم
    viewModel.refreshList()
    // بازنشانی تایمر عدم فعالیت
    inactivityTimer.reset()
}

Jetpack Navigation و onResume

در Jetpack Navigation onResume فرگمنت در هر بازگشت به آن از طریق ناوبری برگشتی فراخوانی می‌شود. این ویژگی برای بازنشانی وضعیت UI استفاده می‌شود: مخفی کردن صفحه‌کلید، پاک کردن فیلدهای جستجو، به‌روزرسانی عنوان نوار ابزار. OnBackPressedCallback در ترکیب با onResume کنترل کامل ناوبری را بدون تکرار کد فراهم می‌کند.