Integrazione mobile · iOS · Android¶

Lo smartphone è il device più rilevante della mesh: portatile, sensori ricchi, sempre con te. Jarvis si integra in modo profondo con iOS e Android, rispettando i vincoli di ciascuna piattaforma.

iOS¶

Capability disponibili¶

Pattern di integrazione¶

iOS è chiuso: per integrare profondamente Jarvis serve un'app companion distribuita tramite App Store (o TestFlight). L'app espone:

• App Intents per Siri/Shortcuts (ApriBriefing, ChiediAJarvis(testo), RegistraNota)
• Estensione Widget per home screen
• Estensione Live Activity per il briefing in corso
• HomeKit Bridge per esporre Jarvis come accessorio
• Push notifications via APNS

flowchart LR
    SIRI[Siri] -->|App Intent| APP[Jarvis iOS App]
    SHORT[Shortcuts] -->|App Intent| APP
    APP -->|HTTPS| SERVER[Jarvis Server]
    SERVER -->|APNS| APP
    APP <-->|HealthKit| HK[HealthKit]
    APP <-->|HomeKit| HOME[HomeKit accessories]
    APP -->|x-callback-url| OTHER[Altre app]

Esempi App Intents¶

// Siri: "Hey Siri, briefing di Jarvis"
struct OpenBriefingIntent: AppIntent {
    static var title: LocalizedStringResource = "Apri il briefing di Jarvis"

    func perform() async throws -> some IntentResult {
        let briefing = try await JarvisAPI.shared.fetchDailyBriefing()
        return .result(view: BriefingView(briefing: briefing))
    }
}

URL scheme¶

L'app supporta anche un URL scheme per integrazione da automazioni esterne:

jarvis://chat?text=Riassumi+l'ultima+riunione
jarvis://briefing?type=morning
jarvis://memory/recall?topic=ferie

Android¶

Capability disponibili¶

Pattern di integrazione¶

Android è significativamente più aperto di iOS:

flowchart LR
    LAUNCHER[Launcher / Voice] -->|Intent| APP[Jarvis Android App]
    TASKER[Tasker] -->|MCP / Intent| APP
    HA[Home Assistant Companion] -->|Intent broadcast| APP
    KDE[KDE Connect] <--> APP
    APP <-->|HTTPS| SERVER[Jarvis Server]
    APP <-->|Health Connect| HC[Health Connect]
    APP -->|MQTT| HABRIDGE[Home Assistant]
    APP -->|Wear OS| WATCH[Wear OS Watch]

Tasker MCP integration¶

Tasker espone un MCP Server che Jarvis può invocare per controllo ultra-profondo del device (volume, notifiche, esecuzione di scene, automazioni context-aware).

# Esempio task Tasker invocabile via MCP
- task: "Drive Mode"
  trigger: "context: in_car"
  actions:
    - mute_notifications
    - launch: "Google Maps"
    - audio_route: "bluetooth"
    - announce_jarvis: "Modalità auto attiva"

Esempi Intent Android¶

// Trigger un'azione Jarvis da app esterna o Tasker
val intent = Intent("dev.federicocalo.jarvis.ACTION_BRIEFING").apply {
    putExtra("type", "morning")
    putExtra("voice", true)
}
sendBroadcast(intent)

Confronto iOS vs Android¶

KDE Connect¶

KDE Connect copre laptop ↔ Android (e ora anche iOS). Funzionalità sfruttate da Jarvis:

• 📋 Clipboard sync (copio sul PC, incollo sul telefono)
• 🔔 Notifiche bidirezionali (rispondo a SMS dal PC)
• 📂 File transfer rapido
• 🎵 Media remote (controllo lo stream sul telefono dal PC)
• 🖱️ Mouse/keyboard remote (per presentazioni)

KDE_CONNECT_DEVICE_ID=...

Configurazione¶

# iOS
JARVIS_IOS_APNS_KEY_ID=...
JARVIS_IOS_TEAM_ID=...
JARVIS_IOS_BUNDLE_ID=dev.federicocalo.jarvis

# Android
JARVIS_ANDROID_FCM_KEY=...
JARVIS_ANDROID_PACKAGE=dev.federicocalo.jarvis

# KDE Connect
KDE_CONNECT_ENABLED=true

# Home Assistant Companion
HOME_ASSISTANT_URL=http://hassio.local:8123
HOME_ASSISTANT_TOKEN=eyJ...

Roadmap¶