智能客服
你问我答，随时在线为你解决问题
高级筛选
API version全部版本
设备全部
元服务API集不筛选
API参考概述
应用框架
系统
媒体
图形
应用服务
AI
公共基础能力
标准库
您当前正在浏览HarmonyOS最新文档，覆盖已发布的所有API版本，可在API参考中筛选您使用的API版本。详细的版本配套关系请参考版本说明。
Class (ScreenCaptureHandler)
Phone12+PC/2in113+Tablet12+TV19+Wearable18+
更新时间: 2026-08-29 09:41
ScreenCaptureHandler是Web组件提供的屏幕捕获权限处理类，用于响应网页发起的屏幕捕获请求。该类适用于在线教育、远程会议、屏幕共享等需要获取用户屏幕内容的应用场景。该类允许开发者通过grant或deny方法控制是否授予网页屏幕捕获权限，并通过getOrigin方法获取请求来源信息，帮助开发者在保护用户隐私的同时，灵活处理网页的屏幕捕获访问需求，提升应用的安全性和用户体验。示例代码参考onScreenCaptureRequest事件。
说明
constructor10+
Phone12+PC/2in113+Tablet12+TV19+Wearable18+
constructor()
ScreenCaptureHandler的构造函数。
系统能力： SystemCapability.Web.Webview.Core
deny10+
Phone12+PC/2in113+Tablet12+TV19+Wearable18+
deny(): void
拒绝网页发起的屏幕捕获操作。用于用户选择不允许，或出于安全原因需要阻止屏幕捕获时调用。调用后将终止当前的屏幕捕获请求，系统会通知网页屏幕捕获权限被拒绝。拒绝操作不影响后续新的屏幕捕获请求。
系统能力： SystemCapability.Web.Webview.Core
getOrigin10+
Phone12+PC/2in113+Tablet12+TV19+Wearable18+
getOrigin(): string
获取网页来源。用于验证请求来源的可信度，或实现白名单机制以控制哪些网页可以进行屏幕捕获。
系统能力： SystemCapability.Web.Webview.Core
返回值：
展开
| 类型 | 说明 |
|---|---|
| string | 当前发起屏幕捕获请求的网页的来源。 |
grant10+
Phone12+PC/2in113+Tablet12+TV19+Wearable18+
grant(config: ScreenCaptureConfig): void
对网页访问的屏幕捕获操作进行授权。该方法会根据提供的配置参数授予屏幕捕获权限，授权后网页可以按照配置的参数进行屏幕捕获。配置参数会被验证，确保符合系统安全要求。用于用户同意网页的屏幕捕获请求后调用，或根据业务策略自动授权可信网页时使用。
系统能力： SystemCapability.Web.Webview.Core
参数：
展开
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| config | ScreenCaptureConfig | 是 | 屏幕捕获配置，用于设置屏幕捕获的相关参数。 |
相关推荐
华为开发者联盟 版权所有 ©2026
在 API参考 中进行搜索
请输入您想要搜索的关键词