Presentation API

制御側ユーザーエージェント はMUST 次のpartial interfaceを実装しなければなりません:

WebIDLpartial interface Presentation {
  attribute PresentationRequest? defaultRequest;
};

defaultRequest 属性は MUST デフォルトプレゼンテーションリクエストが設定されている場合はそれを返し、 そうでなければ null を返します。設定時には、デフォルトプレゼンテーションリクエストを新しい値に必ず MUST 設定しなければなりません。

制御側ユーザーエージェントは、SHOULD ユーザーがブラウザのクロムでボタンをクリックするなど、ユーザー操作によって意図が示された時のみ デフォルトプレゼンテーションリクエストを使用してプレゼンテーションを開始するべきです。

デフォルトプレゼンテーションリクエストを使ってプレゼンテーションを開始する場合、 制御側ユーザーエージェントは必ず MUST デフォルトプレゼンテーションリクエストからプレゼンテーションを開始する 手順に従う必要があります。

デフォルトプレゼンテーションリクエストによるプレゼンテーション開始のサポートは OPTIONAL です。

受信側ユーザーエージェントは MUST 次のpartial interfaceを実装しなければなりません:

WebIDLpartial interface Presentation {
  readonly attribute PresentationReceiver? receiver;
};

receiver 属性は MUST PresentationReceiver インスタンスを返します。 これは、受信側ブラウジングコンテキストに関連付けられ、 受信側ユーザーエージェントが 受信側ブラウジングコンテキストを 作成したときに生成されます。 その他の ブラウジングコンテキスト （child navigable を含む）では、必ず MUST null を返します。

PresentationRequest コンストラクターが呼び出されたとき、 制御側ユーザーエージェントは MUST 以下の手順を実行します:

入力

url または urls、プレゼンテーションリクエストURL

出力

新しい PresentationRequest オブジェクト

1. ドキュメントオブジェクトのactive sandboxing flag setに sandboxed presentation browsing context flag が設定されている場合、SecurityError を投げて手順を中断する。
2. urls が空のシーケンスの場合、 throwし、 NotSupportedError を投げて残りの手順を中断する。
3. 単一の url が与えられた場合、urls を url 1件のみを含む配列にする。
4. presentationUrls を空のURLリストとして初期化する。
5. urls の各URL U について:
   1. A を current settings object で指定されたAPIベースURLを基準に U をパースした結果の絶対URLとする。
   2. URLの解析アルゴリズムが失敗した場合、 throwし、 SyntaxError 例外で残りの手順を中断する。
   3. A のスキームが 制御側ユーザーエージェントによりサポートされていれば、 presentationUrls に A を追加する。
6. presentationUrls が空リストの場合、 NotSupportedError を投げて残りの手順を中断する。
7. presentationUrls のいずれかが potentially trustworthy URL でない場合、 SecurityError を投げて手順を中断する。
8. presentationUrls を プレゼンテーションリクエストURL として持つ新しい PresentationRequest オブジェクトを構築し、返す。

start メソッドが呼び出されたとき、 ユーザーエージェントは MUST 以下の手順で プレゼンテーションディスプレイの選択 を行います。

入力

presentationRequest、PresentationRequest オブジェクト（startを呼び出したもの）

出力

新しい Promise

1. ドキュメントのactive windowに transient activationがない場合、 Promise を InvalidAccessError でrejectし、手順を中断する。
2. topContext を トップレベルブラウジングコンテキスト （制御側ブラウジングコンテキストのもの）とする。
3. topContextまたはその 子孫ナビゲーブルのいずれかに 以前の startの呼び出しによる 未解決の Promise がすでに存在する場合、 新しい Promise を OperationError でrejectし、 残りの手順を中断する。
4. P を新しい Promise とする。
5. P を返す。ただし、以下の手順を並行して実行し続ける。
6. ユーザーエージェントが 利用可能なプレゼンテーションディスプレイ一覧の監視 をしていなければ、利用可能なプレゼンテーションディスプレイ一覧の監視の手順を 並行して実行する。
7. presentationUrls を presentationRequest の プレゼンテーションリクエストURLとする。
8. ユーザーにプレゼンテーションディスプレイの利用と 1台のディスプレイ選択についての許可を求める。
9. 以下のいずれかが真の場合:
   1. 利用可能なプレゼンテーションディスプレイ一覧 が空であり、ユーザー許可リクエスト完了まで空のままである場合
   2. 利用可能なプレゼンテーションディスプレイ一覧 内に presentationUrls のいずれかに対する 利用可能なプレゼンテーションディスプレイ が存在しない場合
   次の手順を実行する:
   1. Presentation APIタスクをキューに入れ reject P を NotFoundError 例外でrejectする。
   2. 残りの手順を中断する。
