Buttons
Button Support
Atom relies heavily on button inputs, making them the most important input method. MagiScript supports button press and release events from three devices:
- Atom, which has 12 buttons,
- PeekSmith 3, which has 3 buttons, and
- SB Watch, which has a single button (the crown).
Atom Hardware
Atom has 12 buttons, numbered from 0 to 11. They are in 4 rows, and there are 3 buttons per row.
Currently, there is no default layout or behavior associated with them, but the system reports button press-related events.
Events
MagiScript is receiving events via the onEvent function. The event structure is the same for the buttons:
- value: a string with the button ID
- type: “press”, “release” strings
- source: “atom:button”, “ps:button”, “sbwatch:button”
function onEvent(e) {
console.log(e.value, e.type, e.source);
}
Events Types
Different devices have different support.
- Atom supports press, release, click, longpress and repeatpress events.
- PeekSmith has press and release events only (for now, maybe a later firmware will introduce the same events as Atom).
- SB Watch supports press, release, click, longpress and repeatpress events, however sometimes a click event is coming with no button press (it is a bug, which might be fixed in the future).