iPhone 之所以能實現計步、導航航向、橫豎屏切換乃至通話自動熄屏,靠的都是機身內部那一組傳感器。而在代碼層面統一接管這些硬件的,正是 CoreMotion 框架。
CoreMotion 把加速度計、陀螺儀、磁力計做了統一封裝,並在此之上封裝了一批複合算法,讓開發者可以直接拿到「設備正在怎麼運動」這樣的結論性信息,而不必自己去做濾波與融合。它負責處理四類數據:
typedef struct {
double x;
double y;
double z;
} CMAcceleration;
@interface CMAccelerometerData : CMLogItem
@property (readonly, nonatomic) CMAcceleration acceleration;
@end
typedef struct {
double x;
double y;
double z;
} CMRotationRate;
@interface CMGyroData : CMLogItem
@property (readonly, nonatomic) CMRotationRate rotationRate;
@end
typedef struct {
double x;
double y;
double z;
} CMMagneticField;
@interface CMMagnetometerData : CMLogItem
@property (readonly, nonatomic) CMMagneticField magneticField;
@end
這個類是最「聰明」的一個,它把重力與用戶施加的加速度剝離開來,還提供了姿態角與四元數:
@interface CMDeviceMotion : CMLogItem
@property (readonly, nonatomic) CMAttitude *attitude; // 設備姿態
@property (readonly, nonatomic) CMRotationRate rotationRate; // 角速度
@property (readonly, nonatomic) CMAcceleration gravity; // 重力加速度
@property (readonly, nonatomic) CMAcceleration userAcceleration; // 用戶施加的加速度
@property (readonly, nonatomic) CMCalibratedMagneticField magneticField;
@end
@interface CMAttitude : NSObject <NSCopying, NSSecureCoding>
@property (readonly, nonatomic) double roll; // 歐拉角 roll
@property (readonly, nonatomic) double pitch; // 歐拉角 pitch
@property (readonly, nonatomic) double yaw; // 歐拉角 yaw
@property (readonly, nonatomic) CMRotationMatrix rotationMatrix;
@property (readonly, nonatomic) CMQuaternion quaternion;
@end
CoreMotion 的使用可以歸納為兩種模式。Pull 是主動拉取:啟動傳感器後,由你自己決定什麼時候去 manager 上讀值;Push 是被動接收:註冊一個回調,數據到來時系統主動餵給你。
- (void)viewDidLoad {
[super viewDidLoad];
manager = [[CMMotionManager alloc] init];
[manager startAccelerometerUpdates];
[manager startGyroUpdates];
[manager startMagnetometerUpdates];
NSTimer *time = [NSTimer scheduledTimerWithTimeInterval:1
target:self
selector:@selector(update)
userInfo:nil
repeats:YES];
time.fireDate = [NSDate distantPast];
}
- (void)update {
NSLog(@"%f,%f,%f\n%f,%f,%f",
manager.accelerometerData.acceleration.x,
manager.accelerometerData.acceleration.y,
manager.accelerometerData.acceleration.z,
manager.gyroData.rotationRate.x,
manager.gyroData.rotationRate.y,
manager.gyroData.rotationRate.z);
}
manager = [[CMMotionManager alloc] init];
[manager startAccelerometerUpdatesToQueue:[NSOperationQueue currentQueue]
withHandler:^(CMAccelerometerData *accelerometerData, NSError *error) {
NSLog(@"%f,%f,%f", accelerometerData.acceleration.x,
accelerometerData.acceleration.y,
accelerometerData.acceleration.z);
}];
四組傳感器的 API 結構高度對稱,每一組都提供「更新間隔、是否可用、是否正在運行、數據對象、Pull 啟動、Push 啟動、停止」這一套完整方法:
@interface CMMotionManager : NSObject
// 加速度計
@property (assign, nonatomic) NSTimeInterval accelerometerUpdateInterval;
@property (readonly, nonatomic, getter=isAccelerometerAvailable) BOOL accelerometerAvailable;
@property (readonly, nonatomic, getter=isAccelerometerActive) BOOL accelerometerActive;
@property (readonly, nullable) CMAccelerometerData *accelerometerData;
- (void)startAccelerometerUpdates;
- (void)startAccelerometerUpdatesToQueue:(NSOperationQueue *)queue
withHandler:(CMAccelerometerHandler)handler;
- (void)stopAccelerometerUpdates;
// 陀螺儀
@property (assign, nonatomic) NSTimeInterval gyroUpdateInterval;
@property (readonly, nonatomic, getter=isGyroAvailable) BOOL gyroAvailable;
@property (readonly, nonatomic, getter=isGyroActive) BOOL gyroActive;
@property (readonly, nullable) CMGyroData *gyroData;
- (void)startGyroUpdates;
- (void)startGyroUpdatesToQueue:(NSOperationQueue *)queue withHandler:(CMGyroHandler)handler;
- (void)stopGyroUpdates;
// 磁力計
@property (assign, nonatomic) NSTimeInterval magnetometerUpdateInterval;
@property (readonly, nonatomic, getter=isMagnetometerAvailable) BOOL magnetometerAvailable;
@property (readonly, nonatomic, getter=isMagnetometerActive) BOOL magnetometerActive;
@property (readonly, nullable) CMMagnetometerData *magnetometerData;
- (void)startMagnetometerUpdates;
- (void)startMagnetometerUpdatesToQueue:(NSOperationQueue *)queue
withHandler:(CMMagnetometerHandler)handler;
- (void)stopMagnetometerUpdates;
// 設備運動
@property (assign, nonatomic) NSTimeInterval deviceMotionUpdateInterval;
@property (readonly, nonatomic, getter=isDeviceMotionAvailable) BOOL deviceMotionAvailable;
@property (readonly, nonatomic, getter=isDeviceMotionActive) BOOL deviceMotionActive;
@property (readonly, nullable) CMDeviceMotion *deviceMotion;
- (void)startDeviceMotionUpdates;
- (void)startDeviceMotionUpdatesToQueue:(NSOperationQueue *)queue
withHandler:(CMDeviceMotionHandler)handler;
- (void)stopDeviceMotionUpdates;
// 參考系
+ (CMAttitudeReferenceFrame)availableAttitudeReferenceFrames;
@property (readonly, nonatomic) CMAttitudeReferenceFrame attitudeReferenceFrame;
- (void)startDeviceMotionUpdatesUsingReferenceFrame:(CMAttitudeReferenceFrame)referenceFrame;
- (void)startDeviceMotionUpdatesUsingReferenceFrame:(CMAttitudeReferenceFrame)referenceFrame
toQueue:(NSOperationQueue *)queue
withHandler:(CMDeviceMotionHandler)handler;
@end
實務上有兩個容易踩的坑:一是每次使用前都應判斷對應的 isXxxAvailable,模擬器與部分老設備並不具備全部硬件;二是傳感器一旦啟動就會持續耗電,離開頁面時記得調用對應的 stop 方法。
iPhone 聽筒附近埋著一顆紅外感應元件,貼近耳朵時屏幕自動熄滅,避免臉頰誤觸。這個能力同樣開放給開發者,接口非常輕量,全靠通知中心驅動。
第一步,打開監測開關:
[UIDevice currentDevice].proximityMonitoringEnabled = YES;
第二步,註冊通知:
[[NSNotificationCenter defaultCenter] addObserver:self
selector:@selector(notice)
name:UIDeviceProximityStateDidChangeNotification
object:nil];
第三步,在回調裡讀取狀態:
- (void)notice {
if ([UIDevice currentDevice].proximityState) {
NSLog(@"貼近,可熄屏");
} else {
NSLog(@"遠離,可亮屏");
}
}
典型場景是語音備忘、通話界面以及需要防誤觸的手機分牌遊戲;用完記得把 proximityMonitoringEnabled 置回 NO,否則會殘留不必要的硬件佔用。