10. ユーザーがディスプレイの利用を 拒否 した場合、 Presentation APIタスクをキューに入れ P を NotAllowedError 例外でrejectし、残りの手順を中断する。
11. それ以外の場合、ユーザーがディスプレイ利用を 許可 した場合、D をそのディスプレイとする。
12. presentationRequest、D、Pで プレゼンテーション接続開始の手順を実行する。

ユーザーがブラウザクロム（専用ボタン、ユーザー操作、その他のシグナルなど）を使ってドキュメントのプレゼンテーションをプレゼンテーションディスプレイで開始する意図を示した場合、そのユーザーエージェントは MUST 以下の手順を実行して デフォルトプレゼンテーションリクエストからプレゼンテーションを開始する。 ドキュメントに デフォルトプレゼンテーションリクエスト が設定されていない場合、これらの手順は MUST 実行しないこと。

入力

W：ユーザーがプレゼンテーション開始の意図を示したドキュメント

presentationRequest：W に設定された navigator.presentation.defaultRequest の非null値

D：プレゼンテーションのターゲットとなる プレゼンテーションディスプレイ

1. 以下の手順を並行して実行する。
2. presentationUrls を presentationRequest の プレゼンテーションリクエストURLとする。
3. Dが presentationRequestの プレゼンテーションリクエストURL のいずれにも 利用可能なプレゼンテーションディスプレイ でない場合は、これらの手順を中断する。
4. presentationRequest と D で プレゼンテーション接続開始の手順を実行する。

ユーザーエージェントが プレゼンテーション接続開始を行う場合、 MUST 以下の手順を実行する：

入力

presentationRequest：プレゼンテーション接続開始に使う PresentationRequest

D：選択された プレゼンテーションディスプレイ

P：新しい Promise で解決される（任意） プレゼンテーション接続

1. Assert：これは 並行して実行されている。
2. I を新しい 有効なプレゼンテーション識別子（既知の 管理中プレゼンテーションの集合内で プレゼンテーション識別子と一意）の値とする。 フィンガープリント対策のため、実装は SHOULD プレゼンテーション識別子を [rfc4122]の4.4または4.5形式で生成した UUIDに設定することが推奨される。
3. 新しい PresentationConnection S を作成する。
4. S の プレゼンテーション識別子に I を設定する。
5. presentationUrls を presentationRequest の プレゼンテーションリクエストURLとする。
6. S の プレゼンテーションURLを、 presentationUrlsのうち 利用可能なプレゼンテーションディスプレイ一覧に (presentationUrl, D)が存在する最初のpresentationUrlに設定する。
7. S の プレゼンテーション接続状態を connectingに設定する。
8. S を 管理中プレゼンテーションの集合 に追加する。
9. P が与えられていれば、 Presentation APIタスクをキューに入れ resolve P を Sで解決する。
10. Presentation APIタスクをキューに入れて、 connectionavailableイベントを PresentationConnectionAvailableEvent インターフェースで、connection 属性を S で初期化して presentationRequest 上で発火する。イベントはバブルせず、キャンセル不可。
11. U を D に接続されているユーザーエージェントとする。
12. 次の手順が失敗した場合、残りの手順を中断し、 プレゼンテーション接続終了 S を error と closeReason・人間可読なcloseMessageで終了する。
13. 実装固有メカニズムで U に 受信側ブラウジングコンテキストの作成を D, presentationUrl, I を引数に指示する。
14. プレゼンテーション接続確立を S で行う。

reconnect メソッドが呼び出されたとき、ユーザーエージェントはMUST以下の手順でプレゼンテーションに再接続を行う：

入力

presentationRequest：PresentationRequest オブジェクト（reconnectが呼ばれたもの）

presentationId：有効なプレゼンテーション識別子

出力

P：新しいPromise

1. P を新しいPromiseとする。
2. Pを返し、以下の手順を並行して実行し続ける。
3. 管理中プレゼンテーションの集合から、 以下の条件を満たすPresentationConnectionを検索する：
   • その制御側ブラウジングコンテキストが現在のブラウジングコンテキストである
   • そのプレゼンテーション接続状態が terminatedでない
   • そのプレゼンテーションURLが presentationRequestのプレゼンテーションリクエストURLのいずれかと等しい
   • そのプレゼンテーション識別子がpresentationIdと等しい
