翻译 android.os.PowerManager

<!-- @page { margin: 0.79in } P { margin-bottom: 0.08in } H1 { margin-bottom: 0.08in } H1.western { font-family: "Times New Roman", serif } H1.cjk { font-family: "DejaVu Sans" } H1.ctl { font-family: "Lohit Hindi" } TD P { margin-bottom: 0in } H2 { margin-bottom: 0.08in } H2.ctl { font-family: "Lohit Hindi" } PRE.cjk { font-family: "DejaVu Sans", monospace } TH P { margin-bottom: 0in } CODE.cjk { font-family: "DejaVu Sans", monospace } -->

public class

PowerManager

extends Object

java.lang.Object

   ↳

android.os.PowerManager

类概括

Class Overview

 

本类使你能控制设备能量状态。

This class gives you control of the power state of the device.

 

设备电池生命将会受到这个API的使用的重大影响。除非你真正需要他们不要获得WakeLocks,尽可能使用最小等级,并且确保一旦你能够就释放他。

Device battery life will be significantly affected by the use of this API. Do not acquire WakeLocks unless you really need them, use the minimum levels possible, and be sure to release it as soon as you can.

 

你可以通过调用Context.getSystemService()获得这个类的一个实例。

You can obtain an instance of this class by calling Context.getSystemService().

 

首先你要用到的APInewWakeLock()。这个方法将建立一个PowerManager.WakeLock对象。你能够这样使用方法通过这个对象来控制设备的能量状态。实践起来十分简单:

The primary API you'll use is newWakeLock(). This will create a PowerManager.WakeLock object. You can then use methods on this object to control the power state of the device. In practice it's quite simple:

 

PowerManager pm = (PowerManager) getSystemService(Context.POWER_SERVICE);
 PowerManager.WakeLock wl = pm.newWakeLock(PowerManager.SCREEN_DIM_WAKE_LOCK, "My Tag");
 wl.acquire();
   ..screen will stay on during this section..
 wl.release();
 

 

以下定义的标志,以及对系统能量的不同影响。有些标志是相互独立-你可能仅指定他们之一。

The following flags are defined, with varying effects on system power. These flags are mutually exclusive - you may only specify one of them.

Flag Value

CPU

Screen

Keyboard

PARTIAL_WAKE_LOCK

On*

Off

Off

SCREEN_DIM_WAKE_LOCK

On

Dim

Off

SCREEN_BRIGHT_WAKE_LOCK

On

Bright

Off

FULL_WAKE_LOCK

On

Bright

Bright

 

*如果你获得一个不完整的wakelock,则CPU会继续运行,不必顾及任何计时器甚至用户按下power键后。对于所有的其他的wakelockCPU在运行,但用户可以直接用power键使设备休眠。

*If you hold a partial wakelock, the CPU will continue to run, irrespective of any timers and even after the user presses the power button. In all other wakelocks, the CPU will run, but the user can still put the device to sleep using the power button.

 

另外,你能加两个以上的标志,这些仅能影响屏幕的行为。这些标志当组合中有一个PARTIAL_WAKE_LOCK时将没有效果。

In addition, you can add two more flags, which affect behavior of the screen only. These flags have no effect when combined with a PARTIAL_WAKE_LOCK.

Flag Value

Description

ACQUIRE_CAUSES_WAKEUP

 

正常的wake lock不会实际转到照明。反而,他们使照明保持自他打开时(例如,来自用户activity)。这个标志会强制屏幕和/或键盘立即打开,当这个wakelock已获取时。一个典型用法是将哪些重要的通知立即让用户看到。

Normal wake locks don't actually turn on the illumination. Instead, they cause the illumination to remain on once it turns on (e.g. from user activity). This flag will force the screen and/or keyboard to turn on immediately, when the WakeLock is acquired. A typical use would be for notifications which are important for the user to see immediately.

ON_AFTER_RELEASE

 

如果这个标志被设置,用户activity计时器当WakeLock被释放时会重新设定,因为照明保持一点长。这个可以用于降低闪烁如果你是在wake lock状态下循环。

If this flag is set, the user activity timer will be reset when the WakeLock is released, causing the illumination to remain on a bit longer. This can be used to reduce flicker if you are cycling between wake lock conditions.

Summary

Nested Classes

class

PowerManager.WakeLock

类让你说你需要有这个设备。

Class lets you say that you need to have the device on. 

Constants

int

ACQUIRE_CAUSES_WAKEUP

正常的wake lock不会实际的唤醒设备,他们自他准备好则保持着。

Normally wake locks don't actually wake the device, they just cause it to remain on once it's already on.

int

FULL_WAKE_LOCK

Wake lock 以确保屏幕和键盘全部点亮。

Wake lock that ensures that the screen and keyboard are on at full brightness.

int

ON_AFTER_RELEASE

当这个wake lock已释放时,拨开了用户界面的计时器所以屏幕停留稍微长。

When this wake lock is released, poke the user activity timer so the screen stays on for a little longer.

int

PARTIAL_WAKE_LOCK

Wake lock以确保CPU运行。

Wake lock that ensures that the CPU is running.

int

SCREEN_BRIGHT_WAKE_LOCK

Wake lock以确保屏幕全亮;键盘背光允许关闭。

Wake lock that ensures that the screen is on at full brightness; the keyboard backlight will be allowed to go off.

int

SCREEN_DIM_WAKE_LOCK

Wake lock以确保屏幕打开(但可以是暗淡的);键盘背光将允许关闭。

Wake lock that ensures that the screen is on (but may be dimmed); the keyboard backlight will be allowed to go off.

Public Methods

void

goToSleep(long time)

强制设备进入休眠。

Force the device to go to sleep.

boolean

IsScreenOn()

返回屏幕是否当前亮着。

Returns whether the screen is currently on.

PowerManager.WakeLock

newWakeLock(int flags, String tag)

得到一个Wake lock在这个标志参数的级别。

Get a wake lock at the level of the flags parameter.

void

reboot(String reason)

重启设备

Reboot the device.

void

userActivity(long when, boolean noChangeLights)

用户界面发生。

User activity happened.

 

  • 0
    点赞
  • 0
    收藏
    觉得还不错? 一键收藏
  • 0
    评论

“相关推荐”对你有帮助么?

  • 非常没帮助
  • 没帮助
  • 一般
  • 有帮助
  • 非常有帮助
提交
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值