Limited support 一部のブラウザのみ対応。使用時はサポート状況を確認すること。

Presentation API

安全なコンテキスト用: この機能は一部またはすべての対応しているブラウザーにおいて、安全なコンテキスト (HTTPS) でのみ利用できます。

presentation は Navigator のプロパティで、プレゼンテーション API のエントリーポイントを提供し、 Presentation オブジェクトへの参照を返します。

埋め込み

対応ブラウザ

機能 デスクトップ モバイル
Chrome
Edge
Firefox
Safari
Chrome Android
Safari iOS
Presentation
実験的
47
79
47
presentation

presentation は Navigator のプロパティで、プレゼンテーション API のエントリーポイントを提供し、 Presentation オブジェクトへの参照を返します。
47
79
47
defaultRequest
実験的

制御ユーザーエージェントでは、defaultRequest 属性はデフォルトのプレゼンテーションリクエストがある場合はそれを返さなければならず、それ以外の場合は null を返さなければなりません。 受信側の閲覧コンテキストでは、null を返さなければなりません (MUST)。
47
79
47
receiver
実験的

読み取り専用の Presentation 属性レシーバーは、プレゼンテーションを受信して​​いるブラウザー コンテキストでのみ使用可能で、プレゼンテーションを制御するブラウザー コンテキストにアクセスして通信するために使用できる PresentationReceiver オブジェクトを返します。 このプロパティは、ブラウザー コンテキストの外部からアクセスされる場合、常に null になります。
59
79
59
PresentationAvailability
実験的

PresentationAvailability オブジェクトは利用可能なプレゼンテーション用の画面に紐付けられ、プレゼンテーションの要求に対する プレゼンテーション用の画面の利用可能性 を表します。操作を行うユーザーエージェントが (start() の保留中の要求が無くても) バックグラウンドで利用可能なプレゼンテーション用の画面のリストを監視できる場合、PresentationAvailability オブジェクトは操作を行う閲覧コンテキストで実装され なければなりません。
47
79
47
change_event
実験的

change`イベント
47
79
47
value
実験的

value 属性は設定された最新の値を返さ なければなりません。この値は利用可能なプレゼンテーション用画面のリストを監視するアルゴリズムにより更新されます。
47
79
47
PresentationConnection
実験的

プレゼンテーション API の PresentationConnection インターフェイスは、単一のプレゼンテーションを管理するためのメソッドとプロパティを提供します。 各プレゼンテーション接続は、PresentationConnection オブジェクトによって表されます。 制御側ユーザー エージェントと受信側ユーザー エージェントの両方が、PresentationConnection を実装する必要があります。
47
79
47
binaryType
実験的

PresentationConnection オブジェクトが作成されるとき、その binaryType IDL 属性は文字列「arraybuffer」に設定されなければなりません。 取得時に、属性は最新の値 (最後に設定された値) を返さなければなりません (MUST)。 設定時に、ユーザー エージェントは IDL 属性を新しい値に設定しなければなりません (MUST)。
47
79
47
close
実験的

close() メソッドが PresentationConnection で呼び出されると、ユーザー エージェントは、closeReason が Closed に設定された空の closeMessage を送信して、接続を閉じるプロセスを開始します。
49
79
49
close_event
実験的

close`イベント
50
79
50
connect_event
実験的

connect`イベント
50
79
50
id
実験的

id 属性は、プレゼンテーション接続のプレゼンテーション識別子を指定します。
47
79
47
message_event
実験的

メッセージ`イベント
47
79
47
send
実験的

PresentationConnection インターフェイスの send() メソッドは、制御ブラウジング コンテキストにバイナリ データまたはテキスト データを表示ブラウジング コンテキストに送信するように指示します。
47
79
47
state
実験的

state 属性は、プレゼンテーション接続の現在の状態を反映します。 現在の PresentationConnectionState に応じて、state 属性は次のいずれかの値を保持できます。
47
79
47
terminate
実験的

terminate() メソッドが PresentationConnection で呼び出されると、ユーザー エージェントはプレゼンテーションを終了するプロセスを開始します。 正確なプロセスは、terminate() が制御コンテキストと表示コンテキストのどちらで呼び出されるかによって異なります。
48
79
48
terminate_event
実験的