4. そのようなPresentationConnectionが存在する場合、以下の手順を実行する：
   1. existingConnectionをそのPresentationConnectionとする。
   2. Presentation APIタスクをキューに入れ resolve P を existingConnectionで解決する
   3. existingConnectionのプレゼンテーション接続状態が connecting または connectedの場合、残りの手順を中断する。
   4. existingConnectionのプレゼンテーション接続状態を connectingに設定する
   5. プレゼンテーション接続確立を existingConnectionで行う
   6. 残りの手順を中断する
5. 管理中プレゼンテーションの集合から、 以下の条件を満たす最初のPresentationConnectionを検索する：
   • その制御側ブラウジングコンテキストが現在のブラウジングコンテキストでない
   • そのプレゼンテーション接続状態が terminatedでない
   • そのプレゼンテーションURLが presentationRequestのプレゼンテーションリクエストURLのいずれかと等しい
   • そのプレゼンテーション識別子がpresentationIdと等しい
6. そのようなPresentationConnectionが存在する場合、以下の手順を実行する：
   1. existingConnectionをそのPresentationConnectionとする。
   2. 新しいPresentationConnection newConnectionを作成する。
   3. newConnectionのプレゼンテーション識別子をpresentationIdに設定する。
   4. newConnectionのプレゼンテーションURLを existingConnectionのプレゼンテーションURLに設定する。
   5. newConnectionのプレゼンテーション接続状態を connectingに設定する。
   6. newConnectionを管理中プレゼンテーションの集合に追加する。
   7. Presentation APIタスクをキューに入れ resolve P を newConnectionで解決する。
   8. Presentation APIタスクをキューに入れ connectionavailableイベントを PresentationConnectionAvailableEvent インターフェースで、connection 属性を newConnection で初期化して presentationRequest 上で発火する。イベントはバブルせず、キャンセル不可。
   9. プレゼンテーション接続確立を newConnectionで行う。
   10. 残りの手順を中断する。
7. Presentation APIタスクをキューに入れて reject P を NotFoundError例外でrejectする。

以下は、PresentationRequest インターフェースを実装するオブジェクトが、イベントハンドラIDL属性としてサポートしなければならない （および対応するイベントハンドライベントタイプ）の一覧です：

ユーザーエージェントは MUST プレゼンテーション可用性オブジェクトの集合（getAvailability メソッドによって作成される）を管理しなければなりません。プレゼンテーション可用性オブジェクトの集合は、初期は空のタプル集合(A, availabilityUrls)として表現されます。ここで：

1. A：生存中の PresentationAvailability オブジェクト
2. availabilityUrls：PresentationRequest の presentation request URLs のリスト（getAvailability 呼び出し時点）

ユーザーエージェントは MUST 利用可能なプレゼンテーションディスプレイ一覧 を保持しなければなりません。利用可能なプレゼンテーションディスプレイ一覧は、タプル (availabilityUrl, display) のリストとして表現されます。このリストのエントリは display が現在 availabilityUrl に対する 利用可能なプレゼンテーションディスプレイ であることを示します。この プレゼンテーションディスプレイのリストは新しいプレゼンテーション開始に使用可能であり、実装固有の発見メカニズムに基づいて構成されます。利用可能なプレゼンテーションディスプレイ一覧の監視アルゴリズムの最新結果に設定されます。

プレゼンテーション可用性オブジェクトの集合が空でない間、ユーザーエージェントは MAY 利用可能なプレゼンテーションディスプレイ一覧の監視を継続し、ページが value プロパティを用いて利用可能なディスプレイがある時だけ提示できるようにします。ただし、ユーザーエージェントはバックグラウンドでの可用性監視を常にサポートしているとは限りません（例：プラットフォームや消費電力制限）。その場合、Promiseは getAvailability の呼び出しで reject され、利用可能なプレゼンテーションディスプレイ一覧の監視は プレゼンテーションディスプレイの選択アルゴリズムの一部としてのみ実行されます。

プレゼンテーション可用性オブジェクトの集合が空の場合 （つまり監視対象の availabilityUrls がない場合）、ユーザーエージェントは SHOULD NOT 利用可能なプレゼンテーションディスプレイ一覧の監視を行うべきではありません（ 省電力非機能要件のため）。さらに省電力のため、ユーザーエージェントは PresentationAvailability オブジェクトを保持しているページがフォアグラウンドにあるかどうかも管理してもよいです。これにより、実装固有の プレゼンテーションディスプレイ発見処理の再開／一時停止が可能となります。

getAvailability メソッドが呼び出されたとき、ユーザーエージェントは MUST 以下の手順を実行します：

入力

presentationRequest：PresentationRequest オブジェクト（getAvailabilityを呼び出したもの）

