Lighting

Lighting-Ressourcen interagieren mit dem canvas und den aktuell abgespielten Effekten. Hier können Sie den aktuellen Effekt einsehen, ihn wechseln, sein Preset ändern oder alle aktuell installierten Effekte des Benutzers durchlaufen.

Methode	Endpunkt
GET	lighting
PATCH	lighting/global_brightness
PATCH	lighting/enabled
GET	lighting/effects
GET	lighting/effect/:id
GET	lighting/effect/:id/presets
PATCH	lighting/effect/:id/presets
POST	lighting/effect/:id/apply
GET	lighting/next
POST	lighting/next
GET	lighting/previous
POST	lighting/previous
POST	lighting/shuffle

Aktuellen Effekt abrufen

Ruft Informationen über den aktuell abgespielten Effekt, die globale Helligkeit und den canvas-Wiedergabestatus ab. Der self-Link kann verwendet werden, um bei Bedarf weitere Informationen zu diesem Effekt abzurufen.

curl http://localhost:16038/api/v1/lighting

{
    "api_version": "1.0",
    "data": {
        "attributes": {
            "enabled": true,
            "global_brightness": 50,
            "name": "Neon Shift"
        },
        "id": "Neon Shift.html",
        "links": {
            "self": "/api/v1/lighting/effects/Neon Shift.html"
        },
        "type": "current_effect"
    },
    "id": 6,
    "method": "/api/v1/lighting",
    "params": {},
    "status": "ok"
}

Globale Helligkeit setzen

Setzt die aktuelle globale Helligkeit.

curl -X PATCH -d "{\"global_brightness\":73}" http://localhost:16038/api/v1/lighting/global_brightness

{
    "api_version": "1.0",
    "data": {
        "attributes": {
            "enabled": true,
            "global_brightness": 73
        },
        "type": "effect"
    },
    "id": 3,
    "method": "/api/v1/lighting/global_brightness",
    "params": {
        "body": {
            "global_brightness": 73
        }
    },
    "status": "ok"
}

Canvas abspielen/pausieren

