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
• BatteryStatus
• Location
• Heading
• iBeacon™ Proximity
• Eddystone™ Proximity
• Microphone
• Screen Brightness
• Network Connection

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:BatteryStatus]) {
    // You can access the sensor
}

Swift

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

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

Objective-C

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

Swift

do {
    try sensingKit.register(SKSensorType.BatteryStatus)
}
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:BatteryStatus
                       withHandler:^(SKSensorType sensorType, SKSensorData *sensorData, NSError *error) {

        if (!error) {
            SKBatteryStatusData *batteryStatusData = (SKBatteryStatusData *)sensorData;
            NSLog(@"Battery Level: %f", batteryStatusData.level);
        }
    } error:NULL];

Swift

do {
    try sensingKit.subscribe(to: SKSensorType.BatteryStatus, withHandler: { (sensorType, sensorData, error) in

        if (error == nil) {
            let batteryStatusData = sensorData as! SKBatteryStatusData
            print("Battery Level: \(batteryStatusData.level)")
        }
    })
}
catch {
    // Handle error
}

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

Objective-C

// Start
[self.sensingKit startContinuousSensingWithSensor:BatteryStatus error:NULL];

// Stop
[self.sensingKit stopContinuousSensingWithSensor:BatteryStatus error:NULL];

Swift

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

// Stop
do {
    try sensingKit.stopContinuousSensing(with:SKSensorType.BatteryStatus)
}
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

• NSBluetoothAlwaysUsageDescription (when Broadcasting only)

• NSBluetoothAlwaysUsageDescription

• NSLocationAlwaysUsageDescription
• NSLocationWhenInUseUsageDescription
• NSLocationAlwaysAndWhenInUseUsageDescription

• NSMotionUsageDescription

Copyright (c) 2014. Kleomenis Katevas
Kleomenis Katevas, minos.kat@gmail.com

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.