Xamarin.Android의 브로드캐스트 수신기

이 섹션에서는 브로드캐스트 수신기를 사용하는 방법을 설명합니다.

브로드캐스트 수신기 개요

브로드캐스트 수신기는 애플리케이션이 Android 운영 체제 또는 애플리케이션에서 브로드캐스트하는 메시지(AndroidIntent)에 응답할 수 있도록 하는 Android 구성 요소입니다. 브로드캐스트는 게시-구독 모델을 따릅니다. 이벤트로 인해 이벤트에 관심이 있는 구성 요소에서 브로드캐스트를 게시하고 받습니다.

Android는 다음 두 가지 유형의 브로드캐스트를 식별합니다.

• 명시적 브로드캐스트 – 이러한 유형의 브로드캐스트는 특정 애플리케이션을 대상으로 합니다. 명시적 브로드캐스트의 가장 일반적인 용도는 활동을 시작하는 것입니다. 앱이 전화 번호로 전화를 걸어야 하는 명시적 브로드캐스트의 예입니다. Android에서 전화 앱을 대상으로 하는 의도를 디스패치하고 전화를 걸 전화 번호를 전달합니다. 그런 다음 Android는 의도를 전화 앱으로 라우팅합니다.
• 암시적 브로드캐 스트 – 이러한 브로드캐스트는 디바이스의 모든 앱으로 디스패치됩니다. 암시적 브로드캐스트의 예는 의도입니다 ACTION_POWER_CONNECTED . 이 의도는 Android가 디바이스의 배터리가 충전 중임을 감지할 때마다 게시됩니다. Android는 이 이벤트에 등록된 모든 앱으로 이 의도를 라우팅합니다.

브로드캐스트 수신기는 형식의 하위 클래스이며 메서드를 재정의 BroadcastReceiverOnReceive 해야 합니다. Android는 기본 스레드에서 실행 OnReceive 되므로 이 메서드는 신속하게 실행되도록 설계되어야 합니다. Android는 메서드가 완료될 때 프로세스를 종료할 수 있으므로 스레드 OnReceive 를 생성할 때 주의해야 합니다. 브로드캐스트 수신기가 장기 실행 작업을 수행해야 하는 경우 Firebase 작업 디스패처를 사용하여 JobScheduler 작업을 예약하는 것이 좋습니다. 작업 예약 작업은 별도의 가이드에서 설명합니다.

의도 필터는 Android가 메시지를 올바르게 라우팅할 수 있도록 브로드캐스트 수신기를 등록하는 데 사용됩니다. 의도 필터는 런타임에 지정하거나(컨텍스트 등록 수신기 또는 동적 등록이라고도 함) Android 매니페스트(매니페스트 등록 수신기)에서 정적으로 정의할 수 있습니다. Xamarin.Android는 의도 필터를 정적으로 등록하는 C# 특성을 IntentFilterAttribute제공합니다(이 가이드의 뒷부분에서 자세히 설명). Android 8.0부터 애플리케이션이 암시적 브로드캐스트에 정적으로 등록할 수 없습니다.

매니페스트 등록 수신기와 컨텍스트 등록 수신기 간의 주요 차이점은 컨텍스트 등록 수신기는 애플리케이션이 실행되는 동안 브로드캐스트에만 응답하고 매니페스트 등록 수신기는 앱이 실행되지 않더라도 브로드캐스트에 응답할 수 있다는 것입니다.

브로드캐스트 수신기를 관리하고 브로드캐스트를 보내기 위한 두 가지 API 집합이 있습니다.

1. Context – 클래스를 Android.Content.Context 사용하여 시스템 전체 이벤트에 응답하는 브로드캐스트 수신기를 등록할 수 있습니다. Context 시스템 전체 브로드캐스트를 게시하는 데도 사용됩니다.
2. LocalBroadcastManager– Xamarin 지원 라이브러리 v4 NuGet 패키지를 통해 사용할 수 있는 API입니다. 이 클래스는 브로드캐스트 및 브로드캐스트 수신기를 사용하는 애플리케이션의 컨텍스트에서 격리된 상태로 유지하는 데 사용됩니다. 이 클래스는 다른 애플리케이션이 애플리케이션 전용 브로드캐스트에 응답하거나 프라이빗 수신기에 메시지를 보내는 것을 방지하는 데 유용할 수 있습니다.

브로드캐스트 수신기는 대화 상자를 표시하지 않을 수 있으며 브로드캐스트 수신기 내에서 활동을 시작하는 것이 좋습니다. 브로드캐스트 수신기가 사용자에게 알려야 하는 경우 알림을 게시해야 합니다.

브로드캐스트 수신기 내에서 서비스를 바인딩하거나 시작할 수 없습니다.

이 가이드에서는 브로드캐스트 수신기를 만드는 방법과 브로드캐스트를 받을 수 있도록 등록하는 방법을 설명합니다.

브로드캐스트 수신기 만들기

