SBSAccelerometer: Difference between revisions

Latest revision as of 14:36, 11 August 2015

SBSAccelerometer is a class in the SpringBoardServices.framework which can be used to create an own SBAccelerometerInterface, even from within SpringBoard.app. It's advantage above hooking "accelerometer"-methods in SpringBoard is that a delegate can be chosen.

Creating an instance of SBSAccelerometer and the delegate

Once an instance of SBSAccelerometer has been created you can use _checkIn to activate it; to deactivate it you send _checkOut. Example:

SBSAccelerometer *acc = [[SBSAccelerometer alloc] init];
acc.accelerometerEventsEnabled = YES;
acc.updateInterval = 0.1;
acc.xThreshold = 0.2;
acc.yThreshold = 0.2;
acc.zThreshold = 0.2;
acc._orientationEventsEnabled = NO;
acc.delegate = myAccDelegateInstance;
[acc _checkIn];

The delegate has to implement:

- (void)accelerometer:(SBSAccelerometer*)accelerometer didAccelerateWithTimeStamp:(NSTimeInterval)timestamp
	x:(CGFloat)x y:(CGFloat)y z:(CGFloat)z eventType:(unsigned)type

For orientation Events you need to enable _orientationEventsEnabled and implement the following method in your delegate:

- (void)accelerometer:(SBSAccelerometer*)accelerometer didChangeDeviceOrientation:(UIDeviceOrientation)newOrientation

References

Header: http://github.com/kennytm/iphone-private-frameworks/blob/master/SpringBoardServices/SBSAccelerometer.h

@@ Line 1: / Line 1: @@
 [[SBSAccelerometer]] is a class in the [[SpringBoardServices.framework]] which can be used to create an own [[SBAccelerometerInterface]], even from within [[SpringBoard.app]]. It's advantage above hooking "accelerometer"-methods in SpringBoard is that a delegate can be chosen.
-==Creating an instance of SBSAccelerometer and the delegate==
+== Creating an instance of SBSAccelerometer and the delegate ==
 Once an instance of SBSAccelerometer has been created you can use <tt>_checkIn</tt> to activate it; to deactivate it you send <tt>_checkOut</tt>. Example:
 <source lang="objc">
-SBSAccelerometer *theAcc = [[SBSAccelerometer alloc] init];
+SBSAccelerometer *acc = [[SBSAccelerometer alloc] init];
-				theAcc.accelerometerEventsEnabled = YES;
+acc.accelerometerEventsEnabled = YES;
-				theAcc.updateInterval = 0.1;
+acc.updateInterval = 0.1;
-				theAcc.xThreshold = 0.2;
+acc.xThreshold = 0.2;
-				theAcc.yThreshold = 0.2;
+acc.yThreshold = 0.2;
-				theAcc.zThreshold = 0.2;
+acc.zThreshold = 0.2;
-                                theAcc._orientationEventsEnabled = NO;
+acc._orientationEventsEnabled = NO;
-				theAcc.delegate = myAccDelegateInstance;
+acc.delegate = myAccDelegateInstance;
+[acc _checkIn];
-				[theAcc _checkIn];
 </source>
 The delegate has to implement:
 <source lang="objc">
--(void)accelerometer:(SBSAccelerometer*)accelerometer didAccelerateWithTimeStamp:(NSTimeInterval)timestamp
+- (void)accelerometer:(SBSAccelerometer*)accelerometer didAccelerateWithTimeStamp:(NSTimeInterval)timestamp
-				   x:(float)x y:(float)y z:(float)z eventType:(unsigned)type
+	x:(CGFloat)x y:(CGFloat)y z:(CGFloat)z eventType:(unsigned)type
 </source>
 For orientation Events you need to enable <tt>_orientationEventsEnabled</tt> and implement the following method in your delegate:
 <source lang="objc">
--(void)accelerometer:(SBSAccelerometer*)accelerometer didChangeDeviceOrientation:(UIDeviceOrientation)newOrientation
+- (void)accelerometer:(SBSAccelerometer*)accelerometer didChangeDeviceOrientation:(UIDeviceOrientation)newOrientation
 </source>
 == References ==
+<references/>
 * Header: http://github.com/kennytm/iphone-private-frameworks/blob/master/SpringBoardServices/SBSAccelerometer.h
 {{occlass|library=SpringBoardServices.framework|navbox=1}}