プレゼンテーション API

制御側ユーザーエージェントは、 次の部分インターフェイスを実装しなければなりません。

WebIDLpartial interface Presentation {
  attribute PresentationRequest? defaultRequest;
};

defaultRequest 属性は、存在する場合は デフォルトプレゼンテーション要求を返し、 それ以外の場合は null を返さなければなりません。設定時には、デフォルト プレゼンテーション要求を新しい値に設定しなければなりません。

制御側ユーザーエージェントは、ユーザーがユーザージェスチャーによってその意図を示した場合にのみ、 デフォルトプレゼンテーション要求を使用してプレゼンテーションを開始するべきです。たとえば、 ブラウザー chrome のボタンをクリックした場合です。

デフォルトプレゼンテーション 要求を使用してプレゼンテーションを開始するには、制御側ユーザーエージェントは、 デフォルトプレゼンテーション 要求からプレゼンテーションを開始する手順に従わなければなりません。

デフォルト プレゼンテーション要求を使用したプレゼンテーション開始のサポートは任意です。

受信側ユーザーエージェントは、 次の部分インターフェイスを実装しなければなりません。

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

receiver 属性は、受信側閲覧 コンテキストが 作成されたときに 受信側ユーザーエージェントによって作成され、 受信側閲覧 コンテキストに関連付けられた PresentationReceiver インスタンスを返さなければなりません。その他の 閲覧コンテキスト（受信側閲覧 コンテキストの 子ナビゲーターを含む）では、null を返さなければなりません。

PresentationRequest コンストラクターが 呼び出されたとき、 制御側ユーザーエージェントは次の手順を実行しなければなりません。

入力

url または urls、すなわち プレゼンテーション要求 URL

出力

新しい PresentationRequest オブジェクト

1. 文書オブジェクトの 有効なサンドボックスフラグ 集合に サンドボックス化された プレゼンテーション閲覧コンテキストフラグ が設定されている場合、SecurityError を投げ、 これらの手順を中止します。
2. urls が空のシーケンスの場合、 NotSupportedError を 投げ、 残りのすべての手順を中止します。
3. 単一の url が指定された場合、urls を url を含む 1 要素の配列とします。
4. presentationUrls を URL の空のリストとします。
5. urls 内の各 URL U について:
   1. A を、 現在の設定オブジェクトによって指定される API ベース URL を基準に U をパースした結果である絶対 URL とします。
   2. URL をパースするアルゴリズムが失敗した場合、 SyntaxError 例外を 投げ、 残りのすべての手順を中止します。
   3. A のスキームが 制御側 ユーザーエージェントによってサポートされている場合、A を presentationUrls に追加します。
6. presentationUrls が空のリストの場合、 NotSupportedError を投げ、 残りのすべての手順を中止します。
7. presentationUrls のいずれかのメンバーが 潜在的に信頼できる URLでない場合、 SecurityError を投げ、これらの手順を中止します。
8. presentationUrls をその プレゼンテーション要求 URL とする新しい PresentationRequest オブジェクトを構築し、 それを返します。

start メソッドが呼び出されたとき、 ユーザーエージェントは、プレゼンテーション ディスプレイを選択するために次の手順を実行しなければなりません。

入力

presentationRequest、すなわち PresentationRequest オブジェクトであり、そのオブジェクトが start の呼び出しを受け取ったもの

出力

新しい Promise

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

ユーザーがブラウザー chrome（専用ボタン、ユーザージェスチャー、またはその他のシグナルを介して）を使用し、 プレゼンテーションディスプレイ上で文書のプレゼンテーションを開始する意図を示した場合、そのユーザーエージェントは、 デフォルトプレゼンテーション要求から プレゼンテーションを開始するために次の手順を実行しなければなりません。文書に デフォルトプレゼンテーション要求が設定されていない場合、 これらの手順を実行してはなりません。

入力

W、ユーザーがプレゼンテーション開始の 意図を示した文書

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

D、プレゼンテーションの対象となる プレゼンテーションディスプレイ

