用途:DockKit 用于让相机应用连接并控制兼容的电动相机底座或云台,通过旋转 iPhone 物理追踪拍摄对象。系统默认会分析相机帧、检测人脸与人体并驱动电机保持主体在画面内,应用也可关闭系统追踪,自行提供观测数据或直接控制电机。
主要能力:通过 DockAccessoryManager.shared 观察底座连接与断开;启用或关闭系统追踪;支持点击选择主体或按 UUID 选择主体;支持自定义追踪,传入 DockAccessory.Observation(类型仅 .humanFace、.humanBody、.object)与 CameraInformation;支持构图模式(.automatic、.center、.left、.right)和感兴趣区域;支持角速度、目标朝向、运动状态、运动限制等电机控制;提供 .yes、.no、.wakeup、.kapow 等动画;iOS 18+ 可读取 trackingStates(含 speakingConfidence、lookingAtCameraConfidence、saliencyRank)和 batteryStates;iOS 17.4+ 可接收 accessoryEvents 物理按键事件。
使用方式:import DockKit;订阅 accessoryStateChanges 处理 .docked 与 .undocked;自定义追踪或电机控制前先 setSystemTrackingEnabled(false),动画完成后恢复;自定义观测需以 10-30 fps 调用 track();animate 与 setOrientation 每秒不超过两次,否则可能抛出 .frameRateTooHigh;Observation 的 rect 使用归一化坐标、原点在左下角。
限制:需要真实的 DockKit 兼容配件和真机,模拟器无法连接底座硬件;DockKit 本身无需特殊权限,但使用相机仍需 NSCameraUsageDescription;应用必须使用 AVFoundation 相机 API;系统追踪状态不会跨应用终止、重启或前后台切换保持,需显式重设;trackingStates 与 batteryStates 需 iOS 18+,accessoryEvents 需 iOS 17.4+。具体价格、平台支持范围等资料暂未提供。