出力

新しい Promise

1. P を presentationRequest の JavaScriptレルム で構築した新しい Promise とする。
2. P を返し、以下の手順を 並行して実行し続ける。
3. ユーザーエージェントがバックグラウンドで 利用可能なプレゼンテーションディスプレイ一覧の監視 を継続できないが、後でプレゼンテーションディスプレイを発見して接続開始はできる場合、以下の手順を実行する：
   1. Presentation APIタスクをキューに入れ reject P を NotSupportedError 例外でrejectする。
   2. 残りの手順を中断する。
4. presentationRequest の プレゼンテーションディスプレイ可用性 が null でない場合、以下の手順を実行する：
   1. Presentation APIタスクをキューに入れ resolve P をリクエストの プレゼンテーションディスプレイ可用性 で解決する。
   2. 残りの手順を中断する。
5. presentationRequest の プレゼンテーションディスプレイ可用性 を presentationRequest の JavaScriptレルム で新規作成した PresentationAvailability オブジェクトに設定し、Aとする。
6. タプル (A, presentationUrls) を作成し、プレゼンテーション可用性オブジェクトの集合に追加する。
7. 利用可能なプレゼンテーションディスプレイ一覧の監視アルゴリズムを実行する。
   注

   監視アルゴリズムは、直前のステップで集合に追加されたタプルを反映するために少なくとももう一度実行しなければなりません。
8. Presentation APIタスクをキューに入れて resolve P を A で解決する。

プレゼンテーション可用性オブジェクトの集合が空でない場合、または プレゼンテーションディスプレイの選択 の保留リクエストがある場合、ユーザーエージェントは MUST 利用可能なプレゼンテーションディスプレイ一覧の監視を次の手順で実行しなければなりません：

1. Assert：これは 並行して実行中である。
2. availabilitySet を プレゼンテーション可用性オブジェクトの集合の浅いコピーとする。
3. プレゼンテーションディスプレイの選択の保留リクエストがあり、かつ PresentationRequest の プレゼンテーションディスプレイ可用性 が null なら、以下のサブステップを実行する：
   1. A を新規作成した PresentationAvailability オブジェクトとする。
   2. タプル (A, presentationUrls) を作成し、 presentationUrlsは PresentationRequest の presentation request URLsとし、availabilitySetに追加する。
4. newDisplays を空リストとする。
5. ユーザーエージェントが プレゼンテーションディスプレイの取得不能（例：ユーザーが機能を無効化）なら、次のステップをスキップする。
6. 実装固有メカニズムで プレゼンテーションディスプレイを取得し、newDisplaysに設定する。
7. 利用可能なプレゼンテーションディスプレイ一覧を空リストに設定する。
8. availabilitySet の各 (A, availabilityUrls) について、以下の手順を実行する：
   1. previousAvailability を A の value プロパティの値とする。
   2. newAvailability を false とする。
   3. availabilityUrls の各 availabilityUrl について以下を実行：
      1. newDisplays の各 display について、display が availabilityUrl の 利用可能なプレゼンテーションディスプレイなら以下を実行：
         1. タプル (availabilityUrl, display) を 利用可能なプレゼンテーションディスプレイ一覧に（同一タプルが未挿入なら）挿入。
         2. newAvailability を true に設定。
   4. A の value プロパティが未初期化なら newAvailability を設定し、次のステップをスキップ。
   5. previousAvailability と newAvailability が異なる場合、Presentation APIタスクをキューに入れて以下を実行：
      1. A の value プロパティを newAvailability に設定。
      2. change イベントを A で発火。

プレゼンテーションディスプレイ可用性 オブジェクトがガベージコレクション対象となった際、ユーザーエージェントは SHOULD 以下の手順を実行する：

1. A をガベージコレクションされた PresentationAvailability オブジェクトとする。
2. プレゼンテーション可用性オブジェクトの集合から (A, availabilityUrl) を検索して削除する。
3. プレゼンテーション可用性オブジェクトの集合が空になり、プレゼンテーションディスプレイの選択 の保留リクエストもなければ、省電力目的で 利用可能なプレゼンテーションディスプレイ一覧の監視 の保留タスクをキャンセルし、利用可能なプレゼンテーションディスプレイ一覧を空リストにする。

WebIDL[SecureContext, Exposed=Window]
interface PresentationConnectionAvailableEvent : Event {
  constructor(DOMString type, PresentationConnectionAvailableEventInit eventInitDict);
  [SameObject] readonly attribute PresentationConnection connection;
};

dictionary PresentationConnectionAvailableEventInit : EventInit {
  required PresentationConnection connection;
};

