健康使用设备授权列表页中应用授权开关打开/关闭时触发回调
============================

#### 场景介绍

当通过健康使用设备授权列表页中的授权开关开启或者关闭应用授权时（设置-健康使用设备-右上角四点设置![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/28/v3/HpJLDHoRSBe0qZ27mQasHA/zh-cn_image_0000002594829390.png?HW-CC-KV=V1&HW-CC-Date=20260612T073647Z&HW-CC-Expire=86400&HW-CC-Sign=35053C36CB679F10EDC86FC1D5F0FA2DE62DD33C19A6BC177983DEB41183D07A)\-可访问健康使用设备的应用），会执行TimeGuardExtensionAbility中的onUserAuthSwitchOn/onUserAuthSwitchOff回调方法，支持开发者在用户授予授权和撤销授权时执行特定逻辑。若之前已设置过健康使用设备的密码，则在此页面取消应用授权时需要输入健康使用设备的密码。

![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/1c/v3/1pYijeGFR-GoPBoSpa5-fw/caution_3.0-zh-cn.png?HW-CC-KV=V1&HW-CC-Date=20260612T073647Z&HW-CC-Expire=86400&HW-CC-Sign=348BA8DFA1A9855C2431242AAC74838D939D98E70E9D907DBC4DE68718D84323)

应用调用Screen Time Guard Kit接口获取授权或者取消授权时，不会触发onUserAuthSwitchOn/onUserAuthSwitchOff回调方法。只有在健康使用设备授权列表页操作授权开关时才会触发。

![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/fe/v3/NgTH3M0ZTmG_9ghTbz8kpg/zh-cn_image_0000002625188837.png?HW-CC-KV=V1&HW-CC-Date=20260612T073647Z&HW-CC-Expire=86400&HW-CC-Sign=5DE12E93C637F391E768504B2C09EC9BE49AED5A4C70ADD9BABAE7D6B384368A)

#### 业务流程

![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/2a/v3/RkLDqWzfTu-DN6d4BIEEAQ/zh-cn_image_0000002625108981.png?HW-CC-KV=V1&HW-CC-Date=20260612T073647Z&HW-CC-Expire=86400&HW-CC-Sign=583A572B7467A6CF1DCAA4313EB2631FB71784DC3FCC3F2B98008AC4FDEF25A4)

流程说明（以关闭授权开关为例）：

1.  应用继承TimeGuardExtensionAbility，实现onUserAuthSwitchOn、onUserAuthSwitchOff方法，以监听用户授权状态。
    
2.  用户在健康使用设备的授权列表页中关闭授权开关后会拉起extension进程，执行TimeGuardExtensionAbility的onUserAuthSwitchOff回调。
    
3.  onUserAuthSwitchOff回调执行，应用可以在该回调中可以执行特定逻辑。
    

#### 接口说明

授权开关打开/关闭时的回调关键接口如下表所示：

| 接口名 | 描述 |
| :-- | :-- |
| [onUserAuthSwitchOn](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/screentimeguard-timeguardextensionability#onuserauthswitchon)(): Promise<void> | 当用户授予授权时执行特定逻辑。 |
| [onUserAuthSwitchOff](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/screentimeguard-timeguardextensionability#onuserauthswitchoff)(): Promise<void> | 当用户撤销授权时执行特定逻辑。 |

![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/64/v3/O42BX7rRROeO_pQOtsHbFg/note_3.0-zh-cn.png?HW-CC-KV=V1&HW-CC-Date=20260612T073647Z&HW-CC-Expire=86400&HW-CC-Sign=623E5DF0541C42DDFBFD9FA7C0FAD1BBBB66BB441B3205D0BFA841E6C92D6ACF)

1.  TimeGuardExtensionAbility与应用运行在不同进程，但共用沙箱。
    
2.  TimeGuardExtensionAbility与应用直接无法直接传递数据，如需传递数据可以通过[用户首选项](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/js-apis-data-preferences)/[数据库](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/js-apis-data-relationalstore)等数据持久化手段进行传递，或者通过[公共事件模块](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/js-apis-commoneventmanager)传递。
    

#### 开发步骤

1.  导入相关模块。
    
    import { TimeGuardExtensionAbility } from '@kit.ScreenTimeGuardKit';
    import { hilog } from '@kit.PerformanceAnalysisKit';
    
2.  继承TimeGuardExtensionAbility，重写onUserAuthSwitchOn和onUserAuthSwitchOff回调。
    
    export default class TimeGuardExtAbility extends TimeGuardExtensionAbility {
      // ...
      
      async onUserAuthSwitchOn(): Promise<void> {
        hilog.info(0x0000, 'TimeGuardExtensionAbility', 'onUserAuthSwitchOn');
      }
    
      async onUserAuthSwitchOff(): Promise<void> {
        hilog.info(0x0000, 'TimeGuardExtensionAbility', 'onUserAuthSwitchOff');
      }
    }
    
3.  在工程中entry模块的module.json5文件中的"extensionAbilities"节点添加如下代码。
    
    "extensionAbilities": \[
      {
        "name": "TimeGuardExtAbility",
        "type": "screenTimeGuard",
        "srcEntry": "./ets/timeguardextability/TimeGuardExtAbility.ets",
        "exported": false,
        "skills": \[
          {
            "actions": \[
              "action.ohos.timeGuard.listener"
            \]
          }
        \],
      }
    \],