diff --git a/zh-cn/application-dev/device-usage-statistics/device-usage-statistics-dev-guide.md b/zh-cn/application-dev/device-usage-statistics/device-usage-statistics-dev-guide.md index 47c693cb3082578e011e97d2f078a86da6a8b18c..f63870a4776f55051a2583801c96ac0e78f4ad0c 100644 --- a/zh-cn/application-dev/device-usage-statistics/device-usage-statistics-dev-guide.md +++ b/zh-cn/application-dev/device-usage-statistics/device-usage-statistics-dev-guide.md @@ -19,18 +19,20 @@ import stats from '@ohos.bundleState'; | function queryBundleStateInfos(begin: number, end: number, callback: AsyncCallback<BundleActiveInfoResponse>): void | 通过指定起始和结束时间查询应用使用时长统计信息。 | | function queryCurrentBundleActiveStates(begin: number, end: number, callback: AsyncCallback<Array<BundleActiveState>>): void | 通过指定起始和结束时间查询当前应用的事件集合。 | | function queryBundleStateInfoByInterval(byInterval: IntervalType, begin: number, end: number, callback: AsyncCallback<Array<BundleStateInfo>>): void | 通过指定时间段间隔（天、周、月、年）查询应用使用时长统计信息。 | -| function queryAppUsagePriorityGroup(bundleName? : string, callback: AsyncCallback<number>): void | 查询当前调用者应用或者指定应用的使用优先级群组。callback形式。 | -| function queryAppUsagePriorityGroup(bundleName? : string): Promise; | 查询当前调用者应用或者指定应用的使用优先级群组。promise形式。 | +| function queryAppUsagePriorityGroup(callback: AsyncCallback<number>): void | 查询当前应用的使用优先级群组。callback形式。 | +| function queryAppUsagePriorityGroup(): Promise<number>; | 查询当前应用的使用优先级群组。promise形式。 | | function isIdleState(bundleName: string, callback: AsyncCallback<boolean>): void | 判断指定Bundle Name的应用当前是否是空闲状态。 | | function getRecentlyUsedModules(maxNum: number, callback: AsyncCallback<BundleActiveModuleInfo>): void | 根据maxNum，查询FA使用记录，返回不超过maxNum条FA使用记录。 | | function queryAppNotificationNumber(begin: number, end: number, callback: AsyncCallback<Array<BundleActiveEventState>>): void | 通过指定起始和结束时间查询所有应用的通知次数。 | | function queryBundleActiveEventStates(begin: number, end: number, callback: AsyncCallback<Array<BundleActiveEventState>>): void | 通过指定起始和结束时间查询系统事件（休眠、唤醒、解锁、锁屏）统计信息。 | -| function setBundleGroup(bundleName : string, newGroup: GroupType, callback: AsyncCallback): void | 给应用名是bundleName的应用分组设置成newGroup，返回设置结果是否成功，以callback形式返回。 | -| function setBundleGroup(bundleName : string, newGroup : GroupType): Promise; | 给应用名是bundleName的应用分组设置成newGroup，返回设置结果是否成功，以promise形式返回。 | -| function registerGroupCallBack(callback: Callback, callback: AsyncCallback): void | 注册应用分组变化监听回调，返回注册是否成功，当应用分组发生变化时，会给所有已注册的监听者返回回调信息，以callback形式返回。 | -| function registerGroupCallBack(callback: Callback): Promise; | 注册应用分组变化监听回调，返回注册是否成功，当应用分组发生变化时，会给所有已注册的监听者返回回调信息，以promise形式返回。 | -| function unRegisterGroupCallBack(callback: AsyncCallback): void | 解除应用分组监听回调，以callback形式返回。 | -| function unRegisterGroupCallBack(): Promise; | 解除应用分组监听回调，以promise形式返回。 | +| function queryAppUsagePriorityGroup(bundleName? : string, callback: AsyncCallback<number>): void | 查询当前调用者应用或者指定应用的使用优先级群组。callback形式。 | +| function queryAppUsagePriorityGroup(bundleName? : string): Promise<number>; | 查询当前调用者应用或者指定应用的使用优先级群组。promise形式。 | +| function setBundleGroup(bundleName : string, newGroup: GroupType, callback: AsyncCallback>boolean>): void | 给应用名是bundleName的应用分组设置成newGroup，返回设置结果是否成功，以callback形式返回。 | +| function setBundleGroup(bundleName : string, newGroup : GroupType): Promise>boolean>; | 给应用名是bundleName的应用分组设置成newGroup，返回设置结果是否成功，以promise形式返回。 | +| function registerGroupCallBack(callback: Callback>BundleActiveGroupCallbackInfo>, callback: AsyncCallback>boolean>): void | 注册应用分组变化监听回调，返回注册是否成功，当应用分组发生变化时，会给所有已注册的监听者返回回调信息，以callback形式返回。 | +| function registerGroupCallBack(callback: Callback>BundleActiveGroupCallbackInfo>): Promise>boolean>; | 注册应用分组变化监听回调，返回注册是否成功，当应用分组发生变化时，会给所有已注册的监听者返回回调信息，以promise形式返回。 | +| function unRegisterGroupCallBack(callback: AsyncCallback>boolean>): void | 解除应用分组监听回调，以callback形式返回。 | +| function unRegisterGroupCallBack(): Promise>boolean>; | 解除应用分组监听回调，以promise形式返回。 | ## 开发步骤 @@ -172,19 +174,19 @@ import stats from '@ohos.bundleState'; }); ``` -6. 查询（无参）当前调用者应用的使用优先级群组，config.json中不需要配置权限。查询（有参）指定应用的使用优先级群组，config.json中需要配置权限：ohos.permission.BUNDLE_ACTIVE_INFO。 +6. 查询（无参）当前调用者应用的使用优先级群组，config.json中不需要配置权限。 ```js import stats from '@ohos.bundleState' - // 无参异步方法promise方式 + // promise方式 stats.queryAppUsagePriorityGroup().then( res => { console.log('BUNDLE_ACTIVE queryAppUsagePriorityGroup promise succeeded. result: ' + JSON.stringify(res)); }).catch( err => { console.log('BUNDLE_ACTIVE queryAppUsagePriorityGroup promise failed. because: ' + err.code); }); - // 无参异步方法callback方式 + // callback方式 stats.queryAppUsagePriorityGroup((err, res) => { if (err) { console.log('BUNDLE_ACTIVE queryAppUsagePriorityGroup callback failed. because: ' + err.code); @@ -192,24 +194,8 @@ import stats from '@ohos.bundleState'; console.log('BUNDLE_ACTIVE queryAppUsagePriorityGroup callback succeeded. result: ' + JSON.stringify(res)); } }); - - //有参异步promise方式 - stats.queryAppUsagePriorityGroup(this.bundleName).then( res => { - console.log('BUNDLE_ACTIVE QueryPackageGroup promise succeeded. result: ' + JSON.stringify(res)); - }).catch( err => { - console.log('BUNDLE_ACTIVE QueryPackageGroup promise failed. because: ' + err.code); - }); - - //有参异步方法callback方式 - stats.queryAppUsagePriorityGroup(this.bundleName, (err, res) => { - if(err) { - console.log('BUNDLE_ACTIVE QueryPackageGroup callback failed. because: ' + err.code); - } else { - console.log('BUNDLE_ACTIVE QueryPackageGroup callback succeeded. result: ' + JSON.stringify(res)); - } - }); ``` - + 7. 判断指定Bundle Name的应用当前是否是空闲状态，config.json中不需要配置权限。 ```js @@ -334,23 +320,61 @@ import stats from '@ohos.bundleState'; }); ``` +11. 查询（无参）当前调用者应用的使用优先级群组，config.json中不需要配置权限。查询（有参）指定应用的使用优先级群组，config.json中需要配置权限：ohos.permission.BUNDLE_ACTIVE_INFO。 + + ```js + import stats from '@ohos.bundleState' + + // 无参异步方法promise方式 + stats.queryAppUsagePriorityGroup().then( res => { + console.log('BUNDLE_ACTIVE queryAppUsagePriorityGroup promise succeeded. result: ' + JSON.stringify(res)); + }).catch( err => { + console.log('BUNDLE_ACTIVE queryAppUsagePriorityGroup promise failed. because: ' + err.code); + }); + + // 无参异步方法callback方式 + stats.queryAppUsagePriorityGroup((err, res) => { + if (err) { + console.log('BUNDLE_ACTIVE queryAppUsagePriorityGroup callback failed. because: ' + err.code); + } else { + console.log('BUNDLE_ACTIVE queryAppUsagePriorityGroup callback succeeded. result: ' + JSON.stringify(res)); + } + }); + + //有参异步promise方式 + stats.queryAppUsagePriorityGroup(this.bundleName).then( res => { + console.log('BUNDLE_ACTIVE QueryPackageGroup promise succeeded. result: ' + JSON.stringify(res)); + }).catch( err => { + console.log('BUNDLE_ACTIVE QueryPackageGroup promise failed. because: ' + err.code); + }); + + //有参异步方法callback方式 + stats.queryAppUsagePriorityGroup(this.bundleName, (err, res) => { + if(err) { + console.log('BUNDLE_ACTIVE QueryPackageGroup callback failed. because: ' + err.code); + } else { + console.log('BUNDLE_ACTIVE QueryPackageGroup callback succeeded. result: ' + JSON.stringify(res)); + } + }); + ``` + 11. 给应用名是bundleName的应用分组设置成newGroup，返回设置结果是否成功 ```javascript import stats from '@ohos.bundleState' //异步方法promise - stats.setBundleGroup(this.bundleName, this.newGroup).then( res => { - console.log('BUNDLE_ACTIVE SetBundleGroup promise succeeded. result: ' + JSON.stringify(res)); + stats.setBundleGroup(this.bundleName, this.newGroup).then( () => { + console.log('BUNDLE_ACTIVE SetBundleGroup promise succeeded.'); }).catch( err => { console.log('BUNDLE_ACTIVE SetBundleGroup promise failed. because: ' + err.code); }); //异步方法callback - stats.setBundleGroup(this.bundleName, this.newGroup, (err, res) => { + stats.setBundleGroup(this.bundleName, this.newGroup, (err) => { if(err) { console.log('BUNDLE_ACTIVE SetBundleGroup callback failed. because: ' + err.code); } else { - console.log('BUNDLE_ACTIVE SetBundleGroup callback succeeded. result: ' + JSON.stringify(res)); + console.log('BUNDLE_ACTIVE SetBundleGroup callback succeeded.'); } }); ``` @@ -369,8 +393,8 @@ import stats from '@ohos.bundleState'; console.log('BUNDLE_ACTIVE onBundleGroupChanged RegisterGroupCallBack result userId is : ' + res.userId); console.log('BUNDLE_ACTIVE onBundleGroupChanged RegisterGroupCallBack result bundleName is : ' + res.bundleName); }; - stats.registerGroupCallBack(onBundleGroupChanged).then( res => { - console.log('BUNDLE_ACTIVE RegisterGroupCallBack promise succeeded. result1: ' + JSON.stringify(res)); + stats.registerGroupCallBack(onBundleGroupChanged).then( () => { + console.log('BUNDLE_ACTIVE RegisterGroupCallBack promise succeeded.'); }).catch( err => { console.log('BUNDLE_ACTIVE RegisterGroupCallBack promise failed. because: ' + err.code); }); @@ -383,34 +407,32 @@ import stats from '@ohos.bundleState'; console.log('BUNDLE_ACTIVE onBundleGroupChanged RegisterGroupCallBack result‘s userId is : ' + res.userId); console.log('BUNDLE_ACTIVE onBundleGroupChanged RegisterGroupCallBack result‘s bundleName is : ' + res.bundleName); }; - stats.registerGroupCallBack(onBundleGroupChanged, (err,res)=>{ + stats.registerGroupCallBack(onBundleGroupChanged, (err)=>{ if(err) { console.log('BUNDLE_ACTIVE RegisterGroupCallBack callback failed, because: ' + err.code); } else { console.log('BUNDLE_ACTIVE RegisterGroupCallBack callback success.'); - console.log('BUNDLE_ACTIVE RegisterGroupCallBack result is : ' + JSON.stringify(res)); } }); ``` - + 13. 解除应用分组监听回调 ```javascript import stats from '@ohos.bundleState' //promise - stats.unRegisterGroupCallBack().then( res => { - console.log('BUNDLE_ACTIVE UnRegisterGroupCallBack promise succeeded. result: ' + JSON.stringify(res)); + stats.unRegisterGroupCallBack().then( () => { + console.log('BUNDLE_ACTIVE UnRegisterGroupCallBack promise succeeded.'); }).catch( err => { console.log('BUNDLE_ACTIVE UnRegisterGroupCallBack promise failed. because: ' + err.code); }); //callback - stats.unRegisterGroupCallBack((err,res)=>{ + stats.unRegisterGroupCallBack((err)=>{ if(err) { console.log('BUNDLE_ACTIVE UnRegisterGroupCallBack callback failed, because: ' + err.code); } else { console.log('BUNDLE_ACTIVE UnRegisterGroupCallBack callback success.'); - console.log('BUNDLE_ACTIVE UnRegisterGroupCallBack result is : ' + JSON.stringify(res)); } }); ``` diff --git a/zh-cn/application-dev/device-usage-statistics/device-usage-statistics-overview.md b/zh-cn/application-dev/device-usage-statistics/device-usage-statistics-overview.md index 333bdcab114e55a85874845713775bf64beed3f8..0f41886faa18b19012ef8b3068ce6ceba107f284 100644 --- a/zh-cn/application-dev/device-usage-statistics/device-usage-statistics-overview.md +++ b/zh-cn/application-dev/device-usage-statistics/device-usage-statistics-overview.md @@ -16,11 +16,12 @@ 2. 根据起止时间查询应用的使用时长。 3. 根据起止时间查询当前应用的事件集合。 4. 根据interval（日、周、月、年）类型和起止时间查询应用的使用时长。 -5. 查询调用者应用或指定应用的优先级群组。 +5. 查询调用者应用的优先级群组。 6. 判断指定应用当前是否是空闲状态。 7. 查询FA使用记录。返回数量最大不超过maxNum设置的值，FA使用记录由近及远排序，maxNum最大为1000，若不填写maxNum参数，则maxNum默认为1000。 8. 根据起止时间查询应用通知次数。 9. 根据起止时间查询系统事件（休眠、唤醒、解锁、锁屏）统计信息。 +9. 查询调用者应用或指定应用的优先级群组。 - 设置接口 @@ -35,5 +36,5 @@ 1. 解除注册应用分组变化回调监听 ### 设备使用信息统计使用权限 -- 设备使用信息统计的queryBundleActiveStates、queryBundleStateInfos、queryBundleStateInfoByInterval、queryBundleActiveEventStates、queryAppNotificationNumber、queryAppUsagePriorityGroup(有参)、setBundleGroup、registerGroupCallBack、unRegisterGroupCallBack接口为系统api，调用前需要申请ohos.permission.BUNDLE_ACTIVE_INFO权限。 -- 设备使用信息统计的queryCurrentBundleActiveStates、queryAppUsagePriorityGroup（无参）、isIdleState接口为三方api，调用时不需要申请权限。 \ No newline at end of file +- 设备使用信息统计的queryBundleActiveStates、queryBundleStateInfos、queryBundleStateInfoByInterval、queryBundleActiveEventStates、queryAppNotificationNumber、queryAppUsagePriorityGroup(bundleName?)、setBundleGroup、registerGroupCallBack、unRegisterGroupCallBack接口为系统api，调用前需要申请ohos.permission.BUNDLE_ACTIVE_INFO权限。 +- 设备使用信息统计的queryCurrentBundleActiveStates、queryAppUsagePriorityGroup()、isIdleState接口为三方api，调用时不需要申请权限。 \ No newline at end of file diff --git a/zh-cn/application-dev/reference/apis/js-apis-deviceUsageStatistics.md b/zh-cn/application-dev/reference/apis/js-apis-deviceUsageStatistics.md index 6f6de81432c60173b2a89562d0a828658b1a0487..e029c9006aa86f81101fe016fa655b12b21bb420 100644 --- a/zh-cn/application-dev/reference/apis/js-apis-deviceUsageStatistics.md +++ b/zh-cn/application-dev/reference/apis/js-apis-deviceUsageStatistics.md @@ -69,20 +69,12 @@ isIdleState(bundleName: string): Promise<boolean> ## bundleState.queryAppUsagePriorityGroup -queryAppUsagePriorityGroup(bundleName? : string): Promise - -可选参数。设置该参数时查询指定bundleName对应应用的分组。无参数时查询当前应用的分组。使用Promise形式返回其应用分组。 +queryAppUsagePriorityGroup(): Promise -**需要权限**：ohos.permission.BUNDLE_ACTIVE_INFO +查询当前应用的优先级分组。使用Promise形式返回其应用分组。 **系统能力**：SystemCapability.ResourceSchedule.UsageStatistics.AppGroup -**参数**： - -| 参数名 | 类型 | 必填 | 说明 | -| ----------------------- | ------ | ---- | ------------------------------------------------------------ | -| bundleName9+ | string | 否 | 可选参数。设置该参数时查询指定bundleName对应应用的分组。无参数时查询当前应用的分组。 | - **返回值**： | 类型 | 说明 | @@ -92,13 +84,6 @@ queryAppUsagePriorityGroup(bundleName? : string): Promise **示例**： ```javascript -//有bundleName的promise -bundleState.queryAppUsagePriorityGroup(this.bundleName).then( res => { - console.log('BUNDLE_ACTIVE QueryPackageGroup promise succeeded. result: ' + JSON.stringify(res)); -}).catch( err => { - console.log('BUNDLE_ACTIVE QueryPackageGroup promise failed. because: ' + err.code); -}); -//无bundleName的promise bundleState.queryAppUsagePriorityGroup().then( res => { console.log('BUNDLE_ACTIVE QueryPackageGroup promise succeeded. result: ' + JSON.stringify(res)); }).catch( err => { @@ -108,20 +93,17 @@ bundleState.queryAppUsagePriorityGroup().then( res => { ## bundleState.queryAppUsagePriorityGroup -queryAppUsagePriorityGroup(bundleName? : string, callback: AsyncCallback): void +queryAppUsagePriorityGroup(callback: AsyncCallback): void -可选参数。设置该参数时查询指定bundleName对应应用的分组。无参数时查询当前应用的分组。使用callback形式返回其应用分组。 - -**需要权限**：ohos.permission.BUNDLE_ACTIVE_INFO +查询当前应用的优先级分组。使用callback形式返回其应用分组。 **系统能力**：SystemCapability.ResourceSchedule.UsageStatistics.AppGroup **参数**： -| 参数名 | 类型 | 必填 | 说明 | -| ----------------------- | ------------------------------------------------------------ | ---- | ------------------------------------------------------------ | -| bundleName9+ | string | 否 | 可选参数。设置该参数时查询指定bundleName对应应用的分组。无参数时查询当前应用的分组。 | -| callback | AsyncCallback<Array<[BundleActiveModuleInfo](#bundleactivemoduleinfo9)>> | 是 | 指定的CallBack回调方法。返回查询的应用分组。 | +| 参数名 | 类型 | 必填 | 说明 | +| -------- | --------------------- | ---- | -------------------------------------------- | +| callback | AsyncCallback | 是 | 指定的CallBack回调方法。返回查询的应用分组。 | **示例**： @@ -523,9 +505,86 @@ getRecentlyUsedModules(maxNum?: number, callback: AsyncCallback<Array<Bund }); ``` +## bundleState.queryAppUsagePriorityGroup9+ + +queryAppUsagePriorityGroup(bundleName? : string): Promise + +可选参数。设置该参数时查询指定bundleName对应应用的分组。无参数时查询当前应用的分组。使用Promise形式返回其应用分组。 + +**需要权限**：ohos.permission.BUNDLE_ACTIVE_INFO + +**系统能力**：SystemCapability.ResourceSchedule.UsageStatistics.AppGroup + +**参数**： + +| 参数名 | 类型 | 必填 | 说明 | +| ---------- | ------ | ---- | ------------------------------------------------------------ | +| bundleName | string | 否 | 可选参数。设置该参数时查询指定bundleName对应应用的分组。无参数时查询当前应用的分组。 | + +**返回值**： + +| 类型 | 说明 | +| --------------- | ----------------------------------------------- | +| Promise | 指定的Promise回调方法。返回查询的应用分组结果。 | + +**示例**： + +```javascript +//有bundleName的promise +bundleState.queryAppUsagePriorityGroup(this.bundleName).then( res => { + console.log('BUNDLE_ACTIVE QueryPackageGroup promise succeeded. result: ' + JSON.stringify(res)); +}).catch( err => { + console.log('BUNDLE_ACTIVE QueryPackageGroup promise failed. because: ' + err.code); +}); +//无bundleName的promise +bundleState.queryAppUsagePriorityGroup().then( res => { + console.log('BUNDLE_ACTIVE QueryPackageGroup promise succeeded. result: ' + JSON.stringify(res)); +}).catch( err => { + console.log('BUNDLE_ACTIVE QueryPackageGroup promise failed. because: ' + err.code); +}); +``` + +## bundleState.queryAppUsagePriorityGroup9+ + +queryAppUsagePriorityGroup(bundleName? : string, callback: AsyncCallback): void + +可选参数。设置该参数时查询指定bundleName对应应用的分组。无参数时查询当前应用的分组。使用callback形式返回其应用分组。 + +**需要权限**：ohos.permission.BUNDLE_ACTIVE_INFO + +**系统能力**：SystemCapability.ResourceSchedule.UsageStatistics.AppGroup + +**参数**： + +| 参数名 | 类型 | 必填 | 说明 | +| ---------- | --------------------- | ---- | ------------------------------------------------------------ | +| bundleName | string | 否 | 可选参数。设置该参数时查询指定bundleName对应应用的分组。无参数时查询当前应用的分组。 | +| callback | AsyncCallback | 是 | 指定的CallBack回调方法。返回查询的应用分组。 | + +**示例**： + +```javascript +//有bundleName的callback +bundleState.queryAppUsagePriorityGroup(this.bundleName, (err, res) => { + if(err) { + console.log('BUNDLE_ACTIVE QueryPackageGroup callback failed. because: ' + err.code); + } else { + console.log('BUNDLE_ACTIVE QueryPackageGroup callback succeeded. result: ' + JSON.stringify(res)); + } +}); +//无bundleName的callback +bundleState.queryAppUsagePriorityGroup((err, res) => { + if(err) { + console.log('BUNDLE_ACTIVE QueryPackageGroup callback failed. because: ' + err.code); + } else { + console.log('BUNDLE_ACTIVE QueryPackageGroup callback succeeded. result: ' + JSON.stringify(res)); + } +}); +``` + ## bundleState.setBundleGroup9+ -setBundleGroup(bundleName: string, newGroup: GroupType): Promise +setBundleGroup(bundleName: string, newGroup: GroupType): Promise 将指定的bundleName的应用的分组设置为newGroup，使用Promise形式返回设置是否成功。 @@ -542,9 +601,9 @@ setBundleGroup(bundleName: string, newGroup: GroupType): Promise **返回值**： -| 类型 | 说明 | -| ---------------- | ------------------------------------------- | -| Promise | 指定的Promise回调方法。返回本次设置是否成功 | +| 类型 | 说明 | +| ------------- | ------------------------------------------- | +| Promise | 指定的Promise回调方法。返回本次设置是否成功 | **示例**： @@ -552,8 +611,8 @@ setBundleGroup(bundleName: string, newGroup: GroupType): Promise this.bundleName = "com.example.deviceUsageStatistics"; this.newGroup = stats.GroupType.ACTIVE_GROUP_DAILY; -bundleState.setBundleGroup(this.bundleName, this.newGroup).then( res => { - console.log('BUNDLE_ACTIVE SetBundleGroup promise succeeded. result: ' + JSON.stringify(res)); +bundleState.setBundleGroup(this.bundleName, this.newGroup).then( () => { + console.log('BUNDLE_ACTIVE SetBundleGroup promise succeeded.'); }).catch( err => { console.log('BUNDLE_ACTIVE SetBundleGroup promise failed. because: ' + err.code); }); @@ -561,7 +620,7 @@ bundleState.setBundleGroup(this.bundleName, this.newGroup).then( res => { ## bundleState.setBundleGroup9+ -setBundleGroup(bundleName: string, newGroup: GroupType, callback: AsyncCallback): void +setBundleGroup(bundleName: string, newGroup: GroupType, callback: AsyncCallback): void 将指定的bundleName的应用的分组设置为newGroup，使用CallBack形式返回设置是否成功。 @@ -571,11 +630,11 @@ setBundleGroup(bundleName: string, newGroup: GroupType, callback: AsyncCallback< **参数**： -| 参数名 | 类型 | 必填 | 说明 | -| ---------- | ---------------------- | ---- | ------------------------------------------ | -| bundleName | string | 是 | 应用名称 | -| newGroup | GroupType | 是 | 应用分组 | -| callback | AsyncCallback | 是 | 指定的CallBack回调方法。返回设置是否成功。 | +| 参数名 | 类型 | 必填 | 说明 | +| ---------- | ------------------- | ---- | ------------------------------------------ | +| bundleName | string | 是 | 应用名称 | +| newGroup | GroupType | 是 | 应用分组 | +| callback | AsyncCallback | 是 | 指定的CallBack回调方法。返回设置是否成功。 | **示例**： @@ -583,18 +642,18 @@ setBundleGroup(bundleName: string, newGroup: GroupType, callback: AsyncCallback< this.bundleName = "com.example.deviceUsageStatistics"; this.newGroup = stats.GroupType.ACTIVE_GROUP_DAILY; -bundleState.setBundleGroup(this.bundleName, this.newGroup, (err, res) => { +bundleState.setBundleGroup(this.bundleName, this.newGroup, (err) => { if(err) { console.log('BUNDLE_ACTIVE SetBundleGroup callback failed. because: ' + err.code); } else { - console.log('BUNDLE_ACTIVE SetBundleGroup callback succeeded. result: ' + JSON.stringify(res)); + console.log('BUNDLE_ACTIVE SetBundleGroup callback succeeded.'); } }); ``` ## bundleState.registerGroupCallBack9+ -registerGroupCallBack(callback: Callback): Promise +registerGroupCallBack(callback: Callback): Promise 应用分组变化注册，待用户名下的某个应用分组发生变化时，通过callback形式向所有已注册的应用返回BundleActiveGroupCallbackInfo。使用Promise形式返回注册是否成功。 @@ -610,9 +669,9 @@ registerGroupCallBack(callback: Callback): Promis **返回值**： -| 类型 | 说明 | -| ---------------- | --------------------------------------- | -| Promise | 指定的Promise回调方法。返回注册是否成功 | +| 类型 | 说明 | +| ------------- | --------------------------------------- | +| Promise | 指定的Promise回调方法。返回注册是否成功 | **示例**： @@ -625,8 +684,8 @@ let onBundleGroupChanged = (err,res) =>{ console.log('BUNDLE_ACTIVE onBundleGroupChanged RegisterGroupCallBack result userId is : ' + res.userId); console.log('BUNDLE_ACTIVE onBundleGroupChanged RegisterGroupCallBack result bundleName is : ' + res.bundleName); }; -bundleState.registerGroupCallBack(onBundleGroupChanged).then( res => { - console.log('BUNDLE_ACTIVE RegisterGroupCallBack promise succeeded. result1: ' + JSON.stringify(res)); +bundleState.registerGroupCallBack(onBundleGroupChanged).then( () => { + console.log('BUNDLE_ACTIVE RegisterGroupCallBack promise succeeded.'); }).catch( err => { console.log('BUNDLE_ACTIVE RegisterGroupCallBack promise failed. because: ' + err.code); }); @@ -634,7 +693,7 @@ bundleState.registerGroupCallBack(onBundleGroupChanged).then( res => { ## bundleState.registerGroupCallBack9+ -registerGroupCallBack(callback: Callback, callback: AsyncCallback): void +registerGroupCallBack(callback: Callback, callback: AsyncCallback): void 应用分组变化注册，待用户名下的某个应用分组发生变化时，通过callback形式向所有已注册的应用返回BundleActiveGroupCallbackInfo。使用异步callback形式返回注册是否成功。 @@ -647,7 +706,7 @@ registerGroupCallBack(callback: Callback, callbac | 参数名 | 类型 | 必填 | 说明 | | -------- | --------------------------------------- | ---- | -------------------------- | | callback | Callback | 是 | 应用分组变化的回调函数 | -| callback | AsyncCallback | 是 | 注册是否成功的异步回调函数 | +| callback | AsyncCallback | 是 | 注册是否成功的异步回调函数 | **示例**： @@ -660,19 +719,18 @@ let onBundleGroupChanged = (err,res) =>{ console.log('BUNDLE_ACTIVE onBundleGroupChanged RegisterGroupCallBack result‘s userId is : ' + res.userId); console.log('BUNDLE_ACTIVE onBundleGroupChanged RegisterGroupCallBack result‘s bundleName is : ' + res.bundleName); }; -bundleState.registerGroupCallBack(onBundleGroupChanged, (err,res)=>{ +bundleState.registerGroupCallBack(onBundleGroupChanged, (err)=>{ if(err) { console.log('BUNDLE_ACTIVE RegisterGroupCallBack callback failed, because: ' + err.code); } else { console.log('BUNDLE_ACTIVE RegisterGroupCallBack callback success.'); - console.log('BUNDLE_ACTIVE RegisterGroupCallBack result is : ' + JSON.stringify(res)); } }); ``` ## bundleState.unRegisterGroupCallBack9+ -unRegisterGroupCallBack(): Promise +unRegisterGroupCallBack(): Promise 应用分组变化解注册，将之前注册的解除注册。使用Promise形式返回注册是否成功。 @@ -684,15 +742,15 @@ unRegisterGroupCallBack(): Promise **返回值**： -| 类型 | 说明 | -| ---------------- | ----------------------------------------- | -| Promise | 指定的Promise回调方法。返回解注册是否成功 | +| 类型 | 说明 | +| ------------- | ----------------------------------------- | +| Promise | 指定的Promise回调方法。返回解注册是否成功 | **示例**： ```javascript -bundleState.unRegisterGroupCallBack().then( res => { - console.log('BUNDLE_ACTIVE UnRegisterGroupCallBack promise succeeded. result: ' + JSON.stringify(res)); +bundleState.unRegisterGroupCallBack().then( () => { + console.log('BUNDLE_ACTIVE UnRegisterGroupCallBack promise succeeded.'); }).catch( err => { console.log('BUNDLE_ACTIVE UnRegisterGroupCallBack promise failed. because: ' + err.code); }); @@ -700,7 +758,7 @@ bundleState.unRegisterGroupCallBack().then( res => { ## bundleState.unRegisterGroupCallBack9+ -unRegisterGroupCallBack(callback: AsyncCallback): void; +unRegisterGroupCallBack(callback: AsyncCallback): void; 应用分组变化解注册，将之前注册的解除注册。使用异步callback形式返回注册是否成功。 @@ -710,19 +768,18 @@ unRegisterGroupCallBack(callback: AsyncCallback): void; **参数**： -| 参数名 | 类型 | 必填 | 说明 | -| -------- | ---------------------- | ---- | ---------------------------- | -| callback | AsyncCallback | 是 | 解注册是否成功的异步回调函数 | +| 参数名 | 类型 | 必填 | 说明 | +| -------- | ------------------- | ---- | ---------------------------- | +| callback | AsyncCallback | 是 | 解注册是否成功的异步回调函数 | **示例**： ```javascript -bundleState.unRegisterGroupCallBack((err,res)=>{ +bundleState.unRegisterGroupCallBack((err)=>{ if(err) { console.log('BUNDLE_ACTIVE UnRegisterGroupCallBack callback failed, because: ' + err.code); } else { console.log('BUNDLE_ACTIVE UnRegisterGroupCallBack callback success.'); - console.log('BUNDLE_ACTIVE UnRegisterGroupCallBack result is : ' + JSON.stringify(res)); } }); ```