输入关键字搜索
开发者能力认证
鸿蒙高校创新赛
HarmonyOS 7
animation
HarmonyOS行业解决方案
layoutWeight
HarmonyOS模板&组件
bindPopup
bindsheet
RelativeContainer
CustomDialogController
animateTo
CTRL+K
文档管理中心

HarmonyOS

输入关键字搜索
开发者能力认证
鸿蒙高校创新赛
HarmonyOS 7
animation
HarmonyOS行业解决方案
layoutWeight
HarmonyOS模板&组件
bindPopup
bindsheet
RelativeContainer
CustomDialogController
animateTo
CTRL+K
FAQ
FAQ应用服务开发屏幕时长守护服务（Screen Time Guard Kit）如何设置不同时间策略实现屏幕时间守护

如何设置不同时间策略实现屏幕时间守护

更新时间: 2026-06-26 07:48
本文导读

问题现象

如何通过Screen Time Guard Kit实现限制每天只能使用1个小时的手机？

背景知识

守护策略管理：当用户希望创建新的屏幕时间守护规则时，可以调用添加管控策略的接口。根据参数中传入的策略，用户可以添加各种策略，如设置各个应用的停用起止时间。一旦策略被创建并启用，系统将根据规则对用户的屏幕使用行为进行监管。

ACL权限申请：使用Screen Time Guard Kit（屏幕时间守护服务）需要申请"ohos.permission.MANAGE_SCREEN_TIME_GUARD"ACL权限，具体参考官网受限ACL权限申请。

解决方案