Xamarin.Android에서 브로드캐스트 수신기를 만들려면 애플리케이션이 클래스를 BroadcastReceiver 서브클래스하고, 클래스로 BroadcastReceiverAttribute표시하고, 메서드를 재정의 OnReceive 해야 합니다.

[BroadcastReceiver(Enabled = true, Exported = false)]
public class SampleReceiver : BroadcastReceiver
{
    public override void OnReceive(Context context, Intent intent)
    {
        // Do stuff here.

        String value = intent.GetStringExtra("key");
    }
}

Xamarin.Android가 클래스를 컴파일하면 AndroidManifest도 수신기를 등록하는 데 필요한 메타 데이터로 업데이트됩니다. 정적으로 등록된 브로드캐스트 수신기의 Enabled 경우 올바르게 설정 true해야 합니다. 그렇지 않으면 Android에서 수신기의 인스턴스를 만들 수 없습니다.

이 속성은 Exported 브로드캐스트 수신기가 애플리케이션 외부에서 메시지를 받을 수 있는지 여부를 제어합니다. 속성이 명시적으로 설정되지 않은 경우 속성의 기본값은 브로드캐스트 수신기와 연결된 의도 필터가 있는지를 기준으로 Android에 의해 결정됩니다. 브로드캐스트 수신기에 대한 의도 필터가 하나 이상 있는 경우 Android는 속성이 Exported .1 true이라고 가정합니다. 브로드캐스트 수신기와 연결된 의도 필터가 없으면 Android는 값이 다음과 같은 false것으로 가정합니다.

메서드는 OnReceive 브로드캐스트 수신기에 Intent 디스패치된 참조를 받습니다. 이렇게 하면 의도의 발신자가 브로드캐스트 수신기에 값을 전달할 수 있습니다.

의도 필터를 사용하여 브로드캐스트 수신기 정적으로 등록

A BroadcastReceiver 가 데코레이팅되면 IntentFilterAttributeXamarin.Android는 컴파일 시간에 필요한 <intent-filter> 요소를 Android 매니페스트에 추가합니다. 다음 코드 조각은 디바이스가 부팅을 완료했을 때(사용자가 적절한 Android 권한을 부여한 경우) 실행되는 브로드캐스트 수신기의 예입니다.

[BroadcastReceiver(Enabled = true)]
[IntentFilter(new[] { Android.Content.Intent.ActionBootCompleted })]
public class MyBootReceiver : BroadcastReceiver
{
    public override void OnReceive(Context context, Intent intent)
    {
        // Work that should be done when the device boots.     
    }
}

참고 항목

Android 8.0(API 26 이상) 에서 Google은 사용자가 직접 상호 작용하지 않는 동안 앱이 수행할 수 있는 작업을 제한 했습니다. 이러한 제한 사항은 백그라운드 서비스 및 암시적 브로드캐스트 수신기(예: .) Android.Content.Intent.ActionBootCompleted에 영향을 줍니다. 이러한 제한 사항으로 인해 최신 버전의 Android에서 브로드캐스트 수신기를 Boot Completed 등록하는 데 어려움이 있을 수 있습니다. 이 경우 브로드캐스트 수신기에서 호출할 수 있는 포그라운드 서비스에는 이러한 제한이 적용되지 않습니다.

사용자 지정 의도에 응답하는 의도 필터를 만들 수도 있습니다. 다음 예제를 참조하세요.

[BroadcastReceiver(Enabled = true)]
[IntentFilter(new[] { "com.xamarin.example.TEST" })]
public class MySampleBroadcastReceiver : BroadcastReceiver
{
    public override void OnReceive(Context context, Intent intent)
    {
        // Do stuff here
    }
}

Android 8.0(API 수준 26) 이상을 대상으로 하는 앱은 암시적 브로드캐스트에 정적으로 등록되지 않을 수 있습니다. 앱은 여전히 명시적 브로드캐스트에 대해 정적으로 등록할 수 있습니다. 이 제한에서 제외되는 암시적 브로드캐스트의 작은 목록이 있습니다. 이러한 예외는 Android 설명서의 암시적 브로드캐스트 예외 가이드에 설명되어 있습니다. 암시적 브로드캐스트에 관심이 있는 앱은 메서드를 사용하여 RegisterReceiver 동적으로 수행해야 합니다. 이 내용은 다음에 설명되어 있습니다.

브로드캐스트 수신기 컨텍스트 등록

수신기의 컨텍스트 등록(동적 등록이라고도 함)은 메서드를 호출하여 RegisterReceiver 수행되며 브로드캐스트 수신기는 메서드 호출 UnregisterReceiver 로 등록을 취소해야 합니다. 리소스 누출을 방지하려면 더 이상 컨텍스트(활동 또는 서비스)와 관련이 없는 경우 수신기의 등록을 취소하는 것이 중요합니다. 예를 들어 서비스는 사용자에게 업데이트를 표시할 수 있음을 활동에 알리기 위한 의도를 브로드캐스트할 수 있습니다. 활동이 시작되면 해당 의도에 등록됩니다. 활동이 백그라운드로 이동되어 사용자에게 더 이상 표시되지 않는 경우 업데이트를 표시하기 위한 UI가 더 이상 표시되지 않으므로 수신기의 등록을 취소해야 합니다. 다음 코드 조각은 활동의 컨텍스트에서 브로드캐스트 수신기를 등록 및 등록 취소하는 방법의 예입니다.

