用途:DockKit 用于将电动相机支架与云台接入相机应用,通过旋转 iPhone 物理跟踪主体,实现 360 度水平旋转与 90 度俯仰跟踪,无需额外代码即可获得电机控制、主体检测与构图能力。
主要能力:支持发现兼容配件、保持配件会话并观察生命周期事件;可在系统跟踪与自定义跟踪间选择;应用可覆盖系统跟踪、提供自定义观测、直接控制电机或调整构图。包含动画、事件与电量状态处理。
使用方式:先在 DockKit 可用且连接兼容配件时启用功能,并规划真机验证。启动并保留配件会话,观察生命周期事件。自定义跟踪需按支持频率提供有效相机几何与置信度的观测。直接控制电机前必须关闭系统跟踪,遵守限幅,事后恢复原模式。观测频率建议 10-30 fps;animate 或 setOrientation 每秒不超过两次,否则可能抛 .frameRateTooHigh。观测矩形使用归一化坐标(左下原点)。动画完成后需恢复跟踪。
适用场景:相机应用中的主体跟踪、云台旋转与构图调整、自定义对象跟踪、程序化旋转与定位。
限制:DockKit 需要物理兼容配件,模拟器不可用,需初始化保护并提供无配件回退。不要同时混用系统跟踪与直接电机控制。跟踪状态不保证跨生命周期事件持续,回前台需重新设置。部分 API 需版本守卫,如 accessoryEvents 需 iOS 17.4、trackingStates 与 batteryStates 需 iOS 18.0。
其他细节:官网与扩展模式、错误处理及测试资料暂未提供。