1. 次の手順を 並列に実行します。
2. presentationUrls を presentationRequest の プレゼンテーション要求 URL とします。
3. D が 利用可能なプレゼンテーションディスプレイである presentationRequest の プレゼンテーション要求 URLが存在しない場合、 これらの手順を中止します。
4. presentationRequest および D を用いて プレゼンテーション 接続を開始する手順を実行します。

ユーザーエージェントが プレゼンテーション 接続を開始する場合、次の手順を実行しなければなりません。

入力

presentationRequest、プレゼンテーション接続を開始するために使用される PresentationRequest

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

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

1. 表明: これは 並列に実行されています。
2. I を、制御対象 プレゼンテーションの集合内の既知の プレゼンテーション接続のすべての プレゼンテーション識別子の中で一意な、新しい 有効なプレゼンテーション 識別子とします。フィンガープリンティングを避けるため、実装は プレゼンテーション識別子を、 [rfc4122] の形式 4.4 または 4.5 に従って生成された UUID に設定するべきです。
3. 新しい PresentationConnection S を作成します。
4. S の プレゼンテーション識別子を I に設定します。
5. presentationUrls を presentationRequest の プレゼンテーション要求 URL とします。
6. S の プレゼンテーション URLを、 利用可能なプレゼンテーション ディスプレイのリストにエントリー (presentationUrl, D) が存在する、 presentationUrls 内の最初の presentationUrl に設定します。
7. S の プレゼンテーション接続状態を connecting に設定します。
8. S を 制御対象 プレゼンテーションの集合に追加します。
9. P が指定されている場合、 P を S で 解決するための Presentation API タスクをキューに入れます。
10. presentationRequest において、 connection 属性を S に初期化した PresentationConnectionAvailableEvent インターフェイスを使用する、 connectionavailable という名前のイベントを 発火するための Presentation API タスクをキューに入れます。 このイベントはバブリングしてはならず、キャンセル可能であってはなりません。
11. U を D に接続されたユーザーエージェントとします。
12. 次の手順が失敗した場合、残りのすべての手順を中止し、 closeReason を error、 closeMessage を失敗を説明する人間が読めるメッセージとして、S の プレゼンテーション接続を 閉じます。
13. 実装固有のメカニズムを使用して、D、 presentationUrl、および I をパラメーターとして 受信側閲覧 コンテキストを作成するよう U に通知します。
14. S を使用して プレゼンテーション 接続を確立します。

reconnect メソッドが呼び出されたとき、ユーザーエージェントは、プレゼンテーションに再接続するために次の 手順を実行しなければなりません。

入力

presentationRequest、すなわち PresentationRequest オブジェクトであり、そのオブジェクト上で reconnect が呼び出されたもの

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

出力

P、新しい Promise

1. P を新しい Promise とします。
2. P を返しますが、これらの手順を 並列に実行し続けます。
3. 制御対象 プレゼンテーションの集合から、次の基準を満たす PresentationConnection を検索します。
   • その 制御側閲覧コンテキストが現在の 閲覧コンテキストである
   • その プレゼンテーション 接続状態が terminated ではない
   • その プレゼンテーション URLが、 presentationRequest の プレゼンテーション要求 URLのいずれかと等しい
   • その プレゼンテーション識別子が presentationId と等しい
4. そのような PresentationConnection が存在する場合、 次の手順を実行します。
   1. existingConnection をその PresentationConnection とします。
   2. P を existingConnection で 解決するための Presentation API タスクをキューに入れます。
   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. P を newConnection で 解決するための Presentation API タスクをキューに入れます。
   8. presentationRequest において、 connection 属性を newConnection に初期化した PresentationConnectionAvailableEvent インターフェイスを使用する connectionavailable という名前のイベントを 発火するための Presentation API タスクをキューに入れます。 このイベントはバブリングしてはならず、 キャンセル可能であってはなりません。
   9. newConnection を使用して プレゼンテーション 接続を確立します。
   10. 残りのすべての手順を中止します。
7. P を NotFoundError 例外で 拒否するための Presentation API タスクをキューに入れます。

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

ユーザーエージェントは、 getAvailability メソッドによって作成された プレゼンテーション 利用可能性オブジェクトの集合を追跡しなければなりません。 プレゼンテーション利用可能性 オブジェクトの集合は、初期状態では空であり、 タプル (A, availabilityUrls) の集合として表されます。ここで:

