使用JobScheduler / JobInfo显式唤醒

时间:2018-06-26 23:20:39

标签: android wakelock android-jobscheduler

我正在重构此代码:

https://github.com/r3gis3r/CSipSimple/blob/master/src/com/csipsimple/utils/TimerWrapper.java

使用AlarmManager安排计时器。按照Google的建议,我将代码重构为使用JobScheduler

/**
 * @param entryId
 * @param latencyMs
 * @brief Handler for schedule
 */
private synchronized int handleSchedule(int entryId, int latencyMs) {
    // clamp to minimum latencyMs
    latencyMs = (latencyMs < TIMER_MIN_LATENCY_MS) ? TIMER_MIN_LATENCY_MS : latencyMs;

    // Cancel previous registrations for the entryId
    mJobScheduler.cancel(entryId);
    int existingReg = mScheduleEntries.indexOf(entryId);
    if (existingReg != -1) {
        mScheduleEntries.remove(existingReg);
        mScheduleTimes.remove(existingReg);
    }

    long fireTimeMs = SystemClock.elapsedRealtime() + latencyMs;

    Log.v(TAG, "Schedule timer " + entryId + " in " + latencyMs + "ms @ " + fireTimeMs);

    ComponentName componentName = new ComponentName(mContext, PTAPITimerJobService.class);

    PersistableBundle persistableBundle = new PersistableBundle();
    persistableBundle.putInt(EXTRA_TIMER_ENTRY, entryId);
    persistableBundle.putLong(EXTRA_TIMER_EXPIRATION, fireTimeMs);

    final JobInfo.Builder jobInfoBuilder = new JobInfo.Builder(entryId, componentName).setExtras(persistableBundle);
    jobInfoBuilder.setMinimumLatency(latencyMs);

    // TODO - set wakelock criteria
    JobInfo jobInfo = jobInfoBuilder.build();
    mJobScheduler.schedule(jobInfo);

    mScheduleEntries.add(entryId);
    mScheduleTimes.add(fireTimeMs);
    return 1;
}

以上方法等效于CSipSimple中粘贴的链接中的doSchedule。在JobInfo的文档中,有类似的方法:setRequiredNetworkType,setRequiresDeviceIdle用于设置各种条件。

问题:在JobInfo中提及这些条件是否足够?还是需要管理一个明确的WakeLock(如AlarmManager案例所示)?

计时器的唤醒锁类型:

public class WakeLockTypes {
    public static final int     LOCK_TYPE_NONE              = 0x0;
    public static final int     LOCK_TYPE_WIFI              = 0x1;  // Keep the Wi-Fi radio awake
    public static final int     LOCK_TYPE_WIFI_MULTICAST    = 0x2;  // Allow receiving of Wifi Multicast packets
    public static final int     LOCK_TYPE_POWER_WAKE        = 0x4;  // Keeps the device CPU on
    public static final int     LOCK_TYPE_SCREEN_DIM_WAKE   = 0x8;  // Keeps the screen on (dim)

    public static final int     LOCK_TYPE_DEFAULT   = (LOCK_TYPE_SCREEN_DIM_WAKE|LOCK_TYPE_WIFI); 

}

1 个答案:

答案 0 :(得分:1)

JobScheduler将在您的作业运行时使设备保持唤醒状态,因此您不需要自己的WakeLock