4.1 requestMIDIAccess() 原文

partial interface Navigator {
    Promise<MIDIAccess> requestMIDIAccess (optional MIDIOptions options);
};

4.2 MIDIOptions ディクショナリ 原文

このディクショナリはrequestMIDIAccess要求に渡される、オプション設定を保持します。

dictionary MIDIOptions {
    boolean sysex;
};

4.3 MIDIInputMap インターフェース 原文

interface MIDIInputMap {
    readonly maplike<DOMString, MIDIInput>;
};

この型は現在使用可能なすべてのMIDI入力ポートを表すのに使用されます。これにより、次の書き方を可能にします

    // エントリーが幾つあるかを得る:
    var numberOfMIDIInputs = inputs.size;

    // それぞれのポートを<select>ボックスに追加する
    inputs.forEach( function( key, port ) {
      var opt = document.createElement("option");
      opt.text = port.name;
      document.getElementById("inputportselector").add(opt);
    });

    // あるいはECMAScript 6ではこのような書き方もできます:
    for (let input of inputs.values()) {
      var opt = document.createElement("option");
      opt.text = input.name;
      document.getElementById("inputportselector").add(opt);
    }

4.4 MIDIOutputMap インターフェース 原文

interface MIDIOutputMap {
    readonly maplike<DOMString, MIDIOutput>;
};

この型は現在使用可能なすべてのMIDI出力ポートを表すのに使用されます。これは次のような書き方を可能にします

    // エントリーが幾つあるかを得る:
    var numberOfMIDIOutputs = outputs.size;

    // それぞれのポートを<select> ボックスに追加する
    outputs.forEach( function( key, port ) {
      var opt = document.createElement("option");
      opt.text = port.name;
      document.getElementById("outputportselector").add(opt);
    });

    // あるいはECMAScript 6ではこのような書き方もできます:
    for (output of outputs.values()) {
      var opt = document.createElement("option");
      opt.text = input.name;
      document.getElementById("inputportselector").add(opt);
    }

4.5 MIDISuccessCallback 原文

callback MIDISuccessCallback = void (MIDIAccess access, MIDIOptions options);

5.1 属性 原文

inputs MIDIInputMap, readonly 型

システムで使用可能なMIDI入力ポートです。

onstatechange EventHandler型

新しいポートが接続された、あるいは既存のポートのstate属性が変化した時に呼ばれるハンドラーです。

このイベントハンドラーは、MIDIConnectionEvent型に対応し、 MIDIAccessインターフェースを実装した全てのオブジェクトでサポートされなくてはなりません(MUST)。

ユーザーエージェントは、これまで有効でなかったMIDIポートが有効になった時、あるいは既存のポートのstate属性が変化した時にはいつでも、 次のステップを実行しなくてはなりません(SHOULD )：

1. 新たに有効になったポート、 あるいはその既存のポートに対応するMIDIPort をportとします。
2. MIDIConnectionEvent型のeventを新たに作成し、 そのport属性にportをセットします。
3. eventをイベントオブジェクトとしてMIDIAccessにstatechangeイベントを発行します。

outputs MIDIOutputMap, readonly 型

システムで使用可能なMIDI出力ポートです。　

sysexEnabled boolean, readonly 型

この属性は、このMIDIAccess上でシステムエクスクルーシブのサポートが有効かどうかを示します。

6.1 属性 原文

connection MIDIPortConnectionState, readonly 型

デバイスの接続状態。

id DOMString, readonly 型

ポートのユニークIDです。 開発者はこれを、ユーザーがアプリケーション内で選択したポートを記憶しておくために使用できます。 ユーザーエージェントはidがそのポートだけのユニークなものである事を保証しなくてはなりません (MUST)。 ユーザーエージェントはそのidがアプリケーションのインスタンスをまたいで、 例えば、システムがリブートした時、 デバイスがシステムから取り外された時にも維持される事を保証しなくてはなりません(SHOULD)。 アプリケーションはMIDI設定を再現するため、これらのidをローカルにキャッシュしようとするかも知れません。 システムによっては完全に永続的なユニーク性を持つ識別手段をサポートしていないかも知れず、 そのような場合、別のインターフェースが接続されたりシステムから切断された時に識別を維持し続けるのは難易度が高くなるでしょう (これによって要求されたポートのインデックスがずれるかも知れません)。 システムはMIDI APIのインスタンスをまたいだポートのマッチングに最善の方法を取る事が期待されます： 例えばある実装ではポートインターフェースの製造者、名前、インデックスをなんらかの形でハッシュしてidとし、不透明な手段で 使用して、ポートが接続された時にポートのidが一致するものを参照するかも知れません。 アプリケーションはMIDIPortのidの比較を品質のテストのために使用するかも知れません。

manufacturer DOMString, readonly , nullable　型

ポートの製造者名です。

name DOMString, readonly , nullable　型

