AlarmManager.Set 메서드

정의

네임스페이스:: Android.App

어셈블리:: Mono.Android.dll

중요

일부 정보는 릴리스되기 전에 상당 부분 수정될 수 있는 시험판 제품과 관련이 있습니다. Microsoft는 여기에 제공된 정보에 대해 어떠한 명시적이거나 묵시적인 보증도 하지 않습니다.

오버로드

속성	Description
Set(AlarmType, Int64, String, AlarmManager+IOnAlarmListener, Handler)	set(int,long,PendingIntent)의 직접 콜백 버전입니다.
Set(AlarmType, Int64, PendingIntent)	알람을 예약합니다.

Set(AlarmType, Int64, String, AlarmManager+IOnAlarmListener, Handler)

set(int,long,PendingIntent)의 직접 콜백 버전입니다.

[Android.Runtime.Register("set", "(IJLjava/lang/String;Landroid/app/AlarmManager$OnAlarmListener;Landroid/os/Handler;)V", "GetSet_IJLjava_lang_String_Landroid_app_AlarmManager_OnAlarmListener_Landroid_os_Handler_Handler", ApiSince=24)]
public virtual void Set(Android.App.AlarmType type, long triggerAtMillis, string? tag, Android.App.AlarmManager.IOnAlarmListener listener, Android.OS.Handler? targetHandler);

[<Android.Runtime.Register("set", "(IJLjava/lang/String;Landroid/app/AlarmManager$OnAlarmListener;Landroid/os/Handler;)V", "GetSet_IJLjava_lang_String_Landroid_app_AlarmManager_OnAlarmListener_Landroid_os_Handler_Handler", ApiSince=24)>]
abstract member Set : Android.App.AlarmType * int64 * string * Android.App.AlarmManager.IOnAlarmListener * Android.OS.Handler -> unit
override this.Set : Android.App.AlarmType * int64 * string * Android.App.AlarmManager.IOnAlarmListener * Android.OS.Handler -> unit

매개 변수

type: AlarmType

int: 경보 유형입니다. 값은 RTC ELAPSED_REALTIME_WAKEUP ELAPSED_REALTIME RTC_WAKEUP 중 하나입니다.

triggerAtMillis: Int64

long: 알람 유형에 따라 적절한 시계를 사용하여 알람이 꺼져야 하는 시간(밀리초)입니다.

tag: String

문자열: 로깅 및 배터리 사용 특성에 사용되는 알람을 설명하는 문자열입니다. 이 값은 null일 수 있습니다.

listener: AlarmManager.IOnAlarmListener

AlarmManager.OnAlarmListener: 경보 시간에 도달하면 onAlarm() 메서드가 호출되는 OnAlarmListener 인스턴스입니다. 지정된 OnAlarmListener 인스턴스는 지정된 PendingIntent를 한 번에 하나의 알람으로만 사용할 수 있는 것처럼 보류 중인 단일 경보의 대상일 수 있습니다. 이 값은 null일 수 없습니다.

targetHandler: Handler

처리기: 수신기의 onAlarm() 콜백을 실행하거나 null을 실행하여 주 루퍼에서 해당 콜백을 실행할 처리기입니다.

특성: RegisterAttribute

설명

set(int,long,PendingIntent)의 직접 콜백 버전입니다. 이 변형은 경보 시간에 도달할 때 보낼 PendingIntent를 제공하는 대신 해당 시간에 호출될 OnAlarmListener 인스턴스를 제공합니다. 호출 프로세스에 활동, 서비스 또는 ContentProvider와 같은 구성 요소가 더 이상 실행되지 않을 때마다 Android 시스템에서 수신기 기반 알람을 취소할 수 있으므로 현재 구성 요소가 완료된 후에 알람을 수신할 필요가 없는 경우에만 이러한 API를 사용하고 취소(OnAlarmListener)해야 합니다. 예를 들어 활동에서 이러한 API를 사용하는 경우 활동이 완료되면 해당 알람을 취소해야 합니다. 그 후에도 알람을 수신해야 하는 경우 PendingIntent 기반 API를 사용합니다. OnAlarmListener의 onAlarm() 메서드는 지정된 대상 처리기를 통해 호출되거나 null이 targetHandler 매개 변수로 전달되는 경우 애플리케이션의 주 루퍼에서 호출됩니다.

