Schwingungserzeuger
:::Warnung: Experimentell Hierbei handelt es sich um eine Reihe von Funktionen, die sich noch in der Entwicklung befinden und experimenteller Natur sind.
Sie können gerne experimentieren und uns je nach Anwendungsfall Feedback geben, damit wir unsere API verbessern und einen größeren Nutzen bieten können.
Die Verwendung und die Signaturen können sich ändern. :::
Diese Funktion ermöglicht eine programmierbare Vibrationsausgabe bei Inverse3 Geräten unter Verwendung von bis zu zwei unabhängigen Oszillatoren. Sie funktioniert ähnlich wie ein einfacher Synthesizer-Signalgenerator: Jeder Oszillator kann eine Wellenform mit konfigurierbarer Amplitude und Frequenz erzeugen.
Grundlagen des Oszillators
- Jede Inverse3 Gerät unterstützt bis zu 2 Oszillatoren (
oscillator: 0undoscillator: 1). - Sie können die Oszillatoren einzeln oder im Ganzen steuern.
- Einmal eingestellt, läuft der Oszillator so lange, bis er explizit geändert oder gestoppt wird ("set and forget"-Verhalten).
- Sie können den Oszillator mit einfachen Mitteln starten/stoppen
amplitudeKontrolle, eingestellt auf0zu stoppen.
Unterstützte Wellenformen
| Form Name | Beschreibung |
|---|---|
sine_wave | Glatte periodische Wellenform |
square_wave | Binäres Hoch/Tief-Signal |
triangle_wave | Winkelförmige sägezahnartige Welle |
saw_wave | Steigendes Rampensignal |
Parameter
| Parameter | Typ | Zwänge | Beschreibung |
|---|---|---|---|
oscillator | number | 0 oder 1 | Index des einzustellenden Oszillators |
shape | string | Siehe gestützte Formen oben | Art der zu erzeugenden Wellenform |
amplitude | number | Muss sein > 0 & < 10 | Schwingungsfestigkeit |
frequency | number | Muss sein > 5 (Hz) & < 20k (Hz) | Frequenz des Oszillators |
Alle Felder sind erforderlich
Befehle
set_oscillator
Weist einem Gerät einen einzelnen Oszillator zu.
{
"inverse3": [
{
"device_id": "04BA",
"commands": {
"set_oscillator": {
"oscillator": 0,
"shape": "sine_wave",
"amplitude": 0,
"frequency": 3000
}
}
}
]
}
set_oscillators
Weist mehrere Oszillatoren auf einmal zu. Sie können auch nur einen zuweisen, falls gewünscht.
{
"inverse3": [
{
"device_id": "04BA",
"commands": {
"set_oscillators": [
{
"oscillator": 0,
"shape": "sine_wave",
"amplitude": 0.2,
"frequency": 3000
},
{
"oscillator": 1,
"shape": "saw_wave",
"amplitude": 0.5,
"frequency": 80
}
]
}
}
]
}
Einstellungen
Zugehörige Einstellungsschlüssel:
Hinweis: Von der Verwendung von HTTP zur häufigen Änderung dieser Werte wird abgeraten. Bitte nutzen Sie den Simulationskanal.
features/synth/enabledfeatures/synth/oscillator1/shapefeatures/synth/oscillator1/amplitudefeatures/synth/oscillator1/frequencyfeatures/synth/oscillator2/shapefeatures/synth/oscillator2/amplitudefeatures/synth/oscillator2/frequency