應(yīng)用空間統(tǒng)計(jì)

該模塊提供空間查詢相關(guān)的常用功能：包括對內(nèi)外卡的空間查詢，對應(yīng)用分類數(shù)據(jù)統(tǒng)計(jì)的查詢，對應(yīng)用數(shù)據(jù)的查詢等。

說明：
開發(fā)前請熟悉鴻蒙開發(fā)指導(dǎo)文檔 ：[gitee.com/li-shizhen-skin/harmony-os/blob/master/README.md]

• 本模塊首批接口從API version 8開始支持。后續(xù)版本的新增接口，采用上角標(biāo)單獨(dú)標(biāo)記接口的起始版本。
• API 9當(dāng)前為Canary版本，僅供試用，不保證接口可穩(wěn)定調(diào)用。

導(dǎo)入模塊

import storageStatistics from "@ohos.storageStatistics";

storageStatistics.getTotalSizeOfVolume

getTotalSizeOfVolume(volumeUuid: string): Promise

異步獲取指定卷的總空間大小，以promise方式返回。

需要權(quán)限 ：ohos.permission.STORAGE_MANAGER

系統(tǒng)能力 ：SystemCapability.FileManagement.StorageService.SpatialStatistics

該接口為系統(tǒng)接口，三方應(yīng)用不支持調(diào)用

參數(shù)：

返回值：

示例：

let uuid = "";
storageStatistics.getTotalSizeOfVolume(uuid).then(function(number){
    console.info("getTotalSizeOfVolume successfully:"+ number);
}).catch(function(err){
    console.info("getTotalSizeOfVolume failed with error:"+ err);
});

storageStatistics.getTotalSizeOfVolume

getTotalSizeOfVolume(volumeUuid: string, callback:AsyncCallback):void

異步獲取指定卷的總空間大小，以callback方式返回。

需要權(quán)限 ：ohos.permission.STORAGE_MANAGER

系統(tǒng)能力 ：SystemCapability.FileManagement.StorageService.SpatialStatistics

該接口為系統(tǒng)接口，三方應(yīng)用不支持調(diào)用

參數(shù)：

示例：

let uuid = "";
storageStatistics.getTotalSizeOfVolume(uuid, function(error, number){
    // do something
    console.info("getTotalSizeOfVolume successfully:"+ number);
});

storageStatistics.getFreeSizeOfVolume

getFreeSizeOfVolume(volumeUuid: string): Promise

異步獲取指定卷的可用空間大小，以promise方式返回。

需要權(quán)限 ：ohos.permission.STORAGE_MANAGER

系統(tǒng)能力 ：SystemCapability.FileManagement.StorageService.SpatialStatistics

該接口為系統(tǒng)接口，三方應(yīng)用不支持調(diào)用

參數(shù)：

返回值：

示例：

let uuid = "";
storageStatistics.getFreeSizeOfVolume(uuid).then(function(number){
    console.info("getFreeSizeOfVolume successfully:"+ number);
}).catch(function(err){
    console.info("getFreeSizeOfVolume failed with error:"+ err);
});

storageStatistics.getFreeSizeOfVolume

getFreeSizeOfVolume(volumeUuid: string, callback:AsyncCallback):void

異步獲取指定卷的可用空間大小，以callback方式返回。

需要權(quán)限 ：ohos.permission.STORAGE_MANAGER

系統(tǒng)能力 ：SystemCapability.FileManagement.StorageService.SpatialStatistics

該接口為系統(tǒng)接口，三方應(yīng)用不支持調(diào)用

參數(shù)：

示例：

let uuid = "";
storageStatistics.getFreeSizeOfVolume(uuid, function(error, number){
    // do something
    console.info("getFreeSizeOfVolume successfully:"+ number);
});

storageStatistics.getBundleStats9+

getBundleStats(packageName: string): Promise

異步獲取應(yīng)用存儲數(shù)據(jù)，以promise方式返回。

