Entwicklerdokumentation – Sparks for Teams

Marktplatz für Apps

Sparks plant einen App-Marktplatz, auf dem Microsoft-Teams-Apps mit geringen Änderungen wiederverwendet werden können. Bestehende Teams-Tabs und -Widgets lassen sich für Sparks anpassen.

MS-Teams-Widgets für Sparks for Teams anpassen

Sparks unterstützt Tabs und Widgets, die dem Microsoft Teams App-Manifest-Schema folgen. Apps, die für Microsoft Teams entwickelt wurden, können mit wenigen Anpassungen auch in Sparks genutzt werden.

Voraussetzungen

Manifest: Ein gültiges Teams App-Manifest (JSON)
Tabs: Statische Tabs (staticTabs) oder konfigurierbare Tabs (configurableTabs)
Domains: Alle verwendeten URLs müssen in validDomains eingetragen sein

Manifest-Struktur (Auszug)

{
  "id": "your-app-id",
  "version": "1.0.0",
  "manifestVersion": "1.16",
  "name": { "short": "App Name", "full": "Full App Name" },
  "description": { "short": "...", "full": "..." },
  "developer": {
    "name": "Your Company",
    "websiteUrl": "https://example.com",
    "privacyUrl": "https://example.com/privacy",
    "termsOfUseUrl": "https://example.com/terms"
  },
  "icons": { "outline": "outline.png", "color": "color.png" },
  "staticTabs": [
    {
      "entityId": "tab1",
      "name": "Tab Name",
      "contentUrl": "https://your-domain.com/tab",
      "websiteUrl": "https://your-domain.com/tab",
      "scopes": ["personal", "groupchat", "team"]
    }
  ],
  "validDomains": ["your-domain.com"]
}

Überblick: Paket und Hosting

Die folgenden Abbildungen fassen zusammen, wie Manifest, Tab-URLs und die Sparks-Oberfläche zusammenspielen.

Überblick Teams-App-Paket und Manifest

Paketinhalt: manifest.json, Icons und HTTPS-Webinhalt der Tabs; das Manifest verknüpft staticTabs / configurableTabs mit validDomains.

Tab-Einbettung in Sparks

Sparks lädt den Tab in einem Sandbox-iframe; dort rufen Sie wie in Teams microsoftTeams.app.initialize() auf.

Wichtige Anpassungen

Aspekt	Hinweis
Teams JavaScript SDK	Sparks nutzt ein kompatibles Hosting. Rufen Sie `microsoftTeams.app.initialize()` nach dem Laden der Seite auf.
contentUrl / websiteUrl	Muss HTTPS sein und in `validDomains` stehen.
Scopes	`personal`, `groupchat`, `team` – Sparks unterstützt diese Kontexte.
iframe-Sandbox	Tabs laufen in iframes; keine nativen Plugins.

Microsoft-Dokumentation (Original)

Build tabs for Teams – Übersicht Tabs
App manifest schema for Microsoft Teams – Manifest-Schema
Create a personal tab – Statische Tabs
Create a channel or group tab – Konfigurierbare Tabs
Teams JavaScript client library – SDK-Referenz
Create tab pages (content, configuration, removal) – Content-Seite

Meeting-Video und Hintergrundeffekte (Vistameet-Teams)

Für Arbeit am Client-Repository Vistameet-Teams:

Thema	Hinweis
`@livekit/track-processors`	Blur und virtueller Hintergrund. Im Repo: `^0.7.2`; auf npm zuletzt 0.7.2 (vor Updates: `npm view @livekit/track-processors version`). Exakte Pins siehe `package.json` (`livekit-client` usw.).
Prozessor beenden	Hintergrundeffekt sauber entfernen: `LocalVideoTrack.stopProcessor()` (LiveKit). Ohne diesen Schritt kann die Kamera-Vorschau nach dem Deaktivieren von Blur/Hintergrundbild hängen bleiben.

Nutzerhinweise (Auto/GPU/CPU, Vollfläche): Meeting beitreten.

Marktplatz für Apps​

MS-Teams-Widgets für Sparks for Teams anpassen​

Voraussetzungen​

Manifest-Struktur (Auszug)​

Überblick: Paket und Hosting​

Wichtige Anpassungen​

Microsoft-Dokumentation (Original)​

Meeting-Video und Hintergrundeffekte (Vistameet-Teams)​

Verwandte Seiten​