RemotePlayback: prompt() 方法

语法

prompt()

参数

无。

返回值

一个 Promise，在用户接受或拒绝提示后，将以 undefined 解析。

异常

Promise 将会因为以下异常之一而被拒绝：

InvalidStateError DOMException

如果媒体元素的 disableRemotePlayback 为 true，则抛出此异常。

OperationError DOMException

如果对于该媒体元素或浏览上下文，之前调用 prompt() 已有一个未完成的 Promise。

InvalidAccessError DOMException

如果用户最近没有与该设备进行交互。

NotSupportedError DOMException

如果用户代理知道该特定媒体无法进行远程播放。

NotFoundError DOMException

如果远程播放不可用。

NotAllowedError DOMException

如果用户拒绝使用该设备的权限。

安全

需要瞬时用户激活。用户必须与页面或 UI 元素进行交互才能使此功能正常工作。

示例

在下面的示例中，将提示用户选择一个远程播放设备来播放视频。

devicesBtn.onclick = () => {
  // Request the user to select a remote playback device.
  videoElem.remote
    .prompt()
    // Update the UI and monitor the connected state.
    .then(updateRemotePlaybackState);
  // Otherwise, the user cancelled the selection UI or no screens were found.
};

规范

浏览器兼容性