An iOS library that provides Continuous Sensing functionality to your applications. For more information, please refer to the project website.

The following mobile sensors are currently supported in SensingKit-iOS, (listed in SKSensorType enum):

• Accelerometer
• Gyroscope
• Magnetometer
• Device Motion (senses Attitude, Gravity, User Acceleration, Magnetic Field, Rotation)
• Motion Activity
• Pedometer
• Altimeter
• Battery
• Location
• Heading
• iBeacon™ Proximity
• Eddystone™ Proximity
• Microphone

You can easily install SensingKit using CocoaPods, a popular dependency manager for Cocoa projects. For installing CocoaPods, use the following command:

$ gem install cocoapods

To integrate SensingKit into your Xcode project, specify it in your Podfile:

target <MyApp> do # Uncomment this line if you're using Swift or would like to use dynamic frameworks use_frameworks! pod 'SensingKit' # For the latest development version, please use: # pod 'SensingKit', :git => 'https://github.com/SensingKit/SensingKit-iOS.git', :branch => 'next' end

Then, run the following command:

$ pod install

For more information about CocoaPods, visit https://cocoapods.org.

Import and init SensingKit as shown below:

Objective-C

#import <SensingKit/SensingKit.h> @property (nonatomic, strong) SensingKitLib *sensingKit; - (void)viewDidLoad { [super viewDidLoad]; self.sensingKit = [SensingKitLib sharedSensingKitLib]; }

Swift

import SensingKit let sensingKit = SensingKitLib.shared()

Check if a sensor is available in the device:

Objective-C

if ([self.sensingKit isSensorAvailable:Battery]) { // You can access the sensor }

Swift

if sensingKit.isSensorAvailable(SKSensorType.Battery) { // You can access the sensor }

Register a sensor (e.g. a Battery sensor) as shown below:

Objective-C

[self.sensingKit registerSensor:Battery error:NULL];

Swift

do { try sensingKit.register(SKSensorType.Battery) } catch { // Handle error }

Subscribe a sensor data handler. You can cast the data object into the actual sensor data object in order to access all the sensor data properties:

Objective-C

[self.sensingKit subscribeToSensor:Battery withHandler:^(SKSensorType sensorType, SKSensorData *sensorData, NSError *error) { if (!error) { SKBatteryData *batteryData = (SKBatteryData *)sensorData; NSLog(@"Battery Level: %f", batteryData.level); } } error:NULL];

Swift

do { try sensingKit.subscribe(to: SKSensorType.Battery, withHandler: { (sensorType, sensorData, error) in if (error == nil) { let batteryData = sensorData as! SKBatteryData print("Battery Level: \(batteryData)") } }) } catch { // Handle error }

You can Start and Stop the Continuous Sensing using the following commands:

Objective-C

// Start [self.sensingKit startContinuousSensingWithSensor:Battery error:NULL]; // Stop [self.sensingKit stopContinuousSensingWithSensor:Battery error:NULL];

Swift

// Start do { try sensingKit.startContinuousSensing(with:SKSensorType.Battery) } catch { // Handle error } // Stop do { try sensingKit.stopContinuousSensing(with:SKSensorType.Battery) } catch { // Handle error }

For a complete description of our API, please refer to the documentation page of SensingKit website.

Depending on the used sensor and its configuration, some keys with a user-friendly description should be included in the info.plist application file:

• NSMicrophoneUsageDescription

• NSBluetoothPeripheralUsageDescription

• NSLocationAlwaysUsageDescription
• NSLocationWhenInUseUsageDescription
• NSLocationAlwaysAndWhenInUseUsageDescription

• NSMotionUsageDescription

Copyright (c) 2014. Kleomenis Katevas Kleomenis Katevas, k.katevas@imperial.ac.uk This file is part of SensingKit-iOS library. For more information, please visit https://www.sensingkit.org SensingKit-iOS is free software: you can redistribute it and/or modify it under the terms of the GNU Lesser General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version. SensingKit-iOS is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU Lesser General Public License for more details. You should have received a copy of the GNU Lesser General Public License along with SensingKit-iOS. If not, see <http://www.gnu.org/licenses/>. 

This library is available under the GNU Lesser General Public License 3.0, allowing to use the library in your applications.

If you want to help with the open source project, contact hello@sensingkit.org.