CaptureController: resetZoomLevel() 方法
CaptureController 接口的 resetZoomLevel() 方法会将捕获的显示表面缩放重置到初始级别 100。
resetZoomLevel() 方法必须通过 瞬时激活 调用。此外，当首次尝试屏幕捕获时，用户会被请求分享标签页的权限；如果用户拒绝权限，则即使有瞬时激活，缩放级别也无法更改。
语法
js
resetZoomLevel()
参数
无。
返回值
异常
InvalidStateErrorDOMException-
尝试在没有瞬时激活的情况下调用
resetZoomLevel()。 NotAllowedErrorDOMException-
抛出时
- 页面的
captured-surface-control权限策略不允许页面使用 Captured Surface Control API。 - 用户明确拒绝了捕获显示图面的权限。
- 页面的
示例
resetZoomLevel() 基本用法
以下代码段为按钮添加了事件监听器，以便在点击按钮时调用 resetZoom() 函数。该函数又调用 resetZoomLevel() 方法，将捕获的表面的缩放级别重置为 100。
js
// Create controller and start capture
const controller = new CaptureController();
videoElem.srcObject = await navigator.mediaDevices.getDisplayMedia({
controller,
});
// ...
resetBtn.addEventListener("click", resetZoom);
async function resetZoom() {
await controller.resetZoomLevel();
}
有关完整的可运行示例，请参阅 使用 Captured Surface Control API。
规范
| 规范 |
|---|
| Captured Surface Control # dom-capturecontroller-resetzoomlevel |
浏览器兼容性
加载中…