DeviceOrientationRequest.Builder

A builder for DeviceOrientationRequest.

Public Constructor Summary

	Builder(long samplingPeriodMicros) Constructs a new builder, requiring to provide a `samplingPeriodMicros`.
	Builder(DeviceOrientationRequest src) Constructs a new builder with values copied from a given `DeviceOrientationRequest`.

Public Method Summary

DeviceOrientationRequest	build() Builds a new `DeviceOrientationRequest`.
DeviceOrientationRequest.Builder	setSamplingPeriodMicros(long samplingPeriodMicros) Sets the requested period (in microseconds) for device orientation updates.

Inherited Method Summary

From class java.lang.Object

Object	clone()
boolean	equals(Object arg0)
void	finalize()
final Class<?>	getClass()
int	hashCode()
final void	notify()
final void	notifyAll()
String	toString()
final void	wait(long arg0, int arg1)
final void	wait(long arg0)
final void	wait()

Public Constructors

public Builder (long samplingPeriodMicros)

Constructs a new builder, requiring to provide a samplingPeriodMicros.

public Builder (DeviceOrientationRequest src)

Constructs a new builder with values copied from a given DeviceOrientationRequest.

Public Methods

public DeviceOrientationRequest build ()

Builds a new DeviceOrientationRequest.

public DeviceOrientationRequest.Builder setSamplingPeriodMicros (long samplingPeriodMicros)

Sets the requested period (in microseconds) for device orientation updates.

The device orientation client will attempt to obtain updates for your application at least at the specified interval. Therefore, it has a direct influence on the amount of power used by your application. By default, we recommend a sampling period of 20_000 microseconds (for example, 50Hz).

This interval is not guaranteed to be used. Your app may not receive updates at all (if no device orientation sources are available). It may also receive them faster or slower than requested (for example if other applications are requesting device orientation at a faster interval, or a sampling rate is not supported by the device).

Throws

IllegalArgumentException	if the interval is less than zero or equal to `Long.MAX_VALUE`