1page.title=Monitoring the Battery Level and Charging State 2parent.title=Optimizing Battery Life 3parent.link=index.html 4 5trainingnavtop=true 6next.title=Determining and Monitoring the Docking State and Type 7next.link=docking-monitoring.html 8 9@jd:body 10 11<div id="tb-wrapper"> 12<div id="tb"> 13 14<h2>Содержание урока</h2> 15<ol> 16 <li><a href="#DetermineChargeState">Определение текущего состояния зарядки</a></li> 17 <li><a href="#MonitorChargeState">Отслеживание изменений состояния зарядки</a></li> 18 <li><a href="#CurrentLevel">Определение текущего уровня заряда батареи</a></li> 19 <li><a href="#MonitorLevel">Отслеживание существенных изменений уровня заряда батареи</a></li> 20</ol> 21 22<h2>Дополнительные материалы</h2> 23<ul> 24 <li><a href="{@docRoot}guide/components/intents-filters.html">Намерения и фильтры намерений</a> 25</ul> 26 27</div> 28</div> 29 30<p>Если вы хотите изменить частоту фоновых обновлений, чтобы продлить время работы устройства от батареи, сначала рекомендуется проверить текущий уровень заряда и состояние зарядки.</p> 31 32<p>Именно от этих двух факторов зависит, как обновления повлияют на время работы устройства от батареи. Когда устройство подключено к сети переменного тока, приложение можно обновлять максимально часто, поскольку процесс обновления не будет сказываться на уровне заряда батареи. Если устройство не подключено к сети, следует воздержаться от обновлений, чтобы продлить время его работы от батареи.</p> 33 34<p>Если заряд батареи практически исчерпан, можно снизить частоту обновлений (вплоть до их полного прекращения).</p> 35 36 37<h2 id="DetermineChargeState">Определение текущего состояния зарядки</h2> 38 39<p>Начните с определения текущего состояния зарядки. {@link android.os.BatteryManager} передает все сведения о батарее и зарядке в закрепленном намерении {@link android.content.Intent}, которое содержит также информацию о состоянии зарядки.</p> 40 41<p>Поскольку это намерение является закрепленным, регистрировать {@link android.content.BroadcastReceiver} не нужно. Чтобы получить текущее состояние батареи в виде намерения, нужно вызвать {@code registerReceiver}, передав {@code null} в качестве приемника, как показано в коде ниже. Можно также передать фактический объект {@link android.content.BroadcastReceiver}, но это необязательно, поскольку обработка обновлений будет выполняться позднее.</p> 42 43<pre>IntentFilter ifilter = new IntentFilter(Intent.ACTION_BATTERY_CHANGED); 44Intent batteryStatus = context.registerReceiver(null, ifilter);</pre> 45 46<p>Можно извлечь данные как о текущем состоянии, так и об источнике зарядки (USB или сеть переменного тока), если устройство заряжается:<p> 47 48<pre>// Are we charging / charged? 49int status = batteryStatus.getIntExtra(BatteryManager.EXTRA_STATUS, -1); 50boolean isCharging = status == BatteryManager.BATTERY_STATUS_CHARGING || 51 status == BatteryManager.BATTERY_STATUS_FULL; 52 53// How are we charging? 54int chargePlug = battery.getIntExtra(BatteryManager.EXTRA_PLUGGED, -1); 55boolean usbCharge = chargePlug == BATTERY_PLUGGED_USB; 56boolean acCharge = chargePlug == BATTERY_PLUGGED_AC;</pre> 57 58<p>Как правило, если устройство подключено к сети переменного тока, фоновые обновления можно выполнять с максимальной частотой. Если устройство заряжается через USB, частоту можно несколько сократить, а если устройство не подключено к сети – сократить еще больше.</p> 59 60 61<h2 id="MonitorChargeState">Отслеживание изменений состояния зарядки</h2> 62 63<p>Состояние зарядки изменяется всякий раз, когда пользователь подключает устройство к источнику питания. Поскольку это случается довольно часто, важно отслеживать изменения этого состояния и соответствующим образом корректировать частоту обновления приложения.</p> 64 65<p>{@link android.os.BatteryManager} передает действие каждый раз, когда устройство подключается к источнику питания или отключается от него. Важно получать эти события, даже если приложение не работает. Они помогут, в частности, определить, как часто будет запускаться приложение для выполнения фоновых обновлений. Чтобы отслеживать их, зарегистрируйте {@link android.content.BroadcastReceiver} в манифесте, задав {@link android.content.Intent#ACTION_POWER_CONNECTED} и {@link android.content.Intent#ACTION_POWER_DISCONNECTED} в фильтре намерений.</p> 66 67<pre><receiver android:name=".PowerConnectionReceiver"> 68 <intent-filter> 69 <action android:name="android.intent.action.ACTION_POWER_CONNECTED"/> 70 <action android:name="android.intent.action.ACTION_POWER_DISCONNECTED"/> 71 </intent-filter> 72</receiver></pre> 73 74<p>Соответствующая реализация {@link android.content.BroadcastReceiver} позволяет извлечь данные о текущем состоянии и способе зарядки, как описано в предыдущем шаге.</p> 75 76<pre>public class PowerConnectionReceiver extends BroadcastReceiver { 77 @Override 78 public void onReceive(Context context, Intent intent) { 79 int status = intent.getIntExtra(BatteryManager.EXTRA_STATUS, -1); 80 boolean isCharging = status == BatteryManager.BATTERY_STATUS_CHARGING || 81 status == BatteryManager.BATTERY_STATUS_FULL; 82 83 int chargePlug = intent.getIntExtra(BatteryManager.EXTRA_PLUGGED, -1); 84 boolean usbCharge = chargePlug == BATTERY_PLUGGED_USB; 85 boolean acCharge = chargePlug == BATTERY_PLUGGED_AC; 86 } 87}</pre> 88 89 90<h2 id="CurrentLevel">Определение текущего уровня заряда батареи</h2> 91 92<p>В некоторых случаях целесообразно определять текущий уровень заряда батареи. Если он ниже определенного значения, частоту фоновых обновлений следует уменьшить.</p> 93 94<p>Узнать, каков в настоящий момент заряд батареи, можно путем извлечения данных о текущем и максимальном уровне заряда из намерения состояния батареи, как показано в этом коде:</p> 95 96<pre>int level = battery.getIntExtra(BatteryManager.EXTRA_LEVEL, -1); 97int scale = battery.getIntExtra(BatteryManager.EXTRA_SCALE, -1); 98 99float batteryPct = level / (float)scale;</pre> 100 101 102<h2 id="MonitorLevel">Отслеживание существенных изменений уровня заряда батареи</h2> 103 104<p>Отслеживать состояние батареи непрерывно не следует,</p> 105 106<p>поскольку при этом нагрузка на батарею будет значительно выше, чем при обычной работе приложения. Рекомендуется отслеживать только существенные изменения уровня заряда, в частности, переход устройства в состояние низкого заряда и обратно.</p> 107 108<p>Фрагмент манифеста, приведенный ниже, относится к фильтру намерений в приемнике широковещательных намерений. Приемник срабатывает, когда батарея устройства переходит в состояние низкого заряда или выходит из него. Для этого прослушиваются события {@link android.content.Intent#ACTION_BATTERY_LOW} и {@link android.content.Intent#ACTION_BATTERY_OKAY}.</p> 109 110<pre><receiver android:name=".BatteryLevelReceiver"> 111<intent-filter> 112 <action android:name="android.intent.action.ACTION_BATTERY_LOW"/> 113 <action android:name="android.intent.action.ACTION_BATTERY_OKAY"/> 114 </intent-filter> 115</receiver></pre> 116 117<p>Общепринятой практикой является отключение всех фоновых обновлений, когда заряд батареи достигает критически низкого уровня. Будет уже неважно, насколько актуальны данные в вашем приложении, если телефон самопроизвольно выключится, прежде чем пользователь успеет их просмотреть.</p> 118 119<p>Во многих случаях начало зарядки устройства совпадает с моментом его установки в док-станцию. В следующем уроке описаны способы определения текущего состояния подключения устройства к док-станции и отслеживания изменений этого состояния.</p> 120 121