From d5023979b63a0f478b07535d78a6ce97c76c54de Mon Sep 17 00:00:00 2001 From: lovechinamo Date: Tue, 7 Jun 2022 18:32:48 +0800 Subject: [PATCH] Signed-off-by: lovechinamo Changes to be committed: --- .../reference/apis/js-apis-request.md | 16 ++++- .../reference/apis/js-apis-wallpaper.md | 62 +++++++++++++++++++ 2 files changed, 76 insertions(+), 2 deletions(-) diff --git a/zh-cn/application-dev/reference/apis/js-apis-request.md b/zh-cn/application-dev/reference/apis/js-apis-request.md index 14dabd5c30..e8412cb6a6 100644 --- a/zh-cn/application-dev/reference/apis/js-apis-request.md +++ b/zh-cn/application-dev/reference/apis/js-apis-request.md @@ -84,7 +84,9 @@ upload(config: UploadConfig): Promise<UploadTask> **示例：** ```js - request.upload({ url: 'https://patch' }).then((data) => { + let file1 = { filename: "test", name: "test", uri: "internal://cache/test.jpg", type: "jpg" }; + let uploadTask; + request.upload({ url: 'https://patch', files: [file1] }).then((data) => { uploadTask = data; }).catch((err) => { console.error('Failed to request the upload. Cause: ' + JSON.stringify(err)); @@ -112,7 +114,9 @@ upload(config: UploadConfig, callback: AsyncCallback<UploadTask>): void **示例：** ```js - request.upload({ url: 'https://patch' }, (err, data) => { + let file1 = { filename: "test", name: "test", uri: "internal://cache/test.jpg", type: "jpg" }; + let uploadTask; + request.upload({ url: 'https://patch', files: [file1] }, (err, data) => { if (err) { console.error('Failed to request the upload. Cause: ' + JSON.stringify(err)); return; @@ -385,6 +389,7 @@ download(config: DownloadConfig): Promise<DownloadTask> **示例：** ```js + let downloadTask; request.download({ url: 'https://xxxx/xxxx.hap' }).then((data) => { downloadTask = data; }).catch((err) => { @@ -413,6 +418,7 @@ download(config: DownloadConfig, callback: AsyncCallback<DownloadTask>): v **示例：** ```js + let downloadTask; request.download({ url: 'https://xxxx/xxxxx.hap', filePath: 'xxx/xxxxx.hap'}, (err, data) => { if (err) { @@ -456,6 +462,7 @@ on(type: 'progress', callback:(receivedSize: number, totalSize: number) => vo **示例：** ```js + let downloadTask; request.download({ url: 'https://xxxx/xxxx.hap' }, (err, data)=> { if (err) { console.error('Failed to request download. Cause:' + err); @@ -497,6 +504,7 @@ off(type: 'progress', callback?: (receivedSize: number, totalSize: number) => **示例：** ```js + let downloadTask; request.download({ url: 'https://xxxx/xxxx.hap' }, (err, data)=> { if (err) { console.error('Failed to request download. Cause:' + err); @@ -531,6 +539,7 @@ on(type: 'complete'|'pause'|'remove', callback:() => void): void **示例：** ```js + let downloadTask; request.download({ url: 'https://xxxx/xxxx.hap' }, (err, data)=> { if (err) { console.error('Failed to request download. Cause:' + err); @@ -565,6 +574,7 @@ off(type: 'complete'|'pause'|'remove', callback?:() => void): void **示例：** ```js + let downloadTask; request.download({ url: 'https://xxxx/xxxx.hap' }, (err, data)=> { if (err) { console.error('Failed to request download. Cause:' + JSON.stringify(err)); @@ -605,6 +615,7 @@ on(type: 'fail', callback: (err: number) => void): void **示例：** ```js + let downloadTask; request.download({ url: 'https://xxxx/xxxx.hap' }, (err, data)=> { if (err) { console.error('Failed to request download. Cause:' + err); @@ -645,6 +656,7 @@ off(type: 'fail', callback?: (err: number) => void): void **示例：** ```js + let downloadTask; request.download({ url: 'https://xxxx/xxxx.hap' }, (err, data)=> { if (err) { console.error('Failed to request download. Cause:' + err); diff --git a/zh-cn/application-dev/reference/apis/js-apis-wallpaper.md b/zh-cn/application-dev/reference/apis/js-apis-wallpaper.md index 6147c5a404..b26073f45b 100644 --- a/zh-cn/application-dev/reference/apis/js-apis-wallpaper.md +++ b/zh-cn/application-dev/reference/apis/js-apis-wallpaper.md @@ -586,6 +586,68 @@ getFile(wallpaperType: WallpaperType): Promise<number> ``` +## wallpaper.getPixelMap + +getPixelMap(wallpaperType: WallpaperType, callback: AsyncCallback<image.PixelMap>): void; + +获取壁纸图片的像素图。 + +**需要权限**：ohos.permission.GET_WALLPAPER、ohos.permission.READ_USER_STORAGE + +**系统能力**: SystemCapability.MiscServices.Wallpaper + +**参数：** + + | 参数名 | 类型 | 必填 | 说明 | + | -------- | -------- | -------- | -------- | + | wallpaperType | [WallpaperType](#wallpapertype) | 是 | 壁纸类型。 | + | callback | AsyncCallback<void> | 是 | 回调函数，调用成功则返回是否移除成功的结果，调用失败则返回error信息。 | + +**示例：** + + ```js + wallpaper.getPixelMap(WALLPAPER_SYSTEM, function (err, data) { + console.info('wallpaperXTS ===> testGetPixelMapCallbackSystem err : ' + JSON.stringify(err)); + console.info('wallpaperXTS ===> testGetPixelMapCallbackSystem data : ' + JSON.stringify(data)); + }); + ``` + + +## wallpaper.getPixelMap + +getPixelMap(wallpaperType: WallpaperType): Promise<image.PixelMap> + +获取壁纸图片的像素图。 + +**需要权限**：ohos.permission.GET_WALLPAPER、ohos.permission.READ_USER_STORAGE + +**系统能力**: SystemCapability.MiscServices.Wallpaper + +**参数：** + + | 参数名 | 类型 | 必填 | 说明 | + | -------- | -------- | -------- | -------- | + | wallpaperType | [WallpaperType](#wallpapertype) | 是 | 壁纸类型。 | + +**返回值：** + + | 类型 | 说明 | + | -------- | -------- | + | Promise<void> | 调用成功则返回是否移除成功的结果，调用失败则返回error信息。 | + +**示例：** + + ```js + wallpaper.getPixelMap(WALLPAPER_SYSTEM).then((data) => { + console.info('wallpaperXTS ===> testGetPixelMapPromiseSystem data : ' + data); + console.info('wallpaperXTS ===> testGetPixelMapPromiseSystem data : ' + JSON.stringify(data)); + }).catch((err) => { + console.info('wallpaperXTS ===> testGetPixelMapPromiseSystem err : ' + err); + console.info('wallpaperXTS ===> testGetPixelMapPromiseSystem err : ' + JSON.stringify(err)); + }); + ``` + + ## wallpaper.on('colorChange') on(type: 'colorChange', callback: (colors: Array<RgbaColor>, wallpaperType: WallpaperType) => void): void -- GitLab