[Activity(Label = "MainActivity", MainLauncher = true, Icon = "@mipmap/icon")]
public class MainActivity: Activity
{
    MySampleBroadcastReceiver receiver;

    protected override void OnCreate(Bundle savedInstanceState)
    {
        base.OnCreate(savedInstanceState);
        receiver = new MySampleBroadcastReceiver();

        // Code omitted for clarity
    }

    protected override void OnResume()
    {
        base.OnResume();
        RegisterReceiver(receiver, new IntentFilter("com.xamarin.example.TEST"));
        // Code omitted for clarity
    }

    protected override void OnPause()
    {
        UnregisterReceiver(receiver);
        // Code omitted for clarity
        base.OnPause();
    }
}

이전 예제에서 활동이 포그라운드로 들어오면 수명 주기 메서드를 사용하여 사용자 지정 의도를 수신 대기하는 브로드캐스트 수신기를 OnResume 등록합니다. 활동이 백그라운드로 이동하면 메서드가 OnPause() 수신기의 등록을 취소합니다.

브로드캐스트 게시

디바이스에 설치된 모든 앱에 브로드캐스트를 게시하여 의도 개체를 만들고 또는 SendOrderedBroadcast 메서드로 SendBroadcast 디스패치할 수 있습니다.

1. Context.SendBroadcast 메서드 – 이 메서드 의 몇 가지 구현이 있습니다. 이러한 메서드는 의도를 전체 시스템에 브로드캐스트합니다. 확정되지 않은 순서로 의도를 수신할 수신기를 브로드캐스트합니다. 이렇게 하면 많은 유연성을 제공하지만 다른 애플리케이션이 의도를 등록하고 받을 수 있음을 의미합니다. 이는 잠재적인 보안 위험을 초래할 수 있습니다. 애플리케이션은 무단 액세스를 방지하기 위해 추가 보안을 구현해야 할 수 있습니다. 한 가지 가능한 해결 방법은 앱의 LocalBroadcastManager 프라이빗 공간 내에서만 메시지를 디스패치하는 방법을 사용하는 것입니다. 이 코드 조각은 메서드 중 하나를 사용하여 의도를 디스패치하는 방법의 한 예입니다.SendBroadcast

   Intent message = new Intent("com.xamarin.example.TEST");
   // If desired, pass some values to the broadcast receiver.
   message.PutExtra("key", "value");
   SendBroadcast(message);
   

   이 코드 조각은 메서드를 사용하여 작업을 식별하여 브로드캐스트를 Intent.SetAction 보내는 또 다른 예입니다.

   Intent intent = new Intent();
   intent.SetAction("com.xamarin.example.TEST");
   intent.PutExtra("key", "value");
   SendBroadcast(intent);
   

2. Context.SendOrderedBroadcast – 이 메서드는 매우 유사 Context.SendBroadcast하며, 수신기가 등록된 순서대로 의도를 수신기에 한 번에 하나씩 게시한다는 차이점이 있습니다.

LocalBroadcastManager

Xamarin 지원 라이브러리 v4는 도우미 LocalBroadcastManager클래스를 제공합니다. 디바이스 LocalBroadcastManager 의 다른 앱에서 브로드캐스트를 보내거나 받지 않으려는 앱용입니다. 애플리케이션 LocalBroadcastManager 의 컨텍스트 내에서만 메시지를 게시하고, 에 등록된 LocalBroadcastManager브로드캐스트 수신기에만 메시지를 게시합니다. 이 코드 조각은 다음을 사용하여 브로드캐스트 수신기 LocalBroadcastManager를 등록하는 예제입니다.

Android.Support.V4.Content.LocalBroadcastManager.GetInstance(this). RegisterReceiver(receiver, new IntentFilter("com.xamarin.example.TEST"));

디바이스의 다른 앱은 .와 함께 LocalBroadcastManager게시된 메시지를 받을 수 없습니다. 이 코드 조각은 다음을 사용하여 LocalBroadcastManager의도를 디스패치하는 방법을 보여줍니다.

Intent message = new Intent("com.xamarin.example.TEST");
// If desired, pass some values to the broadcast receiver.
message.PutExtra("key", "value");
Android.Support.V4.Content.LocalBroadcastManager.GetInstance(this).SendBroadcast(message);

관련 링크

• BroadcastReceiver API
• Context.RegisterReceiver API
• Context.SendBroadcast API
• Context.UnregisterReceiver API
• 의도 API
• IntentFilter API
• LocalBroadcastManager(Android 문서)
• Android 의 로컬 알림 가이드
• Android 지원 라이브러리 v4(NuGet)