制御側ユーザーエージェントは、接続が作成されたとき connectionavailable イベントを PresentationRequest 上で発火します。イベントは PresentationRequest インスタンス上で、PresentationConnectionAvailableEventインターフェースを使い、connection属性に作成されたPresentationConnectionオブジェクトを設定して発火します。イベントは コントローラーが start や reconnectを呼び出した場合、または 制御側ユーザーエージェントが defaultRequest経由でコントローラーの代わりに接続を作成した場合に、それぞれの接続ごとに発火されます。

受信側ユーザーエージェントは、着信接続が作成されたとき connectionavailable イベントを PresentationReceiver上で発火します。イベントは プレゼンテーションコントローラー監視器上で PresentationConnectionAvailableEventインターフェースを使い、connection属性に作成されたPresentationConnectionオブジェクトを設定して発火します。イベントは 受信プレゼンテーション接続の監視中に作成されるすべての接続に対して発火されます。

connection 属性は、 MUST PresentationConnectionオブジェクト作成時に設定された値を返します。

PresentationConnectionAvailableEvent コンストラクターが呼び出された場合、ユーザーエージェントは MUST 新しい PresentationConnectionAvailableEvent オブジェクトを、渡された connection メンバーを connection 属性に設定して構築しなければなりません。

ユーザーエージェントがプレゼンテーション接続の確立を プレゼンテーション接続 を使って行う場合、 MUST 以下の手順を実行しなければなりません:

入力

presentationConnection：接続すべき PresentationConnection オブジェクト

1. Assert：これは並行して実行されています。
2. presentationConnectionのプレゼンテーション接続状態が connectingでない場合、残りの手順を中止する。
3. presentationConnectionの接続を受信側ブラウジングコンテキストに要求する。presentationConnectionのプレゼンテーション識別子はこの要求とともにMUST送信されなければならない。
4. 接続が正常に完了した場合、Presentation APIタスクをキューに入れて以下を実行する：
   1. presentationConnectionのプレゼンテーション接続状態を connectedに設定する。
   2. connect イベント（connect）を presentationConnection で発火する。
5. 接続が完了できなかった場合、プレゼンテーション接続終了 S を error理由と 失敗内容を説明する人間可読のcloseMessageで終了する。

プレゼンテーションメッセージデータは2つのブラウジングコンテキスト間で送信されるペイロードデータを指します。プレゼンテーションメッセージタイプは、そのデータの型で、textまたはbinaryのいずれかです。

ユーザーエージェントがメッセージ送信をプレゼンテーション接続経由で行う場合、MUST 以下の手順を実行しなければなりません:

入力

presentationConnection：相手のブラウジングコンテキストへ接続済みのプレゼンテーション接続

messageOrData：相手のブラウジングコンテキストへ送信するプレゼンテーションメッセージデータ

1. presentationConnectionのstateプロパティがconnectedでない場合、throwし、InvalidStateError例外を投げて中断する。
2. presentationConnectionの終了手順が開始されている場合、残りの手順を中止する。
3. プレゼンテーションメッセージタイプ messageType を messageOrDataが ArrayBuffer、 ArrayBufferView、 Blob型ならbinary、 DOMString型ならtextに設定する。
4. 実装固有メカニズムでmessageOrDataの内容を プレゼンテーションメッセージデータとして、 messageTypeをプレゼンテーションメッセージタイプとして 宛先ブラウジングコンテキストに送信する。
5. 前のステップで回復不能なエラーが発生した場合、即座に プレゼンテーション接続終了 presentationConnection を error理由と エラー内容記述のcloseMessageで終了する。

ユーザーエージェントがリモート側から プレゼンテーションメッセージデータと プレゼンテーションメッセージタイプの伝送を受信した場合、 MUST 以下の手順で メッセージ受信を PresentationConnection 経由で実行する：

入力

presentationConnection：メッセージを受信する プレゼンテーション接続

messageType：メッセージのプレゼンテーションメッセージタイプ

messageData：メッセージのプレゼンテーションメッセージデータ

1. Assert：これは並行して実行中である。
2. presentationConnectionのstateプロパティが connectedでない場合、残りの手順を中止する。
3. eventをイベント生成（ MessageEventインターフェース）で生成し、イベントタイプをmessage、 バブルしない・キャンセル不可とする。
4. event の data属性を次で初期化：
   1. messageTypeがtextなら、eventのdata属性をDOMString型のmessageDataで初期化。
   2. messageTypeがbinaryかつ binaryType 属性が"blob"なら、 eventのdata属性をmessageDataを生データとする新規 Blobオブジェクトで初期化。
   3. messageTypeがbinaryかつ binaryType 属性が"arraybuffer"なら、 eventのdata属性をmessageData内容の新規 ArrayBufferオブジェクトで初期化。