1. A は生存している PresentationAvailability オブジェクトです。
2. availabilityUrls は プレゼンテーション 要求 URL のリストであり、PresentationRequest に対して getAvailability が A を作成するために呼び出されたときのものです。

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

プレゼンテーション 利用可能性オブジェクトの集合が空でない間、 ユーザーエージェントは、ページが PresentationAvailability オブジェクトの value プロパティを使用して、 利用可能なディスプレイがある場合にのみプレゼンテーションを提供できるようにするため、 利用可能な プレゼンテーションディスプレイのリストを継続的に監視してもかまいません。しかし、 ユーザーエージェントは、 たとえばプラットフォームや消費電力の 制約により、バックグラウンドでの継続的な利用可能性監視をサポートしない場合があります。この場合、 getAvailability が返す Promise は 拒否され、 利用可能な プレゼンテーションディスプレイのリストを監視するアルゴリズムは、 プレゼンテーションディスプレイを選択するアルゴリズムの一部としてのみ実行されます。

プレゼンテーション 利用可能性オブジェクトの集合が空である場合 （つまり、監視されている availabilityUrls が存在しない場合）、 ユーザーエージェントは、 省電力の非機能要件を満たすため、 利用可能な プレゼンテーションディスプレイのリストを監視するべきではありません。さらに電力を節約するため、 ユーザーエージェントは、 PresentationAvailability オブジェクトを保持するページが フォアグラウンドにあるかどうかも追跡してもかまいません。 この情報を使用して、実装固有の プレゼンテーションディスプレイの検出を再開または一時停止できます。

getAvailability メソッドが呼び出されたとき、 ユーザーエージェントは次の手順を実行しなければなりません。

入力

presentationRequest、すなわち PresentationRequest オブジェクトであり、そのオブジェクトが getAvailability の呼び出しを受け取ったもの

出力

新しい Promise

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

   前の手順で追加されたタプルを プレゼンテーション 利用可能性オブジェクトの集合から取得するため、監視アルゴリズムは 前の手順の後に少なくとももう 1 回実行されなければなりません。
8. P を A で 解決するための Presentation API タスクをキューに入れます。

プレゼンテーション 利用可能性オブジェクトの集合が 空でないか、プレゼンテーション ディスプレイを 選択するための保留中の要求がある場合、ユーザーエージェントは、次の 手順を実行することによって 利用可能な プレゼンテーションディスプレイのリストを監視しなければなりません。

1. 表明: これは 並列に実行されています。
2. availabilitySet を プレゼンテーション 利用可能性オブジェクトの集合の浅いコピーとします。
3. プレゼンテーション ディスプレイを選択するための保留中の要求が PresentationRequest に対して存在し、かつ PresentationRequest の プレゼンテーションディスプレイの 利用可能性が null の場合、次の 下位手順を実行します。
   1. A を新たに作成された PresentationAvailability オブジェクトとします。
   2. タプル (A, presentationUrls) を作成します。ここで presentationUrls は PresentationRequest の プレゼンテーション要求 URLであり、これを 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 プロパティが まだ初期化されていない場合、A の value プロパティを newAvailability に設定し、次の手順をスキップします。
   5. previousAvailability が newAvailability と等しくない場合、次の手順を実行するための Presentation API タスクをキューに入れます。
      1. A の value プロパティを newAvailability に設定します。
      2. A で change という名前のイベントを 発火します。

プレゼンテーションディスプレイの利用可能性 オブジェクトが ガベージコレクションの対象となった場合、ユーザーエージェントは次の 手順を実行するべきです。

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;
};

制御側ユーザーエージェントは、 オブジェクトに関連付けられた接続が作成されたとき、 PresentationRequest 上で connectionavailable という名前の イベントを発火します。これは、 作成された PresentationConnection オブジェクトに connection 属性を設定した PresentationConnectionAvailableEvent インターフェイスを使用して、PresentationRequest インスタンスで発火します。この イベントは、コントローラーに対して作成される各接続について発火します。これは、コントローラーが start または reconnect を呼び出した場合、または 制御側ユーザーエージェントが defaultRequest を介してコントローラーの代わりに接続を作成した場合です。

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

