Skip to content

WakeLock API

Control device wake locks to keep the CPU or screen on.

Wake Lock Types

QSL4A provides different wake lock types:

Type Description
Full CPU on, screen bright, keyboard bright
Partial CPU on only
Bright CPU on, screen bright
Dim CPU on, screen dim

Wake Lock Methods

wakeLockAcquireFull()

Acquire a full wake lock (CPU on, screen bright, keyboard bright).

wakeLockAcquireFull()

wakeLockAcquirePartial()

Acquire a partial wake lock (CPU on only).

wakeLockAcquirePartial()

wakeLockAcquireBright()

Acquire a bright wake lock (CPU on, screen bright).

wakeLockAcquireBright()

wakeLockAcquireDim()

Acquire a dim wake lock (CPU on, screen dim).

wakeLockAcquireDim()

wakeLockRelease()

Release the wake lock.

wakeLockRelease()

Usage Example

import androidhelper
import time

droid = androidhelper.Android()

# Acquire full wake lock
droid.wakeLockAcquireFull()

# Do important work while keeping screen on
print("Screen will stay on")
time.sleep(10)

# Release when done
droid.wakeLockRelease()

# Or use partial lock for background tasks
droid.wakeLockAcquirePartial()
# CPU stays on even with screen off
time.sleep(30)
droid.wakeLockRelease()

Note: Remember to release wake locks when no longer needed to conserve battery.