Komm nach Hause und werde von deiner Lieblingsmusik begrüßt! Einblenden und Ausblenden von Musiktiteln mit nur einem Knopfdruck! Schalte deine Multimedia Geräte automatisch mit dem betätigen des Lichtschalters deines Wohnzimmers ein! Diese und viele viele weitere Hausautomatisierungen werden mit APIs (engl. application programming interfaces) möglich. Eine API ist eine Reihe klar definierter Kommunikationsmethoden zwischen verschiedenen Komponenten, in diesem Fall deinem Max2Play-Gerät, der Hausautomatisierungssoftware und z.B. deinem Smartphone.
Unsere API-Beispiele sind einfache HTTP-Befehle, die du zur Steuerung deiner Player nutzen kannst. Neben dem simplen Ausführen im Browser, kannst du diese Befehle in existierende Hausautomatisierungssoftware oder Kontext-Aufgaben Apps wie Tasker einbinden. Demnach eröffnen sich nahezu unbegrenzte Möglichkeiten. In diesem HowTo erklären wir dir, anhand von leicht verständlichen Beispielen, wie APIs grundsätzlich mit Max2Play funktionieren und wie du sie nutzen kannst.
Schritt 1 – Die Grundlagen
Die API-Beispiel Seite bietet vorgefertigte URLs für grundlegenden Steuerungsmechaniken der Dienste Squeezebox, Jivelite und Kodi, sowie des Max2Play-Geräts selbst.
Der entsprechende Squeezebox Reiter zeigt die IP des im Moment laufenden Squeezebox Servers. Darunter kannst du in einem Drop-Down-Menü den Player deiner Wahl aussuchen. Anschließend werden sich die URLs diesem Player anpassen. Nun musst du die URLs nur noch in die Zwischenablage kopieren und kannst sie dann als Verknüpfung in die Anwendung deiner Wahl laden oder in ein bestehendes Hausautomatisierungssystem einbinden.
Schritt 2 – Ausführen im Browser
Zunächst empfehlen wir, eine URL wie unter „Start Playing“ auf der API-Beispiele Seite auszuwählen und im Browser zu testen. Kopiere dazu einfach die Webadresse und füge sie in die Browserzeile ein. Gehe zuvor sicher, dass der entsprechende Dienst installiert und aktiviert wurde. Je nach Anfrage, z.B. „action = start“ oder „action = stop“, wird der entsprechende Befehl ausgeführt.
Anschließend wird eine Webseite geöffnet, die dir weitere Steuerungsmöglichkeiten zum ausgewählten Dienst gibt. Im Falle des Squeezebox Servers sieht das wie folgt aus:
Schritt 3 – Hausautomatisierung
Software:
Es gibt einige Open Source Hausautomatisierungs-Tools, für die du unsere API-Beispiele verwenden kannst. Wirf einen Blick auf diese Übersicht der Hausautomatisierungssoftwares, die in Max2Play bereits erhältlich sind.
Wir haben der Liste vor kurzem ein OpenHAB Setup Plugin hinzugefügt, welches es dir ermöglicht einen OpenHAB Server auf dem Raspberry Pi zu installieren. OpenHAB ist eine Open Source Hausautomatisierungsplattform, welche als zentrales Element deines Smart Homes fungieren kann. Für weitere Informationen, wie man OpenHAB konfiguriert, kannst du die offizielle Dokumentation konsultieren.
Hardware:
Auf der Hardware-Seite empfehlen wir einen Blick auf unser Zubehör Angebot zu werfen. Abhängig von deiner Hardware kannst du jegliche Knöpfe und Sensoren an dein Raspberry Pi anbringen. Du könntest deine Geräte mit einem Wandschalter z.B. neben der Tür verbinden, um das Starten der Wiedergabe beim Betreten des Raumes komfortabel zu gestalten. Für weitere Ideen, um dein System in Hausautomationen zu integrieren, sieh dir unser Multiroom Instructable an.
Schritt 4 – Tasker
Tasker führt Aktionen aus, wenn bestimmte Bedingungen erfüllt sind. Es gibt viele WENN-DANN Beziehungen, die Tasker beherrscht, z.B. ‚Zeige eine Pop-Up Nachricht an, wenn ich Geburtstag habe.‘ oder ‚Sende eine HTTP-Anfrage zu meinem Hausautomatisierungssystem und starte die Wiedergabe wenn ich nach Hause komme.‘ Wenn du willst, kannst du mehr als eine Bedingung mit einer Aufgabe verknüpfen, um die Automation einzugrenzen oder zu spezifizieren. Du könntest auch eine Ausgangs-Aufgabe hinzufügen, um zu definieren was passieren soll, wenn die Bedingungen nicht mehr aktiv sind.
Ein einfaches Beispiel dafür, wird im Bild unten gezeigt. Wenn die Bedingung erfüllt ist, dass das Smartphone mit dem Heimnetzwerk verbunden ist, wird die Aufgabe „STARTE Wiedergabe“ ausgeführt und die entsprechende HTTP-Anfrage (=Aktion) zum Squeezebox Server gesendet.
Mehr Informationen zu Tasker.
Mehr zu API
Wenn du mehr über Hausautomatisierung mit Max2Play wissen möchtest, sie dir unsere Übersicht an.
Mehr Squeezebox Server Befehle findest du hier.
Wenn du daran interessiert bist Desktop- bzw. Homescreen-Verknüpfungen für einfache Befehle wie „Starte Wiedergabe“ oder „Starte Gerät neu“ zu erstellen, sie dir unsere Wiki Artikel an.