DasMIDIPort-Interface derWeb MIDI API repräsentiert einen MIDI-Eingangs- oder -Ausgangsport.

EineMIDIPort-Instanz wird erstellt, wenn ein neues MIDI-Gerät angeschlossen wird. Daher gibt es keinen Konstruktor.

Instanz-Eigenschaften

MIDIPort.idSchreibgeschützt

Gibt einen String zurück, der die eindeutige ID des Ports enthält.

MIDIPort.herstellerSchreibgeschützt

Gibt einen String zurück, der den Hersteller des Ports enthält.

MIDIPort.nameSchreibgeschützt

Gibt einen String zurück, der den Systemnamen des Ports enthält.

MIDIPort.typeSchreibgeschützt

Gibt einen String zurück, der den Typ des Ports enthält, einer von:

"input"

DasMIDIPort ist ein Eingangsport.

"output"

DasMIDIPort ist ein Ausgangsport.

MIDIPort.versionSchreibgeschützt

Gibt einen String zurück, der die Version des Ports enthält.

MIDIPort.statusSchreibgeschützt

Gibt einen String zurück, der den Status des Ports enthält, einer von:

"disconnected"

Das Gerät, das diesesMIDIPort repräsentiert, ist vom System getrennt.

"connected"

Das Gerät, das diesesMIDIPort repräsentiert, ist derzeit verbunden.

MIDIPort.verbindungSchreibgeschützt

Gibt einen String zurück, der den Verbindungsstatus des Ports enthält, einer von:

"open"

Das Gerät, das diesesMIDIPort repräsentiert, wurde geöffnet und ist verfügbar.

"closed"

Das Gerät, das diesesMIDIPort repräsentiert, wurde nicht geöffnet oder wurde geschlossen.

"pending"

Das Gerät, das diesesMIDIPort repräsentiert, wurde geöffnet, aber dann getrennt.

Instanz-Methoden

Dieses Interface erbt auch Methoden vonEventTarget.

MIDIPort.open()

Macht das mit diesemMIDIPort verbundene MIDI-Gerät explizit verfügbar, und gibt einPromise zurück, das gelöst wird, sobald der Zugriff auf den Port erfolgreich war.

MIDIPort.close()

Macht das mit diesemMIDIPort verbundene MIDI-Gerät nicht verfügbar, indem derstate von"open" auf"closed" geändert wird. Dies gibt einPromise zurück, das gelöst wird, sobald der Port geschlossen wurde.

Ereignisse

statechange

Wird aufgerufen, wenn ein bestehender Port seinen Zustand oder seine Verbindung ändert.

Beispiele

Ports und deren Informationen auflisten

Das folgende Beispiel listet Eingangs- und Ausgangsports auf und zeigt Informationen über sie mithilfe der Eigenschaften vonMIDIPort an.

function listInputsAndOutputs(midiAccess) {  for (const entry of midiAccess.inputs) {    const input = entry[1];    console.log(      `Input port [type:'${input.type}'] id:'${input.id}' manufacturer: '${input.manufacturer}' name: '${input.name}' version: '${input.version}'`,    );  }  for (const entry of midiAccess.outputs) {    const output = entry[1];    console.log(      `Output port [type:'${output.type}'] id: '${output.id}' manufacturer: '${output.manufacturer}' name: '${output.name}' version: '${output.version}'`,    );  }}

Verfügbare Ports zu einer Auswahlliste hinzufügen

Das folgende Beispiel nimmt die Liste der Eingangsports und fügt sie einer Auswahlliste hinzu, damit ein Benutzer das gewünschte Gerät auswählen kann.

inputs.forEach((port, key) => {  const opt = document.createElement("option");  opt.text = port.name;  document.getElementById("port-selector").add(opt);});

Spezifikationen

Browser-Kompatibilität