Legt fest, ob der canvas derzeit aktiv ist. Wenn deaktiviert, erhalten alle Geräte für alle Farbanfragen schwarz (#000000).

curl -X PATCH -d "{\"enabled\":false}" http://localhost:16038/api/v1/lighting/enabled

{
    "api_version": "1.0",
    "data": {
        "attributes": {
            "enabled": false,
            "global_brightness": 73
        },
        "type": "effect"
    },
    "id": 4,
    "method": "/api/v1/lighting/enabled",
    "params": {
        "body": {
            "enabled": false
        }
    },
    "status": "ok"
}

Installierte Effekte abrufen

Gibt eine Liste aller installierten Effekte des Benutzers zurück.

• Aufgrund der potenziellen Payload-Größe dieses Endpunkts sollte die Anzahl der Aufrufe möglichst gering gehalten werden.

curl http://localhost:16038/api/v1/lighting/effects

{
    "apiVersion": "1.0",
    "data": {
        "items": [
            {
                "attributes": {
                    "name": " Wolfenstein II: TNC"
                },
                "id": "-MQtFeX-o2hMR6sv8aFr",
                "links": {
                    "apply": "/api/v1/lighting/effects/-MQtFeX-o2hMR6sv8aFr/apply",
                    "self": "/api/v1/lighting/effects/-MQtFeX-o2hMR6sv8aFr"
                },
                "type": "effect"
            },
            {
                "attributes": {
                    "name": "4th Dimension"
                },
                "id": "-N-YhDDs2ZIGJ42azDgJ",
                "links": {
                    "apply": "/api/v1/lighting/effects/-N-YhDDs2ZIGJ42azDgJ/apply",
                    "self": "/api/v1/lighting/effects/-N-YhDDs2ZIGJ42azDgJ"
                },
                "type": "effect"
            },
          ...
        ],
        "type": "effects"
    },
    "id": 7,
    "method": "/api/v1/lighting/effects",
    "params": {},
    "status": "ok"
}

Effektinformationen abrufen

Gibt detaillierte Informationen zu einem bestimmten Effekt zurück.

• Wenn die angegebene Effekt-ID nicht existiert, gibt dieser Endpunkt einen 404-Fehler zurück.

curl http://localhost:16038/api/v1/lighting/effects/-Mg1qujV9F4rabJxlSOS

{
    "api_version": "1.0",
    "data": {
        "attributes": {
            "description": "A colorful drizzle of softly moving lines.",
            "developer_effect": false,
            "image": "https://imagedelivery.net/uPA_EtOZxmT3DaI0aRG2mQ/-Mg1qujV9F4rabJxlSOS/main/dashcard",
            "name": "Drizzle",
            "parameters": {
                "backColorMode": {
                    "label": "Background Color Mode",
                    "type": "combobox",
                    "value": "Static"
                },
                "backHue": {
                    "label": "Background Color (Static)",
                    "type": "color",
                    "value": "#320056"
                },
                "confHue": {
                    "label": "Line Color (Static)",
                    "type": "color",
                    "value": "#ff0000"
                },
                "confLength": {
                    "label": "Line Length",
                    "type": "number",
                    "value": 70
                }
            },
            "publisher": "SignalRGB",
            "uses_audio": false,
            "uses_input": false,
            "uses_meters": false,
            "uses_video": false
        },
        "id": "-Mg1qujV9F4rabJxlSOS",
        "links": {
            "apply": "/api/v1/lighting/effects/-Mg1qujV9F4rabJxlSOS/apply",
            "self": "/api/v1/lighting/effects/-Mg1qujV9F4rabJxlSOS"
        },
        "type": "effect"
    },
    "id": 1,
    "method": "/api/v1/lighting/effects/-Mg1qujV9F4rabJxlSOS",
    "params": {
        "id": "-Mg1qujV9F4rabJxlSOS"
    },
    "status": "ok"
}

{
    "api_version": "1.0",
    "errors": [
        {
            "code": "404",
            "detail": "The requested effect was not found",
            "title": "Not Found"
        }
    ],
    "id": 2,
    "method": "/api/v1/lighting/effects/-Mg1qujV9F4rabJxlSO",
    "params": {
        "id": "-Mg1qujV9F4rabJxlSO"
    },
    "status": "error"
}

Effekt-Presets abrufen

Gibt eine Liste der verfügbaren Presets für diesen Effekt zurück.

• Wenn die angegebene Effekt-ID nicht existiert, gibt dieser Endpunkt einen 404-Fehler zurück.

curl http://localhost:16038/api/v1/lighting/effects/-Mg1qujV9F4rabJxlSOS/presets

{
    "api_version": "1.0",
    "data": {
        "id": "-Mg1qujV9F4rabJxlSOS",
        "items": [
            {
                "id": "My Fancy Preset 1",
                "type": "preset"
            },
            {
                "id": "My Other Preset",
                "type": "preset"
            }
        ],
        "type": "presets"
    },
    "id": 1,
    "method": "/api/v1/lighting/effects/-Mg1qujV9F4rabJxlSOS/presets",
    "params": {
        "id": "-Mg1qujV9F4rabJxlSOS"
    },
    "status": "ok"
}

{
    "api_version": "1.0",
    "errors": [
        {
            "code": "404",
            "detail": "The requested effect was not found",
            "title": "Not Found"
        }
    ],
    "id": 4,
    "method": "/api/v1/lighting/effects/-Mg1qujV9F4rabJxlSS/presets",
    "params": {
        "id": "-Mg1qujV9F4rabJxlSS"
    },
    "status": "error"
}

Effekt-Preset anwenden

Wendet das Ziel-Effekt-Preset für die angegebene Effekt-ID an.

• Wenn die angegebene Effekt-ID oder das Preset nicht existiert, gibt dieser Endpunkt einen 404-Fehler zurück.

curl -X PATCH -d "{\"preset\":\"My Fancy Preset 1\"}" http://localhost:16038/api/v1/lighting/effects/-Mg1qujV9F4rabJxlSOS/presets

Effekt anwenden

Wendet die angegebene Effekt-ID an, wenn sie existiert.

• Wenn die angegebene Effekt-ID nicht existiert, gibt dieser Endpunkt einen 404-Fehler zurück.

curl -X POST http://localhost:16038/api/v1/lighting/effects/-Mg1qujV9F4rabJxlSOS/apply

{
    "api_version": "1.0",
    "id": 3,
    "method": "/api/v1/lighting/effects/-Mg1qujV9F4rabJxlSOS/apply",
    "params": {
        "id": "-Mg1qujV9F4rabJxlSOS"
    },
    "status": "ok"
}

{
    "api_version": "1.0",
    "errors": [
        {
            "code": "404",
            "detail": "The requested effect was not found",
            "title": "Not Found"
        }
    ],
    "id": 4,
    "method": "/api/v1/lighting/effects/-Mg1qujV9F4rabJxlSS/apply",
    "params": {
        "id": "-Mg1qujV9F4rabJxlSS"
    },
    "status": "error"
}

Nächsten Effekt abrufen

Gibt Informationen über den nächsten Effekt im Verlauf zurück, falls verfügbar. Wenn der Effektverlauf keinen nächsten Effekt enthält, gibt dieser Endpunkt einen 409-Fehler zurück.

curl http://localhost:16038/api/v1/lighting/next

{
    "api_version": "1.0",
    "data": {
        "attributes": {
            "name": "Drizzle"
        },
        "id": "-Mg1qujV9F4rabJxlSOS",
        "links": {
            "self": "/api/v1/lighting/effects/-Mg1qujV9F4rabJxlSOS"
        },
        "type": "effect"
    },
    "id": 5,
    "method": "/api/v1/lighting/next",
    "params": {},
    "status": "ok"
}

{
    "api_version": "1.0",
    "errors": [
        {
            "code": "409",
            "detail": "Effect History doesn't contain a next effect",
            "title": "No Next Effect"
        }
    ],
    "id": 24,
    "method": "/api/v1/lighting/next",
    "params": {},
    "status": "error"
}// Click to edit code

Nächsten Effekt anwenden

Simuliert eine Medien-Vorspul-Operation für den aktuell abgespielten Effekt. Wenn kein nächster Effekt im Verlauf vorhanden ist, wählt SignalRGB einen zufälligen installierten Effekt aus, der kein Game-Integration- und kein Entwickler-Effekt ist.

Gibt den neu angewendeten Effekt zurück.

curl -X POST http://localhost:16038/api/v1/lighting/next

{
    "api_version": "1.0",
    "data": {
        "attributes": {
            "name": "Drizzle"
        },
        "id": "-Mg1qujV9F4rabJxlSOS",
        "links": {
            "self": "/api/v1/lighting/effects/-Mg1qujV9F4rabJxlSOS"
        },
        "type": "effect"
    },
    "id": 5,
    "method": "/api/v1/lighting/next",
    "params": {},
    "status": "ok"
}

{
    "api_version": "1.0",
    "errors": [
        {
            "code": "409",
            "detail": "Effect History doesn't contain a next effect",
            "title": "No Next Effect"
        }
    ],
    "id": 24,
    "method": "/api/v1/lighting/next",
    "params": {},
    "status": "error"
}

Vorherigen Effekt abrufen

Gibt Informationen über den vorherigen Effekt im Verlauf zurück, falls verfügbar. Wenn der Effektverlauf keinen vorherigen Effekt enthält, gibt dieser Endpunkt einen 409-Fehler zurück.

curl http://localhost:16038/api/v1/lighting/previous

{
    "api_version": "1.0",
    "data": {
        "attributes": {
            "name": "Gradient Generator"
        },
        "id": "-MA7wCKkv_359cmwPOEK",
        "links": {
            "self": "/api/v1/lighting/effects/-MA7wCKkv_359cmwPOEK"
        },
        "type": "effect"
    },
    "id": 7,
    "method": "/api/v1/lighting/previous",
    "params": {},
    "status": "ok"
}

{
    "api_version": "1.0",
    "errors": [
        {
            "code": "409",
            "detail": "Effect History doesn't contain a previous effect",
            "title": "No Previous Effect"
        }
    ],
    "id": 15,
    "method": "/api/v1/lighting/previous",
    "params": {},
    "status": "error"
}

Vorherigen Effekt anwenden

Simuliert eine Medien-Rückspul-Operation für den aktuell abgespielten Effekt. Wenn kein vorheriger Effekt im Verlauf vorhanden ist, gibt dieser Endpunkt einen 409-Fehler zurück.

Gibt den neu angewendeten Effekt zurück.

curl -X POST http://localhost:16038/api/v1/lighting/previous

{
    "api_version": "1.0",
    "data": {
        "attributes": {
            "name": "Gradient Generator"
        },
        "id": "-MA7wCKkv_359cmwPOEK",
        "links": {
            "self": "/api/v1/lighting/effects/-MA7wCKkv_359cmwPOEK"
        },
        "type": "effect"
    },
    "id": 7,
    "method": "/api/v1/lighting/previous",
    "params": {},
    "status": "ok"
}

{
    "api_version": "1.0",
    "errors": [
        {
            "code": "409",
            "detail": "Effect History doesn't contain a previous effect",
            "title": "No Previous Effect"
        }
    ],
    "id": 15,
    "method": "/api/v1/lighting/previous",
    "params": {},
    "status": "error"
}

Zufälligen Effekt anwenden

Simuliert eine Medien-Shuffle-Operation für den aktuell abgespielten Effekt. SignalRGB wählt einen zufälligen installierten Effekt aus, der kein Game-Integration- und kein Entwickler-Effekt ist.

Gibt den neu angewendeten Effekt zurück.

curl -X POST http://localhost:16038/api/v1/lighting/shuffle

{
    "api_version": "1.0",
    "data": {
        "attributes": {
            "name": "Borealis"
        },
        "id": "-N1LC8HkC4fZ6IlFA30j",
        "links": {
            "self": "/api/v1/lighting/effects/-N1LC8HkC4fZ6IlFA30j"
        },
        "type": "effect"
    },
    "id": 6,
    "method": "/api/v1/lighting/shuffle",
    "params": {},
    "status": "ok"
}