准备工作：完成配置签名和受限ACL权限申请。可使用自动签名完成ACL权限调试配置，具体参考自动签名支持的ACL权限。

  • 步骤一：

    Screen Time Guard Kit支持对用户设备的时间管理和应用限制，因此在功能启用前，必须获得用户的明确授权。具体流程参考请求用户授权。

    收起
    自动换行
    深色代码主题
    复制
    1. try {
    2.   const status = await guardService.getUserAuthStatus();
    3.   hilog.info(0x0000, `ScreenTimeGuard:getUserAuthStatus`, `user auth status: ${status}`);
    4.   if (status != guardService.AuthStatus.AUTH_GRANTED) {
    5.     await guardService.requestUserAuth(this.getUIContext().getHostContext() as common.UIAbilityContext);
    6.   }
    7. } catch (err) {
    8.   const message = (err as BusinessError).message;
    9.   const code = (err as BusinessError).code;
    10.   hilog.error(0x0000, `ScreenTimeGuard:requestUserAuth`,
    11.     `requestUserAuth failed with error code: ${code}, message: ${message}`);
    12. }
  • 步骤二：

    TimeStrategyType时长策略类型有以下3种类型，按照不同的场景配置策略类型，具体配置如下：

    • START_END_TIME_TYPE：管控策略可以设置为起止时间策略，表示策略在一天内配置的起始时间和结束时间内生效。常用于周期性管控，使用场景举例：每天22点到第二天7点，禁止使用XX应用。
      说明

      如果为此类型，则TimeStrategy接口中的startTime、endTime必填，totalDuration非必填。

      收起
      自动换行
      深色代码主题
      复制
      1. // 添加起始时间策略
      2. try {
      3.   // 先调用startAppPicker获取相应应用的token
      4.   const tokens = await appPicker.startAppPicker(this.getUIContext().getHostContext(), { appTokens: [] });
      5.   const startEndTime: guardService.TimeStrategy = {
      6.     type: guardService.TimeStrategyType.START_END_TIME_TYPE,
      7.     startTime: '08:00',
      8.     endTime: '19:00',
      9.   };
      10.   const info: guardService.AppInfo = {
      11.     appTokens: tokens
      12.   };
      13.   const strategy: guardService.GuardStrategy = {
      14.     name: 'startEndTimeStrategy',
      15.     timeStrategy: startEndTime,
      16.     appInfo: info,
      17.     appRestrictionType: guardService.RestrictionType.BLOCKLIST_TYPE
      18.   };
      19.   await guardService.addGuardStrategy(strategy);
      20.   this.currentStrategy = 'startEndTimeStrategy';
      21. } catch (err) {
      22.   const message = (err as BusinessError).message;
      23.   const code = (err as BusinessError).code;
      24.   hilog.error(0x0000, `ScreenTimeGuard:addGuardStrategy`,
      25.     `addGuardStrategy failed with error code: ${code}, message: ${message}`);
      26. }
    • TOTAL_DURATION_TYPE：总时长策略类型，表示一天内策略生效的总时长，从调用startGuardStrategy接口成功后开始计时。使用场景举例：启动策略后1小时内，禁止使用XX应用。
      说明

      如果为此类型，则TimeStrategy接口中的startTime、endTime非必填，totalDuration必填。

      收起
      自动换行
      深色代码主题
      复制
      1. // 添加总时长策略
      2. try {
      3.   // 先调用startAppPicker获取相应应用的token
      4.   const tokens = await appPicker.startAppPicker(this.getUIContext().getHostContext(), { appTokens: [] });
      5.   const totalDurationTime: guardService.TimeStrategy = {
      6.     type: guardService.TimeStrategyType.TOTAL_DURATION_TYPE,
      7.     totalDuration: 3,
      8.   };
      9.   const info: guardService.AppInfo = {
      10.     appTokens: tokens
      11.   };
      12.   const strategy: guardService.GuardStrategy = {
      13.     name: 'totalDurationTimeStrategy',
      14.     timeStrategy: totalDurationTime,
      15.     appInfo: info,
      16.     appRestrictionType: guardService.RestrictionType.BLOCKLIST_TYPE
      17.   };
      18.   await guardService.addGuardStrategy(strategy);
      19.   this.currentStrategy = 'totalDurationTimeStrategy';
      20. } catch (err) {
      21.   const message = (err as BusinessError).message;
      22.   const code = (err as BusinessError).code;
      23.   hilog.error(0x0000, `ScreenTimeGuard:addGuardStrategy`,
      24.     `addGuardStrategy failed with error code: ${code}, message: ${message}`);
      25. }
    • INCLUSIVE_DURATION_TYPE：共享时长策略类型，表示策略关联的所有应用共享同一可用时长配额，超额后所有应用均受时长限制，从调用startGuardStrategy接口成功后开始计时。使用场景举例：每天限制使用指定视频类应用（A应用、B应用）时长2小时。
      说明

      如果为此类型，则TimeStrategy接口中的startTime、endTime非必填，totalDuration必填，RestrictionType只支持TRUSTLIST_TYPE。

      收起
      自动换行
      深色代码主题
      复制
      1. // 添加共享时长策略
      2. try {
      3.   // 先调用startAppPicker获取相应应用的token
      4.   const tokens = await appPicker.startAppPicker(this.getUIContext().getHostContext(), { appTokens: [] });
      5.   const inclusiveDurationTime: guardService.TimeStrategy = {
      6.     type: guardService.TimeStrategyType.INCLUSIVE_DURATION_TYPE,
      7.     totalDuration: 3,
      8.   };
      9.   const info: guardService.AppInfo = {
      10.     appTokens: tokens
      11.   };
      12.   const strategy: guardService.GuardStrategy = {
      13.     name: 'inclusiveDurationTimeStrategy',
      14.     timeStrategy: inclusiveDurationTime,
      15.     appInfo: info,
      16.     appRestrictionType: guardService.RestrictionType.TRUSTLIST_TYPE
      17.   };
      18.   await guardService.addGuardStrategy(strategy);
      19.   this.currentStrategy = 'inclusiveDurationTimeStrategy';
      20. } catch (err) {
      21.   const message = (err as BusinessError).message;
      22.   const code = (err as BusinessError).code;
      23.   hilog.error(0x0000, `ScreenTimeGuard:addGuardStrategy`,
      24.     `addGuardStrategy failed with error code: ${code}, message: ${message}`);
      25. }
  • 步骤三：

    确认并生成管控策略后，根据参数中传入的策略名，应用可以启动对应管控策略。具体流程参考启动策略。

    收起
    自动换行
    深色代码主题
    复制
    1. async startGuardStrategy(strategyName: string) {
    2.   try {
    3.     await guardService.startGuardStrategy(strategyName);
    4.     hilog.info(0x0000, `ScreenTimeGuard:startGuardStrategy`, 'success');
    5.     this.getUIContext().getPromptAction().showToast({
    6.       message: 'startGuardStrategy success',
    7.       duration: 2000,
    8.     });
    9.   } catch (err) {
    10.     const message = (err as BusinessError).message;
    11.     const code = (err as BusinessError).code;
    12.     hilog.error(0x0000, `ScreenTimeGuard:startGuardStrategy`,
    13.       `startGuardStrategy failed with error code: ${code}, message: ${message}`);
    14.   }
    15. }

完整代码：

