diff --git a/zh-cn/application-dev/reference/apis/js-apis-screenshot.md b/zh-cn/application-dev/reference/apis/js-apis-screenshot.md index c0126a92a3da3dd958331483243e69f3a46b12f2..903b57b281a2f7e1d8ab54da0a29fd680162feea 100644 --- a/zh-cn/application-dev/reference/apis/js-apis-screenshot.md +++ b/zh-cn/application-dev/reference/apis/js-apis-screenshot.md @@ -55,7 +55,7 @@ import screenshot from '@ohos.screenshot'; ## screenshot.save -save(options?: ScreenshotOptions, callback: AsyncCallback<image.PixelMap>): void +save(options: ScreenshotOptions, callback: AsyncCallback<image.PixelMap>): void 获取屏幕截图。 @@ -67,7 +67,7 @@ save(options?: ScreenshotOptions, callback: AsyncCallback<image.PixelMap>) | 参数名 | 类型 | 必填 | 说明 | | -------- | --------------------------------------- | ---- | ------------------------------------------------------------ | -| options | [ScreenshotOptions](#screenshotoptions) | 否 | 该类型的参数包含screenRect,imageSize,rotation, displayId四个参数,可以分别设置这四个参数。 | +| options | [ScreenshotOptions](#screenshotoptions) | 是 | 该类型的参数包含screenRect、imageSize、rotation、displayId四个参数,可以分别设置这四个参数。 | | callback | AsyncCallback<[image.PixelMap](js-apis-image.md#pixelmap7)> | 是 | 回调函数。返回一个PixelMap对象。 | **示例:** @@ -97,6 +97,35 @@ save(options?: ScreenshotOptions, callback: AsyncCallback<image.PixelMap>) ## screenshot.save +save(callback: AsyncCallback<image.PixelMap>): void + +获取屏幕截图。 + +**系统能力:** SystemCapability.WindowManager.WindowManager.Core + +**需要权限**:ohos.permission.CAPTURE_SCREEN,仅系统应用可用。 + +**参数:** + +| 参数名 | 类型 | 必填 | 说明 | +| -------- | --------------------------------------- | ---- | ------------------------------------------------------------ | +| callback | AsyncCallback<[image.PixelMap](js-apis-image.md#pixelmap7)> | 是 | 回调函数。返回一个PixelMap对象。 | + +**示例:** + + ```js + screenshot.save((err, pixelMap) => { + if (err) { + console.log('Failed to save screenshot: ' + JSON.stringify(err)); + return; + } + console.log('Succeeded in saving sreenshot. Pixel bytes number: ' + pixelMap.getPixelBytesNumber()); + pixelMap.release(); // PixelMap使用完后及时释放内存 + }); + ``` + +## screenshot.save + save(options?: ScreenshotOptions): Promise<image.PixelMap> 获取屏幕截图。