MIDI Extension

extensions/MasterMath/midi.js

@@ -0,0 +1,246 @@
+// Name: MIDI
+// ID: midi
+// Description: An extension that retrieves input from MIDI devices.
+// By: -MasterMath- <https://scratch.mit.edu/users/-MasterMath-/>
+// License: MPL-2.0
+
+(function (Scratch) {
+  "use strict";
+
+  if (!Scratch.extensions.unsandboxed) {
+    alert("This MIDI extension must run unsandboxed!");
+    throw new Error("This MIDI extension must run unsandboxed!");
+  }
+
+  let midiInputDevices = [];
+  let midiDeviceInfo = [];
+  let notesOn = [];
+  let noteVelocities = [];
+  let lastNotePressed = 0;
+  let lastNoteReleased = 0;
+
+  if (navigator.requestMIDIAccess) {
+    navigator.requestMIDIAccess().then(onSuccess, onError);
+
+    function onSuccess(midiAccess) {
+      midiAccess.onstatechange = (event) => {
+        if (event.port.state == "connected") {
+          midiInputDevices.push([
+            `[id: "${event.port.id}"` + ` name: "${event.port.name}"]`,
+          ]);
+          midiDeviceInfo.push([event.port.id, event.port.name]);
+        } else if (event.port.state == "disconnected") {
+          midiInputDevices.splice(
+            [`[id: "${event.port.id}"` + ` name: "${event.port.name}"]`],
+            1
+          );
+          midiDeviceInfo.splice([event.port.id, event.port.name]);
+        }
+      };
+
+      function onMIDIMessage(event) {
+        const [status, note, velocity] = event.data;
+        const command = status & 0xf0;
+        if (command === 0x90 && velocity > 0) {
+          notesOn.push(note);
+          noteVelocities.push([note, velocity]);
+          lastNotePressed = note;
+          Scratch.vm.runtime.startHats("midi_whenAnyNote", {
+            pressedReleased: "pressed",
+          });
+          Scratch.vm.runtime.startHats("midi_whenNote", {
+            note: note,
+            pressedReleased: "pressed",
+          });
+        } else if (command === 0x80 || (command === 0x90 && velocity === 0)) {
+          lastNoteReleased = note;
+          notesOn.splice(notesOn.indexOf(note), 1);
+          noteVelocities.splice(
+            noteVelocities.findIndex((subArray) => subArray[0] === note),
+            1
+          );
+          Scratch.vm.runtime.startHats("midi_whenAnyNote", {
+            pressedReleased: "released",
+          });
+          Scratch.vm.runtime.startHats("midi_whenNote", {
+            note: note,
+            pressedReleased: "released",
+          });
+        } else {
+          console.log(
+            `Other MIDI Message: Status=${status}, Note=${note}, Velocity=${velocity}, Timestamp ${event.timeStamp}`
+          );
+        }
+      }
+
+      midiAccess.inputs.forEach((entry) => {
+        entry.onmidimessage = onMIDIMessage;
+      });
+    }
+
+    function onError(err) {
+      alert("MIDI Access Error:", err);
+      throw new Error("MIDI Access Error:", err);
+    }
+  } else {
+    alert("MIDI is not supported on this browser.");
+    throw new Error("MIDI is not supported on this browser.");
+  }
+
+  class MIDI {
+    getInfo() {
+      return {
+        id: "midi",
+        name: "MIDI",
+        blocks: [
+          {
+            opcode: "MIDIinputDevices",
+            blockType: Scratch.BlockType.REPORTER,
+            text: "connected MIDI input devices",
+            disableMonitor: true,
+          },
+          {
+            opcode: "midiDeviceInfo",
+            blockType: Scratch.BlockType.REPORTER,
+            text: "[info] of MIDI device [number]",
+            arguments: {
+              info: {
+                type: Scratch.ArgumentType.STRING,
+                defaultValue: "name",
+                menu: "infoMenu",
+              },
+              number: {
+                type: Scratch.ArgumentType.NUMBER,
+                defaultValue: 0,
+              },
+            },
+          },
+          "---",
+          {
+            opcode: "whenAnyNote",
+            blockType: Scratch.BlockType.EVENT,
+            text: "when any note [pressedReleased]",
+            isEdgeActivated: false,
+            shouldRestartExistingThreads: true,
+            arguments: {
+              pressedReleased: {
+                type: Scratch.ArgumentType.STRING,
+                defaultValue: "pressed",
+                menu: "pressedReleased",
+              },
+            },
+          },
+          {
+            opcode: "whenNote",
+            blockType: Scratch.BlockType.EVENT,
+            text: "when note [note] [pressedReleased]",
+            isEdgeActivated: false,
+            shouldRestartExistingThreads: true,
+            arguments: {
+              note: {
+                type: Scratch.ArgumentType.NOTE,
+                defaultValue: 60,
+              },
+              pressedReleased: {
+                type: Scratch.ArgumentType.STRING,
+                defaultValue: "pressed",
+                menu: "pressedReleased",
+              },
+            },
+          },
+          {
+            opcode: "noteOn",
+            blockType: Scratch.BlockType.BOOLEAN,
+            text: "is note [note] on?",
+            arguments: {
+              note: {
+                type: Scratch.ArgumentType.NOTE,
+                defaultValue: 60,
+              },
+            },
+          },
+          {
+            opcode: "noteVelocity",
+            blockType: Scratch.BlockType.REPORTER,
+            text: "velocity of note [note]",
+            arguments: {
+              note: {
+                type: Scratch.ArgumentType.NOTE,
+                defaultValue: 60,
+              },
+            },
+          },
+          {
+            opcode: "activeNotes",
+            blockType: Scratch.BlockType.REPORTER,
+            text: "all active notes",
+            disableMonitor: true,
+          },
+          {
+            opcode: "lastNote",
+            blockType: Scratch.BlockType.REPORTER,
+            text: "last note [pressedReleased]",
+            disableMonitor: true,
+            arguments: {
+              pressedReleased: {
+                type: Scratch.ArgumentType.STRING,
+                defaultValue: "pressed",
+                menu: "pressedReleased",
+              },
+            },
+          },
+        ],
+        menus: {
+          infoMenu: {
+            acceptReporters: false,
+            items: ["name", "id"],
+          },
+          pressedReleased: {
+            acceptReporters: false,
+            items: ["pressed", "released"],
+          },
+        },
+      };
+    }
+
+    MIDIinputDevices() {
+      return midiInputDevices;
+    }
+
+    midiDeviceInfo(args) {
+      if (midiInputDevices[args.number] != null) {
+        return midiDeviceInfo[args.number][args.info == "id" ? 0 : 1];
+      } else {
+        return;
+      }
+    }
+
+    noteOn(args) {
+      return notesOn.includes(Number(args.note));
+    }
+
+    noteVelocity(args) {
+      if (
+        notesOn.includes(args.note) &&
+        noteVelocities.find((subArray) => subArray[0] === args.note)[1] !==
+          undefined
+      ) {
+        return noteVelocities.find((subArray) => subArray[0] === args.note)[1];
+      }
+    }
+
+    activeNotes() {
+      return notesOn;
+    }
+
+    lastNote({ pressedReleased }) {
+      if (pressedReleased == "pressed") {
+        return lastNotePressed;
+      } else {
+        return lastNoteReleased;
+      }
+    }
+  }
+
+  Scratch.extensions.register(new MIDI());
+})(Scratch);

extensions/extensions.json

@@ -37,6 +37,7 @@
   "veggiecan/browserfullscreen",
   "shreder95ua/resolution",
   "XmerOriginals/closecontrol",
+  "MasterMath/midi",
   "navigator",
   "battery",
   "PwLDev/vibration",