演示 API

演示显示器指通过实现特定的连接技术，用户代理可以访问的图形和/或音频输出设备。

演示连接是一个将控制浏览上下文与其接收浏览上下文关联起来的对象，并启用它们之间的双向消息传递。每个演示连接都有一个演示连接状态、一个唯一的演示标识符（用于将其与其他演示区分开来），以及一个演示 URL，该 URL 是一个用于创建或重新连接到演示的 URL。有效的演示标识符仅包含字母数字 ASCII 字符，并且至少有 16 个字符长。

由于功能、安全或硬件限制，某些演示显示器可能只能显示 Web 内容的子集。例如机顶盒、智能电视或仅能呈现音频的网络扬声器。如果控制用户代理可以合理地保证在该显示器上演示 URL 会成功，我们就说这样的显示器是演示 URL 的可用演示显示器。

控制浏览上下文（或简称控制器）是一个通过调用 start 或 reconnect 连接到演示的浏览上下文，或者通过 connectionavailable 事件接收到演示连接的浏览上下文。在 PresentationRequest 的算法中，控制浏览上下文是其 JavaScript 领域用于构造 PresentationRequest 的浏览上下文。

接收浏览上下文（或简称演示文稿）是负责向演示显示器呈现内容的浏览上下文。接收浏览上下文可以与控制浏览上下文位于同一个用户代理中，也可以位于不同的用户代理中。通过执行创建接收浏览上下文的步骤来创建接收浏览上下文。

在一个过程中，当过程在控制浏览上下文处启动时，目标浏览上下文是接收浏览上下文；如果过程在接收浏览上下文处启动，则目标浏览上下文是控制浏览上下文。

受控演示集（初始为空）包含由控制用户代理（或该用户代理中的特定用户配置文件）的控制浏览上下文创建的演示连接。受控演示集由表示底层演示连接的 PresentationConnection 对象列表表示。该集合中的多个 PresentationConnection 对象可能共享相同的演示 URL 和演示标识符，但对于给定的控制浏览上下文，只能有一个具有特定演示 URL 和演示标识符的 PresentationConnection。

演示控制器集（初始为空）包含由接收用户代理的接收浏览上下文创建的演示连接。演示控制器集由表示底层演示连接的 PresentationConnection 对象列表表示。此集合中的所有演示连接共享相同的演示 URL 和演示标识符。

在接收浏览上下文中，演示控制器监视器（初始设置为 null）向接收应用程序公开当前的演示控制器集。演示控制器监视器由 PresentationConnectionList 表示。

在接收浏览上下文中，演示控制器承诺（初始设置为 null）在建立初始演示连接后提供演示控制器监视器。演示控制器承诺由一个 Promise 表示，该 Promise 解析为演示控制器监视器。

在控制浏览上下文中，默认演示请求（初始设置为 null）表示当用户希望从浏览器界面启动演示连接时要使用的请求。

本规范中提到的任务的任务源是演示任务源。

当算法将演示 API 任务 T 排队时，用户代理必须使用当前领域的全局对象在演示任务源上将全局任务 T 排队。

除非另有说明，算法步骤构造的脚本对象的 JavaScript 域是当前域。

WebIDLpartial interface Navigator {
  [SecureContext, SameObject] readonly attribute Presentation presentation;
};

[SecureContext, Exposed=Window]
interface Presentation {
};

presentation 属性用于检索 Presentation 接口的实例。它必须返回 Presentation 实例。

控制用户代理必须实现以下部分接口：

WebIDLpartial interface Presentation {
      attribute PresentationRequest? defaultRequest;
    };

defaultRequest 属性必须返回默认演示请求（如果有），否则返回 null。当设置时，默认演示请求必须被设置为新值。

控制用户代理应仅在用户通过用户手势明确表达意图时（例如点击浏览器界面的按钮）使用默认演示请求来启动演示。

要使用默认演示请求启动演示，控制用户代理必须遵循从默认演示请求启动演示的步骤。

支持使用默认演示请求启动演示是 可选的。

注意

如果控制用户代理不支持从默认演示请求启动演示，那么该用户代理应忽略为 defaultRequest 设置的任何值。

接收用户代理必须实现以下部分接口：

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

receiver 属性必须返回与接收浏览上下文关联的 PresentationReceiver 实例，该实例由接收用户代理在接收浏览上下文被创建时创建。在任何其他浏览上下文（包括接收浏览上下文的子可导航对象）中，它必须返回 null。

注意

Web 开发者可以使用 navigator.presentation.receiver 来检测文档是否作为演示加载。

WebIDL[SecureContext, Exposed=Window]
interface PresentationRequest : EventTarget {
  constructor(USVString url);
  constructor(sequence<USVString> urls);
  Promise<PresentationConnection> start();
  Promise<PresentationConnection> reconnect(USVString presentationId);
  Promise<PresentationAvailability> getAvailability();

  attribute EventHandler onconnectionavailable;
};

PresentationRequest 对象与由控制浏览上下文发起的演示请求或重新连接相关联。PresentationRequest 对象必须在由控制浏览上下文提供的控制用户代理中实现。

当构造 PresentationRequest 时，提供的 urls 必须用作演示请求 URL 的列表，它们每一个都是该 PresentationRequest 实例的可能演示 URL。

当调用 PresentationRequest 构造函数时，控制用户代理必须执行以下步骤：

输入: url 或 urls，即演示请求 URL
输出: 一个新的 PresentationRequest 对象

如果文档对象的活动沙箱标志集设置了沙箱化演示文稿浏览上下文标志，则抛出 SecurityError 并中止这些步骤。
如果 urls 是一个空序列，则抛出 NotSupportedError 并中止所有剩余步骤。
如果提供了一个 url，则令 urls 为一个包含 url 的单项数组。
令 presentationUrls 为一个空的 URL 列表。
对于 urls 中的每个 URL U：
1. 令 A 为一个绝对 URL，它是相对于当前设置对象指定的 API 基本 URL 解析 U 的结果。
2. 如果解析 URL 算法失败，则抛出 SyntaxError 异常并中止所有剩余步骤。
3. 如果 A 的方案受控制用户代理支持，则将 A 添加到 presentationUrls。
如果 presentationUrls 是一个空列表，则抛出 NotSupportedError 并中止所有剩余步骤。
如果 presentationUrls 的任何成员不是潜在可信 URL，则抛出 SecurityError 并中止这些步骤。
构造一个新的 PresentationRequest 对象，其演示文稿请求 URL 为 presentationUrls，并返回它。