에 대한 android.app.AlarmManager.setAndroid 참조

이 페이지의 일부는 만들고 공유한 작업을 기반으로 하며 에 설명된 조건에 따라 사용됩니다.

적용 대상

Set(AlarmType, Int64, PendingIntent)

알람을 예약합니다.

[Android.Runtime.Register("set", "(IJLandroid/app/PendingIntent;)V", "GetSet_IJLandroid_app_PendingIntent_Handler")]
public virtual void Set(Android.App.AlarmType type, long triggerAtMillis, Android.App.PendingIntent operation);

[<Android.Runtime.Register("set", "(IJLandroid/app/PendingIntent;)V", "GetSet_IJLandroid_app_PendingIntent_Handler")>]
abstract member Set : Android.App.AlarmType * int64 * Android.App.PendingIntent -> unit
override this.Set : Android.App.AlarmType * int64 * Android.App.PendingIntent -> unit

매개 변수

type: AlarmType

경보 유형입니다.

triggerAtMillis: Int64

알람 유형에 따라 적절한 시계를 사용하여 알람이 꺼져야 하는 시간(밀리초)입니다.

operation: PendingIntent

알람이 꺼지면 수행할 작업입니다. 은 일반적으로 .에서 PendingIntent#getBroadcast IntentSender.getBroadcast()제공됩니다.

특성: RegisterAttribute

설명

알람을 예약합니다. 참고: 타이밍 작업(틱, 시간 제한 등)의 경우 처리기를 사용하는 것이 더 쉽고 효율적입니다. 동일한 IntentSender에 대한 알람이 이미 예약되어 있는 경우 해당 이전 알람이 먼저 취소됩니다. 명시된 트리거 시간이 과거인 경우 알람이 즉시 트리거됩니다. 이 의도에 대한 알람이 이미 예약되어 있는 경우(Intent.filterEquals에 의해 정의된 두 의도의 같음) 제거되고 이 의도로 대체됩니다. 알람은 Context.registerReceiver(BroadcastReceiver, IntentFilter) 또는 AndroidManifest.xml 파일의 수신기 태그를 통해 <등록한 브로드캐스트 수신기> 로 가는 의도 브로드캐스트입니다. 경보 의도는 이 의도 브로드캐스트에 누적된 과거 경보 이벤트의 수를 나타내는 Intent.EXTRA_ALARM_COUNT 호출된 형식의 추가 데이터와 함께 전달됩니다. 전화가 잠들어 있었기 때문에 배달되지 않은 반복 경보는 배달 시 1 개보다 큰 수를 가질 수 있습니다. 참고: API 19부터 이 메서드에 전달된 트리거 시간은 비활성으로 처리됩니다. 알람은 이 시간 이전에 전달되지 않지만 지연되고 나중에 배달될 수 있습니다. OS는 전체 시스템에서 알람을 함께 "일괄 처리"하기 위해 이 정책을 사용하여 디바이스가 "절전 모드 해제"해야 하는 횟수를 최소화하고 배터리 사용을 최소화합니다. 일반적으로 가까운 장래에 예정된 경보는 앞으로 경보로 예약되는 한 지연되지 않습니다. 새 일괄 처리 정책을 사용하면 배달 주문 보장이 이전만큼 강력하지 않습니다. 애플리케이션에서 여러 경보를 설정하는 경우 이러한 경보의 실제 배달 순서가 요청된 배달 시간의 순서와 일치하지 않을 수 있습니다. 애플리케이션에 강력한 순서 지정 요구 사항이 있는 경우 필요한 동작을 가져오는 데 사용할 수 있는 다른 API가 있습니다. setWindow(int,long,long,PendingIntent) 및 setExact(int,long,PendingIntent)를 참조하세요. targetSdkVersion이 API 19 이전인 애플리케이션은 이전 경보 동작을 계속 가져옵니다. 예약된 모든 알람은 정확한 것으로 처리됩니다.

참고 항목:

에 대한 android.app.AlarmManager.setAndroid 참조

이 페이지의 일부는 만들고 공유한 작업을 기반으로 하며 에 설명된 조건에 따라 사용됩니다.

적용 대상