WakefulBroadcastReceiver

public abstract class WakefulBroadcastReceiver
extends BroadcastReceiver

帮助器实现 BroadcastReceiver的常见模式，该模式接收设备唤醒事件，然后将工作传递给 Service ，同时确保设备在转换期间不会回到睡眠状态。

此课程负责为您创建和管理部分唤醒锁; 您必须请求WAKE_LOCK许可才能使用它。

Example

WakefulBroadcastReceiver使用方法startWakefulService()启动执行工作的服务。 此方法与startService()相当，只不过WakefulBroadcastReceiver在服务启动时持有唤醒锁。 与startWakefulService()传递的意图持有一个额外的识别唤醒锁。

import android.content.Context;
import android.content.Intent;
import android.os.SystemClock;
import android.support.v4.content.WakefulBroadcastReceiver;
import android.util.Log;

public class SimpleWakefulReceiver extends WakefulBroadcastReceiver {
    @Override
    public void onReceive(Context context, Intent intent) {
        // This is the Intent to deliver to our service.
        Intent service = new Intent(context, SimpleWakefulService.class);

        // Start the service, keeping the device awake while it is launching.
        Log.i("SimpleWakefulReceiver", "Starting service @ " + SystemClock.elapsedRealtime());
        startWakefulService(context, service);
    }
}

该服务（在本例中为IntentService ）做了一些工作。 完成后，它通过调用completeWakefulIntent(intent)来释放唤醒锁。 它作为参数传递的意图与WakefulBroadcastReceiver最初传入的意图是一样的。

import android.app.IntentService;
import android.content.Intent;
import android.os.SystemClock;
import android.util.Log;

public class SimpleWakefulService extends IntentService {
    public SimpleWakefulService() {
        super("SimpleWakefulService");
    }

    @Override
    protected void onHandleIntent(Intent intent) {
        // At this point SimpleWakefulReceiver is still holding a wake lock
        // for us.  We can do whatever we need to here and then tell it that
        // it can release the wakelock.  This sample just does some slow work,
        // but more complicated implementations could take their own wake
        // lock here before releasing the receiver's.
        //
        // Note that when using this approach you should be aware that if your
        // service gets killed and restarted while in the middle of such work
        // (so the Intent gets re-delivered to perform the work again), it will
        // at that point no longer be holding a wake lock since we are depending
        // on SimpleWakefulReceiver to that for us.  If this is a concern, you can
        // acquire a separate wake lock here.
        for (int i=0; i<5; i++) {
            Log.i("SimpleWakefulReceiver", "Running service " + (i+1)
                    + "/5 @ " + SystemClock.elapsedRealtime());
            try {
                Thread.sleep(5000);
            } catch (InterruptedException e) {
            }
        }
        Log.i("SimpleWakefulReceiver", "Completed service @ " + SystemClock.elapsedRealtime());
        SimpleWakefulReceiver.completeWakefulIntent(intent);
    }
}

Summary

Inherited methods
From class android.content.BroadcastReceiver final void abortBroadcast() 设置指示该接收器应当中止当前广播的标志; 仅适用于通过Context.sendOrderedBroadcast发送的广播。 final void clearAbortBroadcast() 清除指示该接收机应中止当前广播的标志。 final boolean getAbortBroadcast() 返回指示此接收器是否应中止当前广播的标志。 final boolean getDebugUnregister() 返回给定的最后一个值为 setDebugUnregister(boolean) 。 final int getResultCode() 检索当前结果代码，由前一个接收器设置。 final String getResultData() 检索当前结果数据，由前一个接收器设置。 final Bundle getResultExtras(boolean makeMap) 检索当前结果的额外数据，由前一个接收器设置。 final BroadcastReceiver.PendingResult goAsync() 这可以由 onReceive(Context, Intent)的应用程序调用，以允许它在从该函数返回之后保持广播活动。 final boolean isInitialStickyBroadcast() 如果接收者当前正在处理粘性广播的初始值（即，上次广播的值并且当前保存在粘性缓存中），则返回true，因此这不是直接由广播产生的结果。 final boolean isOrderedBroadcast() 如果接收者当前正在处理有序广播，则返回true。 abstract void onReceive(Context context, Intent intent) 当BroadcastReceiver正在接收Intent广播时调用此方法。 IBinder peekService(Context myContext, Intent service) 为已经运行的服务提供一个绑定。 final void setDebugUnregister(boolean debug) 控制对 Context.registerReceiver()不匹配调用包含调试帮助。 final void setOrderedHint(boolean isOrdered) 对于内部使用，设置有关此BroadcastReceiver是否以有序模式运行的提示。 final void setResult(int code, String data, Bundle extras) 更改从此广播返回的所有结果数据; 仅适用于通过Context.sendOrderedBroadcast发送的广播。 final void setResultCode(int code) 更改此广播的当前结果代码; 仅适用于通过Context.sendOrderedBroadcast发送的广播。 final void setResultData(String data) 更改此广播的当前结果数据; 仅适用于通过Context.sendOrderedBroadcast发送的广播。 final void setResultExtras(Bundle extras) 更改此广播的当前结果附加内容; 仅适用于通过Context.sendOrderedBroadcast发送的广播。
From class java.lang.Object Object clone() 创建并返回此对象的副本。 boolean equals(Object obj) 指示其他某个对象是否“等于”这一个。 void finalize() 当垃圾收集确定没有更多对该对象的引用时，由对象上的垃圾回收器调用。 final Class<?> getClass() 返回此 Object的运行时类。 int hashCode() 返回对象的哈希码值。 final void notify() 唤醒正在等待该对象监视器的单个线程。 final void notifyAll() 唤醒在该对象监视器上等待的所有线程。 String toString() 返回对象的字符串表示形式。 final void wait(long millis, int nanos) 导致当前线程等待，直到另一个线程为此对象调用 notify()方法或 notifyAll()方法，或者其他某个线程中断当前线程，或者经过一定的实时时间。 final void wait(long millis) 导致当前线程等待，直到另一个线程调用此对象的 notify()方法或 notifyAll()方法或经过指定的时间量。 final void wait() 导致当前线程等待，直到另一个线程调用此对象的 notify()方法或 notifyAll()方法。

Public constructors

WakefulBroadcastReceiver ()

Public methods

boolean completeWakefulIntent (Intent intent)

ComponentName startWakefulService (Context context, 
                Intent intent)