当调用 start 方法时，用户代理必须按以下步骤来选择一个演示显示设备。

输入: presentationRequest，接收到 start 调用的 PresentationRequest 对象
输出: 一个新的 Promise

如果文档的活动窗口没有瞬时激活，则返回一个因InvalidAccessError 异常而被拒绝的 Promise，并中止这些步骤。
令 topContext 为控制浏览上下文的顶层浏览上下文。
如果在 topContext 或 topContext 的任何后代可导航对象中的浏览上下文中，已存在先前调用 start 时产生的未解决的 Promise，则返回一个因 OperationError 异常而被拒绝的新 Promise，并中止所有剩余步骤。
令 P 为一个新的 Promise。
返回 P，但并行继续运行这些步骤。
如果用户代理未监视可用演示显示列表，则并行运行监视可用演示显示列表的步骤。
令 presentationUrls 为 presentationRequest 的演示请求 URL。
请求用户允许使用演示显示器并选择一个演示显示器。
如果以下任一情况为真：
1. 在请求用户权限完成之前，可用演示显示器列表为空并将保持为空。
2. 可用演示显示器列表中的任何成员都不是 presentationUrls 中任何成员的可用演示显示器。
则运行以下步骤：
1. 将演示 API 任务排队以使用 NotFoundError 异常拒绝 P。
2. 中止所有剩余步骤。
如果用户拒绝使用显示器的权限，则将演示 API 任务排队以使用NotAllowedError 异常拒绝 P，并中止所有剩余步骤。
否则，用户授予使用显示器的权限；令 D 为该显示器。
使用 presentationRequest、D 和 P 运行启动演示连接的步骤。

注

实现许可请求和显示选择的详细信息留给用户代理；例如，它可能显示对话框并允许用户选择可用的显示设备（授予许可），或取消选择（拒绝许可）。建议实现者显示当前是否正在使用某个可用的显示设备，以便支持能够使用多个显示设备的演示。

注

建议接收用户代理为演示显示设备提供一个用户友好的名称，例如“客厅电视”，以帮助用户选择所需的显示设备。建议接收用户代理的实现者提供该用户友好名称的区域设置和预期的文本方向信息。建议控制用户代理的实现者在已知的情况下，以用户友好名称的区域设置和文本方向显示该名称。

当用户通过浏览器界面（通过专用按钮、用户手势或其他信号）表达在演示显示设备上开始演示文档的意图时，用户代理必须执行以下步骤来从默认演示请求开始演示。如果文档上未设置默认演示请求，则不得运行这些步骤。

输入: W，用户表达意图要开始演示的文档; presentationRequest，非 null 的值，由 navigator.presentation.defaultRequest 在 W 上设置; D，作为演示目标的演示显示设备

并行运行以下步骤并行。
让 presentationUrls 为 presentationRequest 的演示请求 URL。
如果没有适合 D 作为可用演示显示设备的 presentationRequest 对应的演示请求 URL，则中止这些步骤。
运行启动演示连接的步骤，使用 presentationRequest 和 D。

注

当从默认演示请求开始演示时，控制用户代理可能允许用户请求演示并使用相同的用户手势选择目标演示显示设备。例如，浏览器界面可以允许用户从菜单中选择显示设备，或允许用户点击支持近场通信 (NFC) 的显示设备。

当用户代理要启动演示连接时，它必须执行以下步骤：

输入: presentationRequest，用于启动演示连接的 PresentationRequest; D，所选的演示显示设备; P，一个可选的 Promise，它将被解析为一个新的演示连接

断言：此操作正在并行运行。
将 I 设置为一个新的有效演示标识符，在所有已知的演示连接的受控演示集中唯一。为避免指纹识别，应将演示标识符设置为遵循 [rfc4122] 第 4.4 或 4.5 形式生成的 UUID。
创建一个新的 PresentationConnection S。
将 S 的演示标识符设置为 I。
让 presentationUrls 成为 presentationRequest 的演示请求 URL。
将 S 的演示 URL 设置为第一个存在于可用演示显示设备列表中的 (presentationUrl, D) 的 presentationUrl。
将 S 的演示连接状态设置为 connecting。
将 S 添加到受控演示集。
如果提供了 P，则排队一个演示 API 任务来解决 P 与 S。
将演示 API 任务排队以在 presentationRequest 处触发一个名为 connectionavailable 的事件，该事件使用 PresentationConnectionAvailableEvent 接口，并将 connection 属性初始化为 S。该事件不得冒泡且不得取消。
让 U 成为连接到 D 的用户代理。
如果下一步失败，取消所有剩余步骤并关闭演示连接 S，将 closeReason 设置为 error，并设置 closeMessage 为描述失败的可读信息。
使用特定实现机制，告知 U 使用 D、presentationUrl 和 I 作为参数创建接收浏览上下文。
建立演示连接与 S。

注

presentationUrl 应该命名一个本地或远程用户代理可以访问的资源。本规范定义了使用 http 或 https 协议的 presentationUrl 的行为；对于其他协议的行为，本规范未定义。

当调用 reconnect 方法时，用户代理必须运行以下步骤来重新连接到演示：

输入: presentationRequest，调用了 reconnect 的 PresentationRequest 对象; presentationId，一个有效的演示标识符
输出: P，一个新的 Promise

令 P 为一个新的 Promise。
返回 P，但并行继续运行这些步骤。
在受控演示集中搜索满足以下条件的 PresentationConnection：
- 其控制浏览上下文是当前的浏览上下文
- 其演示连接状态不是 terminated
- 其演示 URL 等于 presentationRequest 的演示请求 URL 之一
- 其演示标识符等于 presentationId
如果存在这样的 PresentationConnection，则运行以下步骤：
1. 令 existingConnection 为该 PresentationConnection。
2. 将演示 API 任务排队以使用 existingConnection 解析 P。
3. 如果 existingConnection 的演示连接状态为 connecting 或 connected，则中止所有剩余步骤。
4. 将 existingConnection 的演示连接状态设置为 connecting。
5. 使用 existingConnection 建立演示连接。
6. 中止所有剩余步骤。
在受控演示集中搜索第一个满足以下条件的 PresentationConnection：
- 其控制浏览上下文不是当前的浏览上下文
- 其演示连接状态不是 terminated
- 其演示 URL 等于 presentationRequest 的演示请求 URL 之一
- 其演示标识符等于 presentationId
如果存在这样的 PresentationConnection，则运行以下步骤：
1. 令 existingConnection 为该 PresentationConnection。
2. 创建一个新的 PresentationConnection newConnection。
3. 将 newConnection 的演示标识符设置为 presentationId。
4. 将 newConnection 的演示 URL 设置为 existingConnection 的演示 URL。
5. 将 newConnection 的演示连接状态设置为 connecting。
6. 将 newConnection 添加到受控演示集。
7. 将演示 API 任务排队以使用 newConnection 解析 P。
8. 将演示 API 任务排队以在 presentationRequest 处触发一个名为 connectionavailable 的事件，该事件使用 PresentationConnectionAvailableEvent 接口，并将 connection 属性初始化为 newConnection。该事件不得冒泡且不得取消。
9. 使用 newConnection 建立演示连接。
10. 中止所有剩余步骤。
将演示 API 任务排队以使用 NotFoundError 异常拒绝 P。

