dockkit 是做什么的?
控制电动相机底座并使用 DockKit 实现智能主体追踪。适用于发现兼容 DockKit 的配件、实现相机主体追踪(人脸或身体)、控制底座电机进行平移和倾斜、配置取景行为、设置感兴趣区域或构建具备自动相机追踪功能的视频应用。
功能概述
DockKit 是 Apple 提供的一个框架,允许 iPad 和 iPhone 应用控制电动相机底座,并对检测到的主体(如人脸或身体)进行自动追踪。该技能提供了一个 Swift 封装层,便于集成到您的项目中。
主要能力
- 配件发现:扫描并连接兼容 DockKit 的电动底座
- 主体追踪:支持人脸和身体追踪模式
- 电机控制:控制底座的平移和倾斜运动
- 取景配置:设置自动取景行为(如追踪灵敏度、边距)
- 感兴趣区域(ROI):定义追踪应关注的区域
- 相机集成:与
AVCaptureSession无缝协作
使用方法
1. 导入框架
import DockKit
import dpearson2699_dockkit
2. 发现配件
let manager = DockAccessoryManager()
manager.discoverAccessories()
3. 启动追踪
let tracker = SubjectTracker()
tracker.startTracking(mode: .face)
4. 控制电机
dockMotor.pan(to: 30.0, tilt: -15.0)
配置选项
| 参数 | 类型 | 描述 |
|---|---|---|
trackingMode | enum | .face 或 .body |
framingSpeed | Float | 自动取景的响应速度(0.0 - 1.0) |
roi | CGRect | 视频帧内的追踪区域 |
示例应用
完整的示例应用可在 Examples/ 目录中找到,展示了如何将 DockKit 与 AVFoundation 集成,实现实时视频预览和自动追踪。
系统要求
- iOS 17.0+ 或 iPadOS 17.0+
- Swift 5.9+
- 兼容 DockKit 的硬件底座
许可
本项目采用 MIT 许可证。