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

規範

瀏覽器相容性