需要權(quán)限 ：ohos.permission.STORAGE_MANAGER

系統(tǒng)能力 ：SystemCapability.FileManagement.StorageService.SpatialStatistics

該接口為系統(tǒng)接口，三方應(yīng)用不支持調(diào)用

參數(shù)：

返回值：

示例：

let packageName = "";
storageStatistics.getBundleStats(packageName).then(function(BundleStats){
    console.info("getBundleStats successfully:"+ JSON.stringify(BundleStats));
}).catch(function(err){
    console.info("getBundleStats failed with error:"+ err);
});

storageStatistics.getBundleStats9+

getBundleStats(packageName: string, callback: AsyncCallback): void

異步獲取應(yīng)用存儲數(shù)據(jù)，以callback方式返回。

需要權(quán)限 ：ohos.permission.STORAGE_MANAGER

系統(tǒng)能力 ：SystemCapability.FileManagement.StorageService.SpatialStatistics

該接口為系統(tǒng)接口，三方應(yīng)用不支持調(diào)用

參數(shù)：

示例：

let packageName = "";
storageStatistics.getBundleStats(packageName, function(error, BundleStats){
    // do something
    console.info("getBundleStats successfully:"+ JSON.stringify(BundleStats));
});

storageStatistics.getCurrentBundleStats9+

getCurrentBundleStats(): Promise

第三方應(yīng)用異步獲取占用空間，以promise方式返回。

系統(tǒng)能力 ：SystemCapability.FileManagement.StorageService.SpatialStatistics

返回值：

示例：

let bundleStats = storageStatistics.getCurrentBundleStats();
console.info("getCurrentBundleStats successfully:"+ JSON.stringify(bundleStats));

storageStatistics.getCurrentBundleStats9+

getCurrentBundleStats(callback: AsyncCallback): void

第三方應(yīng)用異步獲取占用空間，以callback方式返回。

系統(tǒng)能力 ：SystemCapability.FileManagement.StorageService.SpatialStatistics

參數(shù)：

示例：

storageStatistics.getCurrentBundleStats(function(error, bundleStats){
    // do something
    console.info("getCurrentBundleStats successfully:"+ JSON.stringify(bundleStats));
});

BundleStats9+

屬性

系統(tǒng)能力 ：以下各項(xiàng)對應(yīng)的系統(tǒng)能力均為SystemCapability.FileManagement.StorageService.SpatialStatistics

該接口為系統(tǒng)接口，三方應(yīng)用不支持調(diào)用

storageStatistics.getTotalSize9+

getTotalSize(): Promise

獲取內(nèi)卡的總空間大小，以promise方式返回。

需要權(quán)限 ：ohos.permission.STORAGE_MANAGER

系統(tǒng)能力 ：SystemCapability.FileManagement.StorageService.SpatialStatistics

該接口為系統(tǒng)接口，三方應(yīng)用不支持調(diào)用

返回值：

示例：

let number = storageStatistics.getTotalSize();
console.info("getTotalSize successfully:"+ JSON.stringify(number));

storageStatistics.getTotalSize9+

getTotalSize(callback: AsyncCallback): void

獲取內(nèi)卡的總空間大小，以callback方式返回。

需要權(quán)限 ：ohos.permission.STORAGE_MANAGER

系統(tǒng)能力 ：SystemCapability.FileManagement.StorageService.SpatialStatistics

該接口為系統(tǒng)接口，三方應(yīng)用不支持調(diào)用

參數(shù)：

示例：

storageStatistics.getTotalSize(function(error, number){
    // do something
    console.info("getTotalSize successfully:"+ JSON.stringify(number));
});

storageStatistics.getFreeSize9+

getFreeSize(): Promise

獲取內(nèi)卡的可用空間大小，以promise方式返回。

需要權(quán)限 ：ohos.permission.STORAGE_MANAGER