ポートのシステム名です。

onstatechange EventHandler　型

存在していたポートの状態が変化した時、または接続された時に呼び出されるハンドラーです。

このstatechange型のイベントハンドラーは MIDIPortインターフェースを 実装するすべてのオブジェクトでサポートされなくてはなりません(MUST)。

state MIDIPortDeviceState, readonly 型

デバイスの状態です。

type MIDIPortType, readonly 型

そのポートが入力ポートか出力ポートかを区別する識別子です。 MIDIOutputの場合、 これは"output"にならなくてはなりません(MUST)。 MIDIInputの場合、 これは"input"にならなくてはなりません(MUST)。

version DOMString, readonly , nullable　型

ポートのバージョンです。

6.2 メソッド 原文

close

MIDIPortに対応するMIDIデバイスを 明示的に使用不能にします(この後状態は"open"から"connected"になります)。 このメソッドの呼び出しが成功すると (新しいハンドラーの設定による暗黙的なopen()にかかわらず)MIDIメッセージはMIDI入力ポートのMIDIMessageEventハンドラーに もう伝達されなく事に注意してください。

下層の実装はこの呼び出しに対して何もする必要がないかも知れません。 しかしながら下層の実装によってはMIDIデバイスへの共有アクセスをサポートしていないかも知れないため、 明示的なclose()呼び出しはMIDIアプリケーションに他のアプリケーションにデバイスへのアクセス を取得する事が可能な事を保証します。

呼び出された時、このメソッドはユーザーのシステム上で指定のMIDIポートへのアクセス 要求をあらわすPromiseオブジェクトを返します。 ポートがクローズされた時、(つまり排他的なアクセスのシステムではそのポートが他の アプリケーションから使用可能になった時)、PromiseのresolveCallback がMIDIPortを 引数として呼び出されます。 もしポートが切断された場合、(設定されていれば)PromiseのrejectCallbackが 呼び出されます。

close()メソッドが呼び出された時、ユーザーエージェントは MIDIPortクローズのアルゴリズム を実行しなくてはなりません(MUST):

1. 新たにPromiseオブジェクト、promiseを作成し、resolverを 対応するリゾルバーとします。

2. promiseを返却し、次のステップを非同期に実行します。

3. portを与えられたMIDIPortオブジェクトとします。

4. もし、portが既に閉じられている(その.connectionが "closed"、例えばそのポートがまだ暗黙的にも明示的にも オープンされていない、あるいはこのMIDIPortでclose()が既に呼ばれている)場合、下のclosed ラベルに飛びます。

5. もしそのポートが入力ポートの場合、次のステップに進みます。 もし出力ポートで.stateが "connected"で ない場合、すべての保留されている送信データをクリアし、次のステップに進みます。 タイムスタンプが未来のシステム内の保留されている送信データをすべてクリアし、 次のステップに進む前にタイムスタンプが過去または現在のすべての送信メッセージの送信を終了します。

6. 下層のシステムをオープンしているならポートへのアクセスをすべてクローズし、 下層システムのブロックしているリソースを解放します。

7. 成功: MIDIPortのconnection属性を"closed"に 変更し、新しいMIDIConnectionEvent をMIDIAccessのstatechangeハンドラーおよび、MIDIPortのstatechangeハンドラーに発行します。

8. クローズ: resolverのaccept(value)メソッドをportを引数として呼び出します。

9. これらのステップの実行を終了します。

10. 失敗: DOMExceptionを新たに作成し、errorとします。 ポートが切断された場合、この例外の.nameは"InvalidStateError"でなくてはなりません。

11. resolverのreject(value)メソッドを errorを引数として呼び出します。

パラメーターなし。

戻り値の型: Promise<MIDIPort>

open

MIDIPortに対応するMIDIデバイスを明示的に 使用可能にします。 この呼び出しはMIDIPortを使用するために 必須のものではない事に注意してください - MIDIOutputのsend() の呼び出し、またはMIDIInputPortにMIDIMessageEventハンドラーを設定する事で暗黙的にopen()を実行する 事ができます。 下層の実装はこの呼び出しに対して何もする必要がないかも知れません。 しかしながら下層の実装によってはMIDIデバイスへの共有アクセスをサポートしていないかも知れないため、 明示的なopen()およびclose()呼び出しを使う事でMIDIアプリケーションがデバイスへの排他アクセスを予想して 制御する事が可能になります。

呼び出された時、このメソッドは与えられたユーザーシステムのMIDIポートへのアクセス要求を表す Promiseオブジェクトを返します。

もしそのポートが"connected" 状態であってポートへのアクセスが取得できれば(そしてそのポートで入出力が可能になれば)、 PromiseのresolveCallbackがMIDIPortオブジェクトを引数として 呼び出されます。

connected状態のポートへのアクセスができなかった場合(例えば、排他的アクセスシステムの プラットフォームでそのポートが既に使用中になっていた場合)、Promiseは(設定されていれば) rejectCallbackを呼び出します。