connection 属性は、 PresentationConnection オブジェクトが 作成されたときに設定された値を返さなければなりません。

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

ユーザーエージェントが、プレゼンテーション接続を使用して プレゼンテーション 接続を確立する場合、 次の手順を実行しなければなりません。

入力

presentationConnection、接続される PresentationConnection オブジェクト

1. 表明: これは 並列に実行されています。
2. presentationConnection の プレゼンテーション接続状態が connecting でない場合、 残りのすべての手順を中止します。
3. presentationConnection から 受信側閲覧コンテキストへの接続を要求します。presentationConnection の プレゼンテーション 識別子は、この要求とともに送信されなければなりません。
4. 接続が正常に完了した場合、次の手順を実行するための Presentation API タスクをキューに入れます。
   1. presentationConnection の プレゼンテーション 接続状態を connected に設定します。
   2. presentationConnection で connect という名前のイベントを 発火します。
5. 接続を完了できない場合、closeReason を error、 closeMessage を失敗を説明する人間が読めるメッセージとして、 S の プレゼンテーション 接続を閉じます。

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

ユーザーエージェントが、プレゼンテーション接続を介して メッセージを 送信する場合、 次の手順を実行しなければなりません。

入力

presentationConnection、もう一方の閲覧コンテキストに接続された プレゼンテーション 接続

messageOrData、もう一方の閲覧コンテキストに 送信する プレゼンテーションメッセージ データ

1. presentationConnection の state プロパティが connected でない場合、 InvalidStateError 例外を 投げます。
2. presentationConnection の クローズ 手順が開始されている場合、これらの 手順を中止します。
3. プレゼンテーションメッセージ型 messageType を、 messageOrData が ArrayBuffer、ArrayBufferView、または Blob 型の場合は binary とします。 messageOrData が DOMString 型の場合、 messageType を text とします。
4. 実装固有のメカニズムを使用して、 messageOrData の内容を プレゼンテーションメッセージ データとして、messageType を プレゼンテーションメッセージ 型として 宛先閲覧 コンテキストに送信します。
5. 前の手順で回復不能なエラーが発生した場合、 closeReason を error、 closeMessage を発生したエラーの説明として、 presentationConnection の プレゼンテーション 接続を即座に閉じます。

ユーザーエージェントが、 プレゼンテーションメッセージデータ と プレゼンテーションメッセージ型からなる送信を リモート側から受信したとき、PresentationConnection を介して メッセージを受信するために、次の手順を 実行しなければなりません。

入力

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

messageType、メッセージの プレゼンテーションメッセージ 型

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

1. 表明: これは 並列に実行されています。
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. presentationConnection で event を 発火するための Presentation API タスクをキューに入れます。

ユーザーエージェントが presentationConnection を介して メッセージを受信している間に回復不能なエラーに遭遇した場合、 closeReason を error として presentationConnection の プレゼンテーション 接続を即座に閉じなければなりません。発生したエラーの人間が読める説明を closeMessage として使用するべきです。

WebIDLenum PresentationConnectionCloseReason { "error", "closed", "wentaway" };

[SecureContext, Exposed=Window]
interface PresentationConnectionCloseEvent : Event {
  constructor(DOMString type, PresentationConnectionCloseEventInit eventInitDict);
  readonly attribute PresentationConnectionCloseReason reason;
  readonly attribute DOMString message;
};

dictionary PresentationConnectionCloseEventInit : EventInit {
  required PresentationConnectionCloseReason reason;
  DOMString message = "";
};

プレゼンテーション接続が closed 状態になったとき、 PresentationConnectionCloseEvent が発火します。reason 属性は、接続が閉じられた理由を示します。この属性は、 PresentationConnectionCloseReason の値のいずれかを 取ることができます。

• error は、プレゼンテーションへの 接続または通信のメカニズムで 回復不能なエラーが発生したことを意味します。
• closed は、 PresentationConnection によって接続されていた 制御側閲覧 コンテキストまたは 受信側閲覧 コンテキストのいずれかが close() を呼び出したことを意味します。
• wentaway は、ブラウザーが 接続を閉じたことを意味します。たとえば、接続を所有していた閲覧コンテキストが ナビゲートされたか、破棄された場合です。

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

