---
url: /de/plugins/homekit.md
---

# HomeKit

Das HomeKit-Plugin fügt deine Kameras und Sensoren zu **Apple Home** hinzu. Kameras streamen und zeichnen über die Home-App auf deinen Apple-Geräten auf; Sensoren erscheinen als Zubehör, das du dort sehen und steuern kannst.

## Einrichtung

1. Installiere und aktiviere das **HomeKit**-Plugin.
2. Weise es den Kameras zu, die du in Home willst, im **Cameras**-Tab des Plugins oder über den [Plugins-Tab einer Kamera](/de/sensors/setup).
3. Öffne die **HomeKit-Einstellungen** einer Kamera. Jede Kamera wird einzeln zu Home hinzugefügt und hat ihren eigenen **QR-Code** und **PIN**.
4. Wähle in der Apple-**Home**-App **Gerät hinzufügen** und scanne den QR-Code der Kamera, oder gib ihren PIN ein.

Koppelst du auf dem Gerät, auf dem camera.ui offen ist, nimm in der Home-App **Weitere Optionen** und tippe den PIN ein; der Kopier-Button daneben kopiert ihn.

**HomeKit Secure Video**-Aufnahmen funktionieren, sobald du sie in Home eingerichtet hast.

## Secure Video ab iOS 27

Kameras mit HEVC-Hauptstream (H.265) nutzen Apples neuere Secure-Video-Dienste. Live-Ansicht zu Hause und unterwegs, Aufnahme und Gegensprechen laufen direkt auf dem HEVC-Stream der Kamera, ohne Transkodierung, eine 4K-Kamera kostet also keinen CPU-Kern. Dafür braucht es iOS 27 oder tvOS 27 auf den Geräten, mit denen du zuschaust, und auf der Steuerzentrale.