5. Presentation APIタスクをキューに入れて fire event を presentationConnection で発火する。

ユーザーエージェントが presentationConnection経由でメッセージ受信時に回復不能エラーに遭遇した場合、 MUST即座に プレゼンテーション接続終了 presentationConnection を error理由で終了する必要がある。 SHOULD エラー内容を人間可読なcloseMessageにすることが推奨される。

...（省略：WebIDL部分は翻訳不要）...

PresentationConnectionCloseEvent は プレゼンテーション接続が closed状態に遷移したときに発火されます。 reason 属性は接続が終了した理由を示します。値は PresentationConnectionCloseReason のいずれかです：

• error：プレゼンテーションとの接続・通信機構が回復不能エラーに陥った。
• closed：制御側ブラウジングコンテキストまたは 受信側ブラウジングコンテキストが PresentationConnectionで close()を呼び出した。
• wentaway：ブラウザが接続を閉じた（例：接続所有ブラウジングコンテキストがナビゲート・破棄された）。

reason属性が error の場合、 ユーザーエージェントは SHOULD message 属性に 通信チャネルがどのようなエラーに遭遇したかを説明する人間可読の記述を設定すべきです。

PresentationConnectionCloseEvent コンストラクターが呼ばれたとき、ユーザーエージェントは MUST 新しい PresentationConnectionCloseEvent オブジェクトを構築し、その reason 属性は渡された reason メンバーの値に設定し、 PresentationConnectionCloseEventInit オブジェクトで渡されていれば message属性に設定し、それ以外は空文字列に設定する。

ユーザーエージェントが プレゼンテーション接続の開始終了 を行う場合、MUST 以下を実行する：

入力

presentationConnection：終了する プレゼンテーション接続

closeReason：接続終了理由を示す PresentationConnectionCloseReason

closeMessage：接続終了詳細を含む人間可読メッセージ

1. presentationConnection の プレゼンテーション接続状態が connecting または connected でない場合、残りの手順を中止する。
2. presentationConnection の プレゼンテーション接続状態を closed に設定する。
3. 宛先ブラウジングコンテキストに closeReasonを渡しつつ、対応する PresentationConnection の終了意思を通知開始する。 実際に閉じられたことの確認を待たず、次の手順に進むことができる。
4. closeReason が wentaway でない場合、 ローカルで プレゼンテーション接続終了 の手順を presentationConnection, closeReason, closeMessage で実行する。

ユーザーエージェントが プレゼンテーション接続終了 を行う場合、MUST 以下を実行する：

入力

presentationConnection：終了する プレゼンテーション接続

closeReason：接続終了理由を示す PresentationConnectionCloseReason

closeMessage：接続終了詳細を含む人間可読メッセージ

1. presentationConnection に保留中の プレゼンテーション接続終了 タスクがある場合、 または既に プレゼンテーション接続終了 タスクが実行済みの場合、残りの手順を中止する。
2. Presentation APIタスクをキューに入れて以下を実行する：
   1. presentationConnection の プレゼンテーション接続状態が connecting、 connected、 closed いずれでもない場合、残りの手順を中止する。
   2. presentationConnection の プレゼンテーション接続状態が closed でない場合は closed に設定する。
   3. presentationConnection が 受信側ブラウジングコンテキストで 受信プレゼンテーション接続の監視で作成された場合、以下を実行：
      1. presentationConnection を プレゼンテーションコントローラーの集合から削除する。
      2. プレゼンテーションコントローラー監視器に プレゼンテーションコントローラーの集合を反映する。
   4. close イベントを PresentationConnectionCloseEvent インターフェースで、 reason 属性に closeReason、 message 属性に closeMessage を指定して presentationConnection で発火する。イベントはバブルせず、キャンセル不可。

制御側ユーザーエージェントが 制御側ブラウジングコンテキストでプレゼンテーション終了 を connection を使って行う場合、 MUST 以下の手順を実行する：

1. connection の プレゼンテーション接続状態が connected または connecting でない場合、残りの手順を中止する。
2. それ以外の場合、制御側ユーザーエージェントの 管理中プレゼンテーションの集合内の各 known connection について：
   1. known connection の プレゼンテーション識別子が connectionと等しく、かつ known connection の プレゼンテーション接続状態が connected または connecting の場合、 グローバルタスクをキューに入れ known connection の 関連グローバルオブジェクトで以下を実行：
      1. known connection の プレゼンテーション接続状態を terminated に設定する。
      2. terminate イベントを known connection で発火する。