以下是对象实现 PresentationRequest 接口时必须支持的事件处理程序（及其对应的事件处理程序事件类型），作为事件处理程序 IDL 属性：

事件处理程序	事件处理程序事件类型
`onconnectionavailable`	`connectionavailable`

WebIDL[SecureContext, Exposed=Window]
interface PresentationAvailability : EventTarget {
  readonly attribute boolean value;

  attribute EventHandler onchange;
};

一个 PresentationAvailability 对象暴露了一个演示请求的演示显示可用性。一个演示请求的演示显示可用性记录是否当前至少有一个可用的演示显示设备适用于该请求的演示请求 URL。

当 ECMASCript 代码无法观察到 PresentationAvailability 对象时，该演示请求的演示显示可用性适用于垃圾回收。

如果控制用户代理能够在后台监控可用演示显示设备列表（无挂起的 start 请求），那么 PresentationAvailability 对象必须在控制浏览上下文中实现。

value 属性必须返回它的最后一次设置值。该值由监控可用演示显示设备列表算法初始化和更新。

onchange 属性是一个事件处理程序，其对应的事件处理程序事件类型是 change。

用户代理必须跟踪由 getAvailability 方法创建的演示可用性对象集合。演示可用性对象集合由一组元组 (A, availabilityUrls) 表示，初始为空，其中：

A 是一个活动的 PresentationAvailability 对象。
availabilityUrls 是当 getAvailability 在 PresentationRequest 上被调用时的演示请求 URL 列表。

用户代理必须保持一个可用演示显示设备列表。可用演示显示设备列表由元组列表 (availabilityUrl, display) 表示。此列表中的条目意味着 display 当前是 availabilityUrl 的一个可用演示显示设备。此演示显示设备列表可以用于启动新的演示，并根据具体实现的发现机制进行填充。它设置为用于监控可用演示显示设备列表算法的最新结果。

当演示可用性对象集合不为空时，用户代理可以持续监视可用演示显示器列表，以便页面可以使用 PresentationAvailability 对象的 value 属性仅在有可用显示器时提供演示。但是，用户代理可能不支持后台持续可用性监视；例如，由于平台或功耗限制。在这种情况下，getAvailability 返回的 Promise 将被拒绝，并且监视可用演示显示器列表的算法将仅作为选择演示显示器算法的一部分运行。

当演示可用性对象集合为空时（即没有被监控的 availabilityUrls），用户代理不应监控可用演示显示设备列表以满足节能非功能性要求。为了进一步节省电力，用户代理可以还跟踪持有 PresentationAvailability 对象的页面是否处于前台。使用这些信息，可以恢复或暂停实现特定的演示显示设备发现。

当调用 getAvailability 方法时，用户代理必须运行以下步骤：

输入: presentationRequest，接收到 getAvailability 调用的 PresentationRequest 对象
输出: 一个新的 Promise

令 P 为在 presentationRequest 的 JavaScript 领域中构造的一个新的 Promise。
返回 P，但并行继续运行这些步骤。
如果用户代理无法在后台持续监视可用演示显示器列表，但稍后可以找到演示显示器以启动连接，则：
1. 将演示 API 任务排队以使用 NotSupportedError 异常拒绝 P。
2. 中止所有剩余步骤。
如果 presentationRequest 的演示显示设备可用性不是 null，则：
1. 排队一个 Presentation API 任务以解析 P，并将请求的演示显示设备可用性作为结果返回。
2. 中止所有剩余的步骤。
将 presentationRequest 的演示显示设备可用性设置为一个在 presentationRequest 的 JavaScript 域中构造的新的 PresentationAvailability 对象，并将 A 设置为该对象。
创建一个元组 (A，presentationUrls)，并将其添加到演示可用性对象集合。
运行监控可用演示显示设备列表算法。

注意

监控算法在执行前一步后，至少还需要运行一次，以获取刚刚添加到演示可用性对象集合的元组。
排队一个 Presentation API 任务以解析 P 并返回 A。

如果演示可用性对象集合不为空，或有一个挂起的请求用于选择演示显示设备，则用户代理必须通过运行以下步骤来监控可用演示显示设备列表：

断言：此操作正在并行运行。
让 availabilitySet 为演示可用性对象集合的浅拷贝。
如果有一个挂起的请求用于选择演示显示设备，并且 PresentationRequest 的演示显示设备可用性为 null，则运行以下子步骤：
1. 创建一个新的 PresentationAvailability 对象，并将其命名为 A。
2. 创建一个元组(A, presentationUrls)，其中 presentationUrls 为 PresentationRequest 的演示请求 URL，并将其添加到 availabilitySet。
让 newDisplays 为一个空列表。
如果用户代理无法检索演示显示设备（例如，用户已禁用此功能），则跳过以下步骤。
检索演示显示设备（使用实现特定的机制），并将 newDisplays 设置为此列表。
将可用演示显示设备列表设置为空列表。
对于 availabilitySet 中的每个成员(A，availabilityUrls)，运行以下步骤：
1. 将 A 的 value 属性的值设置为 previousAvailability。
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。

注意

控制用户代理可以选择如何频繁地监控可用演示显示设备列表，包括将来自 start 和 getAvailability 的请求分组，并在多个浏览上下文之间聚合它们。

当演示显示设备可用性对象符合垃圾回收条件时，用户代理应该运行以下步骤：

