브로드캐스트 리시버

• 이벤트 모델로 실행되는 컴포넌트 (여기서 이벤트 모델은 유저 이벤트가 아니라, 시스템의 특정 상황을 의미함.)
• BroadcastReceiver를 상속받은 클래스 작성

class MyReceiver: BroadcastReceiver() {
	override fun onReceive(context: Context, intent: Intent){
    	// ... 
    }
}

브로드캐스트 리시버 등록

• 시스템에서 생명주기를 관리하는 컴포넌트들은 AndroidManifest.xml 파일에 등록해줘야 한다. (name은 필수 속성)

<receiver
  android:name=".MyReceiver"
  android:enabled="true"
  android:exported="true">
</receiver> 

• 그런데, 브로드캐스트 리시버는 매니페스트 파일에 등록시키지 않고 코드에서 필요한 순간에 동적으로 등록할 수 있다.
• unregisterReceiver() 함수로 등록 해제

val receiver = object: BroadcastReceiver(){
	override fun onReceive(context: Context?, intent: Intent?) {
    	// ... 
    }
}

val filter = IntentFilter("ACTION_RECEIVER") 
registerReceiver(receiver, filter) // 동적으로 시스템에 등록 

// ...

unregisterReceiver(receiver) // 등록 해제 

브로드캐스트 리시버 실행

• sendBroadcast() 함수로 리시버 실행 (결국 이 함수는 브로드캐스트를 실행하기 위한 인텐트를 시스템에 발생시키는 함수가 된다.)

val intent = Intent(this, MyReceiver::class.java) 
sendBroadcast(intent) 

• 액티비티 인텐트의 동작 원리
• 인텐트에 의해 실행될 컴포넌트가 없을 때는 에러가 발생하며, 여러 개의 컴포넌트가 있을 때는 유저의 선택에 의해 한 개만 실행된다.

• 브로드캐스트 리시버의 동작 원리
• 인텐트에 의해 실행될 리시버가 없을 때는 에러가 발생하지 않으며, 여러 개의 리시버가 있을 때는 모두 실행된다.

---

시스템 이벤트 활용

부팅 완료

• 부팅 완료 시점에 특정 업무를 진행
• 브로드캐스트 리시버를 만들고 AndroidManifest.xml 파일에 시스템에서 띄우는 인텐트 정보로 intent-filter를 구성해 등록한다.

<uses-permission android:name="android.permission.RECEIVE_BOOT_COMPLETED"/>

<receiver
  android:name=".MyReceiver"
  android:enabled="true"
  android:exported="true">
  <intent-filter>
    <action android:name="android.intent.action.BOOT_COMPLETED"/>
  </intent-filter>
</receiver>

스크린 ON/OFF

• 스크린이 ON/OFF 되는 순간에 브로드캐스트 리시버 실행
• 코드에서 registerReceiver() 함수를 이용해 동적으로 등록해야만 실행 가능

val filter = IntentFilter(Intent.ACTION_SCREEN_ON).apply {
	addAction(Intent.ACTION_SCREEN_OFF)
}
registerReceiver(receiver, filter) 

배터리 상태

• 배터리와 관련된 액션 문자열

실습 예제

AndroidManifest.xml

<?xml version="1.0" encoding="utf-8"?>
<manifest xmlns:android="http://schemas.android.com/apk/res/android"
    package="com.tutorial.c68">

    <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/Theme.AndroidLab">
        <receiver
            android:name=".MyReceiver"
            android:enabled="true"
            android:exported="true">
        </receiver>

        <activity
            android:name=".MainActivity"
            android:exported="true">
            <intent-filter>
                <action android:name="android.intent.action.MAIN" />

                <category android:name="android.intent.category.LAUNCHER" />
            </intent-filter>
        </activity>
    </application>

</manifest>

MyReceiver.kt

package com.tutorial.c68

import android.content.BroadcastReceiver
import android.content.Context
import android.content.Intent
import android.util.Log

class MyReceiver : BroadcastReceiver() {

    override fun onReceive(context: Context, intent: Intent) {
        Log.e("haeun", "receiver~~~~")
    }
}

MainActivity.kt

package com.tutorial.c68

import android.content.Intent
import android.content.IntentFilter
import android.os.BatteryManager
import android.os.Bundle
import android.widget.Button
import android.widget.TextView
import androidx.appcompat.app.AppCompatActivity

class MainActivity : AppCompatActivity() {
    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        setContentView(R.layout.activity_main)

        val resultView = findViewById<TextView>(R.id.resultView)
        val button = findViewById<Button>(R.id.button)

        registerReceiver(null,
            IntentFilter(Intent.ACTION_BATTERY_CHANGED))?.apply {
            var isCharging = "Not Plugged"
            when(getIntExtra(BatteryManager.EXTRA_STATUS, -1)){
                BatteryManager.BATTERY_STATUS_CHARGING -> {
                    when(getIntExtra(BatteryManager.EXTRA_PLUGGED, -1)){
                        BatteryManager.BATTERY_PLUGGED_USB -> {
                            isCharging = "USB Plugged"
                        }
                        BatteryManager.BATTERY_PLUGGED_AC -> {
                            isCharging = "AC Plugged"
                        }
                    }
                }
            }

            val level = getIntExtra(BatteryManager.EXTRA_LEVEL, -1)
            val scale = getIntExtra(BatteryManager.EXTRA_SCALE, -1)
            val batteryPct = level / scale.toFloat() * 100
            resultView.text = "${isCharging}, ${batteryPct}%"
        }

        button.setOnClickListener {
            val intent = Intent(this, MyReceiver::class.java)
            sendBroadcast(intent)
        }
    }
}