程序包 ohos.miscservices.timeutility

类 Timer.OneShotTimer

java.lang.Object

ohos.miscservices.timeutility.Timer.OneShotTimer

封闭类:

Timer

public static class Timer.OneShotTimer
extends Object

Provides the oneshot timer function.

There are two types of oneshot timers. The difference lies in the action after a oneshot timer goes off. The system sends an Intent object to an application, or invokes the ITimerListener callback.

从以下版本开始:

1

方法概要

限定符和类型	方法	说明
static Timer.OneShotTimer	getTimer(Context context, Timer.ITimerListener listener)	Obtains a oneshot timer.
static Timer.OneShotTimer	getTimer(Context context, Timer.TimerIntent operation)	Obtains a oneshot timer object.
void	start(int type, long triggerTime)	Starts a timer.
void	stop()	Cancels the timer.

从类继承的方法 java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

方法详细资料

getTimer

public static Timer.OneShotTimer getTimer(Context context,
                                          Timer.TimerIntent operation)

Obtains a oneshot timer object.

When the timer goes off, the system sends an intent to start a component.

参数:

context - Indicates the application context.

operation - Indicates the intent to send when the timer goes off.

返回:

Returns the OneShotTimer instance that is created using the operation as the key.

从以下版本开始:

1

getTimer

public static Timer.OneShotTimer getTimer(Context context,
                                          Timer.ITimerListener listener)

Obtains a oneshot timer.

When the timer goes off, the system calls the ITimerListener interface.

参数:

context - Indicates the application context.

listener - Indicates a listener to monitor whether the timer goes off.

返回:

Returns a OneShotTimer instance monitored by the listener.

从以下版本开始:

1

start

public void start(int type,
                  long triggerTime)

Starts a timer.

参数:

type - Indicates a timer type.

triggerTime - Indicates the point in time for triggering the timer, in milliseconds. The time will be automatically set to 5000 milliseconds after the current time if the passed value is smaller than the current time plus 5000 milliseconds.

从以下版本开始:

1

另请参阅:

Timer.TIMER_TYPE_REALTIME, Timer.TIMER_TYPE_WAKEUP, Timer.TIMER_TYPE_EXACT

stop

public void stop()

Cancels the timer.

The timer to be canceled is related to the second parameter of the following methods:

• OneShotTimer#getTimer(Context, TimerIntent)
• OneShotTimer#getTimer(Context, ITimerListener)

Note: If a timer is created based on Intent, calling this method will cancel all timers. If a timer is created based on a listener defined by ITimerListener, calling this method will cancel all timers monitored by the listener.

从以下版本开始:

1