令 A 为刚刚被回收的 PresentationAvailability 对象。
在演示可用性对象集合中查找并移除任何 (A, availabilityUrl)的条目。
如果演示可用性对象集合现在为空，并且没有挂起的选择演示显示设备请求，则取消任何挂起的用于监控可用演示显示设备列表的任务以节省电力，并将可用演示显示设备列表设置为空列表。

注意

用于监控演示显示设备可用性的机制以及确定某个演示显示设备与给定 URL 的兼容性由用户代理决定。

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 的事件。该事件在 PresentationRequest 实例上触发，使用 PresentationConnectionAvailableEvent 接口，并将 connection 属性设置为被创建的 PresentationConnection 对象。该事件针对为控制器创建的每个连接触发，无论是通过控制器调用 start 或 reconnect，还是由控制用户代理通过 defaultRequest 代表控制器创建连接。

当传入连接被创建时，接收用户代理会在 PresentationReceiver 上触发一个名为 connectionavailable 的事件。该事件在演示控制器监视器上触发，使用 PresentationConnectionAvailableEvent 接口，并将 connection 属性设置为被创建的 PresentationConnection 对象。该事件针对在监视传入演示连接时创建的所有连接触发。

connection 属性必须返回在创建 PresentationConnection 对象时设置的值。

当调用 PresentationConnectionAvailableEvent 构造函数时，用户代理必须构建一个新的 PresentationConnectionAvailableEvent 对象，并将其 connection 属性设置为传递给构造函数的 connection 成员的值。

每个展示连接都由一个 PresentationConnection 对象表示。控制用户代理和接收用户代理必须实现 PresentationConnection。

WebIDLenum PresentationConnectionState { "connecting", "connected", "closed", "terminated" };

[SecureContext, Exposed=Window]
interface PresentationConnection : EventTarget {
  readonly attribute USVString id;
  readonly attribute USVString url;
  readonly attribute PresentationConnectionState state;
  undefined close();
  undefined terminate();
  attribute EventHandler onconnect;
  attribute EventHandler onclose;
  attribute EventHandler onterminate;

  // Communication
  attribute BinaryType binaryType;
  attribute EventHandler onmessage;
  undefined send (DOMString message);
  undefined send (Blob data);
  undefined send (ArrayBuffer data);
  undefined send (ArrayBufferView data);
};

id 属性指定了展示连接的展示标识符。

url 属性指定了展示连接的展示 URL。

state 属性表示展示连接的当前状态。它可以是 PresentationConnectionState 中的值，具体取决于连接状态：

connecting 表示用户代理正在尝试与目标浏览上下文建立展示连接。这是创建 PresentationConnection 对象时的初始状态。
connected 表示展示连接已建立，可以进行通信。
closed 表示展示连接已关闭或无法打开。可以通过调用 reconnect 重新打开。无法进行通信。
terminated 表示接收浏览上下文已终止。与该展示的任何展示连接也已终止，且无法重新打开。无法进行通信。

注

connected 状态并不意味着发送或接收消息一定会成功，因为通信通道可能会随时突然关闭。希望尽早检测到此类情况的应用程序应实现自己的保活机制。

当调用 close 方法时，PresentationConnection S 的用户代理必须开始关闭展示连接 S， closeReason 设置为 closed，closeMessage 为空。

当调用 terminate 方法时， PresentationConnection S 在控制浏览上下文中，用户代理必须运行算法以终止控制浏览上下文中的展示。

当调用 terminate 方法时， PresentationConnection S 在接收浏览上下文中，用户代理必须运行算法以终止接收浏览上下文中的展示。

binaryType 属性可以取 BinaryType 中的一个值。当创建 PresentationConnection 对象时，其 binaryType 属性必须设置为字符串 "arraybuffer"。获取时，它必须返回最后设置的值。设置时，用户代理必须将属性设置为新值。

备注

binaryType 属性允许开发者控制二进制数据如何暴露给脚本。通过将该属性设置为 "blob"，二进制数据以 Blob 形式返回；通过将其设置为 "arraybuffer"，则以 ArrayBuffer 形式返回。该属性默认为 "arraybuffer"。此属性对以字符串形式发送的数据没有影响。

当在 PresentationConnection S 上调用 send 方法时，用户代理必须运行通过 S 发送消息的算法。

当 PresentationConnection 对象 S 被丢弃（因为拥有它的文档正在导航或已关闭），而 S 的演示连接状态为 connecting 或 connected 时，用户代理必须以 wentaway 作为 closeReason 并使用空的 closeMessage 来开始关闭演示连接 S。

如果用户代理从目标浏览上下文接收到要关闭 PresentationConnection S 的信号，它必须以 closed 或 wentaway 作为 closeReason 并使用空的 closeMessage 来关闭演示连接 S。

当用户代理需要使用展示连接来建立展示连接时，它必须执行以下步骤：

输入: presentationConnection，即需要连接的 PresentationConnection 对象

断言：此操作正在并行运行。
如果 presentationConnection 的展示连接状态不是 connecting，则终止所有后续步骤。
请求将 presentationConnection 连接到接收浏览上下文。该请求必须包含 presentationConnection 的展示标识符。
如果连接成功完成，将展示 API 任务排队，执行以下步骤：
1. 将 presentationConnection 的展示连接状态设置为 connected。
2. 触发一个事件，名为 connect，目标为 presentationConnection。
如果连接无法完成，则关闭展示连接 S，将 error 作为 closeReason，并提供描述故障的可读消息作为 closeMessage。

注

用于在远程显示上展示并连接控制浏览上下文与展示文档的机制由用户代理实现决定。连接必须提供一种双向消息传递抽象，能够按可靠且有序的方式传递 DOMString 和二进制有效负载，如以下发送消息和接收消息步骤中所述。

注

对于控制浏览上下文和接收浏览上下文之间的连接，没有强制规定特定的传输方式，只是对于多次调用 send，必须确保消息能够可靠且按顺序地传递到另一端。该传输应具有与可靠模式下的 RTCDataChannel 等效的功能。

设展示消息数据为在两个浏览上下文之间传输的有效数据。设展示消息类型为该数据的类型，可以是 text 或 binary。

当用户代理需要通过展示连接发送消息时，它必须执行以下步骤：

输入: presentationConnection，即与其他浏览上下文连接的展示连接; messageOrData，即要发送到其他浏览上下文的展示消息数据