PresentationConnectionCloseEvent コンストラクターが 呼び出されたとき、ユーザーエージェントは、 reason 属性をコンストラクターに渡された PresentationConnectionCloseEventInit オブジェクトの reason メンバーに設定し、 message 属性を、 この PresentationConnectionCloseEventInit オブジェクトの message メンバーが設定されている場合はそれに、 それ以外の場合は空の文字列に設定した、新しい PresentationConnectionCloseEvent オブジェクトを構築しなければなりません。

ユーザーエージェントが プレゼンテーション 接続を閉じ始める場合、次のことを行わなければなりません。

入力

presentationConnection、閉じる プレゼンテーション 接続

closeReason、接続を閉じる理由を 説明する PresentationConnectionCloseReason

closeMessage、接続が閉じられた理由の詳細を含む 人間が読めるメッセージ

1. presentationConnection の プレゼンテーション接続状態が connecting または connected でない場合、 残りの 手順を中止します。
2. presentationConnection の プレゼンテーション接続状態を closed に設定します。
3. 対応する PresentationConnection を閉じる意図を 宛先閲覧 コンテキストへ通知し始め、 closeReason をそのコンテキストに渡します。ユーザーエージェントは、 次の手順に進む前に、対応する PresentationConnection が 実際に閉じられたという確認を待つ必要はありません。
4. closeReason が wentaway でない場合、 presentationConnection、closeReason、および closeMessage を用いて プレゼンテーション 接続を閉じる手順をローカルで実行します。

ユーザーエージェントが プレゼンテーション 接続を閉じる場合、次のことを行わなければなりません。

入力

presentationConnection、閉じる プレゼンテーション 接続

closeReason、接続を閉じる理由を 説明する PresentationConnectionCloseReason

closeMessage、接続が閉じられた理由の詳細を含む 人間が読めるメッセージ。

1. presentationConnection に対する保留中の プレゼンテーション 接続を閉じる タスクが存在するか、presentationConnection に対する プレゼンテーション 接続を閉じるタスクがすでに実行されている場合、 残りの手順を中止します。
2. 次の手順を実行するための Presentation API タスクをキューに入れます。
   1. presentationConnection の プレゼンテーション 接続状態が connecting、 connected、 または closed のいずれでもない場合、残りの手順を中止します。
   2. presentationConnection の プレゼンテーション 接続状態が closed でない場合、 closed に設定します。
   3. presentationConnection が、 受信側閲覧コンテキストで 受信する プレゼンテーション接続を監視する 結果として作成された場合、次の 下位手順を実行します。
      1. presentationConnection を プレゼンテーション コントローラーの集合から削除します。
      2. プレゼンテーションコントローラー モニター を プレゼンテーション コントローラーの集合で設定します。
   4. presentationConnection で、 reason 属性を closeReason に、message 属性を closeMessage に初期化した PresentationConnectionCloseEvent インターフェイスを使用する close という名前のイベントを 発火します。このイベントはバブリングしてはならず、 キャンセル可能であってはなりません。

制御側ユーザーエージェントが connection を使用して 制御側閲覧コンテキストで プレゼンテーションを終了する場合、 次の手順を実行しなければなりません。

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

次のいずれかが発生した場合、受信側ユーザーエージェント は 受信側閲覧 コンテキストでプレゼンテーションを終了しなければなりません。

1. 受信側ユーザーエージェントが、 受信側閲覧 コンテキストに対応する 文書をアンロードしようとしている場合。たとえば、 そのコンテキストを新しい リソースへ ナビゲートする要求への応答として行われる場合です。
2. ユーザーが 受信側ユーザーエージェントを介してプレゼンテーションの終了を要求した場合。
   注記

   これは、明示的なユーザー操作によって、またはユーザーエージェントの ポリシーとして発生する可能性があります。たとえば、受信側ユーザー エージェント は、すべての PresentationConnection オブジェクトが 30 分間閉じたままのプレゼンテーションを終了するよう設定できます。

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

受信側ユーザーエージェントが 受信側閲覧コンテキストで プレゼンテーションを終了する場合、次の手順を実行しなければなりません。

