media_projection - 屏幕截图

media_projection 模块提供了屏幕截图功能。类似 Pro 8 中的截图函数已迁移到此模块。

请求截图权限需要启动新的 Activity，因此在 Android 10 及以上，只有应用在前台时才能申请，并且截图期间需要保持前台服务运行，否则会无法收到新截图。

目录

类

• ScreenCapturer

枚举

• Orientation

接口

• ScreenCaptureOptions

函数

• requestScreenCapture

函数

requestScreenCapture

▸ requestScreenCapture(options?, context?): Promise<ScreenCapturer>

请求截图权限，并返回 ScreenCapturer 对象的 Promise。如果用户拒绝或遇到错误，则会抛出一个 ScreenCaptureRequestError。

请求截图权限需要启动新的 Activity，因此在 Android 10 及以上，只有应用在前台时才能申请，并且截图期间需要保持前台服务运行，否则会无法收到新截图。

示例

"nodejs";
const { requestScreenCapture } = require("media_projection");

async function main() {
  const capturer = await requestScreenCapture();
  const img = await capturer.nextImage();
  console.log(img);
}
main();

参数

名称	类型	描述
options	ScreenCaptureOptions	截图选项，包括宽度、高度、像素密度、方向等
context	android.content.Context	用于启动请求截图权限的 Activity 的 Context，一般无需此参数

返回值

Promise<ScreenCapturer>

返回一个 Promise，resolve 时返回 ScreenCapturer 对象。

抛出

• ScreenCaptureRequestError - 当用户拒绝或遇到错误时抛出