Zum Hauptinhalt springen
Version: 3.5.x

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: 0 und oscillator: 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 amplitude Kontrolle, eingestellt auf 0 zu stoppen.

Unterstützte Wellenformen

Form NameBeschreibung
sine_waveGlatte periodische Wellenform
square_waveBinäres Hoch/Tief-Signal
triangle_waveWinkelförmige sägezahnartige Welle
saw_waveSteigendes Rampensignal

Parameter

ParameterTypZwängeBeschreibung
oscillatornumber0 oder 1Index des einzustellenden Oszillators
shapestringSiehe gestützte Formen obenArt der zu erzeugenden Wellenform
amplitudenumberMuss sein > 0 & < 10Schwingungsfestigkeit
frequencynumberMuss 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/enabled
  • features/synth/oscillator1/shape
  • features/synth/oscillator1/amplitude
  • features/synth/oscillator1/frequency
  • features/synth/oscillator2/shape
  • features/synth/oscillator2/amplitude
  • features/synth/oscillator2/frequency