이 튜토리얼에서는 안드로이드 앱에서 BroadcastReceiver를 활용해 배터리 잔량(%)과 충전 상태(충전 중, 방전 중, 충전 완료 등)를 실시간으로 감지하고 화면에 표시하는 방법을 단계별로 살펴봅니다.
배터리 정보는 시스템 브로드캐스트인 ACTION_BATTERY_CHANGED를 통해 얻을 수 있으며, 이 방식은 배터리 상태가 변경될 때마다 자동으로 콜백을 받기 때문에 별도의 폴링 없이도 효율적으로 구현할 수 있습니다.
1단계 — 새 프로젝트 생성
Android Studio를 실행한 뒤 File → New Project 메뉴로 이동하여 새 프로젝트를 생성합니다. 필요한 모든 세부 정보를 입력하고 프로젝트 설정을 완료하세요.
2단계 — 레이아웃 파일 작성
res/layout/activity_main.xml 파일에 아래 코드를 추가합니다. 배터리 정보를 표시할 TextView 하나를 포함하는 간단한 세로 LinearLayout 구조입니다.
<?xml version="1.0" encoding="utf-8"?>
<LinearLayout xmlns:android="https://schemas.android.com/apk/res/android"
xmlns:tools="https://schemas.android.com/tools"
android:layout_width="match_parent"
android:layout_height="match_parent"
android:orientation="vertical"
android:padding="16sp"
tools:context=".MainActivity">
<TextView
android:id="@+id/textView"
android:layout_width="wrap_content"
android:layout_height="wrap_content"
android:layout_marginTop="30dp"
android:textSize="24sp"
android:textStyle="bold" />
</LinearLayout>3단계 — MainActivity 구현
src/MainActivity.java 파일에 아래 코드를 추가합니다. 핵심 로직은 다음과 같습니다.
- ACTION_BATTERY_CHANGED 브로드캐스트 등록:
registerReceiver()를 통해 배터리 상태 변경 이벤트를 수신합니다. - 배터리 잔량 가져오기:
BatteryManager.EXTRA_LEVEL엑스트라에서 현재 잔량(%)을 읽어옵니다. - 충전 상태 판별:
BATTERY_STATUS_CHARGING또는BATTERY_STATUS_FULL이면 충전 중으로,BATTERY_STATUS_DISCHARGING이면 방전 중으로 판단합니다.
import androidx.appcompat.app.AppCompatActivity;
import android.content.BroadcastReceiver;
import android.content.Context;
import android.content.Intent;
import android.content.IntentFilter;
import android.os.BatteryManager;
import android.os.Bundle;
import android.widget.TextView;
import android.widget.Toast;
public class MainActivity extends AppCompatActivity {
TextView textView;
Context context;
@Override
protected void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
setContentView(R.layout.activity_main);
context = getApplicationContext();
textView = findViewById(R.id.textView);
this.registerReceiver(this.broadcastReceiver, new
IntentFilter(Intent.ACTION_BATTERY_CHANGED));
}
private BroadcastReceiver broadcastReceiver = new BroadcastReceiver() {
@Override
public void onReceive(Context context, Intent intent) {
int level = intent.getIntExtra(BatteryManager.EXTRA_LEVEL, 0);
textView.setText("Battery Percentage: " + level);
int status = intent.getIntExtra(BatteryManager.EXTRA_STATUS, -1);
boolean isCharging = status == BatteryManager.BATTERY_STATUS_CHARGING || status ==
BatteryManager.BATTERY_STATUS_FULL;
if (isCharging) {
Toast.makeText(getApplicationContext(), "Charger connected, Battery Charging..",
Toast.LENGTH_SHORT).show();
}
else if (status == BatteryManager.BATTERY_STATUS_DISCHARGING) {
Toast.makeText(getApplicationContext(), "Charger disconnected",
Toast.LENGTH_SHORT).show();
}
}
};
}4단계 — 매니페스트 설정
androidManifest.xml 파일에 아래 코드를 추가합니다. 이 예제는 특별한 권한 없이 시스템 브로드캐스트만 사용하므로, 기본 액티비티 선언 외에 추가 권한 설정은 필요하지 않습니다.
<?xml version="1.0" encoding="utf-8"?>
<manifest xmlns:android="https://schemas.android.com/apk/res/android"
package="app.com.sample">
<application
android:allowBackup="true"
android:icon="@mipmap/ic_launcher"
android:label="@string/app_name"
android:roundIcon="@mipmap/ic_launcher_round"
android:supportsRtl="true"
android:theme="@style/AppTheme">
<activity android:name=".MainActivity">
<intent-filter>
<action android:name="android.intent.action.MAIN" />
<category android:name="android.intent.category.LAUNCHER" />
</intent-filter>
</activity>
</application>
</manifest>앱 실행 및 결과 확인
이제 애플리케이션을 실행해 보겠습니다. 실제 안드로이드 기기를 컴퓨터에 연결했다고 가정합니다. Android Studio에서 프로젝트의 액티비티 파일 중 하나를 연 뒤, 툴바의 Run ▶ 아이콘을 클릭하세요.
실행 옵션 목록에서 연결된 모바일 기기를 선택하면, 해당 기본 화면에 배터리 잔량이 표시되는 것을 확인할 수 있습니다.
충전기를 연결하거나 분리하면 BroadcastReceiver가 즉시 반응하여 충전 중 여부를 토스트 메시지로 알려주고, 배터리 잔량도 실시간으로 갱신됩니다. 이처럼 ACTION_BATTERY_CHANGED 브로드캐스트를 활용하면 배터리 관련 기능(절전 모드 전환, 저전량 경고 등)을 손쉽게 구현할 수 있습니다.