もしcode>"disconnected" 状態のポートに対してopen()が呼び出された場合、 そのポートの.connectionは ポートが"connected" 状態に移行するかすべての参照が無くなるまで、 "pending"に遷移します。

このメソッドが呼び出された時、ユーザーエージェントは MIDIPortオープンのアルゴリズムを実行します (MUST):

1. 新しいPromiseオブジェクト、promiseを作成し、 結び付けられるリゾルバーをresolverとします。

2. promiseを返却し、次のステップを非同期的に実行します。

3. portを与えられたMIDIPortオブジェクトとします。

4. もしデバイスの状態が既に"open" の場合、(例えば このMIDIPortのopen()が既に呼ばれている、または暗黙的にオープンされている場合)、 下のopenedラベルのステップにジャンプします。

5. もしデバイスの状態が"pending" の場合(例えば既にオープンされ、その後デバイスが切断されている場合)、 下のopenedラベルのステップにジャンプします。

6. もしデバイスの状態が"disconnected"の場合、 MIDIPort のstate属性は "pending"に変化し、 新しいMIDIConnectionEvent がMIDIAccessの statechangeハンドラーと MIDIPortのstatechangeハンドラーに発行され、 下のopenedラベルのステップにジャンプします。

7. システム内のMIDIデバイスへのアクセスの取得を試みます。 もしそのデバイスが使用不能の場合(例えば、既に他のプロセスで使用されていてオープンできない、あるいは切断された場合) 下の失敗ラベルのステップにジャンプします。 もしそのデバイスが使用可能でアクセスを取得できた場合、次のステップを続けます。

8. 成功: MIDIPortのstate属性を"opened"に変更し、 新しいMIDIConnectionEvent をMIDIAccessの statechangeハンドラーと MIDIPortの statechangeハンドラーに 発行します。

9. もしこのポートが出力ポートで何らかの送信待ちの保留データを持っている場合、 そのデータの送信を非同期に開始します。

10. opened: resolverのaccept(value)メソッドをportを 引数として呼び出します。

11. これらのステップの実行を終了します。Terminate these steps.

12. 失敗: 新たなDOMException、errorを作成します。 この例外の.nameは、もしポートが使用不能の場合、"InvalidAccessError"、 また、ポートが切断されている場合は"InvalidStateError"となります。

13. resolverのreject(value)メソッドを errorを引数として呼び出します。

パラメーターなし。

戻り値の型: Promise<MIDIPort>

6.3 MIDIInput インターフェース 原文

interface MIDIInput : MIDIPort {
                attribute EventHandler onmidimessage;
};

MIDIInputに対応するMIDIポートが 1つ以上のMIDIメッセージを受信した際にはいつでも、ユーザーエージェントは以下のステップを実行しなくてはなりません (MUST)：

1. portを対象のMIDIInputとします。

2. もしMIDIAccess がシステムエクスクルーシブを許可されておらず、そのメッセージがシステムエクスクルーシブの場合はこの手順を中断します。

3. 新たにMIDIMessageEvent を作成してeventとし、 timestamp属性はシステムがメッセージを受信した時刻、 data属性は単一のMIDIメッセージを表すUint8ArrayのMIDIデータのバイト配列に設定します。

4. eventportに対して midimessageイベントを発行します。

特に注意を要するのは、入力ストリームの他のメッセージの途中でMIDIシステムリアルタイムメッセージが発生した時です。 この場合、そのシステムリアルタイムメッセージは発生する度にディスパッチされ、通常のメッセージはそれが完結するまで バッファされます (完結後ディスパッチされます)。

6.4 MIDIOutput インターフェース 原文

interface MIDIOutput : MIDIPort {
    void send (sequence<octet> data, optional double timestamp);
    void clear ();
};

7.1 属性 原文

data Uint8Array, readonly 型

1つのMIDIメッセージのデータのバイト列を含むUint8Arrayです。

receivedTime double, readonly 型

イベントがいつ発生したのかを示すDOMHighResTimeStampです。

注

DOM4イベントオブジェクトは現在時刻を表すtimeStampメンバーを持っていますが、 その精度は低く、(DOMTimeStampは整数値でミリ秒を表します)、 また異なる時刻0の原点を取ります(DOMTimeStampは1970年1月1日 00:00:00 UTCからのミリ秒)。 そのため、MIDIアプリケーションで使用するには適切ではありません。

7.2 MIDIMessageEventInit インターフェース 原文

dictionary MIDIMessageEventInit : EventInit {
    double     receivedTime;
    Uint8Array data;
};

8.1 属性 原文

port MIDIPort, readonly 型

接続または切断されたポートです。

8.2 MIDIConnectionEventInit インターフェース 原文

dictionary MIDIConnectionEventInit : EventInit {
    MIDIPort port;
};