如果 presentationConnection 的 state 属性不是 connected，则抛出一个 InvalidStateError 异常。
如果 presentationConnection 的关闭过程已开始，则中止这些步骤。
如果 messageOrData 的类型是 ArrayBuffer、ArrayBufferView 或 Blob，则令演示消息类型 messageType 为 binary。如果 messageOrData 的类型是 DOMString，则令 messageType 为 text。
使用实现特定的机制，将 messageOrData 的内容作为演示消息数据，并将 messageType 作为演示消息类型传输到目标浏览上下文。
如果上一步遇到不可恢复的错误，则以 error 作为 closeReason，并使用描述所遇到错误的 closeMessage 立即关闭演示连接 presentationConnection。

注

为了帮助应用程序从通过展示连接发送消息时发生的错误中恢复，用户代理应在 closeMessage 中包括有关哪个尝试失败的详细信息，并提供一个可读字符串来解释失败的原因。closeMessage 的示例：

Unable to send text message (network_error): "hello" 对于 DOMString 消息，其中 "hello" 是失败消息的前 256 个字符。
对于 ArrayBuffer、ArrayBufferView 和 Blob 消息，提示“无法发送二进制消息 (invalid_message)”。

注

当通过展示连接发送用户可见的字符串时，页面作者应确保传播语言环境信息，以便目标用户代理知道如何最好地呈现字符串。请参阅示例以了解一种解决方案。

当用户代理从远程端接收到包含展示消息数据和展示消息类型的传输内容时，它必须按以下步骤通过 PresentationConnection 接收消息：

输入: presentationConnection，接收消息的展示连接; messageType，消息的展示消息类型; messageData，消息的展示消息数据

断言：此操作正在并行运行。
如果 presentationConnection 的 state 属性不是 connected，则中止这些步骤。
令 event 为使用 MessageEvent 接口创建事件的结果，事件类型为 message，该事件不冒泡且不可取消。
按如下方式初始化 event 的 data 属性：
1. 如果 messageType 是 text，则将 event 的 data 属性初始化为类型为 DOMString 的 messageData。
2. 如果 messageType 是 binary，并且 binaryType 属性设置为 "blob"，则将 event 的 data 属性初始化为一个新的 Blob 对象，其原始数据为 messageData。
3. 如果 messageType 是 binary，并且 binaryType 属性设置为 "arraybuffer"，则将 event 的 data 属性初始化为一个新的 ArrayBuffer 对象，其内容为 messageData。
将演示 API 任务排队以在 presentationConnection 处触发 event。

如果用户代理在通过 presentationConnection 接收消息时遇到不可恢复的错误，它必须立即关闭展示连接 presentationConnection，并将 error 作为 closeReason。它应该使用人类可读的描述来解释遇到的错误，作为 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 = "";
};

当一个 PresentationConnectionCloseEvent 在展示连接进入 closed 状态时触发。 reason 属性提供了连接关闭的原因。它可以取以下值之一 PresentationConnectionCloseReason:

error 表示连接或通信机制遇到了不可恢复的错误。
closed 表示连接的控制浏览上下文或接收浏览上下文调用了 close()。
wentaway 表示浏览器关闭了连接，例如，因为拥有连接的浏览上下文已导航或被丢弃。

当 reason 属性为 error 时，用户代理 SHOULD 设置 message 属性为一个人类可读的描述，说明通信通道如何遇到错误。

当 PresentationConnectionCloseEvent 构造函数被调用时，用户代理 MUST 构造一个新的 PresentationConnectionCloseEvent 对象，其 reason 属性应设置为传递给构造函数的 PresentationConnectionCloseEventInit 对象的 reason 成员，其 message 属性应设置为该对象的 message 成员（如果已设置），否则应为空字符串。

当用户代理要开始关闭展示连接时，它 MUST 执行以下步骤：

输入: presentationConnection，要关闭的展示连接; closeReason，描述为什么要关闭连接的 PresentationConnectionCloseReason; closeMessage，包含关闭连接详细原因的可读消息

如果展示连接状态不是 connecting 或 connected，则中止剩余步骤。
将展示连接状态设置为 closed。
开始向目标浏览上下文发出信号，传达关闭相应 PresentationConnection 的意图，并将 closeReason 传递给该上下文。用户代理不需要等待确认相应的 PresentationConnection 实际关闭即可继续下一步。
如果 closeReason 不是 wentaway，则本地执行关闭展示连接的步骤，使用 presentationConnection、closeReason 和 closeMessage。

当用户代理要关闭展示连接时，它 MUST 执行以下步骤：

输入: presentationConnection，要关闭的展示连接; closeReason，描述关闭连接原因的 PresentationConnectionCloseReason; closeMessage，包含关闭连接原因的可读消息。

如果有待处理的关闭展示连接任务，或者关闭展示连接任务已经为 presentationConnection 运行过，则中止剩余步骤。
排队执行展示 API 任务，执行以下步骤：
1. 如果展示连接状态不是 connecting、connected 或 closed，则中止剩余步骤。
2. 如果 presentationConnection 状态还不是 closed，则将其设置为 closed。
3. 如果 presentationConnection 是作为监控传入展示连接的结果在接收浏览上下文中创建的，请执行以下子步骤：
  1. 从展示控制器集合中移除 presentationConnection。
  2. 使用展示控制器集合填充展示控制器监控器。
4. 触发一个事件，名为 close，该事件使用 PresentationConnectionCloseEvent 接口，并将 reason 属性初始化为 closeReason，并将 message 属性初始化为 closeMessage，目标为 presentationConnection。该事件不得冒泡且不得取消。

当控制用户代理要在控制浏览上下文中终止展示时使用 connection，它 MUST 执行以下步骤：

如果 connection 的展示连接状态不是 connected 或 connecting，则中止这些步骤。
否则，对于控制用户代理中的受控展示集合中的每个 known connection：
1. 如果 known connection 和 connection 的演示标识符相等，并且 known connection 的演示连接状态为 connected 或 connecting，则在给定 known connection 的相关全局对象的演示任务源上将全局任务排队以运行以下步骤：
  1. 将 known connection 的演示连接状态设置为 terminated。
  2. 在 known connection 处触发一个名为 terminate 的事件。
并行地，使用实现特定的机制，向其接收用户代理发送该演示的终止请求。

当以下任意情况发生时，接收用户代理 MUST 终止在接收浏览上下文中的展示：

接收用户代理将要卸载与接收浏览上下文对应的文档，例如，响应将该上下文导航到新资源的请求。
用户通过接收用户代理请求终止展示。

Note