3. 並行して、実装固有メカニズムで プレゼンテーション終了要求送信を 該当プレゼンテーションの 受信側ユーザーエージェントに送る。

以下のいずれかが発生した場合、受信側ユーザーエージェントは MUST 受信側ブラウジングコンテキストでプレゼンテーション終了を行う：

1. 受信側ユーザーエージェントが 受信側ブラウジングコンテキストに対応する ドキュメントのアンロードを行う場合（例：そのコンテキストを新しいリソースにナビゲートするリクエストなど）。
2. ユーザーが受信側ユーザーエージェント経由でプレゼンテーションの終了を要求した場合。
   注

   これは明示的なユーザー操作や、ユーザーエージェントのポリシーとして発生し得ます。たとえば、受信側ユーザーエージェントが PresentationConnection オブジェクトがすべて30分間閉じていたプレゼンテーションを終了するよう設定されている場合などが挙げられます。

3. 制御側ユーザーエージェントが 終了要求送信 を そのプレゼンテーションの 受信側ユーザーエージェントに送信した場合。

受信側ユーザーエージェントが 受信側ブラウジングコンテキストでプレゼンテーション終了 を行う場合、 MUST 以下の手順を実行する：

1. 終了するプレゼンテーションを P とし、allControllers を プレゼンテーションコントローラーの集合で P用に作成されたものとし、connectedControllers を空リストとする。
2. allControllers の各 connection について以下を実行：
   1. connectionのプレゼンテーション接続状態が connectedなら connection を connectedControllers に追加する。
   2. connectionのプレゼンテーション接続状態を terminatedに設定する。
3. Pに対する受信側ブラウジングコンテキストが存在し、 かつそのドキュメントがアンロードされていない場合は、そのアンロードを行い、ユーザーインターフェースからブラウジングコンテキストを削除・破棄する。
4. connectedControllers の各 connection について、 Pの終了確認を実装固有メカニズムで、connectionの宛先ブラウジングコンテキストを所有する 制御側ユーザーエージェントに送信する。
   注

   制御側ユーザーエージェントごとに1つだけ終了確認を送信すれば十分です。

受信側ユーザーエージェントがプレゼンテーションPの終了確認を送信し、 制御側ユーザーエージェントがそれを受信した場合、 制御側ユーザーエージェントは MUST 以下の手順を実行する：

1. 管理中プレゼンテーションの集合のうち Pに接続されていた各 connection について、 グローバルタスクをキューに入れ プレゼンテーションタスクソースで connection の 関連グローバルオブジェクトで以下を実行：
   1. connection の プレゼンテーション接続状態が connected または connecting でない場合、残りの手順を中止する。
   2. connection の プレゼンテーション接続状態を terminated に設定する。
   3. terminate イベントを connection で発火する。

以下は PresentationConnection インターフェースを実装するオブジェクトが、 イベントハンドラIDL属性としてサポートしなければならない（および対応するイベントハンドライベントタイプ）の一覧です：

ユーザーエージェントが 受信側ブラウジングコンテキストの作成 を行う場合、MUST 以下の手順を実行する：

入力

D：ユーザーが選択した プレゼンテーションディスプレイ

presentationUrl：プレゼンテーションリクエストURL

presentationId：プレゼンテーション識別子

1. 新規ブラウジングコンテキストの作成を行い、 トップレベルブラウジングコンテキスト C を D の画面に表示するよう設定する。
2. C の セッション履歴 を空リストに設定する。
3. C に sandboxed modals flag および sandboxed auxiliary navigation browsing context flag を設定する。
4. 受信側ユーザーエージェントが [PERMISSIONS] を実装している場合、 C のすべての permission descriptor types の permission state を "denied" に設定する。
5. C 用に新しい空の cookie store を作成する。
6. C 用に新しい空の HTTP認証ストアを作成する。
7. C 用に新しい空の session storage area と local storage area のストレージを作成する。
8. 受信側ユーザーエージェントが [INDEXEDDB] を実装している場合、 C 用に新しい空の IndexedDB データベースストレージを作成する。
9. 受信側ユーザーエージェントが [SERVICE-WORKERS] を実装している場合、C 用に新しい空の service worker登録リスト、および空の Cache オブジェクト集合を作成する。
10. ナビゲート で C を presentationUrl に遷移させる。
11. C に presentationId と presentationUrl を用いて 受信プレゼンテーション接続の監視を開始する。