Unterwegs bietet eine Kamera mit einer zweiten [Quelle](/de/cameras/add-camera#quellen-und-rollen) in **Niedrige Auflösung** oder **Mittlere Auflösung** zusätzlich ein kleines Bild daraus an, auf dem Server transkodiert, sofern diese Quelle nicht schon HEVC ist. Das transkodierte Bild bekommt das Seitenverhältnis, das in den [Kamera-Einstellungen](/de/cameras/settings) unter **Interface** eingestellt ist. Die Home-App wechselt bei langsamer Verbindung wie LTE darauf. Ohne eine solche Quelle zeigt die Live-Ansicht über LTE kein Bild.

Kameras mit H.264-Hauptstream bleiben auf den klassischen HomeKit-Kameradiensten, weil Apples neue Fernansicht nur HEVC annimmt. Jeder andere Codec, etwa MJPEG, nutzt ebenfalls die klassischen Dienste, der Stream wird dann nach H.264 transkodiert. Welcher Weg genommen wird, entscheidet das Plugin beim Veröffentlichen der Kamera anhand des Codecs im Hauptstream.

Bleibt dein Zuhause auf iOS 26 oder älter, schalte in den Einstellungen der Kamera **Force legacy path** unter **Secure Video** ein. Die Kamera nutzt dann die klassischen Dienste, und ihr HEVC-Stream wird nach H.264 transkodiert. Wie bei MJPEG bekommt das Bild die Breite, die die Home-App anfragt, nie mehr als die Kamera liefert. Seitenverhältnis und Bildrate bleiben die der Kamera, die Bitrate richtet sich nach der Bildgröße.

Auf den klassischen Diensten startet die Fernansicht klein, und die Home-App fragt mehr an, sobald die Verbindung hält. Bis dahin schickt eine Kamera mit einer Quelle in **Niedrige Auflösung** oder **Mittlere Auflösung** diese, bei Bedarf nach H.264 transkodiert, und wechselt dann ohne Unterbrechung auf den Hauptstream. Ein transkodiertes kleines Bild bekommt das Seitenverhältnis, das unter **Interface** eingestellt ist, wie bei Secure Video.

## Was wo landet

Eine Kamera ist immer ihr eigenes Zubehör, mit einem Bewegungssensor darauf. Diesen Bewegungssensor speist die Erkennung von camera.ui, er funktioniert also auch ohne zugewiesenen Bewegungssensor.

Was aus einem Sensor wird, hängt an seiner [Kamera-Zuweisung](/de/sensors/setup):

**Einer Kamera zugewiesen** wird der Sensor Teil des Kamera-Zubehörs statt einer eigenen Kachel:

* **Bewegung** speist den Bewegungssensor der Kamera und bekommt kein eigenes Zubehör.
* **Klingel** ergänzt die Klingeltaste an der Kamera.
* **Batterie** ergänzt Ladestand und Warnung bei niedrigem Akku.
* **Spotlight und Sirene** werden zu Bedienelementen an der Kamera, solange es die eigene Hardware der Kamera ist.

**Keiner Kamera zugewiesen** wird der Sensor sein eigenes Zubehör hinter der einen **camera.ui Bridge**: Kontakt, Belegung, Rauchmelder, Wassersensor, Temperatur, Feuchtigkeit, Schloss, Garagentor, Schalter und Alarmanlage landen immer hier, genauso Bewegungssensoren, Klingeln, Lichter und Sirenen, die zu keiner Kamera gehören. Ein eigenständiges Licht oder eine eigenständige Sirene bleibt auf der Bridge, auch wenn du sie einer Kamera zuweist; nur in der Kamera verbaute Hardware wandert auf die Kamera.

Die Bridge läuft, sobald das Plugin läuft, mit oder ohne Sensoren. Kopple sie einmal, und jeder später freigegebene Sensor kommt automatisch dazu. Ihr QR-Code und PIN stecken in den Einstellungen des Plugins.

Ob ein Sensor überhaupt rüberkommt, entscheidet der Schalter **Sensor freigeben** auf der [Sensoren-Seite](/de/sensors/setup#die-sensoren-seite). Kamera-Hardware hat keinen Schalter, sie folgt immer ihrer Kamera.

## Schnelles Streaming

Eine Kamera in Home zu öffnen dauert wenige Millisekunden, mit H.264 oder H.265, solange die Quelle bereitgehalten wird: Aktiviere [Hot Modus und Vorladen](/de/cameras/add-camera#quellen-optionen) an den Kameras, die du bridgest.

Der Hot Modus des Hauptstreams entscheidet auch, ob Aufnahmen von HomeKit Secure Video die Sekunden vor einem Ereignis enthalten. Ohne ihn bleibt die Kamera nicht verbunden, eine Aufnahme öffnet den Stream erst mit dem Ereignis und hat nichts davor. Plugins schalten den Hot Modus bei Akku-Kameras ab, damit sie schlafen können.

Das Bild in Home folgt der [Snapshot-Einstellung](/de/cameras/home#snapshots-und-wie-sie-sich-aktualisieren) der Kamera. Solange ein Ereignis läuft oder die Klingel läutet, holt HomeKit ein frisches.

## Einstellungen

Die HomeKit-Einstellungen jeder Kamera umfassen:

* **QR-Code und PIN.** Die Kopplungs-Details dieser Kamera.
* **Force legacy path.** Unter **Secure Video**: hält die Kamera auf den klassischen HomeKit-Diensten, siehe [Secure Video ab iOS 27](#secure-video-ab-ios-27). Standardmäßig aus.
* **Allow transcoding for mobile data.** Ebenfalls unter **Secure Video**: erlaubt camera.ui, eine Quelle in niedriger oder mittlerer Auflösung zu transkodieren, die kein HEVC ist, damit die Fernansicht über LTE funktioniert. Eine HEVC-Quelle geht unverändert raus, außer **Always transcode** ist an. Standardmäßig an; ist es aus, zeigt so eine Kamera über LTE eventuell kein Bild. Das Log sagt bei jedem Start unterwegs, welche Quelle rausgeht und ob sie transkodiert wird.
* **Use Hardware Acceleration.** Nutzt die GPU, sofern eine vorhanden ist, wenn ein Stream transkodiert werden muss. Standardmäßig an.
* **Use Hardware Acceleration for HKSV.** Dasselbe für HomeKit-Secure-Video-Aufnahmen. Standardmäßig an; schalte es für eine Kamera aus, deren Aufnahmen abbrechen.
* **Always transcode.** Unter **Advanced**: transkodiert die Live-Ansicht auch dann, wenn HomeKit den Stream der Kamera unverändert abspielen könnte, auf dem klassischen Weg und bei Secure Video. Belastet den Server zusätzlich. Für Aufnahmen gibt es einen eigenen Schalter. Standardmäßig aus.
* **Stream as requested.** Ebenfalls unter **Advanced**: sendet die Live-Ansicht in der Größe, Bildrate und Bitrate, die HomeKit anfragt, jeder Live-Stream wird also transkodiert. Eine Quelle, die kleiner ist als angefragt, behält ihre Größe. Standardmäßig aus.
* **Always transcode for HKSV.** Ebenfalls unter **Advanced**: transkodiert HomeKit-Secure-Video-Aufnahmen auch dann, wenn HomeKit den Stream der Kamera unverändert nehmen könnte. Sie sind dann H.264 in der Größe, Bildrate und Bitrate, die HomeKit anfragt. Belastet den Server zusätzlich. Standardmäßig aus.
* **Override Port und mDNS advertiser.** Unter **Advanced**: ein fester Port statt eines automatischen (0) und das Backend, das die Kamera im Netzwerk ankündigt.
* **Reset Pairing.** Einen neuen Code erzeugen und die Kamera neu hinzufügen, falls die Kopplung bricht.

Die Einstellungen des Plugins selbst halten dasselbe Set für die Sensor-Bridge: ihren QR-Code, PIN, Port, mDNS advertiser und einen Button **Reset Bridge Pairing**.

## Gut zu wissen

* Jede Kamera ist ihr eigenes HomeKit-Zubehör, du fügst Kameras also einzeln hinzu. Eigenständige Sensoren teilen sich die eine Bridge und brauchen nur eine einzige Kopplung.
* Kameras mit Zwei-Wege-Audio kannst du aus der Home-App ansprechen.
* Kameras und Bridge lauschen auf den **Server-Adressen** unter **Einstellungen → Remote Zugriff → Netzwerk**, bei einem Plugin auf einem Worker auf den Adressen aus **Worker bearbeiten** (siehe [Worker-Zuweisungen](/de/admin/worker-assignments#plugins)). Ist keine gesetzt, lauschen sie auf allen; stocken oder scheitern Streams, wähle die kabelgebundene LAN-Adresse. Eine Adresse, die es auf der Maschine nicht gibt, wird übersprungen, und das Log nennt sie zusammen mit den gefundenen Adressen.
* Die Kopplungen liegen in den Einstellungen des Plugins auf dem Hauptserver. Kameras und Bridge bleiben gekoppelt, wenn das Plugin auf einen Worker oder zurück wandert.
* Ein als **Kopie** eingespieltes Backup (siehe [Wiederherstellen](/de/admin/backup#wiederherstellen)) gibt Bridge und Kameras neue Kopplungscodes, damit sie nicht für den ursprünglichen Server antworten. Füge sie auf der Kopie neu zu Home hinzu. Ein **Umzug** behält die Kopplungen.
