ضبط قفل تنشيط

يمكنك ضبط قفل تنبيه لإبقاء الجهاز نشطًا مؤقتًا.

التبعيات

يجب أن يحصل تطبيقك على إذن WAKE_LOCK لضبط قفل التنشيط. أضِف الإذن إلى ملف بيان تطبيقك:

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

إنشاء قفل تنبيه واكتسابه

للحصول على قفل تنبيه، اتّبِع الخطوات التالية:

  1. استدعِ الدالة PowerManager.newWakeLock() لإنشاء قفل تنبيه. يؤدي ذلك إلى إنشاء عنصر PowerManager.WakeLock وضبط إعداداته، ولكنّه لا يبقي الجهاز نشطًا.

  2. عندما تريد إبقاء الجهاز نشطًا، استدعِ الطريقة acquire() الخاصة بكائن قفل التنشيط.

على سبيل المثال، إذا كان تطبيقك يتضمّن أداة استقبال بث تستخدم خدمة لتنفيذ بعض المهام، يمكنك استخدام الرمز التالي لضبط قفل التنشيط والحصول عليه:

Kotlin

val wakeLock: PowerManager.WakeLock =
    (getSystemService(Context.POWER_SERVICE) as PowerManager).run {
        newWakeLock(PowerManager.PARTIAL_WAKE_LOCK, "MyClassName::MyWakelockTag").apply {
            acquire()
        }
    }
WakeLockSnippetsKotlin.kt

Java

PowerManager powerManager = (PowerManager) getSystemService(POWER_SERVICE);
PowerManager.WakeLock wakeLock =
        powerManager.newWakeLock(PowerManager.PARTIAL_WAKE_LOCK, "MyClassName::MyWakelockTag");
wakeLock.acquire();
WakeLockSnippetsJava.java

نقاط أساسية حول هذا الرمز

عندما ينشئ الرمز البرمجي عنصر قفل التنشيط، يستخدم اسم الفئة كجزء من علامة قفل التنشيط. ننصحك بتضمين اسم الحزمة أو الفئة أو الطريقة كجزء من علامة قفل التنشيط. بهذه الطريقة، إذا حدث خطأ، سيكون من الأسهل تحديد موقع قفل التنشيط في رمز المصدر. لمزيد من المعلومات، يُرجى الاطّلاع على تسمية قفل التنشيط بشكل صحيح.

انظر أيضًا