1. P を終了するプレゼンテーションとし、 allControllers を P に対して作成された プレゼンテーション コントローラーの集合とし、 connectedControllers を空のリストとします。
2. allControllers 内の各 connection について、 次の手順を実行します。
   1. connection の プレゼンテーション 接続状態が connected の場合、 connection を connectedControllers に追加します。
   2. connection の プレゼンテーション 接続状態を terminated に設定します。
3. P に対する 受信側閲覧コンテキストが存在し、 そこにまだアンロードされていない P の文書がある場合、その 閲覧コンテキストに対応する 文書をアンロードし、その 閲覧コンテキストを ユーザーインターフェイスから削除して破棄します。
4. connectedControllers 内の各 connection について、 実装固有のメカニズムを使用して P の終了確認を、 connection の 宛先閲覧 コンテキストを所有する 制御側ユーザーエージェントに送信します。
   注記

   各 制御側ユーザーエージェントにつき、 送信する必要がある終了確認は 1 つだけです。

受信側ユーザーエージェントがプレゼンテーション P の終了 確認を送信し、その確認が 制御側ユーザーエージェントによって受信された場合、制御側 ユーザーエージェントは次の手順を実行しなければなりません。

1. P に接続されていた 制御対象 プレゼンテーションの集合内の各 connection について、 connection の 関連するグローバルオブジェクトを指定し、 プレゼンテーションタスク ソース上に、次の手順を実行する グローバルタスクをキューに入れます。
   1. connection の プレゼンテーション 接続状態が connected または connecting でない場合、後続の手順を中止します。
   2. connection の プレゼンテーション 接続状態を terminated に設定します。
   3. connection で terminate という名前のイベントを 発火します。

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

ユーザーエージェントが 受信側閲覧 コンテキストを作成する場合、次の手順を 実行しなければなりません。

入力

D、ユーザーによって選択された プレゼンテーションディスプレイ

presentationUrl、プレゼンテーション要求 URL

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

1. 作成して、新しい トップレベル閲覧コンテキスト C を、D に コンテンツを表示するよう設定します。
2. C の セッション履歴を空の リストに設定します。
3. C に サンドボックス化されたモーダルフラグと サンドボックス化された 補助ナビゲーション閲覧コンテキストフラグを設定します。
4. 受信側ユーザーエージェントが [PERMISSIONS] を実装している場合、 C に対するすべての 権限 記述子型の 権限状態を "denied" に設定します。
5. C のために新しい空の Cookie ストアを作成します。
6. C のために、HTTP 認証状態を保持する新しい空のストアを作成します。
7. C のために、セッションストレージ領域および ローカルストレージ領域用の新しい空のストレージを作成します。
8. 受信側ユーザーエージェントが [INDEXEDDB] を実装している場合、 C のために IndexedDB データベース用の新しい空のストレージを作成します。
9. 受信側ユーザーエージェントが [SERVICE-WORKERS] を実装している場合、新しい空の登録済み Service Worker 登録リストと、 C のための新しい空の Cache オブジェクト集合を作成します。
10. C を presentationUrl に ナビゲートします。
11. presentationId および presentationUrl を用いて、C に対する 受信する プレゼンテーション接続の監視を開始します。

表示された文書によって 作成されたすべての 子ナビゲーター、すなわち 受信側閲覧 コンテキストを自身の トップレベル閲覧 コンテキストとして持つものにも、上記の制限 2～4 が 適用されなければなりません。さらに、 それらには ユーザー アクティベーションなしのトップレベルナビゲーションをサンドボックス化する 閲覧コンテキストフラグが 設定されなければなりません。これらすべての 閲覧 コンテキストは、上記の機能 5～10 について同じ閲覧状態（ストレージ）を 共有しなければなりません。

トップレベル閲覧コンテキストが 新しいリソースへのナビゲーションを試みて ナビゲートする手順を実行するとき、そのコンテキストは ナビゲートを許可されているかどうかを判定するために 手順 1 に 従わなければなりません。さらに、フラグメント識別子へ ナビゲートする場合、または 自身の文書を再読み込みする場合を除き、 自身を新しいリソースへナビゲートすることを 許可してはなりません。