这可能是用户的显式操作，也可能是用户代理的策略。例如，接收用户代理可能配置为终止所有 PresentationConnection 对象已关闭 30 分钟的展示。
控制用户代理发送终止请求给该展示的接收用户代理。

当接收用户代理要终止在接收浏览上下文中的展示时，它 MUST 执行以下步骤：

让 P 为要终止的展示，allControllers 为为 P 创建的展示控制器集合，并将 connectedControllers 设置为空列表。
对于 allControllers 中的每个 connection，运行以下步骤：
1. 如果 connection 的展示连接状态是 connected，则将 connection 添加到 connectedControllers。
2. 将 connection 的展示连接状态设置为 terminated。
如果 P 存在一个接收浏览上下文，并且它有一个用于 P 的尚未卸载的文档，则卸载与该浏览上下文对应的文档，从用户界面中移除该浏览上下文并将其丢弃。
对于 connectedControllers 中的每个 connection，使用特定实现机制向拥有 connection 的控制用户代理发送展示的终止确认。

Note

每个控制用户代理只需发送一次终止确认。

当接收用户代理发送展示 P 的终止确认，并且该确认由控制用户代理接收时，控制用户代理 MUST 运行以下步骤：

对于受控演示集中连接到 P 的每个 connection，在给定 connection 的相关全局对象的演示任务源上将全局任务排队以运行以下步骤：
1. 如果 connection 的演示连接状态不是 connected 或 connecting，则中止以下步骤。
2. 将 connection 的演示连接状态设置为 terminated。
3. 在 connection 处触发一个名为 terminate 的事件。

以下是必须支持的事件处理程序（及其对应的事件处理程序事件类型），作为实现 PresentationConnection 接口的对象的事件处理程序 IDL 属性：

事件处理程序	事件处理程序事件类型
`onmessage`	`message`
`onconnect`	`connect`
`onclose`	`close`
`onterminate`	`terminate`

WebIDL[SecureContext, Exposed=Window]
interface PresentationReceiver {
  readonly attribute Promise<PresentationConnectionList> connectionList;
};

PresentationReceiver 接口允许接收浏览上下文访问控制浏览上下文并与其通信。PresentationReceiver 接口 MUST 实现在由接收用户代理提供的接收浏览上下文中。

当获取时，connectionList 属性 MUST 返回运行以下步骤的结果：

如果展示控制器的 promise 不为 null，则返回展示控制器的 promise 并中止所有剩余步骤。
否则，令演示控制器 promise 为一个新的 Promise，它在此 PresentationReceiver 对象的JavaScript 领域中构造。
返回展示控制器的 promise。
如果展示控制器监视器不为 null，则使用展示控制器监视器解析展示控制器的 promise。

当用户代理要创建一个接收浏览上下文时，它 MUST 运行以下步骤：

输入: D，由用户选择的展示设备; presentationUrl，展示请求 URL; presentationId，展示标识符

创建一个新的顶层浏览上下文 C，设置为在 D 上显示内容。
将 C 的会话历史设置为空列表。
在 C 上设置沙盒模态框标志和沙盒辅助导航浏览上下文标志。
如果接收用户代理实现了 [PERMISSIONS]，则将 C 的所有权限描述符类型的权限状态设置为 "denied"。
为 C 创建一个新的空 Cookie 存储。
为 C 创建一个新的空存储，用于保存HTTP 身份验证状态。
为 C 创建一个新的空存储，用于会话存储区域和本地存储区域。
如果接收用户代理实现了 [INDEXEDDB]，则为 C 的 IndexedDB 数据库创建一个新的空存储。
如果接收用户代理实现了 [SERVICE-WORKERS]，则为 C 创建一个新的空服务工作者注册列表和一个新的空Cache 对象集合。
将 C 导航到 presentationUrl。
使用 presentationId 和 presentationUrl 为 C 开始监视传入的演示连接。

由呈现的文档创建的所有子可导航对象，即以接收浏览上下文作为其顶层浏览上下文的子可导航对象，必须也具有上述限制 2-4。此外，它们必须设置无用户激活的沙盒顶层导航浏览上下文标志。所有这些浏览上下文必须也为上面列出的功能 5-10 共享相同的浏览状态（存储）。

当顶层浏览上下文尝试导航到新资源并运行导航步骤时，它必须遵循步骤 1 来确定是否允许导航。此外，它不得允许将自身导航到新资源，除非通过导航到片段标识符或通过重新加载其文档。

注意

这允许用户根据选择演示显示器时显示的演示 URL 的来源授予权限。

如果顶层浏览上下文不允许导航，则它不应提供在新顶层浏览上下文中打开资源的功能，但否则应与导航步骤保持一致。

与接收浏览上下文及其后代可导航对象关联的窗口客户端和工作者客户端不得暴露给相互关联的服务工作者。

当接收浏览上下文终止时，与其关联的任何服务工作者以及其后代可导航对象中的浏览上下文必须被注销和终止。与接收浏览上下文及其后代可导航对象中的浏览上下文关联的任何浏览状态，包括会话历史、Cookie 存储、任何HTTP 身份验证状态、任何数据库、会话存储区域、本地存储区域、服务工作者注册列表和Cache 对象必须被丢弃，并且不得用于任何其他浏览上下文。

注意

此算法旨在创建一个明确定义的环境，以便为单用户代理和双用户代理演示提供可互操作的行为，并最大限度地减少用于双用户代理演示的演示显示器上剩余的状态量。

接收用户代理应在接收浏览上下文中使用反映控制用户代理语言首选项的 HTTP Accept-Language 标头获取资源（即，使用控制用户代理本应发送的相同 Accept-Language）。这将有助于接收用户代理使用反映用户首选项的字体和特定于区域设置的属性来呈现演示。

注意

鉴于演示显示器的操作环境，某些 Web API 将因设计原因（例如，需要用户输入）而无法工作，或者将过时（例如，尝试窗口管理）；接收用户代理应意识到这一点。此外，任何模态用户界面都需要仔细处理。沙盒模态框标志设置在接收浏览上下文上，以防止大多数这些操作。

注意

如一致性中所述，既是控制用户代理又是接收用户代理的用户代理可以允许接收浏览上下文创建其他演示（从而也成为控制浏览上下文）。Web 开发人员可以使用 navigator.presentation.receiver 来检测文档何时作为接收浏览上下文加载。

