Koleksiyonlar ile düzeninizi koruyun
İçeriği tercihlerinize göre kaydedin ve kategorilere ayırın.
Kullanıcı Android cihazını kullanmayı bıraktığında, pilin tükenmesini önlemek için cihaz hızlı bir şekilde askıya alma durumuna geçer. Ancak bazı durumlarda uygulamanın CPU'nun askıya alma durumuna geçmesini önlemesi gerekir. Bazı durumlarda, uygulamanın çalışırken ekranı açık tutması gerekebilir. Diğer durumlarda, uygulamanın ekranı açık tutması gerekmez ancak CPU'nun etkin olması gerekir.
Uygulayacağınız yaklaşım, uygulamanızın ihtiyaçlarına bağlıdır. Ancak genel bir kural olarak, uygulamanızın sistem kaynakları üzerindeki etkisini en aza indirmek için mümkün olan en hafif yaklaşımı kullanmanız gerekir. Bu doküman, durumunuza uygun Android teknolojisini seçmenize yardımcı olur.
Doğru teknolojiyi seçme
Cihazınızı uyanık tutmak için en iyi seçenek, uygulamanızın ihtiyaçlarına bağlıdır. Bu bölüm, doğru yaklaşımı seçmenize yardımcı olur.
Uygulamanızın ekranı açık tutması gerekiyor mu?
Yanıtınız Evet ise Ekranı açık tutma bölümüne bakın. İhtiyacınız olan işlevi yerine getiren özel amaçlı bir API olabilir. Örneğin, telefon görüşmesi kullanıcı arayüzü uyguluyorsanız gerektiğinde ekranı açık tutan Android telekom çerçevesini kullanabilirsiniz. Durumunuza özel bir API yoksa keepScreenOn API'sini kullanabilirsiniz.
Uygulamanız bir ön plan hizmeti mi çalıştırıyor ve hizmet çalışırken ekran kapalıyken cihazı uyanık tutmanız mı gerekiyor?
Yanıtınız Hayır ise cihazı uyanık tutmanıza gerek yoktur. Kullanıcı uygulamayla etkin bir şekilde etkileşim kuruyorsa cihaz uyanık kalır. Kullanıcı uygulamanızla etkileşimde bulunmuyorsa ve ön planda bir hizmet çalıştırılmıyorsa gerektiğinde cihazın askıya alma moduna geçmesine izin vermeniz gerekir. Kullanıcı uygulamadan uzakken bazı işlerin yapılmasını sağlamanız yeterliyse en iyi seçeneği bulmak için arka plan görevleri dokümanını inceleyin.
Yanıtınız Evet ise öncelikle ön plan hizmeti kullanmanız gerektiğini onaylayın. Durumunuza bağlı olarak, ön plan hizmeti yerine ihtiyacınızı karşılamak için kullanabileceğiniz bazı özel amaçlı API'ler olabilir.
Bu bilgilere Ön Plan Hizmeti dokümanlarında ulaşabilirsiniz. Örneğin, kullanıcının konumunu izlemeniz gerekiyorsa location ön plan hizmeti yerine coğrafi sınırlama API'sini kullanabilirsiniz.
Ön plan hizmeti çalışırken ve cihaz ekranı kapalıyken cihazın askıya alınması kullanıcı deneyimi için zararlı olur mu? (Örneğin, bildirimleri güncellemek için bir ön plan hizmeti kullanıyorsanız cihazın askıya alınması kötü bir kullanıcı deneyimi olmaz.)
Yanıtınız Hayır ise wakelock kullanmayın. Kullanıcı cihazıyla etkileşime geçtiğinde işlem otomatik olarak devam eder ve cihaz askıya alınmış durumdan çıkar.
Yanıtınız Evet ise uyandırma kilidi kullanmanız gerekebilir. Ancak, Cihazı uyanık tutan işlemler bölümünde açıklandığı gibi, halihazırda bir API kullanıp kullanmadığınızı veya sizin adınıza uyanma kilidi belirten bir işlem yapıp yapmadığınızı kontrol etmeniz gerekir.
Cihazı uyanık tutan işlemler
Uygulamanız aşağıdakilerden herhangi birini yapıyorsa uyanma kilidi ayarlamanıza gerek yoktur. Aşağıdaki işlemler ve API'lerin tümü cihazı sizin için açık tutar.
Ses çalıyorsanız ses sistemi sizin için bir uyanma kilidi ayarlar ve yönetir. Bunu kendiniz yapmanız gerekmez.
WorkManager, JobScheduler veya DownloadManager gibi görev planlama API'lerini ya da kitaplıklarını kullanıyorsanız sistem veya kitaplık, uygulamanızla ilişkilendirilen bir uyanık kalma kilidi edinir.
Belirli cihaz sensörleri uyandırıcı sensörlerdir. Bu sensörlerin, bildirecek verileri olduğunda cihazı uyandırmasını sağlamak için SensorManager değerini kullanabilirsiniz. Bir sensörün uyanma sensörü olup olmadığını kontrol etmek için Sensor.isWakeUpSensor değerini çağırın.
Bu sayfadaki içerik ve kod örnekleri, İçerik Lisansı sayfasında açıklanan lisanslara tabidir. Java ve OpenJDK, Oracle ve/veya satış ortaklarının tescilli ticari markasıdır.
Son güncelleme tarihi: 2025-07-26 UTC.
[[["Anlaması kolay","easyToUnderstand","thumb-up"],["Sorunumu çözdü","solvedMyProblem","thumb-up"],["Diğer","otherUp","thumb-up"]],[["İhtiyacım olan bilgiler yok","missingTheInformationINeed","thumb-down"],["Çok karmaşık / çok fazla adım var","tooComplicatedTooManySteps","thumb-down"],["Güncel değil","outOfDate","thumb-down"],["Çeviri sorunu","translationIssue","thumb-down"],["Örnek veya kod sorunu","samplesCodeIssue","thumb-down"],["Diğer","otherDown","thumb-down"]],["Son güncelleme tarihi: 2025-07-26 UTC."],[],[],null,["# Choose the right API to keep the device awake\n\nWhen the user leaves their Android-powered device idle, it quickly goes into the\nsuspend state to avoid draining the battery. However, there are times when an\napp needs to prevent the CPU from going to the suspend state. In some cases, the\napp may need to keep the screen on while it's working. In other cases, the app\ndoesn't need to keep the screen on but still needs the CPU to be active.\n\nThe approach you take depends on the needs of your app. However, a general rule\nis that you should use the most lightweight approach possible, to minimize your\napp's impact on system resources. This document helps you choose the correct\nAndroid technology for your situation.\n| **Note:** You may be familiar with **wake locks**. An app can set a wake lock to keep the device from suspending. However, using a wake lock can quickly drain the device battery. You should only use a wake lock if there's no other option that will do what you need. If you do use a wake lock, you should release it as soon as possible.\n\nChoose the right technology\n---------------------------\n\nThe best option for keeping your device awake depends on your app's needs. This\nsection helps you choose the right approach.\n\n- Does your app need to keep the screen on?\n - If **Yes** , see [Keep the screen on](/develop/background-work/background-tasks/awake/screen-on). There may be a special-purpose API that does what you need; for example, if you're implementing a phone-call UI, you can use the [Android telecom\n framework](/reference/android/telecom/package-summary), which keeps the screen on when needed. If there's no special purpose API for your situation, you can use the `keepScreenOn` API.\n- Is your app running a foreground service, and you need to keep the device awake when screen is off while the service is running?\n - If **No** , you do not need to keep the device awake. If the user is actively interacting with the app, the device will stay awake. If the user is not interacting with your app and you are not running a foreground service, you should let the device go into suspend mode when necessary. If you just need to make sure some work gets done while the user is away from the app, see the [background tasks](/develop/background-work/background-tasks) documentation to find the best option.\n - If **Yes** , first confirm that you actually need to use a foreground service. Depending on your situation, there may be some special-purpose API you can use to accomplish your need instead of a foreground service. You can find information about these [in the Foreground Service\n documentation](/develop/background-work/services/fgs/service-types). For example, if you need to track the user's location, you might be able to use the [geofencing API](/develop/sensors-and-location/location/geofencing) instead of a `location` foreground service.\n- Would it be detrimental to the user experience if the device suspends while the foreground service is running and the device screen is off? (For example, if you're using a foreground service to update notifications, it wouldn't be a bad user experience if the device is suspended.)\n - If **No**, do not use a wakelock. The action resumes automatically once the user engages with their device, which takes it out of suspend.\n - If **Yes** , you might need to [use a wake lock](/develop/background-work/background-tasks/awake/wakelock). However, you should still check to see if you're already using an API or doing an action that declares a wake lock on your behalf, as discussed in [Actions that keep the device awake](#actions-keep).\n\nActions that keep the device awake\n----------------------------------\n\nIf your app is doing any of the following, you don't need to set a wake lock\nyourself. The following actions and APIs all keep the device awake for you.\n\n- If you're playing audio, the audio system sets and manages a wake lock for you; you don't need to do it yourself.\n- If you're using task scheduling APIs or libraries such as [WorkManager](/develop/background-work/background-tasks/persistent), [`JobScheduler`](/reference/android/app/job/JobScheduler), or [`DownloadManager`](/reference/android/app/DownloadManager), the system or library acquires a wake lock that is attributed to your app.\n- If you're using [Media3 ExoPlayer](/media/media3/exoplayer), you can use [`ExoPlayer.setWakeMode()`](/reference/androidx/media3/exoplayer/ExoPlayer#setWakeMode(int)) to have the player set a wake lock for you.\n- Certain device sensors are wake-up sensors; you can use [`SensorManager`](/reference/android/hardware/SensorManager) to have those sensors wake up the device when they have data to report. To check if a sensor is a wake-up sensor, call [`Sensor.isWakeUpSensor`](/reference/android/hardware/Sensor#isWakeUpSensor())).\n\nSee also\n--------\n\n- [Use wake locks](/develop/background-work/background-tasks/awake/wakelock)\n- [Keep the screen on](/develop/background-work/background-tasks/awake/screen-on)"]]
