RemotePlayback: prompt() method

Limited availability

This feature is not Baseline because it does not work in some of the most widely-used browsers.

Phương thức prompt() của giao diện RemotePlayback nhắc người dùng chọn một thiết bị phát từ xa khả dụng và cấp quyền cho nội dung phương tiện hiện tại được phát bằng thiết bị đó.

Nếu người dùng cấp quyền, state sẽ được đặt thành connecting và tác nhân người dùng sẽ kết nối với thiết bị để bắt đầu phát.

Nếu người dùng chọn ngắt kết nối khỏi thiết bị, state sẽ được đặt thành disconnected và tác nhân người dùng sẽ ngắt kết nối khỏi thiết bị này.

Cú pháp

prompt()

InvalidStateError DOMException: Được ném ra nếu disableRemotePlayback là true cho phần tử phương tiện.
OperationError DOMException: Được ném ra nếu đã có một promise chưa được giải quyết từ lần gọi prompt() trước đó cho phần tử phương tiện hoặc ngữ cảnh duyệt web này.
InvalidAccessError DOMException: Được ném ra nếu người dùng chưa tương tác với thiết bị này gần đây.
NotSupportedError DOMException: Được ném ra nếu tác nhân người dùng biết rằng phát từ xa của phương tiện cụ thể này không khả thi.
NotFoundError DOMException: Được ném ra nếu phát từ xa không khả dụng.
NotAllowedError DOMException: Được ném ra nếu người dùng từ chối quyền sử dụng thiết bị.

Bảo mật

Cần có kích hoạt người dùng tạm thời. Người dùng phải tương tác với trang hoặc phần tử giao diện người dùng để tính năng này hoạt động.

Ví dụ

Trong ví dụ sau, người dùng được nhắc chọn một thiết bị phát từ xa để phát video.

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