# seeMoteCap

**Repository Path**: dfrobot/seeMoteCap

## Basic Information

- **Project Name**: seeMoteCap
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: CC-BY-4.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-09-17
- **Last Updated**: 2026-09-17

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# seeMoteViewer

An example project for the seeMote general-purpose spatial accessory viewer.

This project demonstrates how to build a visionOS 27.0+ app that:
- Discovers and connects to `GCSpatialAccessory` spatial accessories
- Retrieves accessory anchors through `AccessoryTrackingProvider`
- Displays the accessory position, reference model, and digital replicas in a mixed immersive space
- Previews either a USDZ reference model supplied by the accessory or a bundled model

## Requirements

- Xcode 27.0 beta or later
- visionOS 27.0 SDK
- Apple Vision Pro or the visionOS simulator

## Opening the Project for the First Time

For detailed instructions, see: https://wiki.dfrobot.com/dfr1285

1. Open `seeMoteViewer.xcodeproj` in Xcode.
2. Select the `seeMoteViewer` target and open **Signing & Capabilities**:
   - Set **Team** to your Apple Developer Team (or Personal Team).
   - Change **Bundle Identifier** to a unique identifier that belongs to you, such as `com.yourcompany.seeMoteViewer`.
3. Select a visionOS simulator or connect an Apple Vision Pro device, then press `Cmd+R` to run the app.

## Project Structure

```
seeMoteViewer/
├── Core/
│   ├── AppState.swift                  # Container for global app state
│   ├── AppConfiguration.swift          # Static app configuration
│   ├── LocaleManager.swift             # In-app language switching
│   ├── AccessoryConnectionManager.swift# Accessory connection and disconnection monitoring
│   ├── TrackingSessionManager.swift    # ARKit authorization, session, and tracking provider lifecycle
│   ├── AccessoryTracker.swift          # Unified state and operations interface for the view layer
│   ├── PreviewLoader.swift             # Preview model loading
│   ├── ReplicaPlacementController.swift# Digital replica placement/removal signals
│   ├── HapticController.swift          # Haptic engine control
│   ├── HapticCoordinator.swift         # Haptic controller lifecycle coordination
│   └── SceneState.swift                # Immersive space state
├── Reality/
│   ├── EntityFactory.swift             # Entity factory and visualization placeholders
│   ├── AnchorManager.swift             # Anchor entity creation and management
│   └── TrackingMode+Localization.swift # Localization for tracking modes and accessory positions
├── Utilities/
│   ├── Logger+seeMote.swift            # Logging extensions
│   └── CancellableTask.swift           # Cancellable task wrapper
├── Views/
│   ├── ControlPanelView.swift          # Main control panel
│   ├── WorldOverlayView.swift          # Mixed immersive space view
│   └── ToggleImmersiveSpaceButton.swift# Button for opening/closing the immersive space
├── Resources/
│   ├── model1.usdz                     # Bundled preview model
│   ├── logo.png                        # App icon/logo
│   └── cap-202607152.referenceaccessory# Reference accessory file
├── Localizable.xcstrings               # Chinese and English localization
├── Info.plist                          # Scene configuration and reference accessory type declarations
└── seeMoteViewer.entitlements          # Sandbox and networking capabilities
```

## Core Modules

- **AccessoryConnectionManager**: Observes `GCSpatialAccessory.spatialAccessories`, manages connection state, and invokes callbacks when connected devices change.
- **TrackingSessionManager**: Runs an `ARKitSession`, manages the `AccessoryTrackingProvider`, and exposes authorization status, tracking status, and the latest anchor.
- **AccessoryTracker**: Combines connection, tracking, preview loading, and replica control behind a single interface for the view layer.
- **PreviewLoader**: Loads the USDZ embedded in a `referenceaccessory` supplied by an accessory, or falls back to the bundled `model1.usdz`.
- **ReplicaPlacementController**: Uses `AsyncStream` to send digital replica placement and removal signals to the immersive space.
- **HapticController / HapticCoordinator**: Creates and restores a `CHHapticEngine` for the connected accessory, supporting both single-pulse and multi-pulse patterns.
- **WorldOverlayView**: Uses `RealityView` to render anchor markers, the reference model, and digital replicas in a mixed immersive space.

## Custom Accessory Support

If your seeMote accessory supplies its own USDZ preview model, add a new enum case to `PreviewLoader.PreviewModel` and load the corresponding resource.

## License

This project is provided by seeMote as a reference implementation for developers.