Que fait dockkit ?
Contrôlez les docks motorisés pour caméra et activez le suivi intelligent de sujets à l'aide de DockKit. Utilisez cette compétence lorsque vous devez découvrir des accessoires compatibles DockKit, implémenter le suivi de visages ou de corps, contrôler les moteurs du dock (panoramique et inclinaison), configurer le comportement de cadrage, définir des zones d'intérêt ou créer des applications vidéo avec suivi automatique de la caméra.
Fonctionnalités clés
- Découverte d'accessoires : Scannez et connectez-vous automatiquement aux docks motorisés compatibles DockKit.
- Suivi de sujets : Permet le suivi en temps réel des visages ou des corps détectés par la caméra.
- Contrôle moteur : Ajustez les positions de panoramique et d'inclinaison du dock.
- Cadrage et ROI : Configurez le comportement de cadrage (par exemple, centré, équilibré, ou personnalisé) et définissez des zones d'intérêt (regions of interest) pour le suivi.
- Intégration native : Conçu pour les applications iOS/iPadOS utilisant le framework DockKit d'Apple.
Plateformes supportées
- iOS / iPadOS (Swift, UIKit, AVFoundation)
- Nécessite un accessoire DockKit compatible (par exemple, certains docks Belkin, ou des accessoires tiers certifiés).
Exemple d'utilisation
import DockKit
class CameraViewController: UIViewController {
let dockManager = DKDockManager()
override func viewDidLoad() {
super.viewDidLoad()
// Démarrer la découverte d'accessoires
dockManager.startDiscovering()
// Configurer le suivi
dockManager.framingMode = .centered
dockManager.regionOfInterest = CGRect(x: 0.2, y: 0.2, width: 0.6, height: 0.6)
// Commencer le suivi
dockManager.startTracking()
}
func stopTracking() {
dockManager.stopTracking()
dockManager.stopDiscovering()
}
}
Commandes principales
| Commande | Description |
|---|---|
dockManager.startDiscovering() | Lance la recherche d'accessoires DockKit à proximité. |
dockManager.stopDiscovering() | Arrête la recherche. |
dockManager.startTracking() | Active le suivi automatique du sujet. |
dockManager.stopTracking() | Désactive le suivi. |
dockManager.setDockPosition(pan: tilt:) | Positionne manuellement le dock (valeurs en degrés). |
dockManager.framingMode | Définit le mode de cadrage (.centered, .balanced, .custom). |
dockManager.regionOfInterest | Définit la zone d'intérêt (CGRect normalisée). |
Bonnes pratiques
- Vérifiez la compatibilité : Assurez-vous que l'accessoire est correctement connecté et compatible avec DockKit avant de démarrer le suivi.
- Gérez les erreurs : Implémentez le protocole
DKDockManagerDelegatepour réagir aux déconnexions ou aux échecs de suivi. - Optimisez les performances : Utilisez des zones d'intérêt restreintes pour réduire la charge de calcul et améliorer la réactivité.
- Respectez la vie privée : Informez les utilisateurs du suivi vidéo et obtenez les autorisations nécessaires (via Privacy - Camera Usage Description).
Références
Cette compétence est conçue pour fonctionner avec des agents IA comme Claude Code, Cursor ou Codex, en fournissant un accès structuré au contrôle des docks et au suivi intelligent.