トップレベル閲覧コンテキストが ナビゲートを 許可されていなかった場合、そのコンテキストはリソースを新しい トップレベル閲覧コンテキストで開くことを 提示するべきではありませんが、それ以外の場合は ナビゲートする手順と 整合するべきです。

Window クライアントおよび Worker クライアントで、 受信側閲覧コンテキストおよびその 子孫ナビゲーターに関連付けられたものは、 相互に関連付けられた Service Workerへ公開してはなりません。

受信側閲覧コンテキストが終了したとき、それに関連付けられたすべての Service Workerおよびその 子孫ナビゲーター内の 閲覧 コンテキストは 登録解除され、終了されなければなりません。受信側閲覧コンテキストおよびその 子孫ナビゲーター内の 閲覧コンテキスト に関連付けられたすべての閲覧状態、これには セッション 履歴、Cookie ストア、すべての HTTP 認証状態、すべての データベース、セッション ストレージ領域、ローカルストレージ領域、登録済み Service Worker 登録のリスト、および Cache オブジェクトを含め、破棄しなければならず、他のいかなる 閲覧 コンテキストにも使用してはなりません。

受信側ユーザーエージェントは、受信側閲覧コンテキスト内のリソースを、 制御側ユーザーエージェントの言語設定を反映する HTTP Accept-Language ヘッダー（すなわち、制御側ユーザーエージェントが 送信したであろうものと同じ Accept-Language）を用いて 取得するべきです。これは、受信側ユーザーエージェントが、 ユーザーの設定を反映したフォントおよびロケール固有の属性で プレゼンテーションをレンダリングするのに役立ちます。

受信側ユーザーエージェントが、制御側閲覧 コンテキストから 受信側閲覧 コンテキストへの 受信する プレゼンテーション接続の監視を開始する場合、実装 固有のメカニズムを使用して、制御側閲覧コンテキストからの 受信接続要求を待ち受け、受け入れ なければなりません。新しい接続要求が 制御側閲覧コンテキストから受信されたとき、受信側ユーザー エージェントは次の手順を 実行しなければなりません。

入力

I、受信接続 要求とともに 制御側閲覧コンテキストから渡された プレゼンテーション識別子

presentationId、受信側閲覧コンテキストを 作成するために使用された プレゼンテーション識別子

presentationUrl、受信側閲覧コンテキストを 作成するために使用された プレゼンテーション要求 URL

1. 表明: これは 並列に実行されています。
2. presentationId と I が等しくない場合、 接続を拒否し、残りのすべての手順を中止します。
3. 新しい PresentationConnection S を作成します。
4. S の プレゼンテーション識別子を I に設定します。
5. S の プレゼンテーション URLを presentationUrl に設定します。
6. 実装固有の メカニズムを使用して、制御側と 受信側閲覧コンテキストの間の接続を確立します。
7. 接続の確立が正常に完了した場合、S の プレゼンテーション接続状態を connected に設定します。 それ以外の場合、S の プレゼンテーション 接続状態を closed に設定し、残りのすべての 手順を中止します。
8. S を プレゼンテーション コントローラーの集合に追加します。
9. プレゼンテーションコントローラーモニターが null の場合、次の手順を 並列に実行します。
   1. プレゼンテーションコントローラー モニターを、受信側 閲覧コンテキストの PresentationReceiver オブジェクトの JavaScript レルムで構築された新しい PresentationConnectionList とします。
   2. プレゼンテーションコントローラー モニターを プレゼンテーション コントローラーの集合で設定します。
   3. プレゼンテーションコントローラー promiseが null でない場合、プレゼンテーションコントローラー promise を プレゼンテーションコントローラー モニターで 解決するための Presentation API タスクをキューに入れます。
   4. 残りのすべての手順を中止します。
10. それ以外の場合、次の手順を 並列に実行します。
    1. プレゼンテーションコントローラー モニターを プレゼンテーション コントローラーの集合で設定します。
    2. プレゼンテーション コントローラーモニターで、connection 属性を S に初期化した PresentationConnectionAvailableEvent インターフェイスを使用する connectionavailable という名前のイベントを 発火するための Presentation API タスクをキューに入れます。 このイベントはバブリングしてはならず、 キャンセル可能であってはなりません。

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