버전: 3.5.x

진동 발생기

:::경고: 실험적 기능 이 기능들은 지속적으로 발전 중인 실험적 기능들입니다.

API를 개선하고 더 많은 가치를 제공할 수 있도록 사용 사례에 따라 자유롭게 실험하고 피드백을 제공해 주세요.

사용법 및 시그니처가 변경될 수 있습니다. :::

이 기능은 Inverse3 디바이스에서 최대 두 개의 독립적인 오실레이터를 사용하여 프로그래밍 가능한 진동 출력을 제공합니다. 이는 기본적인 신디사이저 신호 발생기와 유사하게 작동하며, 각 오실레이터는 진폭과 주파수를 설정할 수 있는 파형을 생성할 수 있습니다.

오실레이터 기본 사항

각 Inverse3 장치는 최대 오실레이터 2개 (oscillator: 0 그리고 oscillator: 1).
오실레이터를 개별적으로 또는 일괄적으로 제어할 수 있습니다.
오실레이터는 일단 설정되면 명시적으로 변경하거나 중지할 때까지 실행됩니다("설정 후 잊어버림" 동작).
간단한 방법으로 오실레이터를 시작/정지할 수 있습니다. amplitude 컨트롤을 0 를 눌러 중지합니다.

지원되는 웨이브 모양

모양 이름	설명
`sine_wave`	부드러운 주기적 파형
`square_wave`	이진 하이/로우 신호
`triangle_wave`	톱니 모양의 각진 물결
`saw_wave`	상승 램프 신호

매개변수

매개변수	유형	제약 조건	설명
`oscillator`	`number`	0 또는 1	설정할 오실레이터의 인덱스
`shape`	`string`	위의 지원되는 도형 참조	생성할 파형 유형
`amplitude`	`number`	반드시 `> 0` & `< 10`	진동 강도
`frequency`	`number`	반드시 `> 5` (Hz) 및 `< 20k` (Hz)	발진기 주파수

모든 필드는 필수 입력 사항입니다.

명령

`set_oscillator`

장치에 단일 오실레이터를 할당합니다.

{
  "inverse3": [
    {
      "device_id": "04BA",
      "commands": {
        "set_oscillator": {
          "oscillator": 0,
          "shape": "sine_wave",
          "amplitude": 0,
          "frequency": 3000
        }
      }
    }
  ]
}

`set_oscillators`

한 번에 여러 오실레이터를 할당합니다. 원하는 경우 하나만 전달할 수도 있습니다.

{
  "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
          }
        ]
      }
    }
  ]
}

오실레이터 기본 사항​

지원되는 웨이브 모양​

매개변수​

명령​

set_oscillator​

set_oscillators​

설정​

오실레이터 기본 사항

지원되는 웨이브 모양

매개변수

명령

`set_oscillator`

`set_oscillators`

설정