收起
自动换行
深色代码主题
复制
  1. import { appPicker, guardService } from '@kit.ScreenTimeGuardKit';
  2. import { hilog } from '@kit.PerformanceAnalysisKit';
  3. import { common } from '@kit.AbilityKit';
  4. 

  5. @Entry
  6. @Component
  7. struct Index {
  8.   @State currentStrategy?: string = '';
  9. 

  10.   async aboutToAppear(): Promise<void> {
  11.     try {
  12.       const status = await guardService.getUserAuthStatus();
  13.       hilog.info(0x0000, `ScreenTimeGuard:getUserAuthStatus`, `user auth status: ${status}`);
  14.       if (status != guardService.AuthStatus.AUTH_GRANTED) {
  15.         await guardService.requestUserAuth(this.getUIContext().getHostContext() as common.UIAbilityContext);
  16.       }
  17.     } catch (err) {
  18.       const message = (err as BusinessError).message;
  19.       const code = (err as BusinessError).code;
  20.       hilog.error(0x0000, `ScreenTimeGuard:requestUserAuth`,
  21.         `requestUserAuth failed with error code: ${code}, message: ${message}`);
  22.     }
  23.   }
  24. 

  25.   async startGuardStrategy(strategyName: string) {
  26.     try {
  27.       await guardService.startGuardStrategy(strategyName);
  28.       hilog.info(0x0000, `ScreenTimeGuard:startGuardStrategy`, 'success');
  29.       this.getUIContext().getPromptAction().showToast({
  30.         message: 'startGuardStrategy success',
  31.         duration: 2000,
  32.       });
  33.     } catch (err) {
  34.       const message = (err as BusinessError).message;
  35.       const code = (err as BusinessError).code;
  36.       hilog.error(0x0000, `ScreenTimeGuard:startGuardStrategy`,
  37.         `startGuardStrategy failed with error code: ${code}, message: ${message}`);
  38.     }
  39.   }
  40. 

  41.   async stopGuardStrategy(strategyName: string) {
  42.     try {
  43.       await guardService.stopGuardStrategy(strategyName);
  44.       hilog.info(0x0000, `ScreenTimeGuard:stopGuardStrategy`, 'success');
  45.       this.getUIContext().getPromptAction().showToast({
  46.         message: 'stopGuardStrategy success',
  47.         duration: 2000,
  48.       });
  49.     } catch (err) {
  50.       const message = (err as BusinessError).message;
  51.       const code = (err as BusinessError).code;
  52.       hilog.error(0x0000, `ScreenTimeGuard:stopGuardStrategy`,
  53.         `stopGuardStrategy failed with error code: ${code}, message: ${message}`);
  54.     }
  55.   }
  56. 

  57.   build() {
  58.     Column({ space: 10 }) {
  59.       Text('当前策略：' + this.currentStrategy);
  60. 

  61.       Button('添加起始时间策略')
  62.         .onClick(async () => {
  63.           try {
  64.             await guardService.removeGuardStrategy('startEndTimeStrategy');
  65.           } catch (err) {
  66.             const message = (err as BusinessError).message;
  67.             const code = (err as BusinessError).code;
  68.             hilog.error(0x0000, `ScreenTimeGuard:removeGuardStrategy`,
  69.               `removeGuardStrategy failed with error code: ${code}, message: ${message}`);
  70.           }
  71.           // 添加起始时间策略
  72.           try {
  73.             // 先调用startAppPicker获取相应应用的token
  74.             const tokens = await appPicker.startAppPicker(this.getUIContext().getHostContext(), { appTokens: [] });
  75.             const startEndTime: guardService.TimeStrategy = {
  76.               type: guardService.TimeStrategyType.START_END_TIME_TYPE,
  77.               startTime: '08:00',
  78.               endTime: '19:00',
  79.             };
  80.             const info: guardService.AppInfo = {
  81.               appTokens: tokens
  82.             };
  83.             const strategy: guardService.GuardStrategy = {
  84.               name: 'startEndTimeStrategy',
  85.               timeStrategy: startEndTime,
  86.               appInfo: info,
  87.               appRestrictionType: guardService.RestrictionType.BLOCKLIST_TYPE
  88.             };
  89.             await guardService.addGuardStrategy(strategy);
  90.             this.currentStrategy = 'startEndTimeStrategy';
  91.           } catch (err) {
  92.             const message = (err as BusinessError).message;
  93.             const code = (err as BusinessError).code;
  94.             hilog.error(0x0000, `ScreenTimeGuard:addGuardStrategy`,
  95.               `addGuardStrategy failed with error code: ${code}, message: ${message}`);
  96.           }
  97.         })
  98. 

  99.       Button('添加总时长策略')
  100.         .onClick(async () => {
  101.           try {
  102.             await guardService.removeGuardStrategy('totalDurationTimeStrategy');
  103.           } catch (err) {
  104.             const message = (err as BusinessError).message;
  105.             const code = (err as BusinessError).code;
  106.             hilog.error(0x0000, `ScreenTimeGuard:removeGuardStrategy`,
  107.               `removeGuardStrategy failed with error code: ${code}, message: ${message}`);
  108.           }
  109. 

  110.           // 添加总时长策略
  111.           try {
  112.             // 先调用startAppPicker获取相应应用的token
  113.             const tokens = await appPicker.startAppPicker(this.getUIContext().getHostContext(), { appTokens: [] });
  114.             const totalDurationTime: guardService.TimeStrategy = {
  115.               type: guardService.TimeStrategyType.TOTAL_DURATION_TYPE,
  116.               totalDuration: 3,
  117.             };
  118.             const info: guardService.AppInfo = {
  119.               appTokens: tokens
  120.             };
  121.             const strategy: guardService.GuardStrategy = {
  122.               name: 'totalDurationTimeStrategy',
  123.               timeStrategy: totalDurationTime,
  124.               appInfo: info,
  125.               appRestrictionType: guardService.RestrictionType.BLOCKLIST_TYPE
  126.             };
  127.             await guardService.addGuardStrategy(strategy);
  128.             this.currentStrategy = 'totalDurationTimeStrategy';
  129.           } catch (err) {
  130.             const message = (err as BusinessError).message;
  131.             const code = (err as BusinessError).code;
  132.             hilog.error(0x0000, `ScreenTimeGuard:addGuardStrategy`,
  133.               `addGuardStrategy failed with error code: ${code}, message: ${message}`);
  134.           }
  135.         })
  136. 

  137.       Button('添加共享时长策略')
  138.         .onClick(async () => {
  139.           try {
  140.             await guardService.removeGuardStrategy('inclusiveDurationTimeStrategy');
  141.           } catch (err) {
  142.             const message = (err as BusinessError).message;
  143.             const code = (err as BusinessError).code;
  144.             hilog.error(0x0000, `ScreenTimeGuard:removeGuardStrategy`,
  145.               `removeGuardStrategy failed with error code: ${code}, message: ${message}`);
  146.           }
  147. 

  148.           // 添加共享时长策略
  149.           try {
  150.             // 先调用startAppPicker获取相应应用的token
  151.             const tokens = await appPicker.startAppPicker(this.getUIContext().getHostContext(), { appTokens: [] });
  152.             const inclusiveDurationTime: guardService.TimeStrategy = {
  153.               type: guardService.TimeStrategyType.INCLUSIVE_DURATION_TYPE,
  154.               totalDuration: 3,
  155.             };
  156.             const info: guardService.AppInfo = {
  157.               appTokens: tokens
  158.             };
  159.             const strategy: guardService.GuardStrategy = {
  160.               name: 'inclusiveDurationTimeStrategy',
  161.               timeStrategy: inclusiveDurationTime,
  162.               appInfo: info,
  163.               appRestrictionType: guardService.RestrictionType.TRUSTLIST_TYPE
  164.             };
  165.             await guardService.addGuardStrategy(strategy);
  166.             this.currentStrategy = 'inclusiveDurationTimeStrategy';
  167.           } catch (err) {
  168.             const message = (err as BusinessError).message;
  169.             const code = (err as BusinessError).code;
  170.             hilog.error(0x0000, `ScreenTimeGuard:addGuardStrategy`,
  171.               `addGuardStrategy failed with error code: ${code}, message: ${message}`);
  172.           }
  173.         })
  174. 

  175.       Button('启动当前策略')
  176.         .onClick(() => {
  177.           if (this.currentStrategy) {
  178.             this.startGuardStrategy(this.currentStrategy);
  179.           } else {
  180.             this.getUIContext().getPromptAction().showToast({
  181.               message: '请先设置当前策略',
  182.               duration: 2000,
  183.             });
  184.           }
  185.         })
  186. 

  187.       Button('停止当前策略')
  188.         .onClick(() => {
  189.           if (this.currentStrategy) {
  190.             this.stopGuardStrategy(this.currentStrategy);
  191.           } else {
  192.             this.getUIContext().getPromptAction().showToast({
  193.               message: '请先设置当前策略',
  194.               duration: 2000,
  195.             });
  196.           }
  197.         })
  198.     }
  199.     .height('100%')
  200.     .width('100%')
  201.     .justifyContent(FlexAlign.Center);
  202.   }
  203. }
屏幕时长守护服务（Screen Time Guard Kit）
日历服务（Calendar Kit）
相关推荐
文档Screen Time Guard Kit简介
文档@hms.utilityApplication.screenTimeGuard.guardService（屏幕时间守护服务）
文档添加策略
文档受限ACL权限申请
文档概述
文档修改策略
文档启动策略
文档查询策略运行数据
文档设置应用访问限制
示例代码基于屏幕时间守护服务实现应用访问限制功能
简体中文
华为开发者联盟 版权所有 ©2026
问题反馈
使用条款
华为开发者联盟用户协议
关于华为开发者联盟与隐私的声明
Cookies
开源软件声明
在 FAQ 中进行搜索
请输入您想要搜索的关键词