系統(tǒng)能力 ：SystemCapability.FileManagement.StorageService.SpatialStatistics

該接口為系統(tǒng)接口，三方應(yīng)用不支持調(diào)用

返回值：

示例：

let number = storageStatistics.getFreeSize();
console.info("getFreeSize successfully:"+ JSON.stringify(number));

storageStatistics.getFreeSize9+

getFreeSize(callback: AsyncCallback): void

獲取內(nèi)卡的可用空間大小，以callback方式返回。

需要權(quán)限 ：ohos.permission.STORAGE_MANAGER

系統(tǒng)能力 ：SystemCapability.FileManagement.StorageService.SpatialStatistics

該接口為系統(tǒng)接口，三方應(yīng)用不支持調(diào)用

參數(shù)：

示例：

storageStatistics.getFreeSize(function(error, number){
    // do something
    console.info("getFreeSize successfully:"+ JSON.stringify(number));
});

storageStatistics.getSystemSize9+

getSystemSize(): Promise

異步獲取系統(tǒng)空間大小，以promise方式返回。

需要權(quán)限 ：ohos.permission.STORAGE_MANAGER

系統(tǒng)能力 ：SystemCapability.FileManagement.StorageService.SpatialStatistics

該接口為系統(tǒng)接口，三方應(yīng)用不支持調(diào)用

返回值：

示例：

storageStatistics.getSystemSize().then(function(number){
    console.info("getSystemSize successfully:"+ number);
}).catch(function(err){
    console.info("getSystemSize failed with error:"+ err);
});

storageStatistics.getSystemSize9+

getSystemSize(callback:AsyncCallback):void

異步獲取系統(tǒng)空間大小，以callback方式返回。

需要權(quán)限 ：ohos.permission.STORAGE_MANAGER

系統(tǒng)能力 ：SystemCapability.FileManagement.StorageService.SpatialStatistics

該接口為系統(tǒng)接口，三方應(yīng)用不支持調(diào)用

參數(shù)：

示例：

storageStatistics.getSystemSize(function(error, number){
    // do something
    console.info("getSystemSize successfully:"+ number);
});

storageStatistics.getUserStorageStats9+

getUserStorageStats(userId? : number): Promise

異步獲取用戶各類別數(shù)據(jù)大小，以promise方式返回。

需要權(quán)限 ：ohos.permission.STORAGE_MANAGER

系統(tǒng)能力 ：SystemCapability.FileManagement.StorageService.SpatialStatistics

該接口為系統(tǒng)接口，三方應(yīng)用不支持調(diào)用

參數(shù)：

返回值：

示例：

let userId = 1;
storageStatistics.getUserStorageStats(userId).then(function(StorageStats){
    console.info("getUserStorageStats successfully:"+ JSON.stringify(StorageStats));
}).catch(function(err){
    console.info("getUserStorageStats failed with error:"+ err);
});

storageStatistics.getUserStorageStats9+

getUserStorageStats(userId: number, callback:AsyncCallback):void

異步獲取用戶各類別數(shù)據(jù)大小，以callback方式返回。

需要權(quán)限 ：ohos.permission.STORAGE_MANAGER

系統(tǒng)能力 ：SystemCapability.FileManagement.StorageService.SpatialStatistics

該接口為系統(tǒng)接口，三方應(yīng)用不支持調(diào)用

參數(shù)：

示例：

let userId = 1;
storageStatistics.getUserStorageStats(userId, function(error, StorageStats){
    // do something
    console.info("getUserStorageStats successfully:"+ JSON.stringify(StorageStats));
});

StorageStats9+

屬性

系統(tǒng)能力 ：以下各項(xiàng)對應(yīng)的系統(tǒng)能力均為SystemCapability.FileManagement.StorageService.SpatialStatistics

該接口為系統(tǒng)接口，三方應(yīng)用不支持調(diào)用

審核編輯 黃宇