終了`イベント
50
79
50
url
実験的

PresentationConnection インターフェイスの url 読み取り専用プロパティは、プレゼンテーションの作成またはプレゼンテーションへの再接続に使用される URL を返します。
57
79
57
PresentationConnectionAvailableEvent
実験的

プレゼンテーション API の PresentationConnectionAvailableEvent インターフェイスは、オブジェクトに関連付けられた接続が作成されるときに、PresentationRequest で起動されます。
47
79
47
connection
実験的

受信接続が作成されると、受信ユーザー エージェントは PresentationReceiver 上で connectionavailable という名前の信頼できるイベントを起動します。 信頼できるイベントは、作成された PresentationConnection オブジェクトに設定された接続属性を使用して、PresentationConnectionAvailableEvent インターフェイスを使用して、プレゼンテーション コントローラーのモニターで発生します。
47
79
47
PresentationConnectionAvailableEvent
実験的

PresentationConnectionAvailableEvent() コンストラクターは、新しい PresentationConnectionAvailableEvent オブジェクトを作成します。
47
79
47
PresentationConnectionCloseEvent
実験的

プレゼンテーション API の PresentationConnectionCloseEvent インターフェイスは、PresentationConnection が閉じられるとその上で起動されます。
50
79
50
message
実験的
50
79
50
PresentationConnectionCloseEvent
実験的

PresentationConnectionCloseEvent()`コンストラクタ
50
79
50
reason
実験的
50
79
50
PresentationConnectionList
実験的

PresentationConnectionList は、受信プレゼンテーション接続のコレクションです。
59
79
59
connectionavailable_event
実験的

connectionavailable`イベント
59
79
59
connections
実験的
59
79
59
PresentationReceiver
実験的

プレゼンテーション API の PresentationReceiver インターフェイスは、受信側のブラウジング コンテキストが制御側のブラウジング コンテキストにアクセスし、それらと通信するための手段を提供します。
59
79
59
connectionList
実験的
59
79
59
PresentationRequest
実験的

PresentationRequest オブジェクトは、制御ブラウジング コンテキストによって作成されたプレゼンテーションを開始または再接続するために使用されます。 PresentationRequest オブジェクトは、制御ユーザー エージェントによって提供される制御ブラウジング コンテキストに実装されなければなりません (MUST)。
47
79
47
connectionavailable_event
実験的

connectionavailable`イベント
47
79
47
getAvailability
実験的

getAvailability() メソッドが呼び出されたとき、ユーザー エージェントは次の手順を実行する必要があります。
47
79
47
PresentationRequest
実験的

PresentationRequest() コンストラクターは、新しい PresentationRequest オブジェクトを作成し、そのオブジェクトによって新しい PresentationRequest が作成されます。
47
79
47
reconnect
実験的

reconnect(presentationId) メソッドが PresentationRequest プレゼンテーションリクエストで呼び出された場合、ユーザー エージェントはプレゼンテーションに再接続するために次の手順を実行しなければなりません。
47
79
47
secure_context_required
実験的

安全なコンテキストが必要
61
79
51
61
start
実験的

PresentationRequest インターフェイスの start() プロパティは、ユーザー エージェントがユーザーにディスプレイの選択とそのディスプレイの使用許可の付与を要求した後、PresentationConnection で解決される Promise を返します。
47
79
47
その他
html.elements.iframe.sandbox.allow-presentation

`sandbox="許可プレゼンテーション"`
53
79
50
53
1+対応 (バージョン) 未対応 ※注釈あり サブ機能の解説は MDN Web Docs (CC BY-SA 2.5)
注釈 1件
削除済み
  • このバージョンで機能が削除されました (61)

基本構文

JAVASCRIPT 
const request = new PresentationRequest('presentation.html');
const connection = await request.start();
connection.addEventListener('message', (e) => {
  console.log('Message:', e.data);
});
connection.send('Hello!');

実務での使いどころ

  • Presentation API の活用

    安全なコンテキスト用: この機能は一部またはすべての対応しているブラウザーにおいて、安全なコンテキスト (HTTPS) でのみ利用できます。

注意点

  • 一部のブラウザでのみ対応。使用前にブラウザサポートを確認すること。

アクセシビリティ

  • スクリーンリーダーでの読み上げを確認すること。

参考リンク