MIDIPort

MIDIPort.id Schreibgeschützt

Gibt eine Zeichenkette zurück, die die eindeutige ID des Ports enthält.

MIDIPort.manufacturer Schreibgeschützt

Gibt eine Zeichenkette zurück, die den Hersteller des Ports enthält.

MIDIPort.name Schreibgeschützt

Gibt eine Zeichenkette zurück, die den Systemnamen des Ports enthält.

MIDIPort.type Schreibgeschützt

Gibt eine Zeichenkette zurück, die den Typ des Ports enthält, eine von:

"input"

Das MIDIPort ist ein Eingangsport.

"output"

Das MIDIPort ist ein Ausgangsport.

MIDIPort.version Schreibgeschützt

Gibt eine Zeichenkette zurück, die die Version des Ports enthält.

MIDIPort.state Schreibgeschützt

Gibt eine Zeichenkette zurück, die den Status des Ports enthält, einer von:

"disconnected"

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

"connected"

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

MIDIPort.connection Schreibgeschützt

Gibt eine Zeichenkette zurück, die den Verbindungsstatus des Ports enthält, einer von:

"open"

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

"closed"

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

"pending"

Das Gerät, das dieses MIDIPort repräsentiert, wurde geöffnet, aber anschließend getrennt.

Dieses Interface erbt auch Methoden von EventTarget.

MIDIPort.open()

Macht das MIDI-Gerät, das mit diesem MIDIPort verbunden ist, explizit verfügbar und gibt ein Promise zurück, das aufgelöst wird, sobald der Zugriff auf den Port erfolgreich war.

MIDIPort.close()

Macht das MIDI-Gerät, das mit diesem MIDIPort verbunden ist, nicht verfügbar und ändert den state von "open" zu "closed". Dies gibt ein Promise zurück, das aufgelöst wird, sobald der Port geschlossen wurde.

statechange

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

Das folgende Beispiel listet Eingangs- und Ausgangsports auf und zeigt Informationen über sie mit Hilfe von MIDIPort-Eigenschaften 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}'`,
    );
  }
}

Das folgende Beispiel nimmt die Liste der Eingangsports und fügt sie einer Auswahlliste hinzu, damit der 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);
});