namespace Tizen.Sensor
{
/// <summary>
- /// GravitySensor Class. Used for registering callbacks for gravity sensor and getting gravity data
+ /// The GravitySensor class is used for registering callbacks for the gravity sensor and getting the gravity data.
/// </summary>
+ /// <since_tizen> 3 </since_tizen>
public sealed class GravitySensor : Sensor
{
private const string GravitySensorKey = "http://tizen.org/feature/sensor.gravity";
/// <summary>
/// Gets the X component of the gravity.
/// </summary>
+ /// <since_tizen> 3 </since_tizen>
+ /// <value> X </value>
public float X { get; private set; } = float.MinValue;
/// <summary>
/// Gets the Y component of the gravity.
/// </summary>
+ /// <since_tizen> 3 </since_tizen>
+ /// <value> Y </value>
public float Y { get; private set; } = float.MinValue;
/// <summary>
/// Gets the Z component of the gravity.
/// </summary>
+ /// <since_tizen> 3 </since_tizen>
+ /// <value> Z </value>
public float Z { get; private set; } = float.MinValue;
/// <summary>
- /// Returns true or false based on whether gravity sensor is supported by device.
+ /// Returns true or false based on whether the gravity sensor is supported by the device.
/// </summary>
+ /// <since_tizen> 3 </since_tizen>
+ /// <value><c>true</c> if supported; otherwise <c>false</c>.</value>
public static bool IsSupported
{
get
/// <summary>
/// Returns the number of gravity sensors available on the device.
/// </summary>
+ /// <since_tizen> 3 </since_tizen>
+ /// <value> The count of gravity sensors. </value>
public static int Count
{
get
/// <summary>
/// Initializes a new instance of the <see cref="Tizen.Sensor.GravitySensor"/> class.
/// </summary>
- /// <exception cref="ArgumentException">Thrown when an invalid argument is used</exception>
- /// <exception cref="NotSupportedException">Thrown when the sensor is not supported</exception>
- /// <exception cref="InvalidOperationException">Thrown when the operation is invalid for the current state</exception>
+ /// <since_tizen> 3 </since_tizen>
+ /// <feature>http://tizen.org/feature/sensor.gravity</feature>
+ /// <exception cref="ArgumentException">Thrown when an invalid argument is used.</exception>
+ /// <exception cref="NotSupportedException">Thrown when the sensor is not supported.</exception>
+ /// <exception cref="InvalidOperationException">Thrown when the operation is invalid for the current state.</exception>
/// <param name='index'>
- /// Index. Default value for this is 0. Index refers to a particular gravity sensor in case of multiple sensors
+ /// Index. Default value for this is 0. Index refers to a particular gravity sensor in case of multiple sensors.
/// </param>
public GravitySensor (uint index = 0) : base(index)
{
}
/// <summary>
- /// Event Handler for storing the callback functions for event corresponding to change in gravity sensor data.
+ /// An event handler for storing the callback functions for the event corresponding to the change in the gravity sensor data.
/// </summary>
+ /// <since_tizen> 3 </since_tizen>
public event EventHandler<GravitySensorDataUpdatedEventArgs> DataUpdated;
/// <summary>
- /// Event handler for accuracy changed events.
+ /// An event handler for accuracy changed events.
/// </summary>
+ /// <since_tizen> 3 </since_tizen>
public event EventHandler<SensorAccuracyChangedEventArgs> AccuracyChanged
{
add
return count;
}
+ /// <summary>
+ /// Read gravity sensor data synchronously.
+ /// </summary>
+ internal override void ReadData()
+ {
+ Interop.SensorEventStruct sensorData;
+ int error = Interop.SensorListener.ReadData(ListenerHandle, out sensorData);
+ if (error != (int)SensorError.None)
+ {
+ Log.Error(Globals.LogTag, "Error reading gravity sensor data");
+ throw SensorErrorFactory.CheckAndThrowException(error, "Reading gravity sensor data failed");
+ }
+
+ Timestamp = sensorData.timestamp;
+ X = sensorData.values[0];
+ Y = sensorData.values[1];
+ Z = sensorData.values[2];
+ }
+
+ private static Interop.SensorListener.SensorEventsCallback _callback;
+
internal override void EventListenStart()
{
- int error = Interop.SensorListener.SetEventCallback(ListenerHandle, Interval, SensorEventCallback, IntPtr.Zero);
+ _callback = (IntPtr sensorHandle, IntPtr eventPtr, uint events_count, IntPtr data) => {
+ updateBatchEvents(eventPtr, events_count);
+ Interop.SensorEventStruct sensorData = latestEvent();
+
+ Timestamp = sensorData.timestamp;
+ X = sensorData.values[0];
+ Y = sensorData.values[1];
+ Z = sensorData.values[2];
+
+ DataUpdated?.Invoke(this, new GravitySensorDataUpdatedEventArgs(sensorData.values));
+ };
+
+ int error = Interop.SensorListener.SetEventsCallback(ListenerHandle, _callback, IntPtr.Zero);
if (error != (int)SensorError.None)
{
Log.Error(Globals.LogTag, "Error setting event callback for gravity sensor");
internal override void EventListenStop()
{
- int error = Interop.SensorListener.UnsetEventCallback(ListenerHandle);
+ int error = Interop.SensorListener.UnsetEventsCallback(ListenerHandle);
if (error != (int)SensorError.None)
{
Log.Error(Globals.LogTag, "Error unsetting event callback for gravity sensor");
}
}
+ private static Interop.SensorListener.SensorAccuracyCallback _accuracyCallback;
+
private void AccuracyListenStart()
{
- int error = Interop.SensorListener.SetAccuracyCallback(ListenerHandle, AccuracyEventCallback, IntPtr.Zero);
+ _accuracyCallback = (IntPtr sensorHandle, UInt64 timestamp, SensorDataAccuracy accuracy, IntPtr data) => {
+ Timestamp = timestamp;
+ _accuracyChanged?.Invoke(this, new SensorAccuracyChangedEventArgs(timestamp, accuracy));
+ };
+
+ int error = Interop.SensorListener.SetAccuracyCallback(ListenerHandle, _accuracyCallback, IntPtr.Zero);
if (error != (int)SensorError.None)
{
Log.Error(Globals.LogTag, "Error setting accuracy event callback for gravity sensor");
throw SensorErrorFactory.CheckAndThrowException(error, "Unable to unset accuracy event callback for gravity");
}
}
-
- private void SensorEventCallback(IntPtr sensorHandle, IntPtr sensorPtr, IntPtr data)
- {
- Interop.SensorEventStruct sensorData = Interop.IntPtrToEventStruct(sensorPtr);
- TimeSpan = new TimeSpan((Int64)sensorData.timestamp);
- X = sensorData.values[0];
- Y = sensorData.values[1];
- Z = sensorData.values[2];
-
- DataUpdated?.Invoke(this, new GravitySensorDataUpdatedEventArgs(sensorData.values));
- }
-
- private void AccuracyEventCallback(IntPtr sensorHandle, UInt64 timestamp, SensorDataAccuracy accuracy, IntPtr data)
- {
- TimeSpan = new TimeSpan((Int64)timestamp);
- _accuracyChanged?.Invoke(this, new SensorAccuracyChangedEventArgs(new TimeSpan((Int64)timestamp), accuracy));
- }
}
}