MIDIPort

Thuộc tính phiên bản

MIDIPort.id Read only

Trả về một chuỗi chứa ID duy nhất của cổng.

MIDIPort.manufacturer Read only

Trả về một chuỗi chứa nhà sản xuất của cổng.

MIDIPort.name Read only

Trả về một chuỗi chứa tên hệ thống của cổng.

MIDIPort.type Read only

Trả về một chuỗi chứa loại cổng, một trong các giá trị:

"input"

MIDIPort là một cổng đầu vào.

"output"

MIDIPort là một cổng đầu ra.

MIDIPort.version Read only

Trả về một chuỗi chứa phiên bản của cổng.

MIDIPort.state Read only

Trả về một chuỗi chứa trạng thái của cổng, một trong các giá trị:

"disconnected"

Thiết bị mà MIDIPort này biểu thị đã bị ngắt kết nối khỏi hệ thống.

"connected"

Thiết bị mà MIDIPort này biểu thị hiện đang được kết nối.

MIDIPort.connection Read only

Trả về một chuỗi chứa trạng thái kết nối của cổng, một trong các giá trị:

"open"

Thiết bị mà MIDIPort này biểu thị đã được mở và có sẵn.

"closed"

Thiết bị mà MIDIPort này biểu thị chưa được mở, hoặc đã được đóng.

"pending"

Thiết bị mà MIDIPort này biểu thị đã được mở nhưng sau đó bị ngắt kết nối.

Phương thức phiên bản

Giao diện này cũng kế thừa các phương thức từ EventTarget.

MIDIPort.open()

Làm cho thiết bị MIDI được kết nối với MIDIPort này trở nên khả dụng rõ ràng, và trả về một Promise được giải quyết khi truy cập vào cổng thành công.

MIDIPort.close()

Làm cho thiết bị MIDI được kết nối với MIDIPort này không khả dụng, thay đổi state từ "open" thành "closed". Trả về một Promise được giải quyết khi cổng được đóng.

Sự kiện

statechange

Được gọi khi một cổng hiện có thay đổi trạng thái hoặc kết nối của nó.

Ví dụ

Liệt kê các cổng và thông tin của chúng

Ví dụ sau đây liệt kê các cổng đầu vào và đầu ra, và hiển thị thông tin về chúng sử dụng các thuộc tính của MIDIPort.

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}'`,
    );
  }
}

Thêm các cổng có sẵn vào danh sách chọn

Ví dụ sau đây lấy danh sách các cổng đầu vào và thêm chúng vào danh sách chọn, để người dùng có thể chọn thiết bị họ muốn sử dụng.

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

Thông số kỹ thuật

Tương thích trình duyệt