提示されたドキュメントが 子ナビゲーブル を 作成した場合（すなわち 受信側ブラウジングコンテキスト を トップレベルブラウジングコンテキストとするもの）は、 MUST 上記2～4の制約も持つこと。また、 MUST sandboxed top-level navigation without user activation browsing context flag を設定すること。これらすべての ブラウジングコンテキストは MUST 上記機能5～10で同じブラウジング状態（ストレージ）を共有すること。

トップレベルブラウジングコンテキストが新しいリソースにナビゲートし、 ナビゲート手順を実行する場合、ステップ1で ナビゲート許可か判定する必要がある。 また、MUST NOT フラグメント識別子へのナビゲートや ドキュメント再読み込み以外で自分自身を新リソースにナビゲートしてはならない。

トップレベルブラウジングコンテキストが ナビゲート許可されていない場合、 SHOULD NOT 新しい トップレベルブラウジングコンテキストでリソースを開く提案をしてはならない。 それ以外は、SHOULD ナビゲート手順と一貫するべきである。

Window clients および worker clientsは 受信側ブラウジングコンテキストおよびその 子孫ナビゲーブルに関連付けられたものであっても、 互いの service worker に公開してはならない。

受信側ブラウジングコンテキストが終了した場合、 それおよび ブラウジングコンテキストの 子孫ナビゲーブルに関連付けられた service workerは MUST 全て登録解除・終了されること。 また、関連する セッション履歴、cookie store、HTTP認証状態、 データベース、 session storage area、 local storage area、 service worker登録リストおよび Cache オブジェクトは MUST 破棄され、他の ブラウジングコンテキストで再利用されてはならない。

受信側ユーザーエージェントは SHOULD 受信側ブラウジングコンテキストで リソースを取得する際、Accept-Languageヘッダーを 制御側ユーザーエージェントの言語設定（つまり制御側ユーザーエージェントが送信する Accept-Languageと同じ）に合わせるべきです。 これにより、受信側ユーザーエージェントが ユーザーの言語・フォント設定に合わせてプレゼンテーションをレンダリングできます。

受信側ユーザーエージェントが 受信側ブラウジングコンテキストで 制御側ブラウジングコンテキストからの 受信プレゼンテーション接続の監視を開始する場合、 MUST 実装固有メカニズムで制御側ブラウジングコンテキストからの着信接続リクエストをリッスンし受け入れなければなりません。 制御側ブラウジングコンテキストから新たな接続リクエストを受信した場合、受信側ユーザーエージェントは MUST 以下の手順を実行します：

入力

I：着信接続リクエストと共に制御側ブラウジングコンテキストから送られてきたプレゼンテーション識別子

presentationId：受信側ブラウジングコンテキストの作成に使われた プレゼンテーション識別子

presentationUrl：受信側ブラウジングコンテキストの作成に使われた プレゼンテーションリクエストURL

1. Assert：これは並行して実行中である。
2. presentationIdとIが一致しない場合、接続を拒否し残りの手順を中止する。
3. 新しいPresentationConnection Sを作成する。
4. Sのプレゼンテーション識別子にIを設定する。
5. SのプレゼンテーションURLにpresentationUrlを設定する。
6. 制御側・受信側ブラウジングコンテキスト間の接続を実装固有メカニズムで確立する。
7. 接続確立が成功した場合、Sの プレゼンテーション接続状態を connectedに設定する。 失敗した場合はSのプレゼンテーション接続状態を closedに設定し残りの手順を中止する。
8. Sをプレゼンテーションコントローラーの集合に追加する。
9. presentation controllers monitorがnullなら以下を並行して実行：
   1. presentation controllers monitorを PresentationConnectionListとして このPresentationReceiverオブジェクトの JavaScript realmで新規作成する。
   2. presentation controllers monitorに プレゼンテーションコントローラーの集合を反映する。
   3. presentation controllers promiseがnullでなければ Presentation APIタスクをキューに入れ resolveで presentation controllers promiseを presentation controllers monitorで解決する。
   4. 残りの手順を中止する。
10. それ以外の場合、以下を並行して実行：
    1. presentation controllers monitorに プレゼンテーションコントローラーの集合を反映する。
    2. Presentation APIタスクをキューに入れ connectionavailableイベントを PresentationConnectionAvailableEvent インターフェースでSをconnection属性に初期化し、 presentation controllers monitorで発火する。イベントはバブルせず、キャンセル不可。

以下は、PresentationConnectionList インターフェースを実装するオブジェクトが、イベントハンドラIDL属性としてサポートしなければならない（および対応するイベントハンドライベントタイプ）の一覧です：