WebIDL[SecureContext, Exposed=Window]
interface PresentationConnectionList : EventTarget {
  readonly attribute FrozenArray<PresentationConnection> connections;
  attribute EventHandler onconnectionavailable;
};

connections 属性 MUST 返回在展示控制器集合中的非终止展示连接集合。

当接收用户代理开始在接收浏览上下文中监控传入的展示连接来自控制浏览上下文时，必须监听并接受来自控制浏览上下文的传入连接请求，使用实现特定的机制。当收到来自控制浏览上下文的新连接请求时，接收用户代理必须运行以下步骤：

输入: I，由控制浏览上下文随传入连接请求一起传递的展示标识符; presentationId，用于创建接收浏览上下文的展示标识符; presentationUrl，用于创建接收浏览上下文的展示请求URL

断言：此操作正在并行运行。
如果 presentationId 和 I 不相等，拒绝连接并终止所有剩余步骤。
创建一个新的 PresentationConnection S。
将 S 的展示标识符设置为 I。
将 S 的展示URL 设置为 presentationUrl。
使用实现特定的机制在控制和接收浏览上下文之间建立连接。
如果连接建立成功，设置 S 的展示连接状态为 connected。否则，设置 S 的展示连接状态为 closed，并终止所有剩余步骤。
将 S 添加到展示控制器集合中。
如果演示控制器监视器为 null，则并行运行以下步骤。
1. 让展示控制器监视器为一个新构建的 PresentationConnectionList，构建在 JavaScript 环境中的 PresentationReceiver 对象。
2. 使用展示控制器集合填充展示控制器监视器。
3. 如果展示控制器承诺不为 null，队列一个展示API任务，并解决展示控制器承诺与展示控制器监视器。
4. 终止所有剩余步骤。
否则，并行运行以下步骤。
1. 使用演示控制器集合填充演示控制器监视器。
2. 将演示 API 任务排队，以在演示控制器监视器处触发一个名为 connectionavailable 的事件，该事件使用 PresentationConnectionAvailableEvent 接口，并将 connection 属性初始化为 S。该事件不得冒泡且不得取消。

以下是由实现 PresentationConnectionList 接口的对象支持的事件处理程序（及其对应的事件处理程序事件类型），作为事件处理程序的IDL属性：

事件处理程序	事件处理程序事件类型
`onconnectionavailable`	`connectionavailable`

1-UA 模式 §1.
2-UA 模式 §1.
允许导航 §4.
可用演示显示器 §6.1
binaryType PresentationConnection 的属性 §6.5
更改 §6.4
close PresentationConnection 的方法 §6.5
关闭演示连接 §6.5.5
已关闭
- 枚举值为 PresentationConnectionState 的 closed §6.5
- 枚举值为 PresentationConnectionCloseReason 的 closed §6.5.4
连接 §6.5.9
"connected" PresentationConnectionState 的枚举值 §6.5
"connecting" PresentationConnectionState 的枚举值 §6.5
连接
- 属性属于 PresentationConnectionAvailableEvent §6.4.5
- 成员属于 PresentationConnectionAvailableEventInit §6.4.5
连接可用 §6.3.6
connectionList PresentationReceiver 的属性 §6.6
connections PresentationConnectionList 的属性 §6.7
构造函数
- PresentationRequest 的构造函数 §6.3
- PresentationRequest 的重载构造函数 §6.3
- PresentationConnectionAvailableEvent 的构造函数 §6.4.5
- PresentationConnectionCloseEvent 的构造函数 §6.5.4
控制浏览上下文 §6.1
控制用户代理 §3.1
创建接收浏览上下文 §6.6.1
创建新浏览上下文 §4.
数据库 §4.
默认演示请求 §6.1
defaultRequest Presentation 的属性 §6.2.1
目标浏览上下文 §6.1
"error" PresentationConnectionCloseReason 的枚举值 §6.5.4
建立演示连接 §6.5.1
getAvailability PresentationRequest 的方法 §6.4.3
id PresentationConnection 的属性 §6.5
可用演示显示器列表 §6.4.2
本地存储区 §4.
消息
- 属性属于 PresentationConnectionCloseEvent §6.5.4
- 成员属于 PresentationConnectionCloseEventInit §6.5.4
监控可用演示显示器列表 §6.4.4
监控传入的演示连接 §6.7.1
导航到片段标识符 §4.
onchange PresentationAvailability 的属性 §6.4
onclose PresentationConnection 的属性 §6.5.9
onconnect PresentationConnection 的属性 §6.5.9
onconnectionavailable
- PresentationRequest 的属性 §6.3.6
- PresentationConnectionList 的属性 §6.7.2
onmessage PresentationConnection 的属性 §6.5.9
onterminate PresentationConnection 的属性 §6.5.9
解析 URL §4.
presentation Navigator 的属性 §6.2
Presentation 接口 §6.2
演示连接 §6.1
演示连接状态 §6.1
演示控制器监视器 §6.1
演示控制器 promise §6.1
演示显示器 §6.1
演示显示器可用性 §6.4
演示标识符 §6.1
演示消息数据 §6.5.2
演示消息类型 §6.5.2
演示请求 URL §6.3
演示任务源 §6.1
演示 URL §6.1
PresentationAvailability 接口 §6.4
PresentationConnection 接口 §6.5
PresentationConnectionAvailableEvent 接口 §6.4.5
PresentationConnectionAvailableEventInit 字典 §6.4.5
PresentationConnectionCloseEvent 接口 §6.5.4
PresentationConnectionCloseEventInit 字典 §6.5.4
PresentationConnectionCloseReason 枚举 §6.5.4
PresentationConnectionList 接口 §6.7
PresentationConnectionState 枚举 §6.5
PresentationReceiver 接口 §6.6
PresentationRequest 接口 §6.3
队列一个 Presentation API 任务 §6.1
原因
- 属于 PresentationConnectionCloseEvent 的属性 §6.5.4
- 属于 PresentationConnectionCloseEventInit 的成员 §6.5.4
接收消息 §6.5.3
receiver Presentation 的属性 §6.2.2
接收浏览上下文 §6.1
接收用户代理 §3.1
reconnect PresentationRequest 的方法 §6.3.5
重新加载文档 §4.
选择演示显示器 §6.3.2
send PresentationConnection 的方法 §6.5
发送消息 §6.5.2
发送终止请求 §6.5.6
会话历史记录 §4.
会话存储区 §4.
受控演示集 §6.1
演示可用性对象集 §6.4.1
演示控制器集 §6.1
start PresentationRequest 的方法 §6.3.2
启动演示连接 §6.3.4
从默认演示请求启动演示 §6.3.3
开始关闭演示连接 §6.5.5
state PresentationConnection 的属性 §6.5
terminate PresentationConnection 的方法 §6.5
在控制浏览上下文中终止演示 §6.5.6
在接收浏览上下文中终止演示 §6.5.7
"terminated" PresentationConnectionState 的枚举值 §6.5
卸载文档 §4.
url PresentationConnection 的属性 §6.5
用户代理 §3.1
有效演示标识符 §6.1
value PresentationAvailability 的属性 §6.4
"wentaway" PresentationConnectionCloseReason 的枚举值 §6.5.4

[DIAL] 定义以下术语：
- DIAL
[DOM] 定义以下术语：
- 创建事件
- Event 接口
- EventInit
- EventTarget 接口
- 触发事件
[ECMASCRIPT] 定义以下术语：
- JavaScript realm
- 被拒绝的（rejected）
- 被解决的（resolved）
[FILEAPI] 定义以下术语：
- Blob 接口
[HTML] 定义以下术语：
- 活动沙盒标志集（用于 Document）
- 活动窗口（用于 navigable）
- 浏览上下文
- 子可导航对象
- 当前设置对象
- 后代可导航对象（用于 Document）
- 事件处理程序
- 事件处理程序事件类型
- EventHandler
- 全局对象
- 并行执行
- localStorage 属性（用于 WindowLocalStorage）
- MessageEvent 接口
- 导航
- Navigator 接口
- 队列一个全局任务
- 相关的全局对象
- reload()（用于 Location）
- 辅助导航沙盒标志
- 模态对话框沙盒标志
- 演示沙盒浏览上下文标志
- 无用户激活的顶级导航沙盒浏览上下文标志
- sessionStorage 属性（用于 WindowSessionStorage）
- 任务源
- 顶级浏览上下文
- 临时激活
[INFRA] 定义以下术语：
- 断言
[PERMISSIONS] 定义以下术语：
- 权限描述符类型（用于强大功能）
- 权限状态
[RFC4122] 定义以下术语：
- UUID
[RFC6265] 定义以下术语：
- Cookie 存储
[RFC9110] 定义以下术语：
- Accept-Language
- HTTP 认证
[SECURE-CONTEXTS] 定义以下术语：
- 潜在可信 URL
[SERVICE-WORKERS] 定义以下术语：
- Cache 接口
- 服务工作者注册
- 服务工作者
- 窗口客户端（用于服务工作者客户端）
- 工作者客户端（用于服务工作者客户端）
[URL] 定义以下术语：
- URL
[WEBIDL] 定义以下术语：
- ArrayBuffer 接口
- ArrayBufferView
- boolean 类型
- DOMString 接口
- [Exposed] 扩展属性
- FrozenArray 接口
- InvalidAccessError 异常
- InvalidStateError 异常
- NotAllowedError 异常
- NotFoundError 异常
- NotSupportedError 异常
- OperationError 异常
- Promise 接口
- [SameObject] 扩展属性
- [SecureContext] 扩展属性
- SecurityError 异常
- sequence
- SyntaxError 异常
- 抛出（用于 exception）
- undefined 类型
- USVString 接口
[WEBRTC] 定义以下术语：
- RTCDataChannel 接口
[WEBSOCKETS] 定义以下术语：
- BinaryType 枚举

演示 API

摘要

本文档状态

1. 引言

2. 用例和需求

3. 一致性

3.1 一致性类别

4. 术语

5. 示例

5.1 监控演示显示器的可用性

5.2 启动新演示

5.3 重新连接到现有演示

5.4 由控制用户代理启动演示

5.5 监控连接状态和交换数据

5.6 监听传入的演示连接

5.7 使用消息传递区域信息

5.8 从同一控制页面创建第二个演示

6. API

6.1 常见惯用法

6.2 接口 Presentation

6.2.1 控制用户代理

6.2.2 接收用户代理

6.3 接口 PresentationRequest

6.3.1 构造 PresentationRequest

6.3.2 选择一个演示显示设备

6.3.3 从默认演示请求开始演示

6.3.4 启动演示连接

6.3.5 重新连接到演示

6.3.6 事件处理程序

6.4 接口 PresentationAvailability

6.4.1 演示可用性对象集合

6.4.2 可用演示显示设备列表

6.4.3 获取演示显示设备的可用性信息

6.4.4 监控可用演示显示设备列表

6.4.5 接口 PresentationConnectionAvailableEvent

6.5 接口 PresentationConnection

6.5.1 建立展示连接

6.5.2 通过 PresentationConnection 发送消息

6.5.3 通过 PresentationConnection 接收消息

6.5.4 接口 PresentationConnectionCloseEvent

6.5.5 关闭 PresentationConnection

6.5.6 在控制浏览上下文中终止展示

6.5.7 在接收浏览上下文中终止展示

6.5.8 在控制用户代理中处理终止确认

6.5.9 事件处理程序

6.6 接口 PresentationReceiver

6.6.1 创建接收浏览上下文

6.7 接口 PresentationConnectionList

6.7.1 监控传入的展示连接

6.7.2 事件处理程序

7. 安全性和隐私考虑

7.1 个人身份信息

7.2 跨域访问

7.3 用户界面指南

7.4 设备访问

7.5 临时标识符和浏览器状态

7.6 私密浏览模式和清除浏览数据

7.7 演示连接之间的消息传递

A. IDL 索引

B. 索引

B.1 本规范定义的术语

B.2 引用定义的术语

C. 致谢

D. 候选推荐退出标准

E. 变更记录

E.1 自2017年6月1日以来的更改

E.2 自2016年7月14日以来的更改

F. 参考文献

F.1 规范性引用

F.2 参考性引用

6.2 接口 `Presentation`

6.3 接口 `PresentationRequest`

6.3.1 构造 `PresentationRequest`

6.4 接口 `PresentationAvailability`

6.4.5 接口 `PresentationConnectionAvailableEvent`

6.5 接口 `PresentationConnection`

6.5.2 通过 `PresentationConnection` 发送消息

6.5.3 通过 `PresentationConnection` 接收消息

6.5.4 接口 `PresentationConnectionCloseEvent`

6.5.5 关闭 `PresentationConnection`

6.6 接口 `PresentationReceiver`